WordPress Comment faire: Développer un fichier Comments.php

Article écrit par:
  • WordPress
  • Mise à jour: août 12, 2013

Leçons essentielles dans le développement d'un fichier Comments.php avec WordPress

WordPress Page d'accueil

Un site Web WordPress réussi est un site qui favorise l’interaction entre ses lecteurs et les producteurs de contenu en utilisant un “comments.php" fichier. Cette interaction est non seulement la clé du succès propre et persistant d'un site Web, mais des interactions utilisateur communes permettent de communiquer l'activité et les pouvoirs du site Web aux moteurs de recherche qui classent spécifiquement les sites Web en fonction de l'appréciation du contenu trouvé.

Pour cette raison, maîtriser le modèle «comments.php» dans tout thème WordPress est absolument essentiel pour créer et promouvoir un blog, un magazine ou un site Web amateur. De nombreux utilisateurs novices de WordPress sont intimidés par cette situation et par d’autres fichiers de modèle PHP, en particulier parce que l’utilisateur moyen de WordPress télécharge généralement des thèmes et évite d’apporter des modifications importantes à leur apparence ou à leurs fonctionnalités.

Cependant, ces modifications sont extrêmement faciles à effectuer une fois qu'un utilisateur a appris les bases des variables XHTML, CSS, PHP et WordPress, ainsi que les méthodes usuelles pour générer le contenu du site, les données utilisateur et encourager la communication entre tous les utilisateurs du site. Tout commence avec un client FTP, un éditeur de texte et le désir d'apprendre de nouvelles façons d'exprimer des idées anciennes dans un code pur et conforme aux normes.

Étape 1: Recherche du fichier de modèle Comments.php sur le serveur du site Web

Trouver le comments.php

Pour les débutants en matière de personnalisation de modèles WordPress, il peut être un peu difficile de localiser avec exactitude les fichiers qui doivent être modifiés. Le plus souvent, WordPress est installé dans le répertoire racine d'un serveur, ce qui permet d'y accéder en tant que page d'index du site. Dans ce cas, les fichiers d'un thème (y compris le modèle «comments.php») peuvent être trouvés en naviguant dans le chemin suivant à l'aide d'un client FTP ou d'un gestionnaire de fichiers Web dans le panneau de configuration du site:

/ public_html / wp-content / themes / votre-dossier-theme-selectionné /

Dans ce dossier, une liste complète de fichiers PHP apparaîtra, avec des noms tels que “single.php” et “style.css”, entre autres. Le fichier à modifier est évidemment nommé «comments.php». Ce fichier peut être ouvert à l'aide de l'éditeur de texte intégré du client FTP ou à l'aide d'un programme d'édition de texte séparé, tel que Notepad dans Windows ou TextEditor. utilisateurs de Mac OS X.

Ce fichier n'est probablement pas vide et un modèle complet est probablement déjà construit dans le fichier. Dans les étapes suivantes, vous trouverez un guide sur chacune des variables placées dans le fichier et sur la façon de les utiliser pour réviser la conception actuelle ou pour créer un tout nouveau modèle répondant mieux aux besoins des producteurs et des commentateurs du contenu du site Web.

Étape 2: apprendre à empêcher l'accès au fichier Comments.php

Comments.php sur WordPress

La plupart des modèles stockés dans un thème sont directement accessibles par les utilisateurs et peuvent afficher de manière dynamique le contenu du site, tel que les pages, les publications, les catégories, les archives et les commentaires. Cependant, certains modèles ne sont pas directement accessibles aux utilisateurs et, si les utilisateurs pouvaient y accéder, il serait possible d'exécuter des attaques malveillantes sur les utilisateurs, le contenu et même la base de données d'un site. Le fichier «comments.php» est un modèle auquel les utilisateurs d'un site, directement ou indirectement, doivent accéder directement. WordPress utilise une simple déclaration PHP pour garantir que le fichier est accessible uniquement lorsqu'il est inclus dans un autre document.

