Plus tôt cette année, nous avons effectué une série de didacticiels couvrant le processus de création de pages d’administration personnalisées dans WordPress. Bien que cette série ne soit pas nécessairement une condition préalable à la matière que nous allons couvrir, il n’y aurait pas de mal à la revoir.. 

Par défaut, WordPress fournit de nombreuses fonctionnalités grâce à ses nombreuses API. Si, par exemple, vous souhaitez travailler à l’introduction de pages d’administration en juste en se concentrant sur les options qui seront présentées à l'utilisateur, vous pouvez le faire en utilisant l'API Settings.

Le choix de cette API présente également de nombreux avantages. Certains d'entre eux comprennent:

• assainissement et validation
• éléments de menu personnalisés
• facilité d'introduction des pages d'administration
• travailler avec différents types d'entrées
• messagerie automatisée en cas de succès ou d'échec
• et beaucoup plus

Mais tout comme nous avons examiné comment créer des pages d’administration personnalisées, il est également possible de mettre en place un système nous permettant de définir par programme nos propres messages personnalisés, leur type, et quand et où les afficher sur la page d’administration.. 

Nous poursuivons donc avec le même thème que la série susmentionnée. Nous allons voir comment créer notre propre système de messagerie personnalisé pour les pages d’administration. Pour ce faire, nous allons créer un plugin pour illustrer les concepts, enregistrer des points d'ancrage personnalisés avec WordPress et voir également comment les implémenter..

Comme je l'ai mentionné, le didacticiel précédent n'est pas nécessairement une condition préalable à cette série, mais si vous êtes nouveau dans l'une des choses mentionnées ci-dessus, prenez donc le temps de revoir la série en premier, car cela donnera un peu de base à l'orientation. dans lequel nous nous dirigeons.

Cela dit, commençons.

Ce dont vous aurez besoin pour cette série

Si vous avez lu l'un de mes tutoriels précédents, vous savez que j'aime bien commencer chaque tutoriel (ou série, même) par deux choses:

1. Fournissez une liste des logiciels dont vous aurez besoin pour commencer..
2. Fournissez une feuille de route indiquant où nous nous dirigeons afin que vous puissiez décider si vous souhaitez ou non poursuivre la série..

Faisons-le maintenant.

Votre environnement de développement

De manière générale, voici ce dont vous aurez besoin pour démarrer avec le projet que nous allons construire.

