Retour à la liste des blocs

Le bloc Modèle de commentaire constitue une partie du bloc Boucle de requête des commentaires. Il contient différents blocs permettant d’afficher le commentaire lui-même, le nom et l’avatar de son auteur ou de son autrice, sa date de publication et les liens de modification du commentaire et de réponse au commentaire.

Capture d’écran montrant un exemple de bloc Modèle de commentaire à l’intérieur d’un bloc Boucle de requête de commentaires

Lorsque vous ajoutez le bloc Boucle de requête des commentaires, le bloc Modèle de commentaire est inclus avec une disposition définie par défaut, car il ne peut être inséré à aucun autre emplacement. Aussi veillez à vous placer à l’intérieur d’un bloc Boucle de requête des commentaires pour être en mesure d’insérer le bloc Modèle de commentaire et de modifier éventuellement l’agencement des blocs qu’il contient.

Pour connaître la procédure à suivre pour ajouter un bloc, veuillez consulter l’article Ajouter un nouveau bloc.

Barre d’outils du bloc

Capture d’écran de la barre d’outils du bloc Modèle de commentaire.

Chaque bloc dispose d’une barre d’outils vous permettant de le manipuler directement dans l’éditeur. Parmi ces outils, on distingue les outils communs, présentés dans l’article Barre d’outils des blocs, et d’éventuels outils spécifiques, décrits ci-dessous. 

Le bloc Modèle de commentaire ne propose pas d’outil spécifique.

Réglages du bloc

Selon les blocs, divers réglages sont disponibles dans la colonne latérale des réglages. Parmi ceux-ci, on distingue les réglages communs (à une majorité de blocs) des réglages spécifiques, décrits ci-dessous.

Aucun réglage n’est disponible pour le bloc Modèle de commentaire.

Avancé

L’onglet Avancé vous permet d’accéder aux réglages avancés des blocs.

Traduit par Jenny Dupuy
Relu par Didier Demory & Patrick Olivaud
Dernière mise à jour le 21 août 2022

Contribuer à la documentation en français de WordPress

Retour à la liste des blocs

Le bloc Lien de modification de commentaire affiche un lien vers l’écran Modifier le commentaire du Tableau de bord de WordPress. Ce lien sera visible si l’internaute qui visite le site dispose des droits pour modifier les commentaires.

Ce bloc ne peut être inséré qu’à l’intérieur d’un bloc Modèle de commentaire lui-même inséré dans un bloc Boucle de requête des commentaires.
Ce dernier fonctionne de la même manière que le bloc Boucle de requête mais affiche l’ensemble des commentaires si l’article a été commenté.

Pour connaître la procédure à suivre pour ajouter un bloc, veuillez consulter l’article Ajouter un nouveau bloc.

Barre d’outils du bloc

Capture d’écran de la barre d’outils du bloc Lien de modification de commentaire

Chaque bloc dispose d’une barre d’outils vous permettant de le manipuler directement dans l’éditeur. Parmi ces outils, on distingue les outils communs, présentés dans l’article Barre d’outils des blocs, et d’éventuels outils spécifiques, décrits ci-dessous. 

Ce bloc ne propose pas d’outil spécifique.

Réglages du bloc

Selon les blocs, divers réglages sont disponibles dans la colonne latérale des réglages. Parmi ceux-ci, on distingue les réglages communs (à une majorité de blocs) des réglages spécifiques, décrits ci-dessous.

Réglages de lien

Dans la section Réglages de lien, vous pouvez activer l’option Ouvrir dans un nouvel onglet afin de créer un nouvel onglet lors du clic sur le lien de modification.

Avancé

L’onglet Avancé vous permet d’accéder aux réglages avancés des blocs.

Traduit par Jenny Dupuy
Relu par Laurent Millet & Didier Demory
Dernière mise à jour le 19 août 2022

Contribuer à la documentation en français de WordPress

Retour à la liste des blocs

Le bloc Étiquettes d’articles permet d’afficher sous forme d’une liste de liens les étiquettes associées à un article. Ce bloc est en général imbriqué dans le bloc Boucle de requête afin de personnaliser l’apparence des résultats retournés par la boucle de requête.

Pour connaître la procédure à suivre pour ajouter un bloc, veuillez consulter l’article Ajouter un nouveau bloc.

Barre d’outils du bloc

Capture d’écran de la barre d’outils du bloc Étiquettes d’articles

Chaque bloc dispose d’une barre d’outils vous permettant de le manipuler directement dans l’éditeur. Parmi ces outils, on distingue les outils communs, présentés dans l’article Barre d’outils des blocs, et d’éventuels outils spécifiques, décrits ci-dessous. 

Le bloc Étiquettes d’articles ne propose pas d’outil spécifique.

Réglages du bloc

