Tous ces \u00e9l\u00e9ments vont jouer un r\u00f4le dans ce que nous allons faire aujourd’hui.<\/p>\n
Le passe-partout du widget WordPress\u00a0: refactorisation, partie\u00a07<\/h2>\n
Pour ceux qui connaissent l’ API WordPress Widgets<\/a>, vous savez probablement qu’elle n’a pas beaucoup chang\u00e9 au cours des derni\u00e8res ann\u00e9es.<\/p>\n De plus, il ne se compose en r\u00e9alit\u00e9 que de quatre fonctions (dont l’une est le constructeur) :<\/p>\n La bonne chose est que cette approche particuli\u00e8re est r\u00e9alis\u00e9e en h\u00e9ritant d’une fonctionnalit\u00e9 pour la classe WP_Widget<\/a>.<\/p>\n Le probl\u00e8me, cependant, est que c’est beaucoup de travail pour une seule classe.<\/p>\n Au lieu de cela, nous devrions s\u00e9parer chacune des fonctions dans son propre domaine de fonctionnalit\u00e9.<\/p>\n Comme pour tout ce qui concerne la programmation, il y aura des fa\u00e7ons dont certaines choses sont claires sur la fa\u00e7on dont elles peuvent \u00eatre faites, puis il y aura des choses qui peuvent \u00eatre faites de plusieurs fa\u00e7ons.<\/p>\n Ce que je vais vous pr\u00e9senter, c’est comment je l’aborde pour l’instant. Cela pourrait changer \u00e0 l’avenir, ou peut-\u00eatre pas, et d’autres pourraient avoir une vision diff\u00e9rente.<\/p>\n Quoi qu’il en soit, l’impl\u00e9mentation sera beaucoup plus orient\u00e9e objet et donnera \u00e0 chaque classe son propre ensemble de responsabilit\u00e9s.<\/p>\n La premi\u00e8re question, cependant, est de savoir comment diviser une classe avec quatre fonctions et qui h\u00e9rite d’une classe parente ?<\/p>\n Tout d’abord, il y a quelques choses que nous devons ajuster dans le bootstrap du plugin. A savoir, nous devons faire ce qui suit:<\/p>\n Voici un aper\u00e7u des trois \u00e9l\u00e9ments ci-dessus.<\/p>\n Puisque nous avons d\u00e9j\u00e0 couvert cela plus t\u00f4t dans la s\u00e9rie, il devrait \u00eatre clair comment proc\u00e9der.<\/p>\n D’abord, voyez le code suivant<\/a> :<\/p>\n Ensuite, notez que nous instancions le registre (nous parlerons de son espace de noms dans un instant), puis nous l’accrochons \u00e0 un filtre personnalis\u00e9 qui nous permet d’y acc\u00e9der \u00e0 tout moment dans le plug-in.<\/p>\n Ensuite, nous devons mettre \u00e0 jour la classe du plugin principal (qui r\u00e9side dans le\u00a0 r\u00e9pertoire src<\/strong>) afin qu’elle r\u00e9f\u00e9rence le registre et charge tous les abonn\u00e9s enregistr\u00e9s<\/a> :<\/p>\n Notez, cependant, que nous n’avons pas encore vraiment configur\u00e9 d’abonn\u00e9s. Nous avons commenc\u00e9 cela plus t\u00f4t dans la s\u00e9rie et il est maintenant temps d’y revenir, mais nous le ferons plus tard.<\/p>\n Nous devons cependant ajouter une fonction<\/a> – m\u00eame si elle est temporaire – afin que nous puissions ajouter des classes qui ne sont pas des abonn\u00e9s explicites aux \u00e9v\u00e9nements\u00a0:<\/p>\n Cela sera retravaill\u00e9 plus tard car nous transformerons les classes principales en abonn\u00e9s plus tard.<\/p>\n Avant d’aller plus loin, je pense qu’il est important de revoir le bootstrap. Bien que votre en-t\u00eate et votre documentation puissent varier, il est important de noter que nous faisons les choses suivantes\u00a0:<\/p>\n Cela semble beaucoup mais le code est assez court<\/a> :<\/p>\n \u00c0 ce stade, cependant, il est temps d’examiner ce que c’est que de diviser la classe enfant de l’ API Widgets<\/a> standard en quelque chose qui correspond au mod\u00e8le de code avec lequel nous travaillons.<\/p>\n Cette partie va probablement s’\u00e9tendre sur quelques articles car il y a un peu de travail \u00e0 faire, mais nous allons commencer par cr\u00e9er notre propre classe de widgets qui h\u00e9ritera de la classe de base Widget.<\/p>\n Tout d’abord, allez-y et cr\u00e9ez un\u00a0 r\u00e9pertoire API<\/strong> dans le\u00a0 r\u00e9pertoire src<\/strong> et ajoutez un fichier appel\u00e9 Widget.php<\/strong>. C’est l\u00e0 que r\u00e9sideront les bases du widget. Nous aborderons les feuilles de style administratives et publiques et les fichiers JavaScript dans le prochain article.<\/p>\n \u00c0 ce stade, les bases du fichier devraient ressembler \u00e0 ceci<\/a>\u00a0:<\/p>\n Notez qu’il prend un seul argument. J’ai utilis\u00e9 widget-name mais vous pouvez utiliser ce que vous voulez tant qu’il repr\u00e9sente votre widget.<\/p>\n Cela permet de montrer que la classe est correctement instanci\u00e9e et charg\u00e9e lorsque le plugin est activ\u00e9. Si vous ne voyez pas cela, c’est que quelque chose ne va pas (ce que nous reviendrons dans un moment).<\/p>\n Ensuite, il est important de s’assurer que cette classe est ajout\u00e9e au Registre. Ajoutez donc les lignes suivantes du code dans le bootstrap\u00a0:<\/a><\/p>\n Et maintenant, lorsque vous activez le plugin, vous devriez voir ceci :<\/p>\n\n
Mise \u00e0 jour du Bootstrap<\/h3>\n
\n
1 Instancier le Registre<\/h3>\n
<?php\n\n\/\/ Setup a filter so we can retrieve the registry throughout the plugin.\n$registry = new Registry();\nadd_filter('wpwBoilerplateRegistry', function() use ($registry) {\n return $registry;\n});<\/code><\/pre>\n2 Mettre \u00e0 jour la classe du plugin<\/h3>\n
<?php\n\n\/*\n * This file is part of WordPress Widget Boilerplate\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 WordPressWidgetBoilerplate;\n\nuse WordPressWidgetBoilerplateUtilitiesRegistry;\n\n\/**\n * The base class for this plugin. Maintains a copy of the registry and starts\n * all of the objects that should hook into WordPress.\n *\/\nclass Plugin\n{\n \/**\n * @var Registry a reference to the simple container used to maintain plugin objects\n *\/\n private $registry;\n\n \/**\n * @param Registry $registry a reference to the simple container used to maintain plugin objects\n *\/\n public function __construct(Registry $registry)\n {\n $this->registry = $registry;\n }\n\n \/**\n * Iterates through each of the subscribers maintained in the registry and registers them\n * to the proper WordPress hook.\n *\/\n public function start()\n {\n array_map(function ($subscriber) {\n add_action($subscriber->getHook(), [$subscriber, 'load']);\n }, $this->registry->getRegisteredSubscribers());\n }\n}<\/code><\/pre>\n<?php\n\/**\n * @return array all of the the objects that aren't subscribers registered with WordPress\n *\/\npublic function getRegisteredObjects()\n{\n $objects = [];\n foreach ($this->registry as $object) {\n if (!$object instanceof AbstractSubscriber) {\n $objects[] = $object;\n }\n }\n\n return array_filter($objects);\n}<\/code><\/pre>\n3 Revoir le Bootstrap<\/h3>\n
\n
<?php\n\/**\n * WordPress Widget Boilerplate\n *\n * The WordPress Widget Boilerplate is an organized, maintainable boilerplate for building\n * widgets using WordPress best practices.\n *\n * @package WordPressWidgetBoilerplate\n * @author Your Name <email@example.com>\n * @license GPL-3.0+\n * @link http:\/\/example.com\n * @copyright 2018 - 2019 Your Name or Company Name\n *\n * @wordpress-plugin\n * Plugin Name: WordPress Widget Boilerplate\n * Plugin URI: https:\/\/github.com\/tommcfarlin\/wordpress-widget-boilerplate\n * Description: An object-oriented foundation for building WordPress Widgets.\n * Version: 1.0.0\n * Author: Tom McFarlin\n * Author URI: https:\/\/tommcfarlin.com\n * Text Domain: widget-name\n * License: GPL-3.0+\n * License URI: http:\/\/www.gnu.org\/licenses\/gpl-3.0.txt\n * Domain Path: \/lang\n *\/\n\nnamespace WordPressWidgetBoilerplate;\n\nuse WordPressWidgetBoilerplateUtilitiesRegistry;\nuse WordPressWidgetBoilerplatePlugin;\n\n\/\/ Prevent this file from being called directly.\ndefined('WPINC') || die;\n\n\/\/ Include the autoloader.\nrequire_once __DIR__. '\/vendor\/autoload.php';\n\n\/\/ Setup a filter so we can retrieve the registry throughout the plugin.\n$registry = new Registry();\nadd_filter('wpwBoilerplateRegistry', function() use ($registry) {\n return $registry;\n});\n\n\/\/ Start the machine.\n(new Plugin($registry))->start();\n<\/code><\/pre>\nFractionner une classe enfant<\/h2>\n
<?php\n\n\/*\n * This file is part of WordPress Widget Boilerplate\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 WordPressWidgetBoilerplateAPI;\n\nuse WP_Widget;\n\nclass Widget extends WP_Widget\n{\n \/**\n * @var string unique identifier for your widget\n *\/\n protected $widgetSlug;\n\n \/**\n * Initializes the plugin by setting its properties and calling the parent class with the description.\n *\n * @param mixed $widgetSlug\n *\/\n public function __construct($widgetSlug)\n {\n $this->widgetSlug = $widgetSlug;\n\n \/\/ TODO: update description\n parent::__construct(\n $this->getWidgetSlug(),\n __('Widget Name', $this->getWidgetSlug()),\n [\n 'classname' => $this->getWidgetSlug().'-class',\n 'description' => __('Short description of the widget goes here.', $this->getWidgetSlug()),\n ]\n );\n }\n\n \/**\n * Return the widget slug.\n *\n * @return string slug variable\n *\/\n public function getWidgetSlug()\n {\n return $this->widgetSlug;\n }\n\n \/**\n * TODO: This is a temporary message to show that the Boilerplate has loaded.\n *\/\n public function load()\n {\n $html = '<p style=\"text-align:center; background: #fff; padding: 1em; border: 1px dotted gray; margin: 2em 2em 2em 14em;\">';\n $html .= 'The Widget Boilerplate is loaded.';\n $html .= '<\/p>';\n echo $html;\n }\n}\n<\/code><\/pre>\n<?php\n\n\/\/ Add the Widget base class to the Registry.\n$registry->add('widget', new Widget('widget-name'));<\/code><\/pre>\n
![\"Widgets](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-160983-61e7189c9c671.png\")
<\/a><\/p>\n