Oleme WordPress Widget Boilerplate’is sisse viinud m\u00e4rkimisv\u00e4\u00e4rse hulga muudatusi. Kui te pole j\u00e4lginud, soovitan alustada sarja algusest ja j\u00f5uda j\u00e4rele.<\/p>\n
Kui aga olete seda j\u00e4lginud ja kasutate ka m\u00f5nda koodikvaliteedi t\u00f6\u00f6riista, mis uurib projekti olekut, m\u00e4rkate konsoolis k\u00e4put\u00e4is vigu.<\/p>\n
Tavaliselt on see punkt, kus soovitan p\u00f6\u00f6rata t\u00e4helepanu sellele, mida see jagab, ja seej\u00e4rel parandada k\u00f5ik, mida see teatab, kuid me pole veel seal.<\/p>\n
N\u00e4iteks m\u00f5ned vead, mida meie t\u00f6\u00f6riistad praegu n\u00e4itavad, p\u00f5hinevad asjaolul, et meil on kasutamata muutujaid. Muidugi on see nii, sest me pole alustanud vidina ehitamist.<\/p>\n
Kuid meil on veel m\u00f5ned konkreetsed klassid, mida peame rakendama.<\/p>\n
\u00dcks probleem, mis koodis praegu veel eksisteerib, on see, et vidina konstruktor registreerib funktsioone ja see pole hea.<\/p>\n
Konstruktori eesm\u00e4rk on m\u00e4\u00e4rata klassi omaduste v\u00e4\u00e4rtusi, mitte realiseerida mingit t\u00fc\u00fcpi loogikat. Seda mitmel p\u00f5hjusel:<\/p>\n
Sellega toimetulemiseks on kaks v\u00f5imalust:<\/p>\n
J\u00e4rgmise kolme postituse jooksul:<\/p>\n
Enne registri koodi kirjutamist on oluline m\u00e4rkida, mis on selle peamine eesm\u00e4rk. Lihtsamalt \u00f6eldes on klass m\u00f5eldud sisaldama viidet mis tahes klassile, mis on sellega registreeritud.<\/p>\n
Selleks antakse antud objektile viide funktsioonile ja seotakse see ka v\u00f5tmega, et saaksime selle hiljem h\u00f5lpsasti k\u00e4tte saada.<\/p>\n
Kuid m\u00f5ningaid asju tuleb arvestada. N\u00e4iteks:<\/p>\n
kui antud v\u00f5tme jaoks on registris objekt juba olemas, siis tuleb teha erand \u2013 kui kasutaja \u00fcritab antud v\u00f5tmega registrist objekti haarata, siis peaks ta tegema erandi<\/p>\n
Muidugi ei pea see ilmtingimata erandeid tegema. Selle asemel v\u00f5ib see kuvada ka t\u00f5rketeateid, tagastada null- v\u00f5i t\u00fchjad v\u00e4\u00e4rtused v\u00f5i mida iganes soovite.<\/p>\n
Teiseks peab register suutma tagastada k\u00f5igi selles sisalduvate tellijate loendi, et neid saaks WordPressis registreerida (see on see, mida me j\u00e4rgmises postituses n\u00e4eme).<\/p>\n
Selleks peame aga tagama, et see toetaks k\u00f5iki tellijaid ja siin tuleb m\u00e4ngu eelmise postituse m\u00f5iste AbstractSubscriber.<\/a> See t\u00e4hendab, et seni, kuni klass on selle klassi lasteklass, on k\u00f5ik korras.<\/p>\n Seda arvestades kavandame j\u00e4rgmise:<\/p>\n Klassi t\u00fcnn n\u00e4eb v\u00e4lja umbes selline:<\/a><\/p>\n J\u00e4rgmisena saame m\u00e4\u00e4ratleda p\u00f5hiomaduse<\/a>, massiivi ja l\u00e4htestada selle konstruktoris:<\/p>\n P\u00e4rast seda saame luua lisamismeetodi<\/a>. Pidage meeles, et kui v\u00f5ti on juba m\u00e4\u00e4ratletud, valin ma oma teostuses erandi, kuid te ei pea seda tegema.<\/p>\n Samamoodi tagastab meetod get<\/a> viite selle v\u00f5tmega tuvastatud objekti eksemplarile. Kui v\u00f5tit pole seadistatud, teeb see erandi. Kui see on m\u00e4\u00e4ratud, kuid objekti pole olemas, tagastame null.<\/p>\n L\u00f5puks vajame meetodit k\u00f5igi registreeritud abonentide tagastamiseks. Tulevases postituses muutub selle kasutamine palju selgemaks, kuid praegu pange t\u00e4hele, et loome massiivi mis tahes klassist, mis on klassi AbstractSubscriber<\/strong> eksemplar, ja tagastame seej\u00e4rel filtreeritud massiivi.<\/a><\/p>\n Praegu on meil terve klass<\/a> (koos dokumentatsiooniga):<\/p>\n N\u00fc\u00fcd peame selle lisama oma pistikprogrammi alglaadimisribale.<\/p>\n Nagu postituses varem mainitud, peame selle lisama pistikprogrammi alglaadimisribale. Selleks peame aga m\u00e4\u00e4ratlema oma filtri, et saaksime registrit h\u00f5lpsalt \u00fclej\u00e4\u00e4nud pistikprogrammist m\u00f6\u00f6da saata (kui selleks on aeg).<\/p>\n Enne selle tegemist on aga oluline veenduda, et teil on \u00e4sja loodud registriga hea k\u00e4sitlus, et see sobiks pistikprogrammiga ja et j\u00e4lgiksite arendusharu, mis<\/a> meil seni on olnud.<\/p>\nRegistri loomine<\/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>\nEnne The Bootstrapi siiski<\/h2>\n