Selon les blocs, divers réglages sont disponibles dans la colonne latérale des réglages. Parmi ceux-ci, on distingue les réglages communs (à une majorité de blocs) des réglages spécifiques, décrits ci-dessous.

Aucun réglage spécifique n’est proposé pour ce bloc.

Avancé

L’onglet Avancé vous permet d’accéder aux réglages avancés des blocs.

Traduit par Jenny Dupuy
Relu par Didier Demory & Jb Audras
Dernière mise à jour le 2 août 2022

Contribuer à la documentation en français de WordPress

Retour à la liste des blocs

Utilisez le bloc Catégories d’articles pour afficher les catégories des articles. Ce bloc a été conçu pour être intégré à l’intérieur du bloc Boucle de requête afin de personnaliser l’apparence des résultats retournés par la boucle de requête.

Pour connaître la procédure à suivre pour ajouter un bloc, veuillez consulter l’article Ajouter un nouveau bloc.

Barre d’outils du bloc

Capture d’écran de la barre d’outils du bloc Catégories d’articles

Chaque bloc dispose d’une barre d’outils vous permettant de le manipuler directement dans l’éditeur. Parmi ces outils, on distingue les outils communs, présentés dans l’article Barre d’outils des blocs, et d’éventuels outils spécifiques, décrits ci-dessous. 

Le bloc Catégories d’articles ne propose pas d’outil spécifique.

Réglages du bloc

Selon les blocs, divers réglages sont disponibles dans la colonne latérale des réglages. Parmi ceux-ci, on distingue les réglages communs (à une majorité de blocs) des réglages spécifiques, décrits ci-dessous.

Aucun réglage spécifique n’est disponible pour ce bloc.

Avancé

L’onglet Avancé vous permet d’accéder aux réglages avancés des blocs.

Traduit par Jenny Dupuy
Relu par Didier Demory & Jb Audras
Dernière mise à jour le 2 août 2022

Contribuer à la documentation en français de WordPress

Retour à la liste des blocs

Le bloc Extrait de la publication permet d’afficher l’extrait de la publication, tel qu’il a été saisi dans le champ Rédiger un extrait (facultatif) dans la section Extrait de la colonne latérale des réglages, ou tel qu’il est défini par le thème (l’extrait reprend les 55 premiers mots de la publication suivis de […], ce nombre peu éventuellement varier d’un thème à l’autre).

Ce bloc a été conçu pour être intégré à l’intérieur du bloc Boucle de requête afin de personnaliser l’apparence des résultats retournés par la boucle de requête.

Il propose l’ajout optionnel d’un lien vers le contenu complet de la publication. Vous pouvez utiliser le texte de votre choix dans le champ Texte du lien « Lire la suite » pour définir le texte de ce lien, et personnaliser son apparence indépendamment de celle de l’extrait.

Barre d’outils du bloc

Capture d’écran de la barre d’outils du bloc Extrait de la publication

Chaque bloc dispose d’une barre d’outils vous permettant de le manipuler directement dans l’éditeur. Parmi ces outils, on distingue les outils communs, présentés dans l’article Barre d’outils des blocs, et d’éventuels outils spécifiques, décrits ci-dessous. 

Lorsque vous cliquez sur le lien optionnel « Lire la suite » ou lorsque vous sélectionnez du texte de l’extrait, des outils supplémentaires pour définir le style du texte sont proposés dans la barre d’outils.

Capture d’écran de la barre d’outils du bloc Extrait de la publication avec les outils permettant de styliser le texte de l’extrait et du lien « Lire la suite »

Réglages du bloc

Selon les blocs, divers réglages sont disponibles dans la colonne latérale des réglages. Parmi ceux-ci, on distingue les réglages communs (à une majorité de blocs) des réglages spécifiques, décrits ci-dessous.

Capture d’écran des réglages spécifiques au bloc Extrait de la publication

Réglages de l’extrait de la publication

L’option Afficher le lien sur une nouvelle ligne permet de mettre en évidence le lien « Lire la suite » sur une nouvelle ligne, sous l’extrait. Si cette option n’est pas activée, le lien « Lire la suite » est placé à la suite du texte de l’extrait après […].

Avancé

L’onglet Avancé vous permet d’accéder aux réglages avancés des blocs.

Traduit par Jenny Dupuy
Relu par Didier Demory & Jb Audras
Dernière mise à jour le 2 août 2022

Contribuer à la documentation en français de WordPress

Le bloc Nuage d’étiquettes vous offre la possibilité d’afficher un nuage contenant vos étiquettes ou vos catégories au sein de vos publications. Un nuage d’étiquettes (ou de catégories) est une liste de toutes les étiquettes (ou catégories) associées à vos publications affichées par ordre alphabétique.

Un nuage d’étiquettes (ou catégories) aide les internautes à découvrir ou rechercher plus rapidement et plus simplement vos contenus.

