Share
Les notifications d’administrateur de WordPress constituent un moyen pratique d’afficher des messages aux utilisateurs de la zone d’administration, par exemple. après la publication d'un message ou l'activation d'un plug-in. Ils sont également utilisés par de nombreux thèmes et plug-ins pour afficher des notifications sur des nouveautés, des avertissements de sécurité, des détails sur les promotions en cours ou les invites de mise à niveau..
WordPress Core fournit quatre avis d’administration différents qui peuvent être utilisés de manière contextuelle pour alerter un utilisateur d’un type d’avis spécifique. Ceci est réalisé en affichant une couleur d'accent unique pour chaque type d'avis de l'administrateur.
Les avis d’administrateur sont généralement affichés en haut de chaque page d’administration pour se distinguer du contenu de la page principale et être clairement visibles. Ils sont élégamment conçus pour ne pas gêner visuellement.
WordPress réutilise également les avis d’administrateur dans d’autres emplacements de l’interface d’administration, par exemple lorsqu'un thème ou une mise à jour de plug-in est disponible. L'utilisation principale des avis d'administration ne se limite pas à être simplement affichée en haut de l'écran d'administrateur.
L'affichage d'une notification de l'administrateur dans un plugin ou un thème personnalisé est relativement facile, car il ne nécessite que quelques lignes de code, comme nous le verrons bientôt. Cependant, WordPress ne fournit pas un moyen par défaut de rejeter un avis d’administrateur persistant..
Même si vous pouvez ajouter un bouton de renvoi à tout avis de l'administrateur, cela ne l'empêche pas de réapparaître lorsque la page est rechargée. De plus, les avis d’administrateur apparaissent sur chaque page d’administration, ce qui est loin d’être idéal..
Si vous souhaitez avoir un contrôle granulaire sur le moment et le lieu exacts où les avis d'administration sont affichés et pouvoir les ignorer efficacement, vous devez ajouter un code personnalisé pour modifier le comportement par défaut..
Nous allons commencer par le début et explorer les bases de la mise en œuvre des avis d’administrateur via un plugin personnalisé, notamment en les affichant uniquement sur des pages spécifiques de l’administrateur de WordPress..
Les avis de l'administrateur apparaissent sur chaque page par défaut, ce qui n'est pas toujours ce que vous voulez. Par exemple, vous souhaiterez peut-être uniquement afficher une notification sur une page d'options du plug-in. Donc, notre prochain port d'escale consistera à afficher conditionnellement les avis d'administration en fonction de l'écran actuel de l'administrateur..
Sur cette base, nous allons présenter des moyens de mieux gérer les avis d’administration en contrôlant quand ils apparaissent aussi. Plutôt que d'apparaître dès le chargement de la page, elles n'apparaîtront que si certaines conditions de déclenchement sont remplies. Cela peut être utile, par exemple, si vous souhaitez afficher une notification de l'administrateur sur une page d'options du plug-in, mais seulement après que les paramètres aient été sauvegardés.
Comme mentionné ci-dessus, il n'y a pas de moyen facile de supprimer les notifications d'administrateur persistantes entre les chargements de pages. Ainsi, le reste de la série de didacticiels se concentrera principalement sur les différentes méthodes que vous pouvez utiliser pour supprimer les notifications des administrateurs afin qu'elles ne réapparaissent pas de manière inattendue..
Enfin, pour vous amuser un peu, nous verrons comment vous pouvez créer vos propres types d’avis d’administration personnalisés et ajouter une décoration supplémentaire, telle que des icônes, à vos avis d’administration..
À la fin de cette série de didacticiels, vous serez en mesure d’afficher n’importe quel type d’avis de l’administrateur n’importe où dans l’administrateur de WordPress. De plus, vous serez en mesure de décider de les afficher au chargement de la page ou via une action personnalisée. Vous pourrez également les ignorer de différentes manières, en fonction de vos besoins..
Vous tirerez le meilleur parti de cette série de didacticiels si vous suivez ce que nous faisons chaque exemple d’avis d’administrateur. Le code est présenté étape par étape pour vous permettre de créer vous-même un plugin fonctionnel au fur et à mesure de l'avancement du didacticiel. Cependant, si vous ne souhaitez pas saisir tout le code vous-même, le plug-in final sera disponible au téléchargement dans la quatrième partie..
Il est supposé que vous avez au moins une connaissance pratique rudimentaire du développement de plugins WordPress, y compris du fonctionnement des hooks. Si non, alors je vous recommande de lire ces sujets via la documentation officielle de WordPress avant de continuer:
Afin de tester le code du plugin pour chaque exemple, vous aurez besoin d'un site WordPress fonctionnel. Pour ce faire, le moyen le plus simple consiste à installer WordPress localement afin de vous permettre d'accéder facilement à la modification de fichiers..
Il existe de nombreux choix pour développer localement avec WordPress, notamment:
Si vous débutez dans le développement WordPress, Local ou DesktopServer sont probablement les plus faciles à configurer. Local est libre d'utilisation (ils ont une version premium en préparation), et DesktopServer a une version limitée (gratuite) plus une version premium disponible.
En outre, une expérience préalable de PHP et de JavaScript est recommandée, de même qu'une expérience de la mise en œuvre de requêtes Ajax. Cependant, tout sera expliqué en cours de route, une connaissance approfondie n'est donc pas nécessaire..
Examinons l'implémentation la plus élémentaire d'un avis d'administrateur et le code requis pour rendre un avis de type succès..
fonction display_admin_notice () ?>Le secret du succès est de savoir quelque chose que personne d'autre ne sait ~ Aristote Onassis
Tout ce que nous avons fait ici a été d’enregistrer le
display_admin_notice ()fonction qui sera exécutée lorsque leadmin_noticesaccrocher des feux. Peu importe comment s'appelle la fonction enregistrée, cela n'affectera pas le rendu de la notification de l'administrateur.Ne vous inquiétez pas pour entrer le code ci-dessus vous-même en ce moment; Concentrez-vous simplement sur la façon dont l'avis d'administration est généré, car nous allons nous appuyer sur cela dans des tutoriels ultérieurs..
Vous pouvez utiliser n'importe quel balisage pour afficher une notification de l'administrateur; toutefois, le format recommandé est le suivant:
message
Remplacer
classeavec une liste de noms de classes CSS. Vous devriez inclure la classeremarquerplus l’une des classes suivantes pour déterminer le type d’avis d’administrateur:
Accentsconagua
notice-error (rouge)avis d'avertissement (jaune orange)avis-succès (vert)notice-info (bleu)
le message le bloc peut être n'importe quel texte ou HTML valide qui sera affiché à l'intérieur de la notification de l'administrateur.
L'exemple ci-dessus montre les notifications de l'administrateur sur toutes les pages de l'administrateur, ce qui n'est pas toujours idéal. Dans la deuxième partie, nous verrons comment contrôler exactement les pages sur lesquelles elles apparaissent..
Il existe une autre classe CSS intégrée que vous pouvez ajouter à avis div. cela ajoute un bouton de renvoi à la notification de l'administrateur. Voyons ce qui se passe lorsque le même avis d’administrateur de succès a le est-licenciable classe ajoutée.
fonction display_admin_notice () ?>Le secret du succès est de savoir quelque chose que personne d'autre ne sait ~ Aristote Onassis
Nous avons maintenant un moyen facile de rejeter une notification de l'administrateur. Cependant, avant d’être trop excité, l’utilisation de cette méthode pose un problème. Si vous actualisez la page, la notification de l'administrateur réapparaît! Ainsi, même si vous pouvez définir un avis d'administrateur pour qu'il soit révocable, il est persistant et le statut licencié est oublié entre les chargements de page..
Nous traiterons plus en détail des avis d’administration persistants plus tard et étudierons diverses façons de les supprimer sans qu’ils ne réapparaissent..
Mais les avis de l'administrateur sont mauvais! Ne sont-ils pas?
Si vous êtes familier avec les avis d’administrateur dans WordPress et / ou suivez l’actualité de WordPress en général, alors vous êtes peut-être au courant d’un certain degré de négativité concernant l’utilisation des avis d’administration dans les plugins et les thèmes personnalisés..
Cela provient du fait que certains plug-ins ont trop utilisé les notifications de l'administrateur pour tenter de faire passer leurs messages «importants». Si de nombreux plugins sont installés et que quelques-uns d'entre eux n'abusent du système de notification de l'administrateur, vous pouvez rapidement vous retrouver avec la notification de l'administrateur "soupe", où tout un enchevêtrement de notifications est affiché en haut de chaque page de l'administrateur..
Le fait de surcharger les écrans d’administrateur avec des notifications inutiles peut causer du chaos (et des maux de tête) et est naturellement agaçant pour les utilisateurs, car il est plus difficile de gérer un site..
Idéalement, seules les notifications importantes de l'administrateur, telles que les mises à jour de sécurité critiques, devraient être affichées à chaque chargement de page. Si vous affichez des avis généraux pour informer les utilisateurs qu'un plug-in vient d'être mis à jour et que vous êtes invité à cliquer sur un lien pour plus d'informations, vous devez vous demander si cela doit figurer sur chaque page d'administrateur..
En outre, un favori typique consiste à afficher un avis d’administration non critique qui ne peut pas être facilement congédié de façon permanente. Je vous garantis qu'il n'y a pas de moyen plus facile d'aliéner vos utilisateurs de plugins qu'en faisant cela!
Cependant, il existe des cas d'utilisation pour les avis persistants qui ne sont pas licenciables, tels que les mises à jour de base de données. Les plug-ins qui utilisent des tables personnalisées peuvent avoir besoin d'exécuter de temps en temps les routines de mise à jour de la base de données pour que le plug-in continue de fonctionner correctement. Donc, dans ce cas, il est raisonnable d'ajouter un avis d'administrateur non révocable.
En règle générale, il suffit d'utiliser le bon sens. Est-ce que l'administrateur que vous êtes sur le point d'ajouter à votre plug-in vous importunerait? Si tel est le cas, vous voudrez peut-être repenser l’ajout de l’avis, ou envisager de mieux l’afficher dans un autre emplacement..
Conclusion
Dans ce didacticiel, nous avons décrit ce que sont les avis d’administration et les différents types intégrés fournis par WordPress, y compris un avis d’administrateur licenciable. Comme nous l'avons vu, l'implémentation par défaut des avis d'administration présente certains inconvénients, tels que le fait de ne pas être licencié et le fait qu'ils soient affichés sur chaque page d'administration..
WordPress a une économie incroyablement active. Il existe des thèmes, des plugins, des bibliothèques et de nombreux autres produits qui vous aident à construire votre site et votre projet. La nature open-source de la plate-forme en fait également une excellente option à partir de laquelle vous pouvez améliorer vos compétences en programmation. Quel que soit le cas, vous pouvez voir ce que nous avons à votre disposition Envato Market.
Le reste des didacticiels de cette série portera sur la manière dont nous pouvons étendre les avis d’administration pour qu’ils soient plus pratiques s’ils sont utilisés dans vos propres plugins et thèmes..
