Comment créer des modèles de produits uniques

À ce stade, on peut supposer que vous savez déjà que
Easy Digital Downloads (EDD) a été développé pour fonctionner avec n’importe quel thème. Cependant, plusieurs choses peuvent être faites pour vous assurer que votre thème tire le meilleur parti d’EDD.

Dans cet article, nous allons couvrir les bases de la création de modèles de produits uniques pour votre thème. Pour être clair, un modèle de produit unique est utilisé pour afficher la page front-end créée lorsque vous ajoutez un nouveau Téléchargement à votre site.

Hiérarchie des modèles WordPress

Tout d’abord, nous devons prendre du recul et examiner le fonctionnement de WordPress lui-même. Les thèmes WordPress ne sont rien de plus qu’une collection de fichiers qui fonctionnent ensemble pour afficher votre site. Certains de ces fichiers de thème sont des modèles et des composants de modèles qui s’assemblent pour créer la structure HTML de votre site.

WordPress utilise une
hiérarchie de modèles pour déterminer quand et comment utiliser ces fichiers de modèles. Nous n’entrerons pas dans les détails complets de toute la hiérarchie, mais voici une représentation visuelle de la façon dont les différents fichiers de modèles sont liés.

Ce que nous allons couvrir ici, c’est le modèle d’article unique et comment il affecte la façon dont vos pages de produits uniques s’affichent. Commençons.

Modèle d’article unique (et singulier)

Directement de
wordpress.org, voici la hiérarchie des modèles pour les articles uniques :

1. single-{post-type}-{slug}.php – (Depuis 4.4) D’abord, WordPress recherche un modèle pour l’article spécifique. Par exemple, si le type d’article est product et que le slug de l’article est dmc-12, WordPress rechercherait single-product-dmc-12.php.
2. single-{post-type}.php – Si le type d’article est product, WordPress rechercherait single-product.php.
3. single.php – WordPress se rabat ensuite sur single.php.
4. singular.php – Ensuite, il se rabat sur singular.php.
5. index.php – Enfin, comme mentionné ci-dessus, WordPress se rabat finalement sur index.php.

Ce que cela signifie, c’est que le nom d’un fichier de thème indique à WordPress quand il doit être utilisé et son « rang » dans la hiérarchie pour ce cas d’utilisation particulier.

Le nom de fichier le plus courant à ce stade est très probablement
single.php. Le modèle single.php est utilisé pour afficher les articles de blog uniques. Comme vous pouvez l’imaginer, de nombreux utilisateurs publient plus d’articles de blog sur leurs sites WordPress que quoi que ce soit d’autre. Ainsi, bien que single.php ne soit pas le rang le plus élevé dans l’ensemble, il
est le rang le plus élevé pour les modèles d’articles uniques génériques.

Il y a de fortes chances que votre thème actif (ou thème parent, si vous utilisez un
thème enfant) possède un fichier single.php dans son dossier racine. Si c'est le cas, il est utilisé pour afficher les articles de blog individuels. Cependant, il est aussi possible que vous n'ayez pas de fichier single.php mais plutôt un fichier singular.php. C'est de plus en plus courant. Son objectif de base est d'être un modèle plus « universel » pour toutes les pages du front-end qui entrent dans la définition WordPress de « singulier », comme les articles de blog, les pages et les entrées des types de publication personnalisés de base.

Nous allons couvrir comment EDD utilise ces modèles et comment vous pouvez changer cela.

single.php

Comme mentionné ci-dessus, le fichier
single.php est un modèle de base utilisé pour afficher les articles de blog individuels. Lorsque l'URL d'un article de blog est visitée, WordPress recherchera dans la structure du thème le fichier modèle approprié à utiliser pour afficher cet article de blog. Le fichier single.php est la réponse courante.

Avec cette compréhension, vous devez également savoir que les Articles (et les Pages) sont ce que WordPress appelle des « types d'articles ». Il existe quelques types d'articles par défaut intégrés à WordPress, mais les développeurs peuvent également en créer leurs propres, appelés types d'articles personnalisés.

EDD lui-même introduit plusieurs types d'articles personnalisés dans votre système, dont l'un est le
Téléchargement. C'est le seul que nous allons discuter ici.

Si vous remontez pour jeter un autre regard sur la hiérarchie des modèles pour les articles individuels, vous remarquerez que
single-{post-type}.php a un rang supérieur à single.php. Cela implique deux choses :

1. Si single-{post-type}.php correspond au scénario, il sera utilisé avant single.php.
2. Si aucun modèle single-{post-type}.php n'existe, le choix suivant est single.php.

