No post anterior, passamos por muitas refatora\u00e7\u00f5es que separavam as preocupa\u00e7\u00f5es em suas pr\u00f3prias classes.<\/p>\n
Em \u00faltima an\u00e1lise, isso ajuda a mostrar como podemos manter um alto n\u00edvel de coes\u00e3o enquanto n\u00e3o apenas trabalhamos com classes no WordPress, mas tamb\u00e9m com APIs pr\u00e9-existentes.<\/p>\n
Como as \u00faltimas postagens sobre refatora\u00e7\u00e3o da base de c\u00f3digo foram t\u00e3o longas, o conjunto atual de postagens est\u00e1 focado em pequenas altera\u00e7\u00f5es incrementais e, portanto, em postagens mais curtas e mais focadas.<\/p>\n
Conforme mencionado no artigo anterior:<\/p>\n
\nMas se voc\u00ea atualizar a p\u00e1gina, poder\u00e1 notar que a sanitiza\u00e7\u00e3o e a serializa\u00e7\u00e3o parecem n\u00e3o funcionar ao recuperar os dados. E \u00e9 isso que veremos no pr\u00f3ximo post.<\/p>\n<\/blockquote>\n
Ent\u00e3o \u00e9 a\u00ed que vamos pegar neste artigo.<\/p>\n
The WordPress Widget Boilerplate: Refatorando Parte 11<\/h2>\n
Antes de escrever qualquer c\u00f3digo, a primeira coisa a notar \u00e9 que se voc\u00ea preencher uma das \u00e1reas de conte\u00fado do widget (como o t\u00edtulo) com algo assim<\/a> :<\/p>\n
<script type=\"text\/javascript\">This is the Title<\/script><\/code><\/pre>\nE, em seguida, clique em Salvar, o conte\u00fado real ser\u00e1 higienizado e gravado no banco de dados. Voc\u00ea pode ver que isso \u00e9 verdade observando o valor do widget no banco de dados.<\/p>\n
Al\u00e9m disso, os dados parecem bons \u00e0 primeira vista, mas se voc\u00ea atualizar a p\u00e1gina, o conte\u00fado n\u00e3o limpo aparecer\u00e1. Se voc\u00ea navegar para outra p\u00e1gina, como Menus, e depois voltar, o conte\u00fado do widget aparecer\u00e1, mas devidamente higienizado.<\/p>\n
Por que, ent\u00e3o, ele mostra uma coisa no banco de dados e uma coisa no front-end da \u00e1rea de administra\u00e7\u00e3o ao executar determinadas etapas?<\/p>\n
Isso tem a ver com o cache do widget e, felizmente, podemos liberar esse cache \u00e0 vontade usando os ganchos que quisermos (ou seja, podemos assinar qualquer evento e fazer com que ele libere o cache).<\/p>\n<\/p>\n
Da refer\u00eancia de c\u00f3digo<\/a> :<\/p>\n
\nRemove a chave e o grupo correspondentes ao conte\u00fado do cache.<\/p>\n<\/blockquote>\n
Observe, no entanto, que isso requer que forne\u00e7amos a chave e um grupo opcional. No Boilerplate, usamos o slug do widget como a chave e o grupo \u00e9 widget.<\/p>\n
Limpando o Cache<\/h3>\n
Como a fun\u00e7\u00e3o pode ser vinculada a qualquer evento, podemos criar um assinante que podemos vincular a qualquer evento. Isso significa que podemos criar um assinante DeleteWidgetCache em nosso namespace Subscriber:<\/a><\/p>\n
<?php\n\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 WordPressWidgetBoilerplateSubscriber;\n\n\/**\n * Deletes the cached contents of the widget.\n *\/\nclass DeleteWidgetCacheSubscriber extends AbstractSubscriber\n{\n \/**\n * {@inheritdoc}\n *\/\n public function __construct(string $hook)\n {\n parent::__construct($hook);\n }\n\n \/**\n * Flushes the widget's cache based on the key that's specified in the function arguments.\n *\/\n public function load()\n {\n \/* Because we're implementing an abstract class, we'll parse arguments from the\n * func_get_args().\n *\/\n $args = func_get_args();\n if (!$this->hasValidArguments($args)) {\n return;\n }\n\n \/\/ TODO: More to come...\n }\n\n \/**\n * Verifies that we have valid arguments with which to work.\n *\n * @param array $args the array of arguments we are validating\n *\n * @return bool true if the arguments are valid; otherwise, false\n *\/\n private function hasValidArguments(array $args): bool\n {\n \/\/ First, check the initial index of the arguments.\n if (!isset($args[0])) {\n return false;\n }\n\n \/\/ Next, check the values of the arguments for the widget key and group.\n $args = $args[0];\n if (!isset($args[0]) && !isset($args[1])) {\n return false;\n }\n\n return true;\n }\n}\n<\/code><\/pre>\nEm seguida, atualizaremos o bootstrap<\/a> para adicionar o assinante ao registro e usaremos um gancho personalizado, flush_widget_cache, que usaremos momentaneamente.<\/p>\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;\nuse WordPressWidgetBoilerplateSubscriberWidgetSubscriber;\nuse WordPressWidgetBoilerplateSubscriberDeleteWidgetCacheSubscriber;\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\/\/ Add subscribers.\n$registry->add('deleteWidgetCacheSubscriber', new DeleteWidgetCacheSubscriber('flush_widget_cache'));\n\n\/\/ Add the Widget base class to the Registry.\n$registry->add('widgetSubscriber', new WidgetSubscriber('widgets_init'));\n\n\/\/ Start the machine.\n(new Plugin($registry))->start();\n<\/code><\/pre>\nPara os prop\u00f3sitos do Boilerplate, usaremos o evento customizado sempre que o c\u00f3digo de serializa\u00e7\u00e3o do widget for chamado.<\/p>\n
Primeiro, vamos definir uma\u00a0 chamada do_action<\/a>, identific\u00e1-la como flush_widget_cache e, em seguida , passar os argumentos necess\u00e1rios<\/a> para o evento para que o assinante possa l\u00ea-los:<\/p>\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 WordPressWidgetBoilerplateWordPress;\n\n\/**\n * Santiizes and saves the data for the widget.\n *\/\nclass WidgetSerializer\n{\n \/**\n * @var string a reference to the slug of the widget to which the serialier is associated\n *\/\n private $widgetSlug;\n\n \/**\n * Initializes the class.\n *\n * @param string a reference to the slug of the widget to which the serialier is associated\n *\/\n public function __construct(string $widgetSlug)\n {\n $this->widgetSlug = $widgetSlug;\n }\n\n \/**\n * Updates the values of the widget. Sanitizes the information before saving it.\n *\n * @param array $newInstance the array of new options to save\n *\/\n public function update($newInstance)\n {\n $instance = [];\n foreach ($newInstance as $key => $value) {\n $instance[$key] = strip_tags(\n stripslashes($value)\n );\n }\n\n do_action('flush_widget_cache', [$this->widgetSlug, 'widget']);\n\n return $instance;\n }\n}\n<\/code><\/pre>\n