Création de shortcodes dans wordpress


Création de shortcodes dans wordpress

WordPress a introduit l’API des shortcodes il y a six ans avec le lancement de WordPress 2.5. Les shortcodes sont à présent utilisés par un grand nombre de plugins WordPress pour permettre aux utilisateurs d’ajouter du contenu à leurs articles et pages web.

L’API des shortcodes vous permet de créer vos propres shortcodes en ajoutant des fonctions au fichier modèle functions.php de votre thème (que l’on peut trouver à www.votresite.com/wp-content/themes/votretheme/).

En plus de créer vos propres shortcodes, WordPress inclut également cinq shortcodes par défaut :

  • Audio – vous permet d’intégrer des fichiers audio.
  • Légende (caption) – vous permet d’ajuster du texte de légende à du contenu. Utilisé en général pour des images.
  • Embed – vous permet d’intégrer un large choix de contenu tel que des vidéos, de l’audio et des tweets.
  • Galerie – vous permet d’insérer des galeries d’images.
  • Vidéo – vous permet d’intégrer des fichiers vidéo.

 

Bien qu’on utilise fréquemment les shortcodes par défaut de WordPress, très peu d’utilisateurs de WordPress profitent de l’API des shortcodes pour créer des shortcodes uniques pour leur site web. Dans ce tutoriel, je voudrais vous montrer à quel point il va de soi d’améliorer votre site web avec des shortcodes personnalisés.

Avant de commencer, veuillez-vous assurer de sauvegarder, en créant une copie de functions.php et tout autre fichier que vous modifiez avant de faire des modifications sur votre site web.

Créer un shortcode – un exemple basique

Pour que vous compreniez bien comment marche l’API de shortcodes de WordPress, commençons avec une fonction de shortcode basique.

Rappelez-vous que les shortcodes doivent être créés pour le contenu et les fonctionnalités que vous utilisez régulièrement. L’intérêt à utiliser des shortcodes est de gagner du temps. Si vous n’utilisez quelque chose qu’une seule fois, il n’y a pas vraiment d’intérêt à créer un shortcode pour ça.

J’écris environ une douzaine d’articles par semaine. Une chose que je fais souvent, c’est encourager ceux qui apprécient mes articles à s’abonner à mon blog (ou le blog pour lequel j’écris). J’écris ça à chaque fois, alors que je pourrai gagner beaucoup de temps en créant un shortcode pour ça.

Pour ce faire, je pourrais ajouter une fonction à mon modèle de thèmes de fonctions.php telle que celle-ci :

// Fonction pour ajouter un texte d’abonnement dans les articles et pages  function lien_inscription_shortcode() {    return 'Si vous avez aimé mon article, veuillez-vous <a href=" http://feedburner.google.com/fb/lib/images/icons/feed-icon-16x16-gray.gif" title="Inscrire à notre blog">inscription au flux rssS</a>.';
add_shortcode('inscription', 'lien_inscription_shortcode');

Ceux qui n’ont aucune expérience de code pourraient trouver celui-ci un peu intimidant, mais il est facile à comprendre une fois que vous le décomposez ligne par ligne.

La première chose à faire est d’ajouter un commentaire au-dessus de notre fonction. Cela nous aidera à voir rapidement à quoi sert notre fonction lorsque nous voyons le code à une date ultérieure.

// Fonction pour ajouter un texte d’abonnement dans les articles et pages

Puis nous définissons notre fonction. J’aime utiliser des noms qui parlent d’eux-mêmes, et j’ai donc appelé ma fonction « lien_inscription_shortcode ».

  function lien_inscription_shortcode() {

Ensuite, nous définissons notre message. La déclaration de retour (return) affichera notre message lorsqu’on y fera appel. Ça stocke également les messages (au contraire d’echo, qui les imprimera mais qui ne les stockera pas).

return 'Si vous avez aimé mon article, veuillez-vous <a href=" http://feedburner.google.com/fb/lib/images/icons/feed-icon-16x16-gray.gif" title="Inscrire à notre blog">inscription au flux rssS</a>.';

La fonction est alors fermée.

}

Nous définissons alors le shortcode lui-même en utilisant la fonction add_shortcode. La première variable spécifiée définit le shortcode à utiliser et la seconde variable appelle notre fonction (i.e. celle que nous avons définie ci-dessous).

add_shortcode('subscribe', 'lien_inscription_shortcode');

Après avoir enregistré le modèle functions.php, nous pouvons maintenant appeler notre message à tout moment en utilisant le shortcode souscrit.

[inscription]

Utiliser le shortcode inscription dans un article ou sur une page produira le message suivant :