Un nuage d’étiquettes affiche chaque étiquette avec une taille de police de caractères proportionnelle au nombre de fois où l’étiquette est associée à une publication. Plus la taille de la police est grande, plus l’étiquette correspondante est associée à vos publications. Ceci permet aux internautes de voir d’un seul coup d’œil les sujets les plus fréquemment abordés par vos publications.

Capture d’écran d’un exemple d’un bloc Nuage d’étiquettes présentant la liste des étiquettes ou catégories sous forme de liens avec des tailles de police fonction du nombre d’articles associés à la taxonomie sélectionnée

Si dans votre site, vous avez créé et associé aux publications des étiquettes ou des catégories, alors l’ajout d’un bloc Nuage d’étiquettes devrait afficher la liste de ces taxonomies sous forme d’une liste de liens ciblant chacun la page d’archive de chaque taxonomie (avec une URL du type https://votre-domaine.com/tag/tag-slug ou https://votre-domaine.com/category/category-slug).
Si vous ne disposez pas d’étiquettes (ou de catégories), le message suivant sera affiché :

Votre site n’a aucune publication utilisant la taxonomie « Étiquettes », il n’y a donc rien à afficher pour le moment.

Note : l’apparence du bloc sera variable selon le thème utilisé.

Pour connaître la procédure à suivre pour ajouter un bloc, veuillez consulter l’article Ajouter un nouveau bloc.

Barre d’outils du bloc

Capture d’écran de la barre d’outils du bloc Nuage d’étiquettes

Chaque bloc dispose d’une barre d’outils vous permettant de le manipuler directement dans l’éditeur. Parmi ces outils, on distingue les outils communs, présentés dans l’article Barre d’outils des blocs, et d’éventuels outils spécifiques, décrits ci-dessous. 

Le bloc Nuage d’étiquettes ne propose pas d’outil qui lui soit spécifique.

Réglages du bloc

Selon les blocs, divers réglages sont disponibles dans la colonne latérale des réglages. Parmi ceux-ci, on distingue les réglages communs (à une majorité de blocs) des réglages spécifiques, décrits ci-dessous.

Réglages du nuage d’étiquettes

Taxonomie

Sélectionnez dans la liste déroulante Taxonomie, Étiquettes ou Catégories, selon ce que vous souhaitez utiliser. Le nuage sera alors construit avec les noms (des différentes étiquettes ou catégories) selon la taxonomie sélectionnée.

Afficher le nombre d’articles

Si vous activez l’option Afficher le nombre d’articles, ce dernier sera alors ajouté entre parenthèses à chaque étiquette ou catégorie.

Capture d’écran d’un bloc Nuage d’étiquettes dans lequel le nombre d’articles est indiqué à côté de chaque terme de la taxonomie

Nombre d’étiquettes

Déplacez le curseur ou saisissez une valeur dans le champ Nombre d’étiquettes pour définir de combien d’étiquettes (ou catégories) au maximum sera composé le nuage.

La plus petite / la plus grande taille

Saisissez une valeur pour la taille de la police dans les deux champs La plus petite taille et La plus grande taille et choisissez une unité (parmi les unités proposées : pt, px, %, em ou rem) afin de déterminer quelle sera la taille de la police la plus petite pour le terme de taxonomie le moins répandu et la plus grande pour le terme le plus répandu.

Avancé

L’onglet Avancé vous permet d’accéder aux réglages avancés des blocs.

Traduit par Jenny Dupuy
Relu par Didier Demory & Patrick Olivaud
Dernière mise à jour le 21 juillet 2022

Contribuer à la documentation en français de WordPress

Les fichiers modèles des thèmes constituent les pièces du puzzle que WordPress assemble pour afficher les pages de votre site. Certains modèles (les fichiers d’entête ou de pied de page, par exemple) sont utilisés pour toutes les pages générées ; d’autres ne sont utilisés que sous certaines circonstances.

Cet article explique comment WordPress détermine quel fichier modèle utiliser pour chaque écran. Si vous voulez personnaliser un thème WordPress, cela vous aidera à savoir quel fichier modèle doit être modifié.

Note : vous pouvez aussi utiliser les marqueurs conditionnels pour déterminer les modèles qui seront chargés sur un écran spécifique.

Description de la hiérarchie des fichiers modèles

Vue d’ensemble

WordPress utilise la chaîne de requête pour déterminer le modèle à mettre en place pour afficher l’écran demandé. La chaîne de requête est une information contenue dans l’URL de chaque page de votre site.

Pour le dire simplement, WordPress parcourt la hiérarchie des fichiers modèles jusqu’à ce qu’il trouve un fichier modèle correspondant à la chaîne de requête demandée. Pour déterminer le fichier modèle à utiliser, WordPress suit le processus suivant :

  1. Le CMS fait correspondre chaque chaîne de requête à un type de requête afin de déterminer l’écran en cours d’affichage (par exemple, l’écran des résultats de recherche, l’écran de liste des articles d’une catégorie donnée, etc.).
  2. Il sélectionne le modèle à utiliser en utilisant l’ordre de la hiérarchie des fichiers modèles.
  3. Il identifie parmi les fichiers modèles présents dans le répertoire du thème actif ceux qui correspondent à l’écran en cours d’affichage, et utilise le premier fichier modèle dans l’ordre de la hiérarchie.

À l’exception du fichier modèle de base index.php qui doit être présent dans tout thème, les personnes qui développent des thèmes sont libres de choisir si elles veulent ou non implémenter tel ou tel fichier modèle. Si WordPress ne trouve pas le premier fichier attendu pour le type d’écran dans la liste des fichiers modèles du thème actif, il passe au fichier suivant de la hiérarchie. En dernier lieu, si aucun fichier n’a été trouvé, c’est le fichier index.php qui sera utilisé.

Note : dans ces exemples, l’extension de fichier .php est utilisée. Avec les thèmes basés sur des blocs, ce sera l’extension de fichier .html qui sera utilisée. Dans les deux cas la hiérarchie des fichiers modèles reste la même.

Surcharge des modèles d’un thème en utilisant un thème enfant

Lorsque vous utilisez un thème enfant, tout fichier ajouté dans le répertoire de votre thème enfant sera chargé en lieu et place du fichier du même nom présent dans le thème parent. Par exemple, si les deux thèmes contiennent un fichier category.php, alors ce sera celui du thème enfant qui sera utilisé.

Si un thème enfant contient un fichier modèle spécifique tel que category-licornes.php et que le thème parent contient un fichier modèle moins prioritaire tel que category.php, alors c’est le fichier modèle category-licornes.php du thème enfant qui sera utilisé.

À l’inverse, si le thème enfant contient un modèle général tel que category.php alors que le thème parent contient un fichier modèle spécifique tel que category-licornes.php, alors c’est le fichier modèle du thème parent qui sera utilisé.

Exemples

Si votre site est accessible à l’adresse https://example.com/blog/ et si un internaute essaye d’accéder à une page de catégorie à l’adresse https://example.com/blog/category/photos-de-chatons/, alors WordPress va essayer de trouver un fichier modèle correspondant dans le répertoire de votre thème ou de votre thème enfant. La procédure est la suivante :

  1. Recherche d’un modèle correspondant exactement au slug de catégorie passé dans l’URL. Dans l’exemple ci-dessus, le slug sera photos-de-chatons, WordPress cherchera donc un fichier category-photos-de-chatons.php.
  2. Si le fichier category-photos-de-chatons.php n’existe pas et si l’identifiant de cette catégorie est 4 alors il cherchera un fichier nommé category-4.php.
  3. Si le fichier category-4.php n’existe pas dans le thème, alors WordPress cherchera à utiliser un fichier modèle plus générique, category.php.
  4. Si category.php n’existe pas, alors il cherchera à utiliser un fichier d’archive encore plus générique, archive.php.
  5. Enfin, si WordPress ne trouve pas non plus de fichier archive.php alors il utilisera le fichier de base (obligatoirement présent) du thème, index.php.

Représentation graphique de la hiérarchie des fichiers modèles

Le schéma suivant montre l’arbre de décision utilisé par WordPress pour déterminer le fichier modèle à utiliser en fonction de la hiérarchie des fichiers modèles.

Hiérarchie des fichiers modèles de WordPress – Juillet 2022
Schéma de la hiérarchie des fichiers modèles de WordPress.
Cliquer sur l’image pour l’ouvrir en plus grand dans un nouvel onglet.

La hiérarchie des fichiers modèles en détail

Bien que la hiérarchie des fichiers modèles puisse être plus simple à visualiser sous la forme du diagramme ci-dessus, les sections suivantes décrivent l’ordre dans lequel les fichiers modèles sont appelés pour chaque type de requête.

Affichage de la page d’accueil d’un blog

Par défaut, WordPress est réglé pour afficher les derniers articles de blog sur la page d’accueil de votre site. Vous pouvez changer ce réglage pour utiliser une page d’accueil statique, mais ce cas est décrit dans la section suivante.

Par défaut, le fichier modèle home.php est utilisé pour afficher la liste des articles de votre blog. Si home.php n’existe pas, alors WordPress utilisera index.php.

Ordre des fichiers modèles :

  1. home.php.
  2. index.php.

À noter : si front-page.php existe, alors il est toujours utilisé pour votre page d’accueil à la place de home.php.

Affichage de la page d’accueil générale de votre site

Le fichier modèle front-page.php est utilisé pour afficher la page d’accueil de votre site, qu’elle soit réglée pour afficher les deniers articles (cas décrit dans la section précédente) ou une page statique (voir article concernant l’utilisation d’une page d’accueil statique). Le modèle de page d’accueil générale prend la priorité sur le modèle de page d’accueil du blog (home.php). Si le fichier front-page.php n’existe pas, alors WordPress utilisera soit home.php, soit le fichier page.php, suivant les réglages de lecture utilisés sur votre site. Si aucun de ces fichiers modèles n’existe dans votre thème, alors WordPress utilisera le fichier index.php.

  1. front-page.php – utilisé pour la page d’accueil du blog comme pour la page d’accueil statique de votre site.
  2. home.php – si WordPress ne trouve aucun fichier front-page.php dans le thème et si le site est configuré pour afficher les derniers articles du blog sur la page d’accueil, alors il essayera de charger ce fichier.
  3. page.php – utilisé si vous avez configuré WordPress pour afficher une page d’accueil statique et si aucun fichier front-page.php n’existe dans votre thème.
  4. index.php – utilisé si aucun fichier modèle décrit ci-dessus n’est proposé par le thème.

Affichage de la page de politique de confidentialité

Le fichier modèle privacy-policy.php est utilisé pour afficher la page de politique de confidentialité de votre site (voir les réglages de confidentialité).

Ordre des fichiers modèles :

  1. privacy-policy.php.
  2. Modèle de page personnalisé – le modèle de page assigné à la page.
  3. page-{slug}.php – si le slug de la page est privacy, WordPress cherchera un fichier modèle page-privacy.php.
  4. page-{id}.php – Si l’identifiant de la page est 6, WordPress cherchera un fichier modèle page-6.php.
  5. page.php.
  6. singular.php.
  7. index.php.

Publication seule

Ordre des fichiers modèles :

  1. single-{post-type}-{slug}.php – premièrement, WordPress va chercher un modèle permettant d’afficher cette publication spécifique. Par exemple, si le type de publication est product et si son slug est cookie, alors WordPress cherchera un fichier single-product-cookie.php.
  2. single-{post-type}.php – si le type de publication est product, WordPress cherchera un fichier single-product.php.
  3. single.php – ce sera le fichier modèle utilisé si aucun fichier ne correspond aux cas décrits ci-dessus.
  4. singular.php – idem.
  5. index.php.

Page seule

Fichier modèle utilisé pour afficher une page statique (sur WordPress, il s’agit du type de publication natif page). À noter que contrairement aux autres types de publication, les pages ont un comportement spécifique :

  1. Modèle de page personnalisé – le modèle de page assigné à la page.
  2. page-{slug}.php – si le slug de la page est contact, WordPress cherchera un fichier modèle page-contact.php.
  3. page-{id}.php – si l’identifiant de la page est 6, WordPress cherchera un fichier modèle page-6.php.
  4. page.php.
  5. singular.php.
  6. index.php.

Archive de catégorie

Ordre des fichiers modèles :

  1. category-{slug}.php – si le slug de la catégorie est nouveautes, WordPress cherchera un fichier modèle category-nouveautes.php.
  2. category-{id}.php – si l’identifiant de la catégorie est 4, WordPress cherchera un fichier modèle category-4.php.
  3. category.php.
  4. archive.php.
  5. index.php.

Archive d’étiquette

Ordre des fichiers modèles :

  1. tag-{slug}.php – si le slug de l’étiquette est france, WordPress cherchera un fichier modèle tag-france.php.
  2. tag-{id}.php – si l’identifiant de l’étiquette est 4, WordPress cherchera un fichier modèle tag-4.php.
  3. tag.php.
  4. archive.php.
  5. index.php.

Taxonomies personnalisées

Les taxonomies personnalisées suivent un ordre légèrement différent des taxonomies natives :

  1. taxonomy-{taxonomy}-{term}.php – si la taxonomie est departement, et si le terme de taxonomie est ardeche, alors WordPress cherchera un fichier modèle taxonomy-departement-ardeche.php.
    Dans le cas spécifique des formats de publications, la taxonomie est nommée post_format et le terme de taxonomie est post-format-{format}. Cela donnera donc un fichier modèle taxonomy-post_format-post-format-link.php pour le format de publication ayant le slug link.
  2. taxonomy-{taxonomy}.php – si la taxonomie est departement, WordPress cherchera le fichier modèle taxonomy-departement.php.
  3. taxonomy.php.
  4. archive.php.
  5. index.php.

Types de publications personnalisés

Les types de publications personnalisés utilisent l’ordre suivant pour afficher leur page d’archive (liste des publications du même type) :

  1. archive-{post_type}.php – si le type de publication est product, WordPress cherchera le fichier modèle archive-product.php.
  2. archive.php.
  3. index.php.

(pour le fichier modèle destiné à l’affichage d’une publication d’un type de publication donné, se référer à la section Publication seule).

Archive par auteur ou autrice

La page d’archive des articles publiés par un auteur ou une autrice est affichée selon l’ordre suivant :

  1. author-{nicename}.php – si le slug du nom de l’auteur ou de l’autrice est camille, WordPress cherchera le fichier modèle author-camille.php.
  2. author-{id}.php – si l’identifiant de l’auteur ou de l’autrice est 6, WordPress cherchera le fichier modèle author-6.php.
  3. author.php.
  4. archive.php.
  5. index.php.

Archive par date

Les pages d’archive proposant une liste d’articles publiés à une date donnée sont générées dans l’ordre suivant :

  1. date.php.
  2. archive.php.
  3. index.php.

Résultats de recherche

L’écran affichant la liste des résultats de recherche est généré dans l’ordre suivant :

  1. search.php.
  2. index.php.

Erreur 404 (page introuvable)

L’écran affichant la page d’erreur 404 est généré dans l’ordre suivant :

  1. 404.php.
  2. index.php.

Fichiers attachés

L’affichage d’un fichier attaché seul (type de publication attachment) utilise l’ordre suivant :

  1. {MIME-type}.php – peut être n’importe quel type MIME. Par exemple, image.php, video.php, pdf.php.
    Pour le type MIME text/plain, l’ordre suivant est utilisé :
    1. text-plain.php.
    2. plain.php.
    3. text.php.
  2. attachment.php.
  3. single-attachment-{slug}.php – par exemple, si le slug du fichier attaché est vacances, WordPress cherchera le fichier modèle single-attachment-vacances.php.
  4. single-attachment.php.
  5. single.php.
  6. singular.php.
  7. index.php.

Publications embarquées

Le modèle des publications embarquées est utilisé pour afficher une publication lorsqu’elle est embarquée sur une autre publication.

  1. embed-{post-type}-{post_format}.php – WordPress cherche d’abord un modèle utilisable lorsque la publication à embarquer utilise un type de publication spécifique avec un format spécifique. Par exemple, si le type de publication est post et s’il a le format audio, alors WordPress cherchera le fichier modèle embed-post-audio.php.
  2. embed-{post-type}.php – si le type de publication est product, WordPress cherchera embed-product.php.
  3. embed.php – le fichier modèle générique pour tous les contenus embarqués.
  4. En derniers recours, WordPress utilisera son propre fichier modèle, que vous pouvez trouver au chemin suivant sur votre installation WP : wp-includes/theme-compat/embed.php.

Gestion des caractères spéciaux

Depuis WordPress 4.7, les caractères spéciaux sont supportés, dans l’ordre suivant pour une page nommée « Bonjour tout le monde 😀 » et ayant l’identifiant 6:

Le même comportement s’applique pour les autres types de publications, les noms de termes de taxonomies, ou encore les auteurs et autrices.

Modifier la hiérarchie des fichiers modèles

Le système de modèles de WordPress vous permet de modifier la hiérarchie des fichiers modèles à l’aide de filtres. Le filtre à utiliser (voir la documentation de la fonction get_query_template() (en anglais) sera toujours {$type}_template, où $type correspond au type de modèle.

Voici une liste des filtres disponibles nativement dans la hiérarchie des fichiers modèles :

Exemple d’utilisation du filtrage des fichiers modèles

Par exemple, prenons la hiérarchie des fichiers modèles utilisée par défaut pour l’affichage des archives de contenus d’un auteur ou d’une autrice :

Si l’on souhaite ajouter un type de fichier modèle author-{role}.php qui serait utilisé avant de basculer sur author.php, il est possible de manipuler la hiérarchie en utilisant le filtre author_template. Le résultat serait que par exemple, pour une requête d’URL /author/camille où le compte camille aurait un rôle editor (correspondant au rôle d’éditeur/éditrice), la page d’archive pourrait être générée par le fichier modèle author-editor.php s’il est présent dans le répertoire du thème actif.

Exemple d’implémentation :

function wpdocs_author_role_template( $templates = '' ) { 
    $author = get_queried_object(); 
    $role = $author->roles[0];

    if ( ! is_array( $templates ) && ! empty( $templates ) ) { 
        $templates = locate_template( array( "author-$role.php", $templates ), false ); 
    } elseif ( empty( $templates ) ) { 
        $templates = locate_template( "author-$role.php", false ); 
    } else { 
        $new_template = locate_template( array( "author-$role.php" ) );

        if ( ! empty( $new_template ) ) { 
            array_unshift( $templates, $new_template ); 
        } 
    } 
    return $templates; 
} 

add_filter( 'author_template', 'wpdocs_author_role_template' );

Ressources

Traduit par Jb Audras
Relu par Marie-Aude Koiransky & Jenny Dupuy
Dernière mise à jour le 17 août 2022

Contribuer à la documentation en français de WordPress

Journal des modifications

17 août 2022Jenny Dupuy – Ajout des liens vers Learn WordPress.

Retour à la liste des blocs

Utilisez le bloc Logo du site pour ajouter un logo qui représente votre site.

Le logo du site est différent de l’icône du site, qui est une petite image, aussi appelée « favicon », visible dans votre tableau de bord, dans les onglets du navigateur, etc. et utilisé pour aider les internautes à reconnaître votre site.

Le bloc Logo du site est principalement utilisé lors de la modification des modèles dans l’éditeur de site.

Pour connaître la procédure à suivre pour ajouter un bloc, veuillez consulter l’article Ajouter un nouveau bloc.

Une fois que vous avez ajouté le bloc Logo du site, vous disposez d’un emplacement réservé (matérialisé par une icône d’image) pour placer un logo dans le modèle. Cliquez sur l’emplacement réservé pour téléverser une nouvelle image ou en sélectionner une à partir de la médiathèque.

Lorsque l’image a été choisie, vous pouvez ensuite la redimensionner à l’aide des poignées affichées sur les côtés de l’image.

Notez que lorsque vous modifiez un bloc Logo du site, les modifications sont appliquées à tous les blocs Logo du site existants dans les modèles du site, ou dans les publications du site.

Barre d’outils du bloc

Capture d’écran de la barre d’outils du bloc Logo du site

Chaque bloc dispose d’une barre d’outils vous permettant de le manipuler directement dans l’éditeur. Parmi ces outils, on distingue les outils communs, présentés dans l’article Barre d’outils des blocs, et d’éventuels outils spécifiques, décrits ci-dessous. 

Recadrer

L’outil Recadrer fonctionne comme celui du bloc Image, à l’exception qu’aucun quadrillage n’est appliqué à l’image.

Appliquer un filtre duotone

Là aussi, cet outil fonctionne comme celui disponible pour le bloc Image.

Remplacer

Ici encore, l’outil fonctionne comme celui proposé pour le bloc Image.

Réglages du bloc

Selon les blocs, divers réglages sont disponibles dans la colonne latérale des réglages. Parmi ceux-ci, on distingue les réglages communs (à une majorité de blocs) des réglages spécifiques, décrits ci-dessous.

Réglages

Capture d’écran montrant les différentes options proposées dans les réglages du bloc Logo du site

Largeur de l’image

La largeur de l’image peut être modifiée en déplaçant le curseur ou en saisissant une valeur numérique dans le champ situé à droite du curseur.

Lien vers l’accueil

Activez l’option Faire un lien vers l’accueil sur l’image afin qu’un clic sur le logo du site renvoie l’internaute vers la page d’accueil. Cette option est activée par défaut.

Ouvrir dans un nouvel onglet

Activez l’option Ouvrir dans un nouvel onglet afin que ce dernier s’ouvre lorsque l’internaute clique sur le logo du site.

Icône de site

Activez l’option Utiliser comme icône de site pour créer une favicon identique à votre logo. Si vous souhaitez utiliser une image différente pour votre favicon, cliquez sur le lien Réglages d’icône.

Avancé

L’onglet Avancé vous permet d’accéder aux réglages avancés des blocs.

Traduit par Jenny Dupuy
Relu par Patrick Olivaud & Didier Demory
Dernière mise à jour le 07 juillet 2022

Contribuer à la documentation en français de WordPress

Retour à la liste des blocs

Utilisez le bloc Date de publication pour afficher la date à laquelle la publication a été publiée. Ce bloc est principalement inclus dans le bloc Boucle de requête et permet de personnaliser l’apparence de la date dans votre modèle.

Pour connaître la procédure à suivre pour ajouter un bloc, veuillez consulter l’article Ajouter un nouveau bloc.

Barre d’outils du bloc

Capture d’écran de la barre d’outils du bloc Date de publication

Chaque bloc dispose d’une barre d’outils vous permettant de le manipuler directement dans l’éditeur. Parmi ces outils, on distingue les outils communs, présentés dans l’article Barre d’outils des blocs, et d’éventuels outils spécifiques, décrits ci-dessous. 

Modifier la date

Pour remplacer la date et l’heure de publication par une autre date, antérieure ou postérieure, cliquez sur l’outil Modifier la date :

Capture d’écran de la boîte de dialogue de sélection de date du bloc Date de publication

Si vous choisissez une date antérieure à la date actuelle, les métadonnées de la publication seront modifiées en tenant compte de votre sélection lorsque vous cliquerez sur le bouton Mettre à jour. À l’inverse, si vous choisissez une date postérieure, l’État de la publication passera alors à Planifié, et la publication sera automatiquement publiée à la date sélectionnée, la métadonnée de date sera mise à jour lors de la publication.

Dans la boîte de dialogue de sélection de date, le lien Aide de calendrier affiche des explications sur le fonctionnement du sélecteur de date, en particulier pour la sélection d’une date à l’aide du clavier, le lien Réinitialiser définit la date de publication à la date actuelle.

Réglages du bloc

Selon les blocs, divers réglages sont disponibles dans la colonne latérale des réglages. Parmi ceux-ci, on distingue les réglages communs (à une majorité de blocs) des réglages spécifiques, décrits ci-dessous.

Réglages du format

Capture d’écran de la liste déroulante pour le choix du format de date pour le bloc Date de publication

Le pré-réglage du bloc est fixé au Format par défaut défini pour tout le site dans l’écran Réglages généraux accessible via le menu Réglages, puis Général.

Si vous souhaitez appliquer un autre format pour ce bloc, désélectionnez l’option Format par défaut, puis dans la liste déroulante Choisir un format, sélectionnez un des formats proposés dans la liste ou définissez votre propre chaîne de formatage personnalisée.

Par exemple :

Capture d’écran de la saisie d’une chaîne de formatage personnalisée pour le bloc Date de publication

Ce qui affichera : « mardi 25 janvier 2022, à 9h30 ».

Réglages du lien

En activant l’option Lien vers l’article, la date est transformée en un lien vers l’article.

Avancé

L’onglet Avancé vous permet d’accéder aux réglages avancés des blocs.

Traduit par Jenny Dupuy
Relu par Didier Demory & Bruno Tritsch
Dernière mise à jour le 09 juin 2022

Contribuer à la documentation en français de WordPress

Modifier ce qu’affiche votre page d’accueil

Votre page d’accueil peut afficher une liste de vos derniers articles ou être une page statique de contenu personnalisé. Le réglage que vous utiliserez dépend des modèles qui sont inclus dans votre thème.
Pour consulter la liste des modèles, allez dans le menu Apparence, puis Éditeur, et enfin Modèles.

Pour apprendre comment sélectionner une page statique pour votre page d’accueil, lisez Créer une page d’accueil statique.

Personnaliser votre page d’accueil

Derniers articles

Pour personnaliser votre blog, allez dans le menu Apparence puis Éditeur. L’éditeur de site s’ouvre sur votre page d’accueil que vous pouvez modifier.

Les thèmes basés sur les blocs affichent une liste d’articles à l’aide du bloc Boucle de requête et du bloc Modèle de publication.

Lorsque vous ajoutez un bloc à l’intérieur du bloc Modèle de publication, il est répété pour chaque publication. Les blocs Titre de la publication, Image mise en avant de la publication, Auteur ou autrice de la publication, Date de publication, Catégories d’articles et Étiquettes d’articles sont des exemples de blocs que vous pouvez utiliser pour personnaliser votre modèle.

Page statique

Si vous avez choisi une page statique pour votre page d’accueil, et que vous souhaitez avoir une apparence différente des autres pages, vous devez attribuer à cette page un modèle différent.

Pour attribuer un modèle existant :

  1. Allez dans la liste des pages (menu Pages).
  2. Sélectionnez la page que vous avez choisie comme page d’accueil.
  3. Une fois dans l’éditeur, ouvrez la colonne latérale des réglages.
  4. Dans l’onglet Modèle, vous pouvez sélectionner un modèle existant ou en créer un :
    1. Sous la liste des modèles, cliquez sur Nouveau.
    2. Saisissez un nom pour votre modèle puis cliquez sur Créer.
    3. Vous serez redirigé vers l’Éditeur de site, modifiez votre modèle de page d’accueil puis cliquez sur Mettre à jour.
  5. Enregistrez la page.

À noter que si vous créez un modèle de « Page d’accueil » dans l’Éditeur de site, il sera toujours utilisé comme tel. Pour personnaliser la page d’accueil, vous devrez modifier ce modèle depuis l’Éditeur de site ou le supprimer, et modifier les réglages de la page d’accueil via l’écran Réglages puis Lecture.

Modifier l’icône de votre site (favicon)

L’icône d’un site ou favicon est une image de petite taille utilisée pour aider à reconnaître votre site, et qui est l’image la plus petite visible sur votre tableau de bord, onglet de navigateur, etc.

Les thèmes basés sur les blocs permettent d’utiliser le bloc Logo du site, et ce dernier offre la possibilité d’utiliser le logo du site comme icône du site :

  1. Allez dans le menu Apparence puis Éditeur, le modèle de la « Page d’accueil » s’ouvrira.
  2. Repérez le bloc Logo du site, qui est en général situé dans l’élément de modèle « En-tête » ou « Header ». S’il n’existe pas, ajoutez-le.
  3. Une fois le bloc inséré, vous pouvez téléverser une image ou en choisir une dans la médiathèque.
  4. Après avoir choisi un logo, vous trouverez dans les réglages du bloc l’option Utiliser comme icône de site.
  5. Activez l’option puis enregistrez vos modifications.

Traduit par Marie Comet
Relu par Jenny Dupuy & Didier Demory
Dernière mise à jour le 03 juin 2022

Contribuer à la documentation en français de WordPress