Comment créer vos propres codes courts WordPress
Dans la version 2.5, WordPress a introduit des codes abrégés et nous les avons tous probablement utilisés à un moment ou à un autre. Ils sont généralement livrés avec des plugins, ou même des thèmes, et ce qu'ils font, c'est surveiller lorsque vous insérez quelque chose entre crochets, puis remplacez-le par un autre contenu; cela pourrait être une phrase simple ou une fonction PHP massive, tout dépend de ce que vous avez demandé à WordPress.
Les raccourcis groupés sont excellents et accélèrent considérablement les choses, mais ne serait-il pas génial de savoir comment créer vos propres raccourcis?
Dans cet article, je vais vous aider à créer des raccourcis WordPress simples pour vous aider à créer toutes les fonctionnalités que vous aimez.
Un shortcode simple
L'API shortcode fonctionne très simplement: vous devez d'abord créer une fonction de rappel qui sera exécutée à chaque fois que le shortcode est utilisé; Ensuite, vous devez associer cette fonction à un shortcode spécifique, le rendant ainsi prêt à être utilisé. Le code est fréquemment placé dans le fichier functions.php, mais si vous prévoyez d'avoir beaucoup de shortcodes, il est judicieux de créer un fichier séparé et d'inclure ce fichier dans votre fichier functions.php.
Dans notre premier exemple, nous voulons créer un shortcode qui créera du lorem ipsum chaque fois que nous tapons [lorem] dans l'éditeur. Nous devons d'abord créer la fonction de rappel qui renverra le lorem ipsum (dans les codes courts, nous ne renvoyons rien, tout est renvoyé):
function lorem_function() {return 'Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec nec nulla vitae lacus mattis volutpat eu at sapien. Nunc interdum congue libero, quis laoreet elit sagittis ut. Pellentesque lacus erat, dictum condimentum pharetra vel, malesuada volutpat risus. Nunc sit amet risus dolor. Etiam posuere tellus nisl. Integer lorem ligula, tempor eu laoreet ac, eleifend quis diam. Proin cursus, nibh eu vehicula varius, lacus elit eleifend elit, eget commodo ante felis at neque. Integer sit amet justo sed elit porta convallis a at metus. Suspendisse molestie turpis pulvinar nisl tincidunt quis fringilla enim lobortis. Curabitur placerat quam ac sem venenatis blandit. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Nullam sed ligula nisl. Nam ullamcorper elit id magna hendrerit sit amet dignissim elit sodales. Aenean accumsan consectetur rutrum.';}Ensuite, nous devons ajouter ce shortcode à WordPress en utilisant la fonction add_shortcode dans notre fichier functions.php ou dans un fichier qui y est inclus, cette fonction ajoute le shortcode et le lie également à la fonction que nous venons de créer. add_shortcode ne prend que deux arguments, le premier étant le nom que ce shortcode doit avoir (ce que nous allons taper entre crochets) et le second étant la fonction que nous voulons attacher à ce shortcode:
add_shortcode('lorem', 'lorem_function');C'est tout ce qu'il faut pour créer un shortcode simple dans WordPress.
Ajouter des paramètres
Poursuivant avec cette idée de contenu factice, nous avons souvent besoin d'images dans notre contenu lorsque nous préparons nos maquettes et ces images doivent avoir des tailles différentes. Nous allons maintenant créer un shortcode pour insérer une image comme celle-ci:
[picture width="500" height="500"]Lorsque WordPress rencontre cela, nous voulons une fonction qui insérera une image. Il doit lire les attributs width et height, mais juste au cas où nous fournirions également des valeurs par défaut pour qu'il puisse être utilisé sans les attributs. Comme nous n’avons peut-être pas d’image disponible, nous allons utiliser le lorempixel.com service pour nous fournir une image aléatoire.
Nous devons d'abord créer la fonction:
function random_picture($atts) {extract(shortcode_atts(array('width' => 400,'height' => 200,), $atts));return '
';}Nous avons nommé cette fonction random_picture et comme ce shortcode pourra prendre des arguments, nous lui avons donné le paramètre $ atts . Pour utiliser les attributs, nous avons besoin de deux fonctions: le shortcode_atts qui est une fonction WordPress qui combine nos attributs avec des attributs connus et qui remplit les valeurs par défaut lorsque cela est nécessaire; et la fonction PHP extract qui, comme son nom l'indique, extrait les attributs définis pour notre shortcode. Enfin, la fonction renvoie la valeur souhaitée, dans ce cas le code HTML de notre image combiné aux variables width et height.
Il ne reste plus qu'à enregistrer ce shortcode:
add_shortcode('picture', 'random_picture');Notre shortcode est complet, quand nous tapons [picture] il nous donnera une image aléatoire de 400 par 200, et si nous utilisons les attributs, nous pouvons créer une image de n'importe quelle taille.
Conclusion
Créer de petits codes courts pour des choses que nous utilisons fréquemment nous aide définitivement lors de la rédaction d'articles de blog parce que vous pouvez faire tout ce qui vous plait avec des shortcodes, cela peut être aussi simple que de retourner une phrase ou d'ajouter un formulaire ou les derniers messages triés par mois.
Avez-vous créé des raccourcis utiles pour WordPress? Quels codes abrégés souhaitez-vous avoir? Faites le nous savoir dans les commentaires.
Image / vignette en vedette, image de code via Marjan Krebelj.