Wszystko to odegra pewn\u0105 rol\u0119 w tym, co zrobimy dzisiaj.<\/p>\n
WordPress Widget Boilerplate: Refaktoryzacja, cz\u0119\u015b\u0107 7<\/h2>\n
Ci, kt\u00f3rzy s\u0105 zaznajomieni z API WordPress Widgets<\/a>, prawdopodobnie wiedz\u0105, \u017ce nie zmieni\u0142 si\u0119 on zbytnio w ci\u0105gu ostatnich kilku lat.<\/p>\n Co wi\u0119cej, tak naprawd\u0119 sk\u0142ada si\u0119 tylko z czterech funkcji (z kt\u00f3rych jedn\u0105 jest konstruktor):<\/p>\n Mi\u0142\u0105 rzecz\u0105 jest to, \u017ce to szczeg\u00f3lne podej\u015bcie jest osi\u0105gane poprzez dziedziczenie funkcjonalno\u015bci klasy WP_Widget<\/a>.<\/p>\n Problem polega jednak na tym, \u017ce jedna klasa to du\u017co pracy.<\/p>\n Zamiast tego powinni\u015bmy rozdzieli\u0107 ka\u017cd\u0105 z funkcji na jej w\u0142asny obszar funkcjonalno\u015bci.<\/p>\n Podobnie jak w przypadku wszystkiego w programowaniu, b\u0119d\u0105 sposoby, w kt\u00f3rych pewne rzeczy b\u0119d\u0105 jasne, jak mo\u017cna je wykona\u0107, a tak\u017ce b\u0119d\u0105 pewne rzeczy, kt\u00f3re mo\u017cna zrobi\u0107 na wiele sposob\u00f3w.<\/p>\n Zaprezentuj\u0119, jak do tego podchodz\u0119 na razie. Mo\u017ce si\u0119 to zmieni\u0107 w przysz\u0142o\u015bci, a mo\u017ce nie, a inni mog\u0105 mie\u0107 na to inne podej\u015bcie.<\/p>\n Niezale\u017cnie od tego implementacja b\u0119dzie znacznie bardziej zorientowana obiektowo i da ka\u017cdej klasie w\u0142asny zestaw obowi\u0105zk\u00f3w.<\/p>\n Pierwsze pytanie brzmi jednak, jak podzieli\u0107 klas\u0119 z czterema funkcjami, kt\u00f3ra dziedziczy po klasie nadrz\u0119dnej?<\/p>\n Po pierwsze, jest kilka rzeczy, kt\u00f3re musimy dostosowa\u0107 w programie startowym wtyczki. Mianowicie musimy wykona\u0107 nast\u0119puj\u0105ce czynno\u015bci:<\/p>\n Oto spojrzenie na wszystkie trzy z powy\u017cszych.<\/p>\n Poniewa\u017c om\u00f3wili\u015bmy to ju\u017c wcze\u015bniej w serii, powinno by\u0107 jasne, jak to zrobi\u0107.<\/p>\n Najpierw zobacz nast\u0119puj\u0105cy kod<\/a> :<\/p>\n Nast\u0119pnie zauwa\u017c, \u017ce tworzymy instancj\u0119 Rejestru (za chwil\u0119 porozmawiamy o jego przestrzeni nazw), a nast\u0119pnie pod\u0142\u0105czamy go do niestandardowego filtra, kt\u00f3ry umo\u017cliwia nam dost\u0119p do niego przez ca\u0142\u0105 wtyczk\u0119, kiedy tylko chcemy.<\/p>\n Nast\u0119pnie musimy zaktualizowa\u0107 podstawow\u0105 klas\u0119 wtyczki (znajduj\u0105c\u0105 si\u0119 w\u00a0 katalogu src<\/strong> ), aby odwo\u0142ywa\u0142a si\u0119 do rejestru i \u0142adowa\u0142a wszystkich zarejestrowanych subskrybent\u00f3w<\/a> :<\/p>\n Pami\u0119taj jednak, \u017ce tak naprawd\u0119 nie skonfigurowali\u015bmy jeszcze \u017cadnych subskrybent\u00f3w. Zacz\u0119li\u015bmy to wcze\u015bniej w serii i teraz nadszed\u0142 czas, aby do tego wr\u00f3ci\u0107, ale zrobimy to p\u00f3\u017aniej.<\/p>\n Musimy jednak doda\u0107 funkcj\u0119<\/a> \u2013 nawet tymczasow\u0105 \u2013 aby\u015bmy mogli doda\u0107 klasy, kt\u00f3re nie s\u0105 jawnymi subskrybentami zdarze\u0144:<\/p>\n Zostanie to przerobione p\u00f3\u017aniej, poniewa\u017c p\u00f3\u017aniej b\u0119dziemy przekszta\u0142ca\u0107 podstawowe klasy w subskrybent\u00f3w.<\/p>\n Zanim przejdziemy dalej, my\u015bl\u0119, \u017ce wa\u017cne jest, aby przejrze\u0107 bootstrap. Chocia\u017c Tw\u00f3j nag\u0142\u00f3wek i dokumentacja mog\u0105 si\u0119 r\u00f3\u017cni\u0107, wa\u017cne jest, aby pami\u0119ta\u0107, \u017ce wykonujemy nast\u0119puj\u0105ce czynno\u015bci:<\/p>\n Brzmi to du\u017co, ale kod jest do\u015b\u0107 kr\u00f3tki<\/a> :<\/p>\n W tym momencie jednak nadszed\u0142 czas, aby przyjrze\u0107 si\u0119, jak to jest podzieli\u0107 klas\u0119 potomn\u0105 ze standardowego interfejsu API wid\u017cet\u00f3w<\/a> na co\u015b, co pasuje do modelu kodu, z kt\u00f3rym pracujemy.<\/p>\n Ta cz\u0119\u015b\u0107 prawdopodobnie obejmie kilka post\u00f3w, poniewa\u017c jest troch\u0119 pracy do wykonania, ale zaczniemy od stworzenia w\u0142asnej klasy wid\u017cet\u00f3w, kt\u00f3ra b\u0119dzie dziedziczy\u0107 po podstawowej klasie wid\u017cet\u00f3w.<\/p>\n Najpierw stw\u00f3rz\u00a0 katalog API<\/strong> w katalogu src<\/strong> i dodaj plik o nazwie Widget.php<\/strong>. Tutaj b\u0119d\u0105 znajdowa\u0107 si\u0119 podstawy wid\u017cetu. W nast\u0119pnym po\u015bcie zajmiemy si\u0119 administracyjnymi i publicznymi arkuszami styl\u00f3w oraz plikami JavaScript.<\/p>\n W tym momencie podstawy pliku powinny wygl\u0105da\u0107 tak<\/a> :<\/p>\n Zauwa\u017c, \u017ce zajmuje jeden argument. U\u017cy\u0142em nazwy wid\u017cetu, ale mo\u017cesz u\u017cy\u0107 tego, co chcesz, o ile reprezentuje tw\u00f3j wid\u017cet.<\/p>\n Ma to na celu pokazanie, \u017ce klasa jest poprawnie tworzona i \u0142adowana, gdy wtyczka jest aktywowana. Je\u015bli tego nie widzisz, oznacza to, \u017ce co\u015b jest nie tak (co za chwil\u0119 sprawdzimy).<\/p>\n Nast\u0119pnie wa\u017cne jest, aby upewni\u0107 si\u0119, \u017ce ta klasa zosta\u0142a dodana do Rejestru. Dodaj wi\u0119c nast\u0119puj\u0105ce wiersze kodu w bootstrapie:<\/a><\/p>\n A teraz, kiedy aktywujesz wtyczk\u0119, powiniene\u015b zobaczy\u0107:<\/p>\n\n
Aktualizacja Bootstrapa<\/h3>\n
\n
1 Utw\u00f3rz instancj\u0119 rejestru<\/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 Zaktualizuj klas\u0119 wtyczki<\/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 Przejrzyj 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>\nDzielenie klasy dziecka<\/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
![\"Wid\u017cety](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-160983-61e7189c9c671.png\")
<\/a><\/p>\n