Tutti questi giocheranno un ruolo in quello che faremo oggi.<\/p>\n
The WordPress Widget Boilerplate: Refactoring, parte 7<\/h2>\n
Per coloro che hanno familiarit\u00e0 con l’ API dei widget di WordPress<\/a>, probabilmente saprai che non \u00e8 cambiato molto negli ultimi anni.<\/p>\n Inoltre, in realt\u00e0 consiste solo di quattro funzioni (una delle quali \u00e8 il costruttore):<\/p>\n La cosa bella \u00e8 che questo particolare approccio si ottiene ereditando una funzionalit\u00e0 per la classe WP_Widget<\/a>.<\/p>\n Il problema, per\u00f2, \u00e8 che \u00e8 molto lavoro da fare per una singola classe.<\/p>\n Invece, dovremmo separare ciascuna delle funzioni nella propria area di funzionalit\u00e0.<\/p>\n Come per qualsiasi cosa nella programmazione, ci saranno modi in cui alcune cose sono chiare su come possono essere fatte e poi ci saranno alcune cose che possono essere fatte in pi\u00f9 modi.<\/p>\n Quello che ho intenzione di presentare \u00e8 come mi sto avvicinando per ora. Questo potrebbe cambiare in futuro, o forse no, e altri potrebbero avere una visione diversa.<\/p>\n Indipendentemente da ci\u00f2, l’implementazione sar\u00e0 molto pi\u00f9 orientata agli oggetti e attribuir\u00e0 a ciascuna classe il proprio insieme di responsabilit\u00e0.<\/p>\n La prima domanda, tuttavia, \u00e8 come possiamo dividere una classe con quattro funzioni e che eredita da una classe genitore?<\/p>\n Innanzitutto, ci sono alcune cose che dobbiamo regolare nel bootstrap del plugin. Vale a dire, dobbiamo fare quanto segue:<\/p>\n Ecco uno sguardo a tutti e tre i precedenti.<\/p>\n Dal momento che ne abbiamo gi\u00e0 parlato all’inizio della serie, dovrebbe essere chiaro come farlo.<\/p>\n Per prima cosa, vedere il seguente codice<\/a> :<\/p>\n Successivamente, nota che stiamo creando un’istanza del registro (parleremo momentaneamente del suo spazio dei nomi) e quindi lo colleghiamo a un filtro personalizzato che ci consente di accedervi in \u200b\u200btutto il plug-in ogni volta che lo desideriamo.<\/p>\n Successivamente, dobbiamo aggiornare la classe del plugin principale (che risiede nella\u00a0 directory src<\/strong>) in modo che faccia riferimento al registro e carichi tutti gli abbonati registrati<\/a> :<\/p>\n Nota, tuttavia, che non abbiamo ancora impostato alcun abbonato. L’abbiamo iniziato all’inizio della serie e ora \u00e8 il momento di tornare su di esso, ma lo faremo pi\u00f9 tardi.<\/p>\n Tuttavia, \u00e8 necessario aggiungere una funzione<\/a>, anche se temporanea, in modo da poter aggiungere classi che non siano sottoscrittori di eventi espliciti:<\/p>\n Questo verr\u00e0 rielaborato in seguito poich\u00e9 trasformeremo le classi principali in abbonati in seguito.<\/p>\n Prima di andare oltre, penso che sia importante rivedere il bootstrap. Sebbene l’intestazione e la documentazione possano variare, \u00e8 importante notare che stiamo effettuando le seguenti operazioni:<\/p>\n Sembra molto ma il codice \u00e8 piuttosto breve<\/a> :<\/p>\n A questo punto, per\u00f2, \u00e8 il momento di guardare a com’\u00e8 dividere la classe figlia dall’API Widgets<\/a> standard in qualcosa che si adatta al modello di codice con cui stiamo lavorando.<\/p>\n \u00c8 probabile che questa parte si estenda su alcuni post poich\u00e9 c’\u00e8 un po’ di lavoro da fare, ma inizieremo creando la nostra classe widget che erediter\u00e0 dalla classe Widget di base.<\/p>\n Per prima cosa, vai avanti e crea una\u00a0 directory API<\/strong> nella directory src<\/strong> e aggiungi un file chiamato Widget.php<\/strong>. \u00c8 qui che risiederanno le basi del widget. Nel prossimo post parleremo dei fogli di stile pubblici e amministrativi e dei file JavaScript.<\/p>\n A questo punto, le basi del file dovrebbero apparire cos\u00ec<\/a> :<\/p>\n Si noti che richiede un singolo argomento. Ho usato widget-name ma puoi usare qualunque cosa desideri purch\u00e9 rappresenti il \u200b\u200b\u200b\u200btuo widget.<\/p>\n Questo per mostrare che la classe viene istanziata e caricata correttamente quando il plugin viene attivato. Se non vedi questo, allora qualcosa non va (che esamineremo momentaneamente).<\/p>\n Successivamente, \u00e8 importante assicurarsi che questa classe venga aggiunta al Registro di sistema. Quindi aggiungi le seguenti righe di codice nel bootstrap:<\/a><\/p>\n E ora, quando attivi il plugin, dovresti vedere quanto segue:<\/p>\n\n
Aggiornamento di Bootstrap<\/h3>\n
\n
1 Istanziare il Registro<\/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 Aggiorna la classe del 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 Esamina 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>\nDividere una classe bambino<\/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
![\"Widget](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-160983-61e7189c9c671.png\")
<\/a><\/p>\n