Hemos implementado una cantidad significativa de cambios en el modelo est\u00e1ndar de widgets de WordPress. Si no ha estado siguiendo, le recomiendo comenzar desde el principio de la serie y ponerse al d\u00eda.<\/p>\n
Sin embargo, si ha estado siguiendo y tambi\u00e9n est\u00e1 ejecutando algunas de las herramientas de calidad de c\u00f3digo que examinan el estado del proyecto, notar\u00e1 algunos errores en la consola.<\/p>\n
Normalmente, este es el punto en el que recomiendo prestar atenci\u00f3n a lo que comparte y luego corregir lo que informa, pero a\u00fan no hemos llegado all\u00ed.<\/p>\n
Por ejemplo, algunos de los errores que est\u00e1n mostrando nuestras herramientas en este momento se basan en el hecho de que tenemos variables sin usar. Por supuesto, ese es el caso, sin embargo, porque no hemos comenzado a construir un widget.<\/p>\n
Pero todav\u00eda hay algunas clases concretas que debemos implementar.<\/p>\n
Uno de los problemas que a\u00fan existen en el c\u00f3digo tal como est\u00e1 ahora es que el constructor del widget est\u00e1 registrando funciones y esto no es bueno.<\/p>\n
El prop\u00f3sito de un constructor es establecer los valores de las propiedades de la clase, no implementar ning\u00fan tipo de l\u00f3gica. Esto se debe a algunas razones:<\/p>\n
La forma de manejar esto es doble:<\/p>\n
En las siguientes tres publicaciones:<\/p>\n
Antes de escribir el c\u00f3digo para el Registro, es importante tener en cuenta cu\u00e1l es su prop\u00f3sito principal. En pocas palabras, la clase debe contener una referencia a cualquier clase que est\u00e9, ejem, registrada con ella.<\/p>\n
Esto se hace pasando una referencia a un objeto dado a una funci\u00f3n y tambi\u00e9n vincul\u00e1ndola a una clave para que podamos recuperarla f\u00e1cilmente m\u00e1s tarde.<\/p>\n
Pero hay algunas cosas a considerar. Por ejemplo:<\/p>\n
si un objeto ya existe dentro del registro para una clave dada, entonces debemos lanzar una excepci\u00f3n; si un usuario intenta tomar un objeto del registro con una clave dada, entonces deber\u00eda lanzar una excepci\u00f3n<\/p>\n
Por supuesto, no necesariamente tiene que lanzar excepciones. En su lugar, tambi\u00e9n puede mostrar mensajes de error, devolver valores nulos o vac\u00edos, o lo que elija.<\/p>\n
En segundo lugar, el registro debe poder devolver una lista de todos los suscriptores que contiene para que puedan registrarse en WordPress (que es lo que veremos en la pr\u00f3xima publicaci\u00f3n).<\/p>\n
Sin embargo, para hacer esto, debemos asegurarnos de que sea compatible con todos los suscriptores y aqu\u00ed es donde entra en juego la noci\u00f3n de AbstractSubscriber de la publicaci\u00f3n anterior .<\/a> Es decir, mientras una clase sea una clase secundaria de esa clase, entonces estamos bien.<\/p>\n Dicho esto, planeemos lo siguiente:<\/p>\n El resguardo de la clase se ver\u00e1 as\u00ed:<\/a><\/p>\n A continuaci\u00f3n, podemos definir la propiedad b\u00e1sica<\/a>, una matriz, e inicializarla en el constructor:<\/p>\n Despu\u00e9s de eso, podemos crear el m\u00e9todo add<\/a>. Recuerde que en mi implementaci\u00f3n, opt\u00e9 por lanzar una excepci\u00f3n si ya se defini\u00f3 una clave, pero no tiene que hacerlo.<\/p>\n De manera similar, el m\u00e9todo get<\/a> devolver\u00e1 una referencia a la instancia de un objeto identificado con esa clave. Si la clave no est\u00e1 configurada, generar\u00e1 una excepci\u00f3n. Si est\u00e1 configurado, pero no existe ning\u00fan objeto, devolveremos nulo.<\/p>\n Finalmente, necesitamos un m\u00e9todo para devolver todos los suscriptores registrados. En una publicaci\u00f3n futura, el uso de esto ser\u00e1 mucho m\u00e1s evidente, pero por ahora, tenga en cuenta que crearemos una matriz de cualquier clase que sea una instancia de la clase AbstractSubscriber<\/strong> y luego devolveremos la matriz filtrada.<\/a><\/p>\n En este punto, tenemos la clase<\/a> completa (completa con documentaci\u00f3n):<\/p>\n Ahora necesitamos agregarlo al bootstrap de nuestro complemento.<\/p>\n Como se mencion\u00f3 anteriormente en la publicaci\u00f3n, debemos agregar esto al arranque del complemento. Sin embargo, para hacer esto, necesitamos definir nuestro propio filtro para que podamos pasar f\u00e1cilmente el registro por el resto del complemento (cuando llegue el momento de hacerlo).<\/p>\n Sin embargo, antes de hacer eso, es importante asegurarse de que tiene un buen manejo del Registro que acabamos de crear, que encaja en el complemento y que est\u00e1 rastreando con la rama de desarrollo<\/a> que tenemos hasta ahora.<\/p>\nCreando el 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 de Bootstrap, aunque<\/h2>\n