Tutoriel sur le thème WordPress pour les débutants – Partie 5 : Accéder aux informations sur les publications

Last updated Nov 12, 2022

Teneur

Balises de modèle les plus courantes à utiliser dans la boucle de publication

Documentation sur les méthodes utilisées

Cette leçon du didacticiel sur le thème WordPress pour les débutants portera sur la façon dont nous pouvons accéder et produire des informations telles que son lien, son titre, etc. à partir de chaque article lorsqu’il se trouve dans la boucle de publication. Nous faisons cela avec des balises de modèle. Dans le processus, nous ajouterons également les modèles de vue unique à notre thème.

Dans l’ étape précédente, nous avons ajouté la boucle post qui inclut la the_post()fonction. Cette fonction définit des variables globales et s’assure que nous pouvons utiliser des appels de fonction simples et intuitifs, appelés balises de modèle, pendant que nous sommes à l’intérieur de la whileboucle.

Balises de modèle les plus courantes à utiliser dans la boucle de publication

Voici une liste des balises de modèle les plus courantes que vous voudriez utiliser pour accéder aux informations d’une publication :

the_title()fait écho au titre du message.
the_permalink()affiche le permalien/l’URL de la publication.
the_content()affiche le contenu de l’article (depuis l’éditeur)
the_excerpt()fait écho à l’extrait du message. Si le champ d’extrait est vide, cela fera écho aux 55 premiers mots du contenu de la publication avec "…"
the_ID()affiche l’ID de la publication.
the_category()fait écho à toutes les catégories associées.
the_tags()affiche toutes les balises associées.
the_date()fait écho à la date de publication du message.
the_time()affiche l’heure de publication du message.
the_author()fait écho au nom d’affichage de l’auteur du message
the_post_thumbnail()produit l’image sélectionnée du message. Nous apprendrons comment ajouter la prise en charge des vignettes en vedette plus tard dans ce didacticiel.

Il y en a beaucoup plus. Si vous êtes intéressé, jetez un œil à la documentation de WordPress Codex sur toutes les balises de publication. Jetez également un coup d’œil en dehors de la rubrique "tags de publication" pour en savoir plus – ils sont un peu éparpillés sur cette page.

Commençons à implémenter certaines de ces balises dans notre fichier index.php. J’ajouterai également du HTML très basique juste pour mieux formater la sortie. Je vous encourage à ajouter votre propre HTML! Ajoutez des divs, des spans, des sections, des en-têtes, etc. avec les classes de votre choix.

Concrétiser la boucle dans index.php

À l’intérieur de la boucle de notre index.php, je voudrais ajouter un lien qui mène au permalien de la publication. À l’intérieur du lien, je voudrais faire écho au titre du message. Ensuite, je voudrais également faire écho à l’extrait du message et à ses catégories.

<?php get_header(); ?>
<?php 
if (have_posts()) {
    while (have_posts()): the_post();
        <article <?php post_class(); ?>>
            <h2>
                <a href="<?php the_permalink(); ?>" title="<?php the_title(); ?>"><?php the_title(); ?></a>
            </h2>
            <?php the_excerpt(); ?>
            <?php the_category(); ?>
        </article>
    endwhile;
    the_posts_pagination();
} else {
    ?><p>No posts, sorry.</p><?php
}
?>
<?php get_sidebar(); ?>
<?php get_footer(); ?>

Ce que fait le code ci-dessus est;

La ligne #5 ajoute la <article>balise HTML avec un appel post_class()qui génère des classes de publication utiles – tout comme body_class()nous l’avons utilisé dans une étape précédente.
Aux lignes 6 à 8, nous ajoutons une <h2>balise pour le titre, avec un lien vers le permalien de la publication (vue unique).
La ligne n ° 9 fait écho à l’extrait du message.
Et à la ligne 10, nous faisons écho aux catégories de la publication. Comme je ne transmets aucun argument à cet appel, il s’agit par défaut d’une <ul>liste.

Cela se traduit par le résultat suivant lors de l’actualisation de la page d’accueil :

Nous allons quelque part! Je vous encourage à consulter la documentation de chaque fonction de balise pour les paramètres qu’ils acceptent. Vous pouvez modifier un peu la sortie ! Et décidez vous-même des balises de modèle à utiliser.

Essayez de cliquer sur le lien d’un article et voyez que vous arrivez sur cette page d’article unique. Vous pouvez maintenant voir que la boucle ne montre qu’un seul message. Cependant, étant donné que nous n’avons actuellement qu’un seul modèle, index.php, la vue unique utilise également ce modèle. Donc, la vue unique n’a pas beaucoup de sens. Nous n’en avons pas besoin pour créer un lien vers lui-même, et nous voulons voir le contenu complet de la publication ! Résolvons cela en créant notre deuxième modèle dans notre thème.