À moins que votre thème n'ait été écrit spécifiquement pour EDD, votre situation tombe par défaut dans le deuxième scénario. Étant donné que le type d'article personnalisé Téléchargement d'EDD est enregistré sous le nom de « download », à moins que votre thème n'inclue un fichier
single-download.php (ou la 1ère position dans la hiérarchie des articles individuels, que nous n'aborderons pas), WordPress recherchera le fichier single.php.

Ce que cela signifie, c'est que quelle que soit la manière dont vos articles de blog s'affichent, votre téléchargement EDD aura le même aspect. Si vos articles de blog incluent des informations de signature, de navigation d'un article à l'autre, ou quoi que ce soit d'autre, cela s'affichera également pour vos téléchargements.

Pour de nombreux utilisateurs, ce n'est pas un problème. Pour d'autres, cela peut ajouter des informations indésirables à l'affichage du produit. Ou peut-être que certains utilisateurs ne veulent tout simplement pas que leurs pages de produits s'affichent de la même manière que les articles de blog, ce qui est compréhensible.

single-download.php

Afin de dire à WordPress que vous souhaitez afficher vos pages de produits individuelles différemment de vos articles de blog individuels, vous devez exploiter la hiérarchie des modèles d'articles individuels en créant un fichier
single-download.php dans le dossier racine de votre thème actif (ce qui signifierait votre thème enfant si vous en utilisez un).

Une fois ce fichier en place dans le dossier racine de votre thème actif, l'affichage de la page front-end d'un de vos produits appellera le modèle spécifique au téléchargement au lieu du modèle d'article de blog. À ce stade, vous contrôlez votre modèle single-download.php et vous pouvez le construire comme vous le souhaitez.

Voici une astuce très utile pour créer votre modèle single-download.php :

À moins que vous ne soyez un développeur de thèmes qui sait déjà ce qu'il fait, la meilleure façon de créer votre fichier initial single-download.php est de dupliquer le fichier single.php de votre thème, puis de renommer le duplicata en single-download.php. À ce stade, rien ne changera dans l'affichage de vos pages produits. Cependant, vous êtes maintenant libre de modifier le nouveau fichier modèle et cela n'affectera que vos pages produits.

Si vous utilisez un thème enfant, cela signifie que vous devrez copier le modèle d'article principal du thème parent pour le placer dans le dossier racine de votre thème enfant.

singular.php

Les choses se compliquent un peu ici. Le fichier singular.php est assez nouveau et bien qu'il ne soit pas aussi largement utilisé que le fichier single.php, il reste populaire. Comme mentionné précédemment, WordPress est livré avec plusieurs types d'articles déjà intégrés et prend en charge la création de types d'articles personnalisés. *Tous* ces types d'articles sont considérés comme singuliers.

Ce que cela signifie, c'est qu'un thème n'a pas besoin d'inclure un fichier single.php, ni même un fichier page.php (le modèle utilisé pour afficher les pages WordPress). Si un fichier singular.php est présent et qu'aucun des modèles plus spécifiques n'est disponible, WordPress l'utilisera pour tous les types d'articles.

Inutile de dire que ce fichier modèle doit souvent utiliser une logique conditionnelle. Cela signifie :

Si l'URL visitée est une page, utilisez ce code pour afficher la page. Si l'URL visitée est un article, utilisez ce code pour afficher l'article.

Tout cela se passe à l'intérieur d'un seul fichier modèle. Pour les sites avec seulement des articles et des pages, c'est simple. Lorsque vous introduisez des types d'articles personnalisés, cela peut devenir délicat car le développeur du thème n'a probablement pas créé de condition pour le type d'article Téléchargement, c'est-à-dire si le thème n'a pas été écrit pour prendre en compte EDD.

Bien que ce ne soit pas l'endroit pour entrer dans les détails de la création d'un thème, la même chose est vraie dans ce scénario qu'avec la substitution du single.php pour les modèles de produits. Vous pouvez utiliser le fichier singular.php pour créer (par duplication) un fichier single-download.php. La seule différence ici est que vous devrez mieux comprendre le code de ce fichier pour le modifier afin de l'utiliser avec les produits.

Modèles de produits uniques en résumé

Ceci n'est pas destiné à être un guide sur le thème WordPress. Au lieu de cela, l'objectif est de vous montrer comment EDD fonctionne avec WordPress afin que vous puissiez utiliser des modèles de produits uniques pour afficher vos pages produits.

Si vous n'êtes pas un développeur de thèmes WordPress, il s'agit d'une tâche que vous voudrez peut-être externaliser à une personne expérimentée dans ce domaine. La création du fichier nécessaire n'est qu'une étape. La création (ou la modification) du code dans le fichier est une tâche complètement distincte qui nécessite un peu d'expérience ou au moins une familiarité avec HTML et PHP.