Hiérarchie des modèles

Aller voir :

marqueurs conditionnels

**chaîne de requête**

**mod_rewrite**

Ressoures Thématiques

Hiérarchie des modèles doc officielle

• Liste des pages-modèles et leur fonctions :
  • index.php (thème classique) ou index.html (thème bloc) —> Le fichier principal du modèle. Il est nécessaire dans tous les thèmes.
  • style.css —> La feuille de style principale. Elle est requise dans tous les thèmes et contient l’en-tête d’information de votre thème**.**
  • front-page.php(thème classique)ou front-page.html (thème bloc) —> Le modèle de page d’accueil est toujours utilisé comme page d’accueil du site s’il existe, quels que soient les paramètres définis dans Admin > Réglages > Lecture.
  • home.php (thème classique) ou home.html (thème bloc) —> Le modèle de page d’accueil est la page de garde par défaut. Si vous ne configurez pas WordPress pour qu’il utilise une page d’accueil statique, ce modèle est utilisé pour afficher les derniers articles.
  • singular.php (thème classique) ou singular.html (thème bloc) —> Le modèle singulier est utilisé pour les articles lorsque single.php n’est pas trouvé, ou pour les pages lorsque page.php n’est pas trouvé. Si singular.php n’est pas trouvé, index.php est utilisé.
  • single.php (thème classique) ou single.html (thème bloc) —> Le modèle d’article unique est utilisé lorsqu’un visiteur demande un article unique.
  • single-{post-type}.php (thème classique) ou single-{post-type}.html (thème bloc) —> Modèle d’article unique utilisé lorsqu’un visiteur demande un article unique à partir d’un type d’article personnalisé. Par exemple, single-book.php sera utilisé pour afficher des messages uniques à partir d’un type de message personnalisé nommé book.
  • archive-{post-type}.php (thème classique) ou archive-{post-type}.html (thème bloc) —> Ce modèle est utilisé lorsque les visiteurs demandent une archive des articles de type personnalisé. Par exemple, archive-books.php serait utilisé pour afficher une archive des articles de type personnalisé nommé books. Le fichier de modèle d’archive archive.php ****est utilisé si le modèle archive-{post-type} n’est pas présent.
  • page.php (thème classique) ou page.html (thème bloc) —> Le modèle de page est utilisé lorsque les visiteurs demandent des pages individuelles, qui sont un modèle intégré.
  • page-{slug}.php (thème classique) ou page-{slug}.html (thème bloc) —> Le modèle de page balisée (-slug) est utilisé lorsque les visiteurs demandent une page spécifique, par exemple une page avec la balise « about » (page-about.php).
  • category.php (thème classique) ou category.html (thème bloc) —> Le modèle de catégorie est utilisé lorsque les visiteurs demandent des articles par catégorie.
  • tag.php (thème classique) ou tag.html (thème bloc) —> Le modèle étiquette est utilisé lorsque les visiteurs demandent des articles par étiquettes.
  • taxonomy.php (thème classique) ou taxonomy.html (thème bloc) —> Le modèle de terme de taxonomie est utilisé lorsqu’un visiteur demande un terme dans une taxonomie personnalisée.
  • author.php (thème classique) ou author.html (thème bloc) —> Le modèle de page d’auteur est utilisé chaque fois qu’un visiteur charge une page reliée à un auteur. (publication par auteur)
  • date.php (thème classique) ou date.html (thème bloc) —> Le modèle date/heure est utilisé lorsque les messages sont demandés par date ou heure. Par exemple, les pages générées avec ces slugs :
    • http://example.com/blog/2014/
    • http://example.com/blog/2014/05/
    • http://example.com/blog/2014/05/26/
  • archive.php (thème classique) ou archive.html (thème bloc) —> Le modèle d’archive est utilisé lorsque les visiteurs demandent des articles par catégorie, auteur ou date. Remarque : ce modèle sera remplacé par des modèles plus spécifiques tels que category.php, author.php et date.php.
  • search.php (thème classique) ou search.html (thème bloc) —> Le modèle de résultats de recherche est utilisé pour afficher les résultats de la recherche d’un visiteur.
  • attachment.php (thème classique) ou attachment.html (thème bloc) —> Le modèle de pièce jointe est utilisé lors de l’affichage d’une pièce jointe unique, telle qu’une image, un fichier PDF ou un autre fichier multimédia.
  • image.php (thème classique) ou image.html (thème bloc) —> Le modèle d’image jointe est une version plus spécifique de attachment.php et est utilisé lors de l’affichage d’une seule image jointe. S’il n’est pas présent, WordPress utilisera attachment.php à la place.
  • 404.php (thème classique) ou 404.html (thème bloc) —> Le modèle 404 est utilisé lorsque WordPress ne trouve pas d’article, de page ou d’autre contenu correspondant à la demande du visiteur.
  • comments.php —> Le modèle de commentaires dans les thèmes classiques. Dans les thèmes à blocs, les blocs sont utilisés à la place.

<aside> 💡

• Les pages standard sont des pages ;
• La liste des articles d’un blog sont des archives ;
• Lorsque l’on clique sur une catégorie, c’est aussi une archive ;
• L’affichage d’un article est un single. </aside>

Dans tous les cas, on commence par la gauche avec le type de page qui va être affiché. Pour chaque cas existe un fichier template correspondant :

• Une archive : triée par catégorie, mot clé, auteur, date… pointe sur archive.php ;
• Une page singulière : qui va afficher soit le contenu d’une page avec page.php, soit d’un article avec single.php ;
• La page d’accueil du site est front-page.php dans le cas où le site est configuré pour afficher une page ;
• La page d’accueil du blog : qui est un type d’archive particulier et répond sur home.php ;
• La page 404 : en cas de page non trouvée (mauvaise URL) affiche 404.php ;
• La page des résultats d’une recherche affiche search.php lorsque l’on utilise le moteur de recherche du site ;

Entre temps, WordPress va regarder s’il trouve un fichier de template plus spécifique qui aurait été créé par le développeur du thème. Et s’il ne le trouve pas, il se rabat sur le modèle plus généraliste.

C’est d’ailleurs ce que l’on observe tout à droite : en l’absence d’autres fichiers présents dans le thème, WordPress se rabat toujours sur index.php. C’est pour ça que ce fichier est obligatoire, même si on ne l’utilise quasiment jamais.

Le cas des pages

Le cas spécifique de la page d’accueil

Le cas des archives

La version simplifiée :