Création de modèles de vue unique

Si vous vous souvenez de la leçon 1 du didacticiel sur le thème WordPress pour les débutants, nous avons examiné la hiérarchie des modèles? Lorsque nous sommes sur une seule publication ou page, WordPress recherche single.phpdes publications et page.phpdes pages. Si l’un d’entre eux n’a pas été trouvé, WordPress se rabat sur singular.phpcelui qui est partagé quel que soit le type de publication. Cependant, les thèmes sont généralement mis en œuvre single.phpet en page.phpraison des différences entre les articles et les pages. Les pages n’ont pas de catégories ni de balises, et comme les pages sont généralement utilisées pour du contenu statique, elles n’affichent normalement pas la date de publication ni les commentaires. Cela dépend entièrement de vous.

Nous allons créer single.phpet page.phppour notre thème. Commençons d’abord par les messages.

Modèle de publication unique

Dans votre dossier de thème, faites une copie de index.phpet renommez-le en single.php. Dans single.php, nous supprimerons le permalien (qui renvoie à lui-même) et remplacerons l’extrait par le contenu complet de la publication. Et enfin, nous n’avons pas besoin de navigation dans les archives ici.

<?php get_header(); ?>
<?php 
if (have_posts()) {
    while (have_posts()): the_post();
        <article <?php post_class(); ?>>
            <h2><php the_title(); ?></h2>
            <?php the_content(); ?>
            <?php the_category(); ?>
        </article>
    endwhile;
} else {
    ?><p>No posts, sorry.</p><?php
}
?>
<?php get_sidebar(); ?>
<?php get_footer(); ?>

Ajoutons quelques informations plus utiles; tels que la date du message et le nom de l’auteur. Encore une fois, je vous encourage à ajouter des balises HTML pour créer une structure HTML beaucoup plus agréable.

<?php get_header(); ?>
<?php 
if (have_posts()) {
    while (have_posts()): the_post();
        <article <?php post_class(); ?>>
            <h2><php the_title(); ?></h2>
            <?php the_content(); ?>
            <?php the_category(); ?>
            <p>Posted: <?php the_date(); ?> at <?php the_time(); ?></p>
            <p>Author: <?php the_author(); ?></p>
        </article>
    endwhile;
} else {
    ?><p>No posts, sorry.</p><?php
}
?>
<?php get_sidebar(); ?>
<?php get_footer(); ?>

Les fonctions the_time()et the_date()feront écho à la date et à l’heure dans le format que vous avez défini dans le panneau d’administration > Paramètres. Cependant, vous pouvez remplacer cela en fournissant un format de date différent en tant que paramètre de ces méthodes.

La fonction the_author()fait écho au "nom d’affichage" de l’auteur. Si l’utilisateur n’a fourni aucun autre nom dans son profil, cela fera écho au nom d’utilisateur.

Je vous encourage fortement à ne jamais imprimer les noms d’utilisateur car cela peut constituer une menace pour la sécurité. Assurez-vous toujours que tous les auteurs ont fourni un nom propre ou n’utilisent pas the_author().

Voici à quoi ressemble un seul message pour moi maintenant. Impressionnant! Créons le modèle d’une seule page.

Modèle de page unique

Faites une copie de votre single.phpet renommez-le en page.php. Tout ce que j’ai fait page.phpétait de supprimer tout ce qui n’était pas lié aux pages. L’écho des catégories pour les pages ne fonctionnera pas, et j’ai également supprimé la date, l’heure et l’auteur. Voici ce que nous obtenonspage.php :

<?php get_header(); ?>
<?php 
if (have_posts()) {
    while (have_posts()): the_post();
        <article <?php post_class(); ?>>
            <h2><php the_title(); ?></h2>
            <?php the_content(); ?>
        </article>
    endwhile;
} else {
    ?><p>No posts, sorry.</p><?php
}
?>
<?php get_sidebar(); ?>
<?php get_footer(); ?>

Nous commençons enfin à avancer avec nos modèles ! Cependant, je ne peux pas répéter cela assez; Je vous encourage à modifier les modèles et les paramètres des fonctions à votre guise. Surtout en ajoutant plus de wrappers HTML pour faciliter le style plus tard.

Dans l’étape suivante, nous nous éloignons un peu des modèles et entrons davantage dans le codage backend des thèmes WordPress.

Documentation sur les méthodes utilisées

Source d’enregistrement: awhitepixel.com