Nous avons impl\u00e9ment\u00e9 un nombre important de modifications dans le WordPress Widget Boilerplate. Si vous n’avez pas suivi, je vous recommande de commencer au d\u00e9but de la s\u00e9rie et de rattraper votre retard.<\/p>\n
Si, toutefois, vous avez suivi et que vous utilisez \u00e9galement certains des outils de qualit\u00e9 du code qui examinent l’\u00e9tat du projet, vous remarquerez une poign\u00e9e d’erreurs dans la console.<\/p>\n
Normalement, c’est le point o\u00f9 je recommande de pr\u00eater attention \u00e0 ce qu’il partage, puis de corriger tout ce qu’il rapporte, mais nous n’en sommes pas encore l\u00e0.<\/p>\n
Par exemple, certaines des erreurs que nos outils affichent actuellement sont bas\u00e9es sur le fait que nous avons des variables inutilis\u00e9es. Bien s\u00fbr, c’est le cas, car nous n’avons pas commenc\u00e9 \u00e0 cr\u00e9er un widget.<\/p>\n
Mais il reste encore quelques classes concr\u00e8tes que nous devons impl\u00e9menter.<\/p>\n
L’un des probl\u00e8mes qui existent toujours dans le code tel qu’il est actuellement est que le constructeur du widget enregistre des fonctions et ce n’est pas une bonne chose.<\/p>\n
Le but d’un constructeur est de d\u00e9finir les valeurs des propri\u00e9t\u00e9s de la classe, et non d’impl\u00e9menter un type de logique. Ceci pour plusieurs raisons\u00a0:<\/p>\n
La fa\u00e7on de g\u00e9rer cela est double :<\/p>\n
Au cours des trois prochains articles\u00a0:<\/p>\n
Avant d’\u00e9crire le code du registre, il est important de noter son objectif principal. En termes simples, la classe est cens\u00e9e contenir une r\u00e9f\u00e9rence \u00e0 toute classe qui est, ahem, enregistr\u00e9e avec elle.<\/p>\n
Cela se fait en passant une r\u00e9f\u00e9rence \u00e0 un objet donn\u00e9 \u00e0 une fonction et en la liant \u00e9galement \u00e0 une cl\u00e9 afin que nous puissions facilement la r\u00e9cup\u00e9rer plus tard.<\/p>\n
Mais il y a certaines choses \u00e0 consid\u00e9rer. Par exemple:<\/p>\n
si un objet existe d\u00e9j\u00e0 dans le registre pour une cl\u00e9 donn\u00e9e, alors nous devons lever une exception – si un utilisateur essaie de r\u00e9cup\u00e9rer un objet dans le registre avec une cl\u00e9 donn\u00e9e, alors il devrait lever une exception<\/p>\n
Bien s\u00fbr, il ne doit pas n\u00e9cessairement lever d’exceptions. Au lieu de cela, il peut \u00e9galement afficher des messages d’erreur, renvoyer des valeurs nulles ou vides, ou tout ce que vous choisissez.<\/p>\n
Deuxi\u00e8mement, le registre doit \u00eatre en mesure de renvoyer une liste de tous les abonn\u00e9s qui y sont contenus afin qu’ils puissent \u00eatre enregistr\u00e9s avec WordPress (c’est ce que nous allons voir dans le prochain article).<\/p>\n
Pour ce faire, cependant, nous devons nous assurer qu’il prend en charge tous les abonn\u00e9s et c’est l\u00e0 que la notion de AbstractSubscriber du post pr\u00e9c\u00e9dent<\/a> entre en jeu. Autrement dit, tant qu’une classe est une classe enfant de cette classe, tout va bien.<\/p>\n Cela dit, planifions ce qui suit\u00a0:<\/p>\n Le stub de la classe ressemblera \u00e0 ceci\u00a0:<\/a><\/p>\n Ensuite, nous pouvons d\u00e9finir la propri\u00e9t\u00e9 de base<\/a>, un tableau, et l’initialiser dans le constructeur\u00a0:<\/p>\n Apr\u00e8s cela, nous pouvons cr\u00e9er la m\u00e9thode add<\/a>. N’oubliez pas que dans mon impl\u00e9mentation, je choisis de lever une exception si une cl\u00e9 est d\u00e9j\u00e0 d\u00e9finie, mais vous n’avez pas \u00e0 le faire.<\/p>\n De m\u00eame, la m\u00e9thode get<\/a> renverra une r\u00e9f\u00e9rence \u00e0 l’instance d’un objet identifi\u00e9 avec cette cl\u00e9. Si la cl\u00e9 n’est pas d\u00e9finie, elle l\u00e8vera une exception. S’il est d\u00e9fini, mais qu’aucun objet n’existe, nous renverrons null.<\/p>\n Enfin, nous avons besoin d’une m\u00e9thode pour renvoyer tous les abonn\u00e9s enregistr\u00e9s. Dans un prochain article, l’utilisation de cela deviendra beaucoup plus apparente, mais pour l’instant, notez que nous allons cr\u00e9er un tableau de n’importe quelle classe qui est une instance de la classe AbstractSubscriber ,<\/strong> puis nous renverrons le tableau filtr\u00e9.<\/a><\/p>\n \u00c0 ce stade, nous avons la classe<\/a> compl\u00e8te (compl\u00e8te avec la documentation):<\/p>\n Nous devons maintenant l’ajouter au bootstrap de notre plugin.<\/p>\n Comme mentionn\u00e9 pr\u00e9c\u00e9demment dans le post, nous devons ajouter ceci au bootstrap du plugin. Pour ce faire, cependant, nous devons d\u00e9finir notre propre filtre afin de pouvoir facilement passer le registre autour du reste du plugin (le moment venu).<\/p>\n Avant de faire cela, cependant, il est important de s’assurer que vous ma\u00eetrisez bien le registre que nous venons de cr\u00e9er, qu’il s’int\u00e8gre dans le plugin et que vous suivez avec la branche de d\u00e9veloppement que nous avons jusqu’\u00e0 pr\u00e9sent.<\/a><\/p>\nCr\u00e9ation du registre<\/h4>\n
\n
<?php\n\nclass Registry extends AbstractSubscriber\n{\n public function __construct()\n {\n }\n\n public function add($id, $obj)\n {\n }\n\n public function get($id)\n {\n }\n\n public function getRegisteredSubscribers()\n {\n }\n}\n<\/code><\/pre>\n<?php\n\nclass Registry\n{\n private $registry;\n\n public function __construct()\n {\n $this->registry = [];\n }\n\n \/\/ ...\n\n}<\/code><\/pre>\n<?php\n\npublic function add($id, $obj)\n{\n if (isset($this->registry[$id])) {\n throw new Exception('An object already exists for this given key.');\n }\n $this->registry[$id] = $obj;\n}<\/code><\/pre>\n<?php\n\npublic function get($id)\n{\n if (!isset($this->registry[$id])) {\n throw new Exception('No object exists for the specified key.');\n }\n\n return $this->registry[$id] ?? null;\n}<\/code><\/pre>\n<?php\n\npublic function getRegisteredSubscribers()\n{\n $subscribers = [];\n foreach ($this->registry as $object) {\n if ($object instanceof AbstractSubscriber) {\n $subscribers[] = $object;\n }\n }\n\n return array_filter($subscribers);\n}<\/code><\/pre>\n<?php\n\n\/*\n * This file is part of the WordPress Widget Boilerplate\n *\n * (c) Tom McFarlin <tom@tommcfarlin.com>\n *\n * This source file is subject to the GPL license that is bundled\n * with this source code in the file LICENSE.\n *\/\n\nnamespace WordPressWidgetBoilerplateUtilities;\n\nuse Exception;\nuse WordPressWidgetBoilerplateSubscriberAbstractSubscriber;\n\n\/**\n * This class services as a simple container that can be used to pass objects\n * around the plugin.\n *\n * To use this class you'd make a call to the registry by saying Registry->get(),\n * then making a class to `register()` and `retrieve()` on an instance of the object.\n *\/\nclass Registry\n{\n \/**\n * @var array an array used to maintain the objects registered with the plugin\n *\/\n private $registry;\n\n \/**\n * Initializes the class by setting up the registry.\n *\/\n public function __construct()\n {\n $this->registry = [];\n }\n\n \/**\n * Registers an object with the registry with the specified ID; however, will throw an\n * exception if the ID is already referencing an object.\n *\n * @param string $id an ID by which the specified object will be referenced\n * @param mixed $obj an instance of an object to store in the registry\n *\n * @throws Exception if an object already exists for the specified key\n *\/\n public function add($id, $obj)\n {\n if (isset($this->registry[$id])) {\n throw new Exception('An object already exists for this given key.');\n }\n $this->registry[$id] = $obj;\n }\n\n \/**\n * @param string $id the ID for the object that we wish to retrieve\n *\n * @throws Exception if no object exists for the specified key\n *\n * @return mixed a reference to the object or null\n *\/\n public function get($id)\n {\n if (!isset($this->registry[$id])) {\n throw new Exception('No object exists for the specified key.');\n }\n\n return $this->registry[$id] ?? null;\n }\n\n \/**\n * @return array all of the the Subscribers that should be registered with WordPress\n *\/\n public function getRegisteredSubscribers()\n {\n $subscribers = [];\n foreach ($this->registry as $object) {\n if ($object instanceof AbstractSubscriber) {\n $subscribers[] = $object;\n }\n }\n\n return array_filter($subscribers);\n }\n}\n<\/code><\/pre>\nAvant le bootstrap, bien que<\/h2>\n