Tudo isso vai desempenhar um papel no que vamos fazer hoje.<\/p>\n
The WordPress Widget Boilerplate: Refatora\u00e7\u00e3o, Parte 7<\/h2>\n
Para aqueles que est\u00e3o familiarizados com o WordPress Widgets API<\/a>, ent\u00e3o voc\u00ea provavelmente sabe que n\u00e3o mudou muito nos \u00faltimos anos.<\/p>\n Al\u00e9m disso, ele realmente consiste apenas em quatro fun\u00e7\u00f5es (uma das quais \u00e9 o construtor):<\/p>\n O bom \u00e9 que essa abordagem espec\u00edfica \u00e9 alcan\u00e7ada herdando uma funcionalidade para a classe WP_Widget<\/a>.<\/p>\n O problema, por\u00e9m, \u00e9 que \u00e9 muito trabalho para uma \u00fanica classe fazer.<\/p>\n Em vez disso, devemos separar cada uma das fun\u00e7\u00f5es em sua pr\u00f3pria \u00e1rea de funcionalidade.<\/p>\n Como acontece com qualquer coisa na programa\u00e7\u00e3o, haver\u00e1 maneiras pelas quais algumas coisas ser\u00e3o claras sobre como podem ser feitas e, em seguida, algumas coisas poder\u00e3o ser feitas de v\u00e1rias maneiras.<\/p>\n O que vou apresentar \u00e9 como estou abordando isso por enquanto. Isso pode mudar no futuro, ou talvez n\u00e3o, e outros podem ter uma opini\u00e3o diferente sobre isso.<\/p>\n Independentemente disso, a implementa\u00e7\u00e3o ser\u00e1 muito mais orientada a objetos e dar\u00e1 a cada classe seu pr\u00f3prio conjunto de responsabilidades.<\/p>\n A primeira pergunta, por\u00e9m, \u00e9 como dividir uma classe com quatro fun\u00e7\u00f5es e que herda de uma classe pai?<\/p>\n Primeiro, h\u00e1 algumas coisas que precisamos ajustar no bootstrap do plugin. Ou seja, precisamos fazer o seguinte:<\/p>\n Aqui est\u00e1 uma olhada em todos os tr\u00eas acima.<\/p>\n Como j\u00e1 abordamos isso no in\u00edcio da s\u00e9rie, deve ficar claro como fazer isso.<\/p>\n Primeiramente, veja o seguinte c\u00f3digo<\/a> :<\/p>\n Em seguida, observe que estamos instanciando o Registro (falaremos sobre seu namespace momentaneamente) e, em seguida, estamos conectando-o a um filtro personalizado que nos permite acess\u00e1-lo em todo o plug-in sempre que quisermos.<\/p>\n Em seguida, precisamos atualizar a classe do plugin principal (que reside no\u00a0 diret\u00f3rio src<\/strong>) para que fa\u00e7a refer\u00eancia ao registro e carregue todos os assinantes registrados<\/a> :<\/p>\n Observe, no entanto, que ainda n\u00e3o configuramos nenhum assinante. Come\u00e7amos isso no in\u00edcio da s\u00e9rie e agora \u00e9 hora de voltar, mas faremos isso mais tarde.<\/p>\n No entanto, precisamos adicionar uma fun\u00e7\u00e3o<\/a> \u2013 mesmo que tempor\u00e1ria \u2013 para que possamos adicionar classes que n\u00e3o sejam assinantes de eventos expl\u00edcitos:<\/p>\n Isso ser\u00e1 reformulado posteriormente, pois transformaremos as classes principais em assinantes posteriormente.<\/p>\n Antes de prosseguir, acho importante revisar o bootstrap. Embora o cabe\u00e7alho e a documenta\u00e7\u00e3o possam variar, \u00e9 importante observar que estamos fazendo o seguinte:<\/p>\n Parece muito, mas o c\u00f3digo \u00e9 bem curto<\/a> :<\/p>\n Neste ponto, por\u00e9m, \u00e9 hora de ver como \u00e9 dividir a classe filha da API Widgets<\/a> padr\u00e3o em algo que se encaixe no modelo de c\u00f3digo com o qual estamos trabalhando.<\/p>\n Esta parte provavelmente abranger\u00e1 alguns posts, pois h\u00e1 um pouco de trabalho a ser feito, mas come\u00e7aremos criando nossa pr\u00f3pria classe de widget que herdar\u00e1 da classe Widget base.<\/p>\n Primeiro, v\u00e1 em frente e crie um\u00a0 diret\u00f3rio de API<\/strong> no diret\u00f3rio src<\/strong> e adicione um arquivo chamado Widget.php<\/strong>. \u00c9 aqui que o b\u00e1sico do widget residir\u00e1. Entraremos em folhas de estilo administrativas e p\u00fablicas e arquivos JavaScript na pr\u00f3xima postagem.<\/p>\n Neste ponto, o b\u00e1sico do arquivo deve ficar assim<\/a> :<\/p>\n Observe que ele recebe um \u00fanico argumento. Eu usei o nome do widget, mas voc\u00ea pode usar o que quiser, desde que represente seu widget.<\/p>\n Isso \u00e9 para mostrar que a classe est\u00e1 sendo instanciada e carregada corretamente quando o plugin \u00e9 ativado. Se voc\u00ea n\u00e3o vir isso, algo n\u00e3o est\u00e1 certo (o que revisaremos momentaneamente).<\/p>\n Em seguida, \u00e9 importante garantir que essa classe seja adicionada ao Registro. Ent\u00e3o adicione as seguintes linhas do c\u00f3digo no bootstrap:<\/a><\/p>\n E agora, ao ativar o plugin, voc\u00ea dever\u00e1 ver o seguinte:<\/p>\n\n
Atualizando o Bootstrap<\/h3>\n
\n
1 Instanciar o Registro<\/h3>\n
<?php\n\n\/\/ Setup a filter so we can retrieve the registry throughout the plugin.\n$registry = new Registry();\nadd_filter('wpwBoilerplateRegistry', function() use ($registry) {\n return $registry;\n});<\/code><\/pre>\n2 Atualize a Classe do Plugin<\/h3>\n
<?php\n\n\/*\n * This file is part of WordPress Widget Boilerplate\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 WordPressWidgetBoilerplate;\n\nuse WordPressWidgetBoilerplateUtilitiesRegistry;\n\n\/**\n * The base class for this plugin. Maintains a copy of the registry and starts\n * all of the objects that should hook into WordPress.\n *\/\nclass Plugin\n{\n \/**\n * @var Registry a reference to the simple container used to maintain plugin objects\n *\/\n private $registry;\n\n \/**\n * @param Registry $registry a reference to the simple container used to maintain plugin objects\n *\/\n public function __construct(Registry $registry)\n {\n $this->registry = $registry;\n }\n\n \/**\n * Iterates through each of the subscribers maintained in the registry and registers them\n * to the proper WordPress hook.\n *\/\n public function start()\n {\n array_map(function ($subscriber) {\n add_action($subscriber->getHook(), [$subscriber, 'load']);\n }, $this->registry->getRegisteredSubscribers());\n }\n}<\/code><\/pre>\n<?php\n\/**\n * @return array all of the the objects that aren't subscribers registered with WordPress\n *\/\npublic function getRegisteredObjects()\n{\n $objects = [];\n foreach ($this->registry as $object) {\n if (!$object instanceof AbstractSubscriber) {\n $objects[] = $object;\n }\n }\n\n return array_filter($objects);\n}<\/code><\/pre>\n3 Revise o Bootstrap<\/h3>\n
\n
<?php\n\/**\n * WordPress Widget Boilerplate\n *\n * The WordPress Widget Boilerplate is an organized, maintainable boilerplate for building\n * widgets using WordPress best practices.\n *\n * @package WordPressWidgetBoilerplate\n * @author Your Name <email@example.com>\n * @license GPL-3.0+\n * @link http:\/\/example.com\n * @copyright 2018 - 2019 Your Name or Company Name\n *\n * @wordpress-plugin\n * Plugin Name: WordPress Widget Boilerplate\n * Plugin URI: https:\/\/github.com\/tommcfarlin\/wordpress-widget-boilerplate\n * Description: An object-oriented foundation for building WordPress Widgets.\n * Version: 1.0.0\n * Author: Tom McFarlin\n * Author URI: https:\/\/tommcfarlin.com\n * Text Domain: widget-name\n * License: GPL-3.0+\n * License URI: http:\/\/www.gnu.org\/licenses\/gpl-3.0.txt\n * Domain Path: \/lang\n *\/\n\nnamespace WordPressWidgetBoilerplate;\n\nuse WordPressWidgetBoilerplateUtilitiesRegistry;\nuse WordPressWidgetBoilerplatePlugin;\n\n\/\/ Prevent this file from being called directly.\ndefined('WPINC') || die;\n\n\/\/ Include the autoloader.\nrequire_once __DIR__. '\/vendor\/autoload.php';\n\n\/\/ Setup a filter so we can retrieve the registry throughout the plugin.\n$registry = new Registry();\nadd_filter('wpwBoilerplateRegistry', function() use ($registry) {\n return $registry;\n});\n\n\/\/ Start the machine.\n(new Plugin($registry))->start();\n<\/code><\/pre>\nDividindo uma classe filha<\/h2>\n
<?php\n\n\/*\n * This file is part of WordPress Widget Boilerplate\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 WordPressWidgetBoilerplateAPI;\n\nuse WP_Widget;\n\nclass Widget extends WP_Widget\n{\n \/**\n * @var string unique identifier for your widget\n *\/\n protected $widgetSlug;\n\n \/**\n * Initializes the plugin by setting its properties and calling the parent class with the description.\n *\n * @param mixed $widgetSlug\n *\/\n public function __construct($widgetSlug)\n {\n $this->widgetSlug = $widgetSlug;\n\n \/\/ TODO: update description\n parent::__construct(\n $this->getWidgetSlug(),\n __('Widget Name', $this->getWidgetSlug()),\n [\n 'classname' => $this->getWidgetSlug().'-class',\n 'description' => __('Short description of the widget goes here.', $this->getWidgetSlug()),\n ]\n );\n }\n\n \/**\n * Return the widget slug.\n *\n * @return string slug variable\n *\/\n public function getWidgetSlug()\n {\n return $this->widgetSlug;\n }\n\n \/**\n * TODO: This is a temporary message to show that the Boilerplate has loaded.\n *\/\n public function load()\n {\n $html = '<p style=\"text-align:center; background: #fff; padding: 1em; border: 1px dotted gray; margin: 2em 2em 2em 14em;\">';\n $html .= 'The Widget Boilerplate is loaded.';\n $html .= '<\/p>';\n echo $html;\n }\n}\n<\/code><\/pre>\n<?php\n\n\/\/ Add the Widget base class to the Registry.\n$registry->add('widget', new Widget('widget-name'));<\/code><\/pre>\n
![\"Widgets](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-160983-61e7189c9c671.png\")
<\/a><\/p>\n