Abbiamo implementato una quantit\u00e0 significativa di modifiche al WordPress Widget Boilerplate. Se non hai seguito, ti consiglio di iniziare dall’inizio della serie e di recuperare il ritardo.<\/p>\n
Se, tuttavia, hai seguito e stai anche eseguendo alcuni degli strumenti di qualit\u00e0 del codice che esaminano lo stato del progetto, noterai una manciata di errori nella console.<\/p>\n
Normalmente, questo \u00e8 il punto in cui consiglio di prestare attenzione a ci\u00f2 che condivide e quindi di correggere ci\u00f2 che segnala, ma non ci siamo ancora.<\/p>\n
Ad esempio, alcuni degli errori che i nostri strumenti stanno mostrando in questo momento si basano sul fatto che abbiamo variabili inutilizzate. Naturalmente, questo \u00e8 il caso, per\u00f2, perch\u00e9 non abbiamo iniziato a creare un widget.<\/p>\n
Ma ci sono ancora alcune classi concrete che dobbiamo implementare.<\/p>\n
Uno dei problemi che esistono ancora nel codice cos\u00ec com’\u00e8 in questo momento \u00e8 che il costruttore del widget sta registrando le funzioni e questa non \u00e8 una buona cosa.<\/p>\n
Lo scopo di un costruttore \u00e8 impostare i valori delle propriet\u00e0 della classe, non implementare alcun tipo di logica. Questo per alcuni motivi:<\/p>\n
Il modo per gestirlo \u00e8 duplice:<\/p>\n
Nei prossimi tre post:<\/p>\n
Prima di scrivere il codice per il Registro, \u00e8 importante notare qual \u00e8 il suo scopo principale. In poche parole, la classe ha lo scopo di contenere un riferimento a qualsiasi classe che \u00e8, ehm, registrata con essa.<\/p>\n
Questo viene fatto passando un riferimento a un determinato oggetto a una funzione e anche legandolo a una chiave in modo da poterlo recuperare facilmente in seguito.<\/p>\n
Ma ci sono alcune cose da considerare. Per esempio:<\/p>\n
se esiste gi\u00e0 un oggetto nel registro per una determinata chiave, allora \u00e8 necessario generare un’eccezione: se un utente tenta di acquisire un oggetto dal registro con una determinata chiave, dovrebbe generare un’eccezione<\/p>\n
Naturalmente, non deve necessariamente generare eccezioni. Al contrario, pu\u00f2 anche visualizzare messaggi di errore, restituire valori null o vuoti o qualsiasi altra cosa tu scelga.<\/p>\n
In secondo luogo, il registro deve essere in grado di restituire un elenco di tutti gli abbonati che sono contenuti al suo interno in modo che possano essere registrati con WordPress (che \u00e8 quello che vedremo nel prossimo post).<\/p>\n
Per fare questo, per\u00f2, dobbiamo assicurarci che supporti tutti gli iscritti ed \u00e8 qui che entra in gioco la nozione di AbstractSubscriber del post precedente .<\/a> Cio\u00e8, finch\u00e9 una classe \u00e8 una classe figlia di quella classe, allora siamo a posto.<\/p>\n Detto questo, pianifichiamo quanto segue:<\/p>\n Lo stub per la classe sar\u00e0 simile a questo:<\/a><\/p>\n Successivamente, possiamo definire la propriet\u00e0 di base<\/a>, un array e inizializzarlo nel costruttore:<\/p>\n Successivamente, possiamo creare il metodo add<\/a>. Ricorda che nella mia implementazione, sto optando per generare un’eccezione se una chiave \u00e8 gi\u00e0 definita, ma non devi farlo.<\/p>\n Allo stesso modo, il metodo get<\/a> restituir\u00e0 un riferimento all’istanza di un oggetto identificato con quella chiave. Se la chiave non \u00e8 impostata, generer\u00e0 un’eccezione. Se \u00e8 impostato, ma non esiste alcun oggetto, restituiremo null.<\/p>\n Infine, abbiamo bisogno di un metodo per restituire tutti gli abbonati registrati. In un post futuro, l’uso di questo diventer\u00e0 molto pi\u00f9 evidente, ma per ora, tieni presente che creeremo un array di qualsiasi classe che sia un’istanza della classe AbstractSubscriber<\/strong> e quindi restituiremo l’array filtrato.<\/a><\/p>\n A questo punto abbiamo la classe<\/a> completa (completa di documentazione):<\/p>\n Ora dobbiamo aggiungerlo al bootstrap del nostro plugin.<\/p>\n Come accennato in precedenza nel post, dobbiamo aggiungerlo al bootstrap del plugin. Per fare ci\u00f2, per\u00f2, dobbiamo definire il nostro filtro in modo da poter passare facilmente il registro intorno al resto del plugin (quando arriva il momento di farlo).<\/p>\n Prima di farlo, tuttavia, \u00e8 importante assicurarsi di avere una buona gestione del registro che abbiamo appena creato, che si adatti al plug-in e che stai monitorando con il ramo di sviluppo<\/a> che abbiamo finora.<\/p>\nCreazione del Registro<\/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>\nPrima di Bootstrap, per\u00f2<\/h2>\n