I f\u00f6rra inl\u00e4gget gick vi igenom en hel del refaktorering som separerade bekymmer i sina egna klasser.<\/p>\n
I slut\u00e4ndan hj\u00e4lper detta att visa hur vi kan bibeh\u00e5lla en h\u00f6g niv\u00e5 av sammanh\u00e5llning samtidigt som vi inte bara arbetar med klasser i WordPress utan g\u00f6r det tillsammans med redan existerande API:er.<\/p>\n
Eftersom de senaste inl\u00e4ggen om omstrukturering av kodbasen har varit s\u00e5 l\u00e5nga, \u00e4r den nuvarande upps\u00e4ttningen av inl\u00e4gg fokuserad p\u00e5 sm\u00e5, inkrementella f\u00f6r\u00e4ndringar och d\u00e4rmed kortare, mer fokuserade inl\u00e4gg.<\/p>\n
Som n\u00e4mndes i f\u00f6reg\u00e5ende artikel:<\/p>\n
\nMen om du uppdaterar sidan kanske du m\u00e4rker att saneringen och serialiseringen inte verkar fungera n\u00e4r du h\u00e4mtar data. Och det \u00e4r vad vi ska titta p\u00e5 i n\u00e4sta inl\u00e4gg.<\/p>\n<\/blockquote>\n
S\u00e5 det \u00e4r d\u00e4r vi ska ta upp i den h\u00e4r artikeln.<\/p>\n
WordPress Widget Boilerplate: Refactoring del 11<\/h2>\n
Innan du skriver n\u00e5gon kod \u00e4r det f\u00f6rsta att l\u00e4gga m\u00e4rke till att om du fyller i ett av inneh\u00e5llsomr\u00e5dena i widgeten (som titeln) med n\u00e5got s\u00e5 h\u00e4r<\/a> :<\/p>\n
<script type=\"text\/javascript\">This is the Title<\/script><\/code><\/pre>\nOch klicka sedan p\u00e5 Spara, det faktiska inneh\u00e5llet saneras och skrivs till databasen. Du kan se att detta \u00e4r sant genom att titta p\u00e5 widgetens v\u00e4rde i databasen.<\/p>\n
Vidare ser data bra ut vid f\u00f6rsta anblicken, men om du uppdaterar sidan visas det osaniserade inneh\u00e5llet. Om du navigerar till en annan sida, som Menyer, och sedan kommer tillbaka, visas widgetinneh\u00e5llet men ordentligt sanerat.<\/p>\n
Varf\u00f6r visar det d\u00e5 en sak i databasen och en sak p\u00e5 administrationsomr\u00e5dets front-end n\u00e4r man utf\u00f6r vissa steg?<\/p>\n
Detta har att g\u00f6ra med widget-cachen och lyckligtvis kan vi spola denna cache efter behag med hj\u00e4lp av vilka krokar vi vill (det vill s\u00e4ga vi kan prenumerera p\u00e5 vilken h\u00e4ndelse som helst och sedan f\u00e5 den att spola cachen).<\/p>\n<\/p>\n
Fr\u00e5n kodreferensen<\/a> :<\/p>\n
\nTar bort cacheminneh\u00e5llet som matchar nyckel och grupp.<\/p>\n<\/blockquote>\n
Observera dock att det kr\u00e4ver att vi tillhandah\u00e5ller nyckeln och en valfri grupp. I Boilerplate har vi anv\u00e4nt widgetens slug som nyckeln och gruppen \u00e4r widget.<\/p>\n
Rensa cachen<\/h3>\n
Eftersom funktionen kan kopplas till vilket event som helst kan vi skapa en prenumerant som vi kan koppla till vilket event som helst. Det betyder att vi kan skapa DeleteWidgetCache-prenumeranter i v\u00e5rt namnomr\u00e5de f\u00f6r prenumeranter:<\/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>\nVi kommer sedan att uppdatera bootstrap<\/a> f\u00f6r att l\u00e4gga till prenumeranten i registret och vi kommer att anv\u00e4nda en anpassad hook, flush_widget_cache, som vi kommer att anv\u00e4nda tillf\u00e4lligt.<\/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>\nF\u00f6r syftet med Boilerplate kommer vi att anv\u00e4nda den anpassade h\u00e4ndelsen n\u00e4rhelst widgetens serialiseringskod anropas.<\/p>\n
F\u00f6rst definierar vi ett do_action<\/a> -anrop, identifierar det som flush_widget_cache, och sedan skickar vi de n\u00f6dv\u00e4ndiga argumenten<\/a> till h\u00e4ndelsen s\u00e5 att abonnenten kan l\u00e4sa dem:<\/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