Implementamos uma quantidade significativa de mudan\u00e7as no WordPress Widget Boilerplate. Se voc\u00ea n\u00e3o tem acompanhado, recomendo come\u00e7ar no in\u00edcio da s\u00e9rie e se atualizar.<\/p>\n
Se, no entanto, voc\u00ea estiver acompanhando e tamb\u00e9m estiver executando algumas das ferramentas de qualidade de c\u00f3digo que examinam o estado do projeto, notar\u00e1 alguns erros no console.<\/p>\n
Normalmente, este \u00e9 o ponto em que recomendo prestar aten\u00e7\u00e3o ao que ele compartilha e depois corrigir o que ele relata, mas ainda n\u00e3o chegamos l\u00e1.<\/p>\n
Por exemplo, alguns dos erros que nossas ferramentas est\u00e3o mostrando agora s\u00e3o baseados no fato de termos vari\u00e1veis \u200b\u200bn\u00e3o utilizadas. Claro, esse \u00e9 o caso, porque ainda n\u00e3o come\u00e7amos a construir um widget.<\/p>\n
Mas ainda existem algumas classes concretas que precisamos implementar.<\/p>\n
Um dos problemas que ainda existem no c\u00f3digo como est\u00e1 agora \u00e9 que o construtor do widget est\u00e1 registrando fun\u00e7\u00f5es e isso n\u00e3o \u00e9 uma coisa boa.<\/p>\n
O objetivo de um construtor \u00e9 definir os valores das propriedades da classe, n\u00e3o implementar nenhum tipo de l\u00f3gica. Isso ocorre por alguns motivos:<\/p>\n
A maneira de lidar com isso \u00e9 dupla:<\/p>\n
Nos pr\u00f3ximos tr\u00eas posts:<\/p>\n
Antes de escrever o c\u00f3digo para o Registro, \u00e9 importante observar qual \u00e9 seu objetivo principal. Simplificando, a classe deve conter uma refer\u00eancia a qualquer classe que esteja registrada com ela.<\/p>\n
Isso \u00e9 feito passando uma refer\u00eancia a um determinado objeto para uma fun\u00e7\u00e3o e tamb\u00e9m ligando-o a uma chave para que possamos recuper\u00e1-lo facilmente mais tarde.<\/p>\n
Mas h\u00e1 algumas coisas a considerar. Por exemplo:<\/p>\n
se um objeto j\u00e1 existe no registro para uma determinada chave, precisamos lan\u00e7ar uma exce\u00e7\u00e3o – se um usu\u00e1rio tentar pegar um objeto do registro com uma determinada chave, ele deve lan\u00e7ar uma exce\u00e7\u00e3o<\/p>\n
Claro, n\u00e3o necessariamente tem que lan\u00e7ar exce\u00e7\u00f5es. Em vez disso, ele tamb\u00e9m pode exibir mensagens de erro, retornar valores nulos ou vazios ou o que voc\u00ea escolher.<\/p>\n
Em segundo lugar, o registro precisa ser capaz de retornar uma lista de todos os assinantes que est\u00e3o contidos nele para que possam ser registrados no WordPress (que \u00e9 o que veremos no pr\u00f3ximo post).<\/p>\n
Para fazer isso, por\u00e9m, precisamos ter certeza de que ele suporta todos os assinantes e \u00e9 a\u00ed que a no\u00e7\u00e3o do AbstractSubscriber do post anterior<\/a> entra em jogo. Isto \u00e9, desde que uma classe seja uma classe filha daquela classe, ent\u00e3o tudo bem.<\/p>\n Dito isso, vamos planejar o seguinte:<\/p>\n O stub da classe ficar\u00e1 assim:<\/a><\/p>\n Em seguida, podemos definir a propriedade b\u00e1sica<\/a>, um array, e inicializ\u00e1-lo no construtor:<\/p>\n Depois disso, podemos criar o m\u00e9todo add<\/a>. Lembre-se que na minha implementa\u00e7\u00e3o, estou optando por lan\u00e7ar uma exce\u00e7\u00e3o se uma chave j\u00e1 estiver definida, mas voc\u00ea n\u00e3o precisa fazer isso.<\/p>\n Da mesma forma, o m\u00e9todo get<\/a> retornar\u00e1 uma refer\u00eancia \u00e0 inst\u00e2ncia de um objeto identificado com essa chave. Se a chave n\u00e3o estiver definida, ela lan\u00e7ar\u00e1 uma exce\u00e7\u00e3o. Se estiver definido, mas n\u00e3o existir nenhum objeto, retornaremos null.<\/p>\n Finalmente, precisamos de um m\u00e9todo para retornar todos os assinantes registrados. Em um post futuro, o uso para isso ficar\u00e1 muito mais aparente, mas, por enquanto, observe que criaremos um array de qualquer classe que seja uma inst\u00e2ncia da classe AbstractSubscriber e<\/strong> , em seguida, retornaremos o array filtrado.<\/a><\/p>\n Neste ponto, temos a classe<\/a> completa (completa com documenta\u00e7\u00e3o):<\/p>\n Agora precisamos adicion\u00e1-lo ao bootstrap do nosso plugin.<\/p>\n Como mencionado anteriormente no post, precisamos adicionar isso ao bootstrap do plugin. Para fazer isso, por\u00e9m, precisamos definir nosso pr\u00f3prio filtro para que possamos passar facilmente o registro pelo resto do plugin (quando chegar a hora de fazer isso).<\/p>\n Antes de fazermos isso, por\u00e9m, \u00e9 importante ter certeza de que voc\u00ea tem um bom controle sobre o Registro que acabamos de criar, que ele se encaixa no plug-in e que voc\u00ea est\u00e1 rastreando com a ramifica\u00e7\u00e3o de desenvolvimento<\/a> que temos at\u00e9 agora.<\/p>\nCriando o 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>\nAntes do Bootstrap, embora<\/h2>\n