Edellisess\u00e4 postauksessa k\u00e4vimme l\u00e4pi monia uudelleenj\u00e4rjestelyj\u00e4, jotka erottivat huolenaiheet omiin luokkiinsa.<\/p>\n
Viime k\u00e4dess\u00e4 t\u00e4m\u00e4 auttaa osoittamaan, kuinka voimme yll\u00e4pit\u00e4\u00e4 korkeaa koheesion tasoa ty\u00f6skennelless\u00e4mme WordPressin luokkien lis\u00e4ksi my\u00f6s olemassa olevien API:iden kanssa.<\/p>\n
Koska viimeiset viestit koodikannan uudelleenmuodostamisesta ovat olleet niin pitki\u00e4, nykyiset viestit keskittyv\u00e4t pieniin, asteittain tapahtuviin muutoksiin ja siten lyhyempiin, tarkempiin viesteihin.<\/p>\n
Kuten edellisess\u00e4 artikkelissa mainittiin:<\/p>\n
\nMutta jos p\u00e4ivit\u00e4t sivun, saatat huomata, ett\u00e4 desinfiointi ja serialisointi eiv\u00e4t n\u00e4yt\u00e4 toimivan tietoja haettaessa. Ja sit\u00e4 aiomme tarkastella seuraavassa postauksessa.<\/p>\n<\/blockquote>\n
Joten t\u00e4ss\u00e4 artikkelissa poimimme sen.<\/p>\n
WordPress Widget Boilerplate: Refactoring osa 11<\/h2>\n
Ennen kuin kirjoitat mit\u00e4\u00e4n koodia, huomaa ensin, ett\u00e4 jos t\u00e4yt\u00e4t yhden widgetin sis\u00e4lt\u00f6alueista (kuten otsikon) jollain t\u00e4mm\u00f6isell\u00e4<\/a> :<\/p>\n
<script type=\"text\/javascript\">This is the Title<\/script><\/code><\/pre>\nNapsauta sitten Tallenna, todellinen sis\u00e4lt\u00f6 desinfioidaan ja kirjoitetaan tietokantaan. Voit n\u00e4hd\u00e4 t\u00e4m\u00e4n olevan totta katsomalla widgetin arvoa tietokannassa.<\/p>\n
Lis\u00e4ksi tiedot n\u00e4ytt\u00e4v\u00e4t ensi silm\u00e4yksell\u00e4 hyv\u00e4lt\u00e4, mutta jos p\u00e4ivit\u00e4t sivun, puhdistamaton sis\u00e4lt\u00f6 tulee n\u00e4kyviin. Jos siirryt toiselle sivulle, kuten valikot, ja palaat sitten takaisin, widgetin sis\u00e4lt\u00f6 n\u00e4kyy, mutta se on kunnolla desinfioitu.<\/p>\n
Miksi se sitten n\u00e4ytt\u00e4\u00e4 yht\u00e4 asiaa tietokannassa ja yht\u00e4 asiaa hallinta-alueen etuosassa tiettyj\u00e4 vaiheita suoritettaessa?<\/p>\n
T\u00e4m\u00e4 liittyy widget-v\u00e4limuistiin, ja onneksi voimme tyhjent\u00e4\u00e4 t\u00e4m\u00e4n v\u00e4limuistin haluamallamme tavalla k\u00e4ytt\u00e4m\u00e4ll\u00e4 mit\u00e4 tahansa haluamiasi koukkuja (eli voimme tilata mink\u00e4 tahansa tapahtuman ja pyyt\u00e4\u00e4 sen sitten tyhjent\u00e4m\u00e4\u00e4n v\u00e4limuistin).<\/p>\n<\/p>\n
Koodiviittauksesta<\/a>: _<\/p>\n
\nPoistaa v\u00e4limuistin sis\u00e4lt\u00f6\u00e4 vastaavan avaimen ja ryhm\u00e4n.<\/p>\n<\/blockquote>\n
Huomaa kuitenkin, ett\u00e4 se edellytt\u00e4\u00e4 avaimen ja valinnaisen ryhm\u00e4n toimittamista. Boilerplatessa olemme k\u00e4ytt\u00e4neet widgetin etanaa avaimena ja ryhm\u00e4 on widget.<\/p>\n
V\u00e4limuistin tyhjent\u00e4minen<\/h3>\n
Koska toiminto voidaan kytke\u00e4 mihin tahansa tapahtumaan, voimme luoda tilaajan, jonka voimme liitt\u00e4\u00e4 mihin tahansa tapahtumaan. T\u00e4m\u00e4 tarkoittaa , ett\u00e4 voimme luoda DeleteWidgetCache-tilaajan Tilaajan nimiavaruuteen:<\/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>\nP\u00e4ivit\u00e4mme sitten bootstrapin<\/a> lis\u00e4t\u00e4ksemme tilaajan rekisteriin ja k\u00e4yt\u00e4mme mukautettua koukkua, flush_widget_cache, jota k\u00e4yt\u00e4mme hetkellisesti.<\/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>\nBoilerplatea varten k\u00e4yt\u00e4mme mukautettua tapahtumaa aina, kun widgetin serialisointikoodia kutsutaan.<\/p>\n
Ensin m\u00e4\u00e4rit\u00e4mme do_action-<\/a> kutsun, tunnistamme sen flush_widget_cacheksi ja v\u00e4lit\u00e4mme sitten tapahtumalle tarvittavat argumentit<\/a>, jotta tilaaja voi lukea ne:<\/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