• PHP 5.6.25
• MySQL 5.6.28
• Apache (ou Nginx si vous êtes à l'aise avec ça)
• WordPress 4.6.1
• Votre éditeur ou IDE préféré

Si vous êtes curieux de savoir comment tout cela s’agence, je vous recommande de lire cette série..

En règle générale, je ne recommande pas un logiciel qui soit meilleur que d'autres car il y a tellement d'options, mais si vous êtes novice dans ce domaine, je vous recommande vivement la version gratuite de MAMP. Compatible avec macOS et Windows, il devrait donc être compatible avec bon nombre de vos configurations. Il est facile à utiliser, à démarrer et fournit tout ce dont vous avez besoin lors de l'installation.

Notre feuille de route

Cela dit, voici la ventilation provisoire de cette série:

1. Dans ce tutoriel, nous allons jeter les bases du strict minimum de notre plugin et de ce dont nous avons besoin pour commencer..
2. Dans la deuxième partie, nous allons pousser le plugin un peu plus loin en ajoutant une page d'administration WordPress très basique. Nous allons également appeler le hook personnalisé que nous utiliserons et nous le câblerons du côté serveur. Nous allons également commencer les travaux de base pour notre paramètres Messenger.
3. Dans le prochain didacticiel, nous allons commencer à mettre en œuvre nos paramètres Messenger en ajoutant la prise en charge des erreurs et des messages de réussite, ainsi que des points relatifs à la sécurité..
4. Nous finirons par tout lier, de le voir en action et de rendre public le plugin final que vous pourrez télécharger..

Notez que chaque tutoriel comprendra des fichiers sources téléchargeables. Cependant, ils ne seront pas nécessairement des fichiers source complets, dans la mesure où ils pourraient ne pas inclure de documentation ou d'autres notes. C'est ce que le tutoriel est tout, après tout.

Mais la version finale fournie inclura exactement cela.

Démarrer le plugin

Pour le moment, nous savons que nous aurons besoin des éléments suivants pour notre plugin:

• une page d'administration de base
• un élément de menu pour nous emmener à la page d'administration
• un fichier de démarrage pour démarrer le plugin

Alors réunissons tous ces éléments et fonctionnels.

1. L'élément de menu

La première chose à faire est d’introduire la fonctionnalité permettant d’ajouter un élément de sous-menu à la liste. Les options menu dans le menu de navigation de l'administration WordPress.

Pour ce faire, nous avons besoin de deux classes et d'un fichier: une classe qui affichera le sous-menu, une classe qui affichera la page de sous-menu et un fichier qui affichera le contenu de la page..

Avant de faire cela, je vous recommande la structure de répertoire suivante:

Cela signifie que le admin répertoire aura un vues sous-répertoire. le admin répertoire aura class-submenu.php et classe-sous-menu-page.php. Nous parlerons de la page d'administration dans la section suivante.

D'abord, regardons chacun de ces fichiers individuels.

class-submenu.php

Cette classe est responsable de l'ajout de l'élément de menu à la page d'options:

submenu_page = $ submenu_page;  fonction publique init () add_action ('admin_menu', array ($ this, 'add_options_page'));  fonction publique add_options_page () add_options_page ('Tuts + Custom Messages', 'Tuts + Exemple de message personnalisé', 'manage_options', 'tutsplus-custom-messages', array ($ this-> submenu_page, 'render'));  

Si vous avez lu l'appel de l'API dans le Codex, vous verrez que cela introduira un élément de menu dans le menu déroulant. Outils menu qui sera accessible via "Tuts + Custom Messages" et qui contiendra un titre que nous verrons momentanément.

Notez également qu’il existe un init méthode. Cette fonction enregistre le add_options_page avec WordPress admin_menu accrocher afin qu'il soit correctement enregistré (et affiché) pendant le cycle de vie d'une page WordPress.

Deuxièmement, ce menu est accessible via n'importe qui avec le manage_options capacité, et il appellera la méthode de rendu sur le submenu_page qui lui appartient.

Le problème? Là est pas de page de sous-menu. Créons maintenant cette classe.

classe-sous-menu-page.php

Le code de cette classe est ci-dessous:

le Submenu_Page la classe est clairement simple. Tout ce qu'il fait est d'afficher le settings.php page, que nous passerons en revue dans un moment.
Notez que toutes les pages de sous-menu ne seront pas aussi simples. Cependant, la complexité de notre plugin est encore à venir. Nous verrons cela dans un futur post.
2. La page d'administration
Comme le Submenu_Page était simple, ainsi est la page de réglage. En fait, si vous connaissez le balisage de base, il devrait être facile de comprendre exactement ce qui se passe:
 
 
 Nous n'allons pas réellement afficher les options sur cette page. Au lieu de cela, nous allons utiliser cette page pour montrer comment se connecter à notre messagerie personnalisée.. 
 
 
En bref, cela affiche simplement un message dans WordPress indiquant que nous n'utiliserons pas cette page pour autre chose que l'affichage de messages personnalisés..
Après tout ça est ce que nous ferons.
3. Donner vie
À ce stade, nous sommes prêts à configurer le fichier d'amorçage pour que le plug-in soit activé. Voici le fichier de démarrage de base:
init ();  
Prenez note du commentaire ci-dessus le pour chaque boucle. Bien que nous ayons déjà abordé le chargement automatique dans une série précédente, je ne veux pas supposer que quelqu'un a lu toutes les séries menant à celle-ci. 
Une fois que cela est en place, vous devriez pouvoir vous connecter à votre compte WordPress, activer le plugin et voir l'écran suivant:
Sinon, revérifiez tout votre code source par rapport à celui qui est attaché à ce message et vérifiez que tout est exactement comme il se doit.. 
Sinon, apportez les corrections nécessaires et essayez à nouveau. Si cela prend quelques essais, ne vous en faites pas. La programmation peut parfois être un peu frustrante, surtout lorsque vous débutez.
Conclusion
Si vous avez suivi la plupart de mes travaux jusqu'à présent, cela peut sembler familier. Sinon, je suis content de vous avoir à bord. Pendant que vous attendez le deuxième tutoriel, je vous recommande de consulter certains des autres documents que j'ai publiés pour avoir une idée de ce que j'aime couvrir et de mon approche de l'enseignement de ces concepts..
Je suis également toujours heureux de répondre aux questions via les commentaires, et vous pouvez également consulter mon blog et me suivre sur Twitter. Je parle habituellement de développement de logiciels dans WordPress et de sujets tangentiels, ainsi.
En attendant le prochain tutoriel, étudiez le code, téléchargez les fichiers et voyez comment cela fonctionne sur votre ordinateur local. Dans la prochaine partie, nous allons reprendre exactement où nous avons laissé.
Ressources
 
Création de pages d'administration personnalisées avec WordPress
 
L'API Paramètres WordPress
 
Comment se lancer dans WordPress
 
 MAMP
 
add_options_page
 



		
			
	   
	




Code