Si vous avez aimé mon article, veuillez-vous inscrire à notre blog

J’ai utilisé dans mon exemple un texte simple, mais vous pouvez le modifier pour afficher plein d’autres choses. Vous pourriez par exemple créer un shortcode pour afficher des publicités adsense ou un formulaire d’inscription pour votre newsletter ; et puis les insérer partout où vous voulez dans vos articles.

Créer un shortcode avec des attributs

Les attributs peuvent étendre la fonctionnalité des shortcodes en vous permettant d’envoyer des données à travers vos shortcodes.

Dans l’exemple ci-dessous, je vais vous montrer comment les attributs peuvent être utilisés pour étendre la fonction que nous avons créée plus tôt. Comme vous pouvez le voir, la majorité du code reste pareil.

// Fonction avancée avec type variablefunction subscribe_multilink_shortcode( $atts ) {    extract( shortcode_atts( array(        'subtype' => 'RSS',        'subtypeurl' => 'http://feeds.feedburner.com/DidacticielsEtTutorielsSurLhbergementWeb ',    ), $atts, 'multilink' ) );     return sprtinf( 'Soyez à jours et recevez nos dernière publications <a href='%1$s'>avec %2$s</a>.',        esc_url( $subtypeurl ),        esc_html( $subtype )    );}add_shortcode( 'inscription', 'subscribe_multilink_shortcode' );

$atts est le nom de votre collection d’attributs. Nous utilisons ensuite la fonction extract pour importer des variables de votre collection (via la fonction WordPress shortcode_atts).

Deux attributs sont alors définis : subtype et et subtypeurl. Ces deux-là représentent le type de souscription et l’URL de souscription. Ces attributs sont alors appelés dans notre message.

Notre type de souscription par défaut est RSS et notre souscription URL par défaut est http://feeds.feedburner.com/DidacticielsEtTutorielsSurLhbergementWeb. Cette information sera affichée quand aucun attribut n’est défini.

Donc, quand vous ajoutez ce qui suit à un article :

[inscription]

Nous obtiendrons le résultat suivant :

Soyez à jours et recevez nos dernières publications avec RSS

Si nous définissons les attributs, le résultat est différent. Le code suivant :

[inscription]