Il ressemble à ceci:

<? php if (! empty ($ _ SERVER ['SCRIPT_FILENAME'])) && 'comments.php' == nom de base ($ _ SERVER ['SCRIPT_FILENAME'])):? >

<? php die ('Whoa! Cette page ne peut pas être vue indépendamment. Si vous souhaitez publier un commentaire, naviguez jusqu'à l'entrée pour laquelle vous souhaitez faire des commentaires et utilisez le formulaire inclus dans cette page. Désolé pour le désagrément!') ; ? >

<? php endif; ? >

<? php if (! empty ($ post-> post_password)):? > <? php if ($ _ COOKIE ['wp-postpass_'. COOKIEHASH]! = $ post-> post_password):? >

<? php endif; ? >

<? php endif; ? >

Le code ci-dessus identifie si le modèle est actuellement affiché ou non en tant que fichier PHP «inclus». Sinon, il affiche un message d'erreur utile aux visiteurs du site. Cela garantit qu'aucune activité malveillante ne se produit dans les coulisses. Cela va également vraiment ennuyer les pirates informatiques qui espéraient trouver un moyen simple de compromettre l'intégrité du site. La deuxième ligne garantit qu’une entrée peut réellement être affichée; s'il est protégé par un mot de passe, l'entrée ne sera pas affichée, pas plus que le modèle «comments.php». Sans cette ligne de code en haut du fichier, les visiteurs pouvaient facilement commenter une entrée dont ils ne pouvaient pas lire le contenu.

Il convient de noter que, si cette série de balises n'est pas présente dans le fichier «comments.php» actuel du thème, elle doit être ajoutée immédiatement et le fichier doit être enregistré sur le serveur avant de continuer. Il n'est jamais trop tôt pour réparer une faille de sécurité potentielle.

Étape 3: Reconnaître la boucle de commentaire et ajouter des variables pour personnaliser son apparence

En fonction de l'expérience des variables WordPress et de leur insertion dans les modèles, les utilisateurs peuvent ou non être familiarisés avec l'utilisation de «boucles» dans ces fichiers lors de l'insertion de variables et de l'extraction d'informations utilisateur ou post-utilisateur de la base de données. Les entrées et les commentaires ont leurs propres formats WordPress Loop. Il s'agit de la prochaine série d'instructions PHP qui apparaîtra dans le fichier «comments.php». Dans cette boucle, le modèle de commentaire réel est construit. Cela détermine l’apparence de chaque commentaire pour l’utilisateur final après sa publication. Il s’agit d’un mélange de XHTML, de CSS et de PHP.

Les éléments CSS et XHTML de ce modèle devraient déjà être connus de l'utilisateur entreprenant de WordPress qui apprend à personnaliser les modèles, car ils constituent un aspect essentiel de l'apparence du site et de son contenu, tel qu'il est écrit dans le tableau de bord WordPress. En partant du principe que XHTML et CSS sont des quantités connues, voici ce que l'utilisateur devra savoir sur les variables WordPress et PHP lors de la modification ou de la construction d'un modèle de commentaires.

Chaque variable de la boucle de commentaire est construite comme une instruction PHP distincte, semblable à celle qui apparaît ci-dessous:

<? php get_variable? >

Dans le modèle «comments.php» lui-même, chaque variable utilisable commence par le préfixe «comment_», qui est placé entre les balises PHP d'ouverture et de fermeture, comme indiqué ci-dessus. Plusieurs modèles peuvent être utilisés dans ce modèle pour extraire des informations de la base de données.

<? php comment_author (); ? > Extrait le nom de l'auteur de la base de données et l'imprime exactement comme il l'a tapé, où que la variable soit placée. En règle générale, cela devrait être utilisé dans le cadre d'une construction de lien pour envoyer les utilisateurs au site Web de l'auteur ou à leur adresse électronique.

