Wprowadzili\u015bmy znaczn\u0105 ilo\u015b\u0107 zmian w WordPress Widget Boilerplate. Je\u015bli nie nad\u0105\u017casz, polecam zacz\u0105\u0107 od pocz\u0105tku serii i nadrobi\u0107 zaleg\u0142o\u015bci.<\/p>\n
Je\u015bli jednak \u015bledzisz ten temat i korzystasz r\u00f3wnie\u017c z niekt\u00f3rych narz\u0119dzi jako\u015bci kodu, kt\u00f3re badaj\u0105 stan projektu, zauwa\u017cysz gar\u015b\u0107 b\u0142\u0119d\u00f3w w konsoli.<\/p>\n
Zwykle jest to punkt, w kt\u00f3rym zalecam zwr\u00f3cenie uwagi na to, co udost\u0119pnia, a nast\u0119pnie naprawienie tego, co zg\u0142asza, ale jeszcze do tego nie doszli\u015bmy.<\/p>\n
Na przyk\u0142ad niekt\u00f3re b\u0142\u0119dy, kt\u00f3re obecnie wy\u015bwietlaj\u0105 nasze narz\u0119dzia, wynikaj\u0105 z faktu, \u017ce mamy nieu\u017cywane zmienne. Oczywi\u015bcie tak jest, poniewa\u017c nie zacz\u0119li\u015bmy budowa\u0107 wid\u017cetu.<\/p>\n
Ale jest jeszcze kilka konkretnych klas, kt\u00f3re musimy zaimplementowa\u0107.<\/p>\n
Jednym z problem\u00f3w, kt\u00f3re wci\u0105\u017c istniej\u0105 w kodzie w obecnej postaci, jest to, \u017ce konstruktor wid\u017cetu rejestruje funkcje, a to nie jest dobre.<\/p>\n
Zadaniem konstruktora jest ustawienie warto\u015bci w\u0142a\u015bciwo\u015bci klasy, a nie implementacja jakiejkolwiek logiki. Dzieje si\u0119 tak z kilku powod\u00f3w:<\/p>\n
Spos\u00f3b radzenia sobie z tym jest dwojaki:<\/p>\n
W kolejnych trzech postach:<\/p>\n
Przed napisaniem kodu dla Rejestru wa\u017cne jest, aby zwr\u00f3ci\u0107 uwag\u0119, jaki jest jego g\u0142\u00f3wny cel. M\u00f3wi\u0105c najpro\u015bciej, klasa ma zawiera\u0107 odniesienie do dowolnej klasy, kt\u00f3ra jest, hm, zarejestrowana w niej.<\/p>\n
Odbywa si\u0119 to poprzez przekazanie referencji do danego obiektu do funkcji, a tak\u017ce powi\u0105zanie go z kluczem, dzi\u0119ki czemu mo\u017cemy go p\u00f3\u017aniej \u0142atwo pobra\u0107.<\/p>\n
Ale jest kilka rzeczy do rozwa\u017cenia. Na przyk\u0142ad:<\/p>\n
je\u015bli obiekt ju\u017c istnieje w rejestrze dla danego klucza, to musimy zg\u0142osi\u0107 wyj\u0105tek \u2013 je\u015bli u\u017cytkownik pr\u00f3buje pobra\u0107 obiekt z rejestru z danym kluczem, powinien zg\u0142osi\u0107 wyj\u0105tek<\/p>\n
Oczywi\u015bcie nie musi koniecznie rzuca\u0107 wyj\u0105tk\u00f3w. Zamiast tego mo\u017ce r\u00f3wnie\u017c wy\u015bwietla\u0107 komunikaty o b\u0142\u0119dach, zwraca\u0107 warto\u015bci null lub puste lub cokolwiek wybierzesz.<\/p>\n
Po drugie, rejestr musi by\u0107 w stanie zwr\u00f3ci\u0107 list\u0119 wszystkich zawartych w nim subskrybent\u00f3w, aby mo\u017cna by\u0142o ich zarejestrowa\u0107 w WordPressie (o czym przekonamy si\u0119 w nast\u0119pnym po\u015bcie).<\/p>\n
Aby to zrobi\u0107, musimy jednak upewni\u0107 si\u0119, \u017ce obs\u0142uguje wszystkich subskrybent\u00f3w i tutaj w gr\u0119 wchodzi poj\u0119cie AbstractSubscriber z poprzedniego postu .<\/a> Oznacza to, \u017ce dop\u00f3ki klasa jest klas\u0105 potomn\u0105 tej klasy, wszystko jest w porz\u0105dku.<\/p>\n Powiedziawszy to, zaplanujmy nast\u0119puj\u0105ce rzeczy:<\/p>\n Kod klasy b\u0119dzie wygl\u0105da\u0142 mniej wi\u0119cej tak:<\/a><\/p>\n Nast\u0119pnie mo\u017cemy zdefiniowa\u0107 podstawow\u0105 w\u0142a\u015bciwo\u015b\u0107<\/a>, tablic\u0119 i zainicjalizowa\u0107 j\u0105 w konstruktorze:<\/p>\n Nast\u0119pnie mo\u017cemy stworzy\u0107 metod\u0119 add<\/a>. Pami\u0119taj, \u017ce w mojej implementacji decyduj\u0119 si\u0119 na zg\u0142oszenie wyj\u0105tku, je\u015bli klucz jest ju\u017c zdefiniowany, ale nie musisz tego robi\u0107.<\/p>\n Podobnie metoda get<\/a> zwr\u00f3ci odwo\u0142anie do instancji obiektu zidentyfikowanego za pomoc\u0105 tego klucza. Je\u015bli klucz nie zostanie ustawiony, zg\u0142osi wyj\u0105tek. Je\u015bli jest ustawiony, ale nie istnieje \u017caden obiekt, zwr\u00f3cimy null.<\/p>\n Na koniec potrzebujemy metody, aby zwr\u00f3ci\u0107 wszystkich zarejestrowanych subskrybent\u00f3w. W przysz\u0142ym po\u015bcie u\u017cycie tego stanie si\u0119 znacznie bardziej widoczne, ale na razie zauwa\u017c, \u017ce utworzymy tablic\u0119 dowolnej klasy, kt\u00f3ra jest instancj\u0105 klasy AbstractSubscriber, a<\/strong> nast\u0119pnie zwr\u00f3cimy przefiltrowan\u0105 tablic\u0119.<\/a><\/p>\n W tym momencie mamy pe\u0142n\u0105 klas\u0119<\/a> (wraz z dokumentacj\u0105):<\/p>\n Teraz musimy doda\u0107 go do programu startowego naszej wtyczki.<\/p>\n Jak wspomniano wcze\u015bniej w po\u015bcie, musimy doda\u0107 to do \u0142adowania pocz\u0105tkowego wtyczki. Aby to zrobi\u0107, musimy jednak zdefiniowa\u0107 w\u0142asny filtr, dzi\u0119ki czemu b\u0119dziemy mogli \u0142atwo omin\u0105\u0107 rejestr z reszt\u0105 wtyczki (gdy nadejdzie na to czas).<\/p>\n Jednak zanim to zrobimy, wa\u017cne jest, aby upewni\u0107 si\u0119, \u017ce dobrze radzisz sobie z utworzonym w\u0142a\u015bnie Rejestrem, \u017ce pasuje on do wtyczki i \u017ce \u015bledzisz za pomoc\u0105 ga\u0142\u0119zi<\/a> deweloperskiej, kt\u00f3r\u0105 mamy do tej pory.<\/p>\nTworzenie rejestru<\/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>\nChocia\u017c przed Bootstrapem<\/h2>\n