[inscription subtype=&quot;Twitter&quot; subtypeurl=&quot; https://twitter.com/RevueHW &quot;]

[inscription subtype=&quot;Facebook&quot; subtypeurl=&quot; https://www.facebook.com/pages/RevueHebergementWeb/128458923831696&quot;]

[inscription subtype=&quot;Google&quot; subtypeurl=&quot; https://plus.google.com/+Revue-hebergement-web/&quot;]

Résultera en :

Soyez à jours et recevez nos dernières publications avec Twitter

Soyez à jours et recevez nos dernières publications avec Facebook

Soyez à jours et recevez nos dernières publications avec Google

Bien qu’il s’agit d’un exemple basique sur comment marchent les attributs, c’est facile de voir comment les développeurs de plugins peuvent utiliser l’API de shortcodes pour créer des fonctions compliquées plus accessibles aux utilisateurs.

Vue d’ensemble

Si vous suivez bien les étapes décrites dans le présent tutoriel, vous devriez avoir une bonne compréhension de comment créer vos propres shortcodes personnalisés pour votre site web. Les shortcodes sont un excellent moyen de simplifier des tâches compliquées et je vous encourage donc à garder l’API de shortcodes de WordPress à l’esprit dans le futur.

Ne vous inquiétez pas si ce tutoriel était un peu compliqué pour vous. La plupart des templates Wordpress moderne dont ceux de : Elegant Themes viennent avec des shortcodes qui rendent la publication d’un beau contenu facile. Les shortcodes peuvent être utilisés pour créer des diaporamas, des colonnes et des tableaux. Cela vous permet même de protéger votre contenu avec un mot de passe.

J’espère que vous avez apprécié ce tutoriel sur comment créer un shortcode unique pour votre site web WordPress. Si tel est le cas, je vous encourage de nous suivre sur les réseaux sociaux ou encore via rss étant donné que nous y avons du bon contenu en cours.

Aussi, encore une fois, souvenez-vous de sauvegarder tous vos fichiers avant de les modifier.

Article original de  Kevin Muldoon


comments powered by Disqus

Comment changer un domaine principal wp multi-site

Comment changer un domaine principal wp multi-site

Si vous voulez changer le domaine principal de l'installation de votre WordPress multi-site, il y a 5 valeurs à modifier. Vous n’aurez pas besoin d'effectuer une dump de base de données. Ceci est en fait désapprouvé parceque WordPress enregistre des données en séries, et la modification de cela peut … Continuer

Publié le 8 octobre, 2016

0 Commentaires
Supprimer le spam dans wordpress

Supprimer le spam dans wordpress

L’augmentation des commentaires spams dans WordPress devenant un problème, vous vous retrouvez peut-être avec des centaines, voire même des milliers de commentaires en attente que vous avez à supprimer. Malheureusement, l’installation de base de WordPress vous laisse seulement supprimer en masse les … Continuer

Publié le 8 mai, 2016

0 Commentaires
Optimiser la base de données de Wordpress avec Cron

Optimiser la base de données de Wordpress avec Cron

Nous avons déjà souligné l’importance d’avoir une base de données simple et optimisée pour votre site web WordPress pour accélérer la performance de votre site. Après un certain temps, les tableaux MySQL deviennent encombrés et exigeront grandement quelques réparations et travaux d’entretien. Comme … Continuer

Publié le 24 janvier, 2016

0 Commentaires
Comment protéger wp-config.php

Comment protéger wp-config.php

Il est triste de constater à quel point de nombreux sites WordPress sont incroyablement faciles à pirater. Beaucoup d'entre eux ne sont même équipé de la dernière version. Cependant, l'un des fichiers parmi les plus dangereux et les plus sensibles dans WordPress est le wp-config.php. Ce fichier cont … Continuer

Publié le 21 octobre, 2015

0 Commentaires
Comment changer un site html en un site Wordpress

Comment changer un site html en un site Wordpress

Récemment, sur un forum que je fréquente, une vieille connaissance m’a demandé comment convertir un de ses anciens sites Dreamweaver vers WordPress, sans que cela ne lui demande trop d’effort. J’ai d’abord pensé que ce serait impossible de faire cela facilement, mais après avoir vu d’autres réponses … Continuer

Publié le 13 juillet, 2015

2 Commentaires
Comment ajouter un bouton donation dans Wordpress

Comment ajouter un bouton donation dans Wordpress

Il y a un grand nombre de sites web qui offrent des logiciels gratuits ou autres services libres de droit (open source). Les développeurs font beaucoup d’efforts pour nous fournir des outils spécialisés pour divers besoins. Les plugins WordPress sont eux-mêmes un bon exemple. Regardez le nombre d’ad … Continuer

Publié le 11 juillet, 2015

0 Commentaires
Comment installer SSL dans Wordpress

Comment installer SSL dans Wordpress

Tous les jours, nous révélons des informations personnelles sur internet. Rien que pendant la dernière heure, j’ai utilisé ma carte de crédit, acheté un livre, sauvegardé une copie de l’adresse de mes amis, envoyé des mails et fait quelques courses. Partager nos informations est devenu tellement co … Continuer

Publié le 28 février, 2015

0 Commentaires



Les avis des clients

Avis des utilisateurs


Faites entendre votre voix. Passez en revue votre fournisseur d'hébergement Web - bon ou mauvais.


Tout simplement génial ! Avant j'étais chez un hébergeur, je préfère ne pas citer le nom, il était bien mais l'interface d'administration n'était pas de très bonne qualité, l'accès était acceptable. Mais chez one.com, c'est juste génial ! C'est le meilleur hébergeur d'après moi ! En plus d'être g …

M. à propos One

Montrer une autre revue
Lire les avis One



Plans d'hébergement




Les plans d'hébergement de 60 sociétés d'hébergement partout dans le monde


Meilleur hébergeurs web

# hébergeur web prix action

1

Ikoula

1.95 EURO

Ajouter un Avis
Visiter

2

Siteground

6.95 USD

Ajouter un Avis
Visiter

3

Ex2hosting

3.99 EURO

Ajouter un Avis
Visiter

4

Inmotion

5.95 USD

Ajouter un Avis
Visiter

5

Webhostinghub

4.95 USD

Ajouter un Avis
Visiter

6

Bluehost

6.95 USD

Ajouter un Avis
Visiter






Hébergeurs par avis de clients

Ex2hosting
78 avis des clients
Nuxit France
70 avis des clients
Hostpapa France
67 avis des clients
1and1 France
62 avis des clients
Rapidenet
50 avis des clients
Ajouter un avis Tous les profils


Hébergeurs par fidélité de clients

Ex2hosting
73 / 78 recommandé
Nuxit France
68 / 70 recommandé
Rapidenet
49 / 50 recommandé
Infomaniak France
48 / 48 recommandé
Hostpapa France
39 / 67 recommandé
Évaluer hébergeur Tous les profils


Question de la Semaine


Le plus important critère de votre hébergeur



Contacter l'éditeur

Posez votre question