<? php comment_date (); ? > Imprime la date à laquelle un commentaire a été publié; Par défaut, cette variable utilise le format de date défini dans les paramètres WordPress du panneau d'administration de Dashboard. Pour personnaliser l'apparence de la date dans les commentaires, les utilisateurs peuvent insérer des variables de code de date PHP (telles que F jS Y) entre parenthèses.

<? php comment_ID (); ? > L'identification numérique du commentaire lui-même, généralement dans l'ordre chronologique. Cela peut être utilisé pour créer un lien permanent entre commentaires et liens afin de créer un lien direct avec un seul commentaire.

<? php comment_author_link (); ? > Cette variable est une sorte de construction «tout en un» pour l'auteur du commentaire, car elle imprime son nom et des liens automatiques vers les sites Web ou les adresses électroniques saisis lors du processus de soumission des commentaires.

<? php comment_text (); ? > Imprime le commentaire lui-même, entouré de balises <p> utiles pouvant être personnalisées à l'aide d'un code de style CSS dans la feuille de style «style.css» du thème.

<? php comment_time (); ? > Comme la variable date, cette option affiche l'heure et la minute exactes de la publication d'un commentaire et utilise le format défini par défaut dans WordPress Dashboard. Il peut aussi être personnalisé en plaçant des variables de date PHP entre parenthèses.

<? php comment_type (); ? > Cette variable différencie les commentaires traditionnels, les posts de rétrolien et les pingback de sites Web. Ceci est utile pour trier les interactions et les afficher séparément dans le modèle de commentaire.

Étape 4: maîtriser l'art du formulaire de commentaires

Le segment suivant du modèle «comments.php» est le formulaire de soumission de commentaires qui permet l’interaction sur laquelle reposent la plupart des sites Web. Ce formulaire peut être produit à l'aide d'éléments de «formulaire» XHTML standard et est probablement déjà construit dans le modèle existant. Les éléments de formulaire doivent avoir certains noms (nom, email, URL, commentaire), mais au-delà, il appartient à l'utilisateur de leur donner des identifiants, des classes et des styles.

L'élément qui doit absolument être inclus lorsqu'un formulaire de commentaire est conçu et placé dans le modèle est une variable conditionnelle qui affiche uniquement le formulaire lorsque le commentaire est «ouvert». N'oubliez pas que WordPress permet de «fermer» les commentaires dans le tableau de bord. entrée, à tout moment. L'ensemble du site de commentaires sur la capacité peut également être désactivé. Et, bien sûr, les commentaires «expirent» et se ferment automatiquement après 30-90 jours à compter de la date de publication du message. Cette variable conditionnelle est placée avant la balise «form» d'ouverture XHTML et ressemble exactement à ceci:

<? php if (comments_open ()):? >

Une fois que le formulaire de commentaire a été complètement inséré, avec les quatre éléments «formulaire», un bouton de soumission et un bouton de réinitialisation, la déclaration PHP conditionnelle doit être fermée. Si ce n'est pas le cas, toute la page sera coupée immédiatement après tout commentaire si la possibilité de commenter un message est révoquée. Les instructions de clôture de cette instruction PHP conditionnelle ressemblent à l'exemple ci-dessous:

<? php sinon:? >
<? php endif; ? >

Avec cela, le formulaire de commentaire est en grande partie complet. N'oubliez pas que chaque élément de formulaire doit être nommé conformément à la liste ci-dessus, sinon les informations ne seront pas correctement soumises à la base de données WordPress. Cela entraînera une longue liste de commentaires vides, car les données seront complètement perdues et ne seront stockées nulle part. Cela mènera également à des lecteurs en colère qui sentent que leur voix n'a pas été entendue et aucun administrateur de site ne veut avoir ce genre de problème sur leur conscience.

Étape 5: Apporter de la personnalité au processus

