Comment créer des modèles de page personnalisés WordPress (et pourquoi) • WPShout

By | juin 2, 2021

trouver un expert WordPress

Il existe de nombreuses façons de modifier l'apparence d'une page spécifique sur votre site WordPress. Vous pouvez modifier le contenu dans l'éditeur de contenu WordPress. Vous pouvez modifier les règles CSS qui affectent le site. Ou créez un nouveau fichier dans la hiérarchie des modèles de votre thème WordPress pour correspondre à la page spécifique. Ou vous pouvez utiliser un modèle de page de thème conçu spécifiquement pour cette page. Le dernier est ce dont nous parlons ici. Dans ce didacticiel, nous expliquerons à la fois comment créer un modèle de page personnalisé WordPress et pourquoi vous voudrez peut-être le faire. Nous allons commencer par le pourquoi.

Lorsque vous dites « Modèle de page personnalisé pour le thème WordPress », que voulez-vous dire ?

Capture d'écran de la liste déroulante du modèle d'attributs de page WordPress dans WordPress 5.6

Il y a un énorme problème de terminologie avec ce sujet. Comme je l’ai laissé entendre ci-dessus, il y a beaucoup de choses avec la notion vague de « page » et de « modèle » dans le monde WordPress qui ne sont pas ce dont nous parlons ici. La première chose que je ne veux pas dire en disant « modèle de page personnalisé WordPress » est « un thème WordPress ». (Beaucoup de nouveaux utilisateurs de WordPress disent « modèles » lorsqu'ils signifient « un thème WordPress ».)

Alors, qu'est-ce que j'entends par « modèle de page personnalisé » ? Je veux dire ce qui est montré à droite. Par exemple, vous modifiez le type de contenu de la page dans WordPress (bien que, comme nous le verrons plus tard, il puisse désormais inclure d'autres types de contenu WordPress). Et lors de l'édition de votre page, vous remarquez la case "Attributs de page", et à l'intérieur de celle-ci, vous force (selon si votre thème a déjà ces modèles) voir cette liste déroulante "Modèle". Cette boîte de sélection est illustrée sur la droite (elle se trouve également sur le côté droit de votre écran « édition de page »). Si vous voyez cette liste déroulante, c'est parce que votre thème fournit certains de ces "modèles de page personnalisés". Ce sont en fait des fichiers dans le dossier de votre thème actuellement actif (ou son parent) et ont une seule caractéristique distinctive sur laquelle nous reviendrons plus tard. Mais cette liste déroulante sélectionnable de modèles de page nommés c'est ce dont nous parlons ici aujourd'hui.

Comment cela s'intègre-t-il dans la hiérarchie des modèles ?

J'ai déjà écrit, et je le ferai probablement encore, sur la façon dont le modèle – il y a encore ce mot – la hiérarchie est vraiment les concept clé que vous devez comprendre pour créer ou modifier un thème WordPress. (Voici notre rapide introduction.) Presque tout le reste est un détail que vous pouvez régler une fois que vous avez compris la dynamique de base de la hiérarchie des modèles. La chose spécifique que nous voulons dire aujourd'hui, cependant, se situe en dehors de la hiérarchie des modèles. Ce « modèle sélectionné » remplace essentiellement l'ensemble du processus de sélection de la hiérarchie des modèles.

Si un modèle de page personnalisé a été sélectionné dans la liste déroulante que nous avons montrée ci-dessus, ce fichier « modèle » sera utilisé. Point final, pas d'exception.

Pour réaffirmer cela, si un modèle de page personnalisé est sélectionné, ce fichier « modèle » sera utilisé. Point final, pas d'exception. Sinon, la hiérarchie des modèles WordPress cherchera une manière quelque peu différente que quelqu'un aurait pu essayer de styliser une page spécifique – avec un page-123.php ou alors page-custom-template-utilizer.php déposer. (La différence entre le modèle personnalisé et un avec ce page-$id ou alors page-$slug la structure n'est vraiment que dans l'interaction et l'interface.) Si aucun de ceux-ci n'est trouvé, WordPress reviendra à page.php, s'il existe, et sinon on se retrouverait à l'ultime repli, index.php.

Si vous vous demandez pourquoi vous utiliseriez cette méthode par opposition à la méthode numérique ou slug – dans les deux cas, vous créez un fichier personnalisé dans votre thème, après tout – la raison en est que l'utilisation de modèles personnalisés vous donne plus de flexibilité et indépendance entre votre thème et la base de données et le contenu de votre site. Pour cette raison, je le recommanderais dans à peu près toutes les situations lorsque vous ne savez pas avec quoi aller. Avec le numérique ou à base de slug page-*.php structure, vous êtes obligé de faire connaître à votre thème la manière spécifique dont sont actuellement vos données de base de données WordPress. (Donc, si vous réutilisez le thème sur un autre site WordPress, par exemple, ce fichier est inutile.)

Comment créer un modèle de page personnalisé WordPress ?

OK, nous savons donc que les modèles de page personnalisés remplaceront la hiérarchie des modèles WordPress. Et que nous les utiliserons sur les pages réelles de notre site WordPress en les sélectionnant dans un menu déroulant « Modèle » dans la barre de droite du contenu concerné. Il est donc temps de passer au processus de création d'un modèle de page personnalisé WordPress.

Ce que vous allez faire, c'est ajouter à votre thème (et ce devrait vraiment être un thème enfant à moins qu'il n'y ait une contrainte très forte rendant cela impossible pour vous) un fichier avec un nom comme mon-modèle.php ou alors vraiment-cool-génial.php. Cela n'a pas vraiment d'importance, tant que vous n'utilisez pas réellement un nom faisant partie de la hiérarchie des modèles, vous êtes en or. (Ce qui signifie: ne pas utiliser un nom comme page-quoi que ce soit.php. Comme nous l'avons évoqué ci-dessus, la hiérarchie des modèles de WordPress pense qu'elle possède un fichier nommé avec ce modèle.)

Une fois que vous avez le fichier (modèle-de-page-cool.php, de ce que vous préférez), vous devriez le commencer comme ceci :





Ceci est mon modèle personnalisé.

Et vous avez essentiellement terminé. Comme vous pouvez probablement le deviner, le nom qui apparaîtra dans la liste déroulante "Modèle" est ce que j'ai habilement appelé "Nom à apparaître dans la liste déroulante". Tout comme votre thème style.css ou le fichier principal d'un plugin, WordPress utilise les informations contenues dans ce commentaire de code pour lui fournir un contexte de travail.

Ensuite, le contenu de nos pages sera, dans ce cas, le texte HTML très basique « Ceci est mon modèle personnalisé ». Comme vous pouvez le deviner, c'est ici que vous êtes beaucoup plus susceptible de mettre le contenu HTML que vous souhaitez voir apparaître sur la page. Alors votre

Mots clés,

balises, et peut-être (si vous avez envie 🤪) du PHP pour faire un comportement personnalisé que vous voulez montrer.

Pourquoi votre modèle de page personnalisé WordPress ne s'affiche pas

J'ai (plus d'une fois) eu l'expérience que mon nouveau modèle de page WordPress ne s'affiche pas. La cause la plus courante est de loin que j'ai tapé (ou mal mémorisé) à quoi devrait ressembler le commentaire d'en-tête de fichier. Il doit être étiqueté avec le bon titre précis. Donc Nom du modèle : Page étroite est parfait, mais WordPress va jamais localiser quelque chose qui a plutôt un en-tête de Modèle : Personnalisé.

Il y a quelques autres choses à vérifier. Autres raisons pour lesquelles vous pourriez trouver que votre modèle de page personnalisé ne s'affiche pas :

  • Vous avez placé le fichier au mauvais endroit (il doit être dans votre thème en cours d'exécution ou dans son parent)
  • Vous avez donné à votre modèle un fichier qui commence par page-. En raison d'une fonctionnalité des thèmes WordPress, les modèles de page personnalisés qui commencent par page- sont plutôt traités comme des pages de la hiérarchie des modèles.
  • Il manque l'un de ses deux fichiers requis à votre thème et ne fonctionne donc pas. (Les thèmes WordPress *doivent* avoir un index.php fichier et un style.css.)
  • Il y avait un problème avec cela à l'époque de WordPress 4.9 (il y a quelques années maintenant)

Modèles de page pour les types de publication personnalisés WordPress non «Page»

Pendant une grande partie de l'histoire de WordPress, ces « modèles de page personnalisés » étaient uniquement pour le type de contenu « Page ». (WordPress n'a que deux types de contenu, « Publications » et « Pages » par défaut.) Mais dans WordPress 4.7, la fonctionnalité a été ajoutée que vous pouvez utiliser ces modèles de page avec de nouveaux types de contenu (souvent appelés « types de publication personnalisés »).

Pour ce faire, vous ajoutez une autre ligne à votre "en-tête de fichier". Donc ça ressemblerait un peu à ça :

<?php
/ *
Nom du modèle : Modèle plus étroit
Type de publication du modèle : publication, page, événement
*/
// La page HTML et PHP va ici...

Comme vous pouvez probablement le deviner, ce nouveau Type de publication de modèle : l'en-tête précède le nom « au niveau du code » des types de publication (personnalisés). Vous remarquerez que dans l'exemple ci-dessus, nous listons les page type de contenu avec lequel WordPress est livré, ainsi que le Publier une. De plus, nous prenons en charge un troisième « type de publication personnalisé » appelé un événement.

Une excellente raison d'utiliser des modèles de page personnalisés

Maintenant, si vous l'avez déjà fait, vous remarquerez que la page ci-dessus n'aura aucun style et ressemblera très très peu au reste de votre site WordPress (à moins que vous n'ayez le thème le plus simple imaginable). C'est parce que notre fichier contient une chose simple et manque de fonctionnalités très courantes dans toutes les autres pages de thème. Il n'a pas get_header(), get_footer(), ou The Loop, appelle probablement tous vos autres fichiers de thème.

Parfois, vous voulez une page qui ne ressemble pas beaucoup au reste de votre site, mais qui fait toujours partie de votre expérience de gestion WordPress. Ces modèles personnalisés sont parfaits pour cela.

Mais cela illustre également l'un des grands pouvoirs des modèles personnalisés comme ceux-ci : parfois, vous voulez une page qui ne ressemble pas beaucoup au reste de votre site, mais qui fait toujours partie de votre expérience de gestion WordPress. Ces modèles personnalisés sont parfaits pour cela. Bien que vous les voyiez également utilisés pour les pages d'archives ou (moins souvent) les pages de contact, cette capacité est souvent négligée.

Et enfin, quelques conseils pratiques sur les modèles de page

Lorsque vous cherchez à créer une page qui ressemble à vos autres pages (mais un peu différente), je commencerais en fait par copier un fichier existant de votre thème, probablement page.php. C'est simplement parce que la plupart d'entre nous trouvent qu'il est plus facile de changer quelque chose que de construire à partir de zéro. L'exemple de code donne à votre modèle de page ce sens de «page blanche vierge», où vous cherchez probablement à ajouter ou à supprimer des détails spécifiques de votre page.php modèle. La suppression de la barre latérale ou du pied de page, par exemple, est très raisons courantes pour lesquelles les gens créent un « modèle de page personnalisé » dans WordPress.

Comme nous l'avons vu, si vous dupliquez votre thème page.php fichier pour commencer à créer votre modèle de page personnalisé, vous devrez vous assurer d'ajouter "l'en-tête de modèle de page personnalisé" que nous avons ci-dessus. Encore une fois, ce sont la page « magique » qui fait que ces modèles fonctionnent. Maintenant, allez faire des pages géniales !

Crédit image : Infrogmation

[ad_2]