Share
L'API WordPress Shortcode a été introduite dans WordPress dans la version 2.5. Depuis lors, il est devenu une méthode largement utilisée pour permettre la personnalisation rapide de la mise en page et l'insertion de certains extraits de mise en forme. Mais les codes courts peuvent être tout aussi utiles lors de la création de thèmes WordPress - voici comment vous pouvez les utiliser pleinement!
Les codes courts présentent de nombreux avantages s’ils sont utilisés correctement dans les fichiers de thème. Si vous connaissez les macros de préprocesseur en C / C ++, les codes courts peuvent remplir une fonction similaire dans WordPress. L'utilisation d'un code abrégé a pour objectif fondamental de remplacer le paramètre fictif par votre propre élément de code HTML personnalisé lorsque le serveur envoie la page au côté client. Les étapes nécessaires à la création et à la mise en œuvre de codes courts sont les suivantes:.
Dans cette astuce, nous allons utiliser des codes abrégés pour afficher des publications personnalisées. J'ai expliqué en détail comment créer des types d'articles personnalisés et utiliser des thèmes vierges dans Nettuts +, mais pour cet exemple, nous allons modifier le thème par défaut de TwentyTen fourni par WordPress..
La fonction que vous créez pour votre code court définit en réalité l'objectif du code court. Une fonction de base peut être définie de la manière suivante (vous pouvez ajouter tout le code au bas de votre fichier functions.php):
Accentsconagua
// Définition de la fonction utilisée pour afficher la publication de projet personnalisée. function project_shortcode ($ atts) // Extraire les arguments du shortcode. extraire (shortcode_atts (array ('limit' => '10', 'orderby' => 'date',), $ atts)); / * C’est là que nous allons écrire le code de récupération des données * et construire la structure HTML à renvoyer dans la variable $ output * / $ output = 'Cela contiendra la sortie HTML finale de votre boucle de projet personnalisé.'; return $ output; Assurez-vous simplement de ne pas laisser d'espaces à la fin du fichier functions.php, car cela pourrait poser problème. Ajoutons maintenant du code pour récupérer le post personnalisé 'projet' et construire la structure HTML qui remplacera notre shortcode.
function project_shortcode ($ atts) extract (shortcode_atts (array ('limit' = = '10', 'commander' ')> =' 'date',), $ atts)); // Création d'une requête personnalisée pour extraire la publication personnalisée de type de projet. $ loop = new WP_Query (array ('post_type' => 'project', 'posts_per_page' => $ limit, 'orderby' => $ orderby)); // Parcourt les articles et construit la structure HTML. if ($ loop) while ($ loop-> have_posts ()) $ loop-> the_post (); $ output. = ''.get_the_title ().'
'; $ output. = ''.get_the_excerpt ().''; else $ output = 'Désolé, pas encore de projets. Reviens bientôt.'; // Nous retournons maintenant le code HTML à l'endroit d'où le shortcode a été appelé. return $ output; Les '$ atts' sont les attributs fournis avec le shortcode. La méthode d'extraction de PHP est utilisée pour diviser les éléments du tableau en variables afin qu'ils puissent être utilisés directement dans la fonction.
Dans cet exemple, nous utilisons les attributs passés dans la fonction pour créer une requête personnalisée permettant d'extraire les données de publication personnalisées du "projet". Ensuite, nous parcourons tous les posts du projet retournés.
Dans la boucle, nous récupérons et ajoutons les données à la variable de sortie avec les balises HTML appropriées. Une fois la boucle terminée, la variable de sortie contient le code HTML complet de notre liste de projets. Ce code HTML est renvoyé et le shortcode utilisé dans le thème est remplacé par celui-ci lors du chargement de la page..
Maintenant que nous avons créé la fonction, nous devons l'enregistrer dans la base de données avec le code court qui sera utilisé pour cela. Nous pouvons le faire avec le
register_shortcode méthode fournie par WordPress.
add_shortcode ('projets', 'projet_shortcode'); Le premier argument de cette méthode est le nom du shortcode que nous allons utiliser dans le thème, et le second argument est le nom de la fonction (que nous avons définie ci-dessus) relative à ce shortcode. Voici comment WordPress saura quoi faire lorsque ce shortcode est analysé ou rencontré.
WordPress fournit une méthode d'analyse de shortcode que très peu de développeurs envisagent d'utiliser aussi souvent. La méthode do_shortcode peut être utilisée pour insérer des codes abrégés dans les fichiers de thème eux-mêmes..
La syntaxe de shortcode est similaire à celle que vous auriez insérée dans l'éditeur backend. Dans ce cas, nous transmettons les attributs indiquant le nombre maximal de publications à afficher et leur ordre de classement. Comme nous affichons les articles personnalisés "projet", nous allons créer un nouveau modèle de page dédié et utiliser le shortcode dans celui-ci. Créez un modèle nommé 'page-project.php' et utilisez les éléments suivants:
Maintenant, pour voir le modèle que vous venez de créer, créez une page appelée "Projet". Évidemment, créez des démos "Project" postés aussi!
Voila! Le code de fonction affiche correctement les publications personnalisées.
Comme vous pouvez le constater, la méthode ci-dessus consistant à créer un shortcode pour les publications personnalisées et à les utiliser dans notre thème nous permet de garder les fichiers de thème gérables et propres. Cela présente également un avantage supplémentaire: tout le monde peut insérer la boucle de publication personnalisée à partir de l'éditeur de backend WordPress..
L'exemple ci-dessus montre comment utiliser efficacement les codes courts lors du développement de thèmes. Il existe de nombreux moyens novateurs et productifs d'utiliser des codes courts dans les thèmes WordPress - n'hésitez pas à partager vos propres idées dans les commentaires.!