Il y a plusieurs années, WordPress a acquis une petite société appelée Gravatar; cette société était connue pour afficher des images d'utilisateurs universels liées à une adresse électronique spécifique. Ces images peuvent être affichées dans les commentaires d’entrée de plusieurs sites Web, à l’aide de plusieurs plates-formes de gestion de contenu, à condition que la structure URL standard des images soit incluse dans le modèle.

Depuis l'acquisition de la société il y a quelque temps, WordPress a intégré cette fonctionnalité directement à la fois dans le tableau de bord WordPress et dans le fichier de modèle «comments.php». C'est un excellent moyen de personnaliser l'expérience d'interaction utilisateur en permettant à chaque utilisateur de définir une image personnalisée qui l'identifie auprès de ses collègues commentateurs et des administrateurs de site Web.

Gravatar

Avant tout, cette fonctionnalité doit être activée dans le tableau de bord WordPress. Naviguez jusqu'au titre de la barre latérale «Paramètres» et cliquez sur le lien du panneau d'administration «Lecture». Ici, vous pouvez définir des éléments tels que le «classement» maximum à afficher dans les images Gravatar, ainsi que l’image par défaut et ce qu’il faut faire avec les utilisateurs n’ayant pas d’image Gravatar définie. Une fois ces paramètres définis, enregistrez la page et revenez au modèle «comments.php» précédemment modifié. Une simple variable peut être placée dans la boucle de commentaires. Elle affiche soit l'image par défaut, un avatar d'utilisateur généré de manière dynamique, soit le Gravatar réel qu'un utilisateur s'est défini.

La variable qui affiche toutes ces images est ci-dessous:

<? php echo get_avatar (); ? >

Pour en savoir plus sur l'ajout de gravatar dans votre site WordPress, lisez également: Intégrer le gravatar dans les thèmes et les commentaires WordPress.

C'est un peu différent des variables standard utilisées dans la boucle de commentaires, mais cela fonctionne tout aussi bien. Il peut être personnalisé avec des modificateurs entre parenthèses qui déterminent l'image par défaut des commentateurs autres que Gravatar, ainsi que la taille de l'image à imprimer dans les commentaires. Avec cela, le fichier “comments.php” typique a été en grande partie maîtrisé et bien appris. Il est maintenant temps d'approfondir les conceptions personnalisées, les nouvelles manières d'afficher les interactions des utilisateurs et les manières innovantes d'inclure le formulaire standard de soumission de commentaires.

Toujours vérifier les erreurs et valider les normes de conception

Enfin, assurez-vous de toujours vérifier les modifications apportées aux modèles afin de vous assurer qu'ils fonctionnent aussi bien que prévu. Comme pour toute solution logicielle basée sur PHP et MySQL, certaines modifications ou erreurs de codage accidentelles peuvent entraîner d'importantes erreurs d'impression sur la page statique de l'entrée et empêcher les utilisateurs d'utiliser les fonctions de commentaire présentes dans le modèle. Avec la validation XHTML et CSS, une attention particulière aux détails et une utilisation judicieuse des variables WordPress, cette complication peut être largement évitée.

Lorsque la page a cessé de générer des erreurs et affiche exactement comment elle est destinée, le processus est terminé. Il est maintenant temps de montrer le travail à vos utilisateurs et de les encourager à visiter le site Web de Gravatar, à s'inscrire et à personnaliser leur apparence dans les commentaires. N'oubliez pas que le nouveau modèle de commentaires est aussi performant que le prétendent les utilisateurs. Assurez-vous donc de bien expliquer toutes les nouvelles fonctionnalités ou exigences développées au cours du processus.

Et avec ça, votre travail est terminé!

Article de Jerry Low

Papa geek, accro aux données SEO, investisseur et fondateur de Web Hosting Secret Revealed. Jerry construit des actifs Internet et gagne de l'argent en ligne depuis 2004. Il adore gribouiller sans réfléchir et essayer de nouveaux plats.