Kaikki n\u00e4m\u00e4 vaikuttavat siihen, mit\u00e4 aiomme tehd\u00e4 t\u00e4n\u00e4\u00e4n.<\/p>\n
WordPress Widget Boilerplate: Refactoring, osa 7<\/h2>\n
Ne, jotka ovat perehtyneet WordPress Widgets -sovellusliittym\u00e4\u00e4n<\/a>, tiet\u00e4v\u00e4t todenn\u00e4k\u00f6isesti, ett\u00e4 se ei ole juurikaan muuttunut viime vuosina.<\/p>\n Lis\u00e4ksi se koostuu oikeastaan \u200b\u200bvain nelj\u00e4st\u00e4 funktiosta (joista yksi on rakentaja):<\/p>\n Mukava asia on, ett\u00e4 t\u00e4m\u00e4 erityinen l\u00e4hestymistapa saavutetaan perim\u00e4ll\u00e4 WP_Widget-<\/a> luokan toiminnallisuus.<\/p>\n Ongelmana on kuitenkin se, ett\u00e4 yhdell\u00e4 luokalla on paljon ty\u00f6t\u00e4.<\/p>\n Sen sijaan meid\u00e4n pit\u00e4isi erottaa jokainen toiminto omaan toiminta-alueeseensa.<\/p>\n Kuten miss\u00e4 tahansa ohjelmoinnissa, on olemassa tapoja, joilla jotkut asiat ovat selkeit\u00e4, kuinka ne voidaan tehd\u00e4, ja sitten on joitain asioita, jotka voidaan tehd\u00e4 useilla tavoilla.<\/p>\n Aion esitt\u00e4\u00e4 sen, miten suhtaudun siihen t\u00e4ll\u00e4 hetkell\u00e4. T\u00e4m\u00e4 voi muuttua tulevaisuudessa tai ehk\u00e4 ei, ja muut voivat suhtautua asiaan eri tavalla.<\/p>\n Siit\u00e4 huolimatta toteutus tulee olemaan paljon oliokeskeisempi ja antaa jokaiselle luokalle omat vastuunsa.<\/p>\n Ensimm\u00e4inen kysymys kuitenkin on, kuinka jaetaan luokka, jossa on nelj\u00e4 funktiota ja joka perii yl\u00e4luokan?<\/p>\n Ensinn\u00e4kin, meid\u00e4n on s\u00e4\u00e4dett\u00e4v\u00e4 joitain asioita laajennuksen k\u00e4ynnistyspalkissa. Nimitt\u00e4in meid\u00e4n on teht\u00e4v\u00e4 seuraava:<\/p>\n T\u00e4ss\u00e4 on katsaus kaikkiin kolmeen yll\u00e4 olevaan.<\/p>\n Koska olemme k\u00e4sitelleet t\u00e4t\u00e4 jo aiemmin sarjassa, pit\u00e4isi olla selv\u00e4\u00e4, kuinka t\u00e4m\u00e4 tehd\u00e4\u00e4n.<\/p>\n Katso ensin seuraava koodi<\/a> :<\/p>\n Huomaa seuraavaksi, ett\u00e4 luomme rekisterin (puhumme sen nimiavaruudesta hetkellisesti) ja liit\u00e4mme sen sitten mukautettuun suodattimeen, jonka avulla voimme k\u00e4ytt\u00e4\u00e4 sit\u00e4 koko laajennuksen aikana milloin tahansa.<\/p>\n Seuraavaksi meid\u00e4n on p\u00e4ivitett\u00e4v\u00e4 ydinlaajennusluokka (joka sijaitsee src<\/strong> – hakemistossa) niin, ett\u00e4 se viittaa rekisteriin ja lataa kaikki rekister\u00f6idyt tilaajat<\/a> :<\/p>\n Huomaa kuitenkin, ett\u00e4 emme ole viel\u00e4 m\u00e4\u00e4ritt\u00e4neet yht\u00e4\u00e4n tilaajaa. Aloitimme t\u00e4m\u00e4n aiemmin sarjassa ja nyt on aika palata siihen, mutta teemme sen my\u00f6hemmin.<\/p>\n Meid\u00e4n on kuitenkin lis\u00e4tt\u00e4v\u00e4 funktio<\/a> \u2013 vaikka se olisikin v\u00e4liaikainen \u2013 jotta voimme lis\u00e4t\u00e4 luokkia, jotka eiv\u00e4t ole eksplisiittisi\u00e4 tapahtuman tilaajia:<\/p>\n T\u00e4t\u00e4 muokataan my\u00f6hemmin, koska muutamme ydinluokat tilaajiksi my\u00f6hemmin.<\/p>\n Ennen kuin jatkat, mielest\u00e4ni on t\u00e4rke\u00e4\u00e4 tarkistaa bootstrap. Vaikka otsikkosi ja dokumentaatiosi voivat vaihdella, on t\u00e4rke\u00e4\u00e4 huomata, ett\u00e4 teemme seuraavat asiat:<\/p>\n Se kuulostaa paljon, mutta koodi on melko lyhyt<\/a> :<\/p>\n T\u00e4ss\u00e4 vaiheessa on kuitenkin aika tarkastella, millaista on jakaa aliluokka tavallisesta Widgets API<\/a> :sta johonkin, joka sopii k\u00e4ytett\u00e4v\u00e4\u00e4n koodimalliin.<\/p>\n T\u00e4m\u00e4 osa kattaa todenn\u00e4k\u00f6isesti muutaman postauksen, koska ty\u00f6t\u00e4 on v\u00e4h\u00e4n, mutta aloitamme luomalla oman widget-luokkamme, joka perii peruswidget-luokan.<\/p>\n Tee ensin API<\/strong> -hakemisto src<\/strong> – hakemistoon ja lis\u00e4\u00e4 tiedosto nimelt\u00e4 Widget.php<\/strong>. T\u00e4ss\u00e4 ovat widgetin perusteet. K\u00e4sittelemme hallinnollisia ja julkisia tyylisivuja ja JavaScript-tiedostoja seuraavassa viestiss\u00e4.<\/p>\n T\u00e4ss\u00e4 vaiheessa tiedoston perusasioiden pit\u00e4isi n\u00e4ytt\u00e4\u00e4 t\u00e4lt\u00e4<\/a> :<\/p>\n Huomaa, ett\u00e4 se vaatii yhden argumentin. Olen k\u00e4ytt\u00e4nyt widgetin nimi, mutta voit k\u00e4ytt\u00e4\u00e4 mit\u00e4 tahansa, kunhan se edustaa widgetti\u00e4si.<\/p>\n T\u00e4m\u00e4 osoittaa, ett\u00e4 luokkaa instantoidaan ja ladataan oikein, kun laajennus aktivoidaan. Jos et n\u00e4e t\u00e4t\u00e4, jokin on vialla (jotka tarkistamme hetken).<\/p>\n Seuraavaksi on t\u00e4rke\u00e4\u00e4 varmistaa, ett\u00e4 t\u00e4m\u00e4 luokka on lis\u00e4tty rekisteriin. Joten lis\u00e4\u00e4 seuraavat koodirivit bootstrapiin:<\/a><\/p>\n Ja nyt, kun aktivoit laajennuksen, sinun pit\u00e4isi n\u00e4hd\u00e4 seuraava:<\/p>\n\n
Bootstrapin p\u00e4ivitys<\/h3>\n
\n
1 Luo rekisteri<\/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 P\u00e4ivit\u00e4 Plugin Class<\/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 Tarkista 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>\nLapsiluokan jakaminen<\/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
![\"WordPress-widgetit:](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-160983-61e7189c9c671.png\")
<\/a><\/p>\n