Vi har implementerat en betydande m\u00e4ngd \u00e4ndringar i WordPress Widget Boilerplate. Om du inte har f\u00f6ljt med rekommenderar jag att b\u00f6rja i b\u00f6rjan av serien och komma ikapp.<\/p>\n
Om du d\u00e4remot har f\u00f6ljt med och du ocks\u00e5 k\u00f6r n\u00e5gra av kodkvalitetsverktygen som unders\u00f6ker projektets tillst\u00e5nd, kommer du att m\u00e4rka en handfull fel i konsolen.<\/p>\n
Normalt \u00e4r det h\u00e4r punkten d\u00e4r jag rekommenderar att du \u00e4r uppm\u00e4rksam p\u00e5 vad den delar och sedan fixar vad den rapporterar, men vi \u00e4r inte d\u00e4r \u00e4n.<\/p>\n
Till exempel \u00e4r n\u00e5gra av de fel som v\u00e5ra verktyg visar just nu baserade p\u00e5 att vi har oanv\u00e4nda variabler. Naturligtvis \u00e4r det dock s\u00e5, eftersom vi inte har b\u00f6rjat bygga en widget.<\/p>\n
Men det finns fortfarande n\u00e5gra konkreta klasser vi beh\u00f6ver implementera.<\/p>\n
Ett av problemen som fortfarande finns i koden som den ser ut just nu \u00e4r att widgetens konstruktor registrerar funktioner och det \u00e4r inte bra.<\/p>\n
Syftet med en konstruktor \u00e4r att st\u00e4lla in v\u00e4rdena f\u00f6r klassens egenskaper, inte att implementera n\u00e5gon typ av logik. Detta \u00e4r av n\u00e5gra anledningar:<\/p>\n
S\u00e4ttet att hantera detta \u00e4r tv\u00e5delat:<\/p>\n
Under de kommande tre inl\u00e4ggen:<\/p>\n
Innan du skriver koden f\u00f6r registret \u00e4r det viktigt att notera vad dess prim\u00e4ra syfte \u00e4r. Enkelt uttryckt \u00e4r klassen menad att inneh\u00e5lla en referens till vilken klass som helst som \u00e4r, ahem, registrerad med den.<\/p>\n
Detta g\u00f6rs genom att skicka en referens till ett givet objekt till en funktion och \u00e4ven binda det till en nyckel s\u00e5 att vi enkelt kan h\u00e4mta det senare.<\/p>\n
Men det finns n\u00e5gra saker att t\u00e4nka p\u00e5. Till exempel:<\/p>\n
om ett objekt redan finns i registret f\u00f6r en given nyckel, d\u00e5 m\u00e5ste vi kasta ett undantag – om en anv\u00e4ndare f\u00f6rs\u00f6ker ta ett objekt fr\u00e5n registret med en given nyckel, s\u00e5 b\u00f6r den kasta ett undantag<\/p>\n
Naturligtvis beh\u00f6ver det inte n\u00f6dv\u00e4ndigtvis ge undantag. Ist\u00e4llet kan den ocks\u00e5 visa felmeddelanden, returnera null eller tomma v\u00e4rden, eller vad du \u00e4n v\u00e4ljer.<\/p>\n
F\u00f6r det andra m\u00e5ste registret kunna returnera en lista \u00f6ver alla prenumeranter som finns i det s\u00e5 att de kan registreras med WordPress (vilket \u00e4r vad vi kommer att se i n\u00e4sta inl\u00e4gg).<\/p>\n
F\u00f6r att g\u00f6ra detta m\u00e5ste vi dock se till att det st\u00f6der alla prenumeranter och det \u00e4r h\u00e4r begreppet abstrakt prenumerant fr\u00e5n det tidigare inl\u00e4gget<\/a> kommer in i bilden. Det vill s\u00e4ga, s\u00e5 l\u00e4nge en klass \u00e4r en barnklass i den klassen, s\u00e5 \u00e4r vi okej.<\/p>\n Med det sagt, l\u00e5t oss planera f\u00f6ljande:<\/p>\n Stubben f\u00f6r klassen kommer att se ut ungef\u00e4r s\u00e5 h\u00e4r:<\/a><\/p>\n D\u00e4refter kan vi definiera den grundl\u00e4ggande egenskapen<\/a>, en array, och initiera den i konstruktorn:<\/p>\n Efter det kan vi skapa add-metoden<\/a>. Kom ih\u00e5g att i min implementering v\u00e4ljer jag att g\u00f6ra ett undantag om en nyckel redan \u00e4r definierad, men du beh\u00f6ver inte g\u00f6ra det.<\/p>\n P\u00e5 samma s\u00e4tt kommer get-metoden<\/a> att returnera en referens till instansen av ett objekt som identifieras med den nyckeln. Om nyckeln inte \u00e4r inst\u00e4lld kommer det att skapa ett undantag. Om det \u00e4r inst\u00e4llt, men inget objekt existerar, returnerar vi null.<\/p>\n Slutligen beh\u00f6ver vi en metod f\u00f6r att returnera alla registrerade prenumeranter. I ett framtida inl\u00e4gg kommer anv\u00e4ndningen av detta att bli mycket mer uppenbar, men f\u00f6r nu, notera att vi kommer att skapa en array av alla klasser som \u00e4r en instans av klassen AbstractSubscriber<\/strong> och sedan returnerar vi den filtrerade arrayen.<\/a><\/p>\n Vid det h\u00e4r laget har vi hela klassen<\/a> (komplett med dokumentation):<\/p>\n Nu m\u00e5ste vi l\u00e4gga till det i bootstrap f\u00f6r v\u00e5rt plugin.<\/p>\n Som n\u00e4mnts tidigare i inl\u00e4gget m\u00e5ste vi l\u00e4gga till detta till pluginets bootstrap. F\u00f6r att g\u00f6ra detta m\u00e5ste vi dock definiera v\u00e5rt eget filter s\u00e5 att vi enkelt kan skicka registret runt resten av pluginet (n\u00e4r det \u00e4r dags att g\u00f6ra det).<\/p>\n Innan vi g\u00f6r det \u00e4r det dock viktigt att se till att du har ett bra grepp om registret vi just har skapat, att det passar in i pluginet och att du sp\u00e5rar med utvecklingsgrenen<\/a> som vi har hittills.<\/p>\nSkapar registret<\/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>\nF\u00f6re Bootstrap, dock<\/h2>\n