Alla dessa kommer att spela en roll i vad vi ska g\u00f6ra idag.<\/p>\n
WordPress Widget Boilerplate: Refactoring, del 7<\/h2>\n
F\u00f6r de som \u00e4r bekanta med WordPress Widgets API<\/a> vet du f\u00f6rmodligen att det inte har f\u00f6r\u00e4ndrats mycket under de senaste \u00e5ren.<\/p>\n Dessutom best\u00e5r den egentligen bara av fyra funktioner (varav en \u00e4r konstrukt\u00f6ren):<\/p>\n Det fina \u00e4r att just detta tillv\u00e4gag\u00e5ngss\u00e4tt uppn\u00e5s genom att \u00e4rva en funktionalitet f\u00f6r klassen WP_Widget<\/a>.<\/p>\n Problemet \u00e4r dock att det \u00e4r mycket arbete f\u00f6r en enskild klass att g\u00f6ra.<\/p>\n Ist\u00e4llet borde vi separera var och en av funktionerna i sitt eget funktionsomr\u00e5de.<\/p>\n Som med allt inom programmering kommer det att finnas s\u00e4tt d\u00e4r vissa saker \u00e4r tydliga om hur de kan g\u00f6ras och sedan kommer det att finnas n\u00e5gra saker som kan g\u00f6ras p\u00e5 flera s\u00e4tt.<\/p>\n Det jag ska presentera \u00e4r hur jag f\u00f6rh\u00e5ller mig till det nu. Detta kan f\u00f6r\u00e4ndras i framtiden, eller kanske inte, och andra kan ha en annan syn p\u00e5 det.<\/p>\n Oavsett vilket kommer implementeringen att bli mycket mer objektorienterad och kommer att ge varje klass sin egen upps\u00e4ttning ansvarsomr\u00e5den.<\/p>\n Den f\u00f6rsta fr\u00e5gan \u00e4r dock hur vi delar upp en klass med fyra funktioner och som \u00e4rver fr\u00e5n en \u00f6verordnad klass?<\/p>\n F\u00f6r det f\u00f6rsta finns det n\u00e5gra saker vi beh\u00f6ver justera i pluginets bootstrap. Vi beh\u00f6ver n\u00e4mligen g\u00f6ra f\u00f6ljande:<\/p>\n H\u00e4r \u00e4r en titt p\u00e5 alla tre ovanst\u00e5ende.<\/p>\n Eftersom vi redan har tagit upp detta tidigare i serien borde det vara klart hur man g\u00f6r detta.<\/p>\n Se f\u00f6rst f\u00f6ljande kod<\/a> :<\/p>\n L\u00e4gg sedan m\u00e4rke till att vi instansierar registret (vi kommer att prata om dess namnomr\u00e5de f\u00f6r en stund) och sedan kopplar vi in \u200b\u200bdet i ett anpassat filter som l\u00e5ter oss komma \u00e5t det genom hela pluginet n\u00e4r vi vill.<\/p>\n D\u00e4refter m\u00e5ste vi uppdatera k\u00e4rnpluginklassen (som finns i src-<\/strong> katalogen) s\u00e5 att den refererar till registret och laddar alla registrerade prenumeranter<\/a> :<\/p>\n Observera dock att vi inte riktigt har skapat n\u00e5gra prenumeranter \u00e4n. Vi b\u00f6rjade med det h\u00e4r tidigare i serien och nu \u00e4r det dags att \u00e5terkomma till det men vi g\u00f6r det senare.<\/p>\n Vi beh\u00f6ver dock l\u00e4gga till en funktion<\/a> \u2013 \u00e4ven om den \u00e4r tillf\u00e4llig \u2013 s\u00e5 att vi kan l\u00e4gga till klasser som inte \u00e4r explicita h\u00e4ndelseprenumeranter:<\/p>\n Detta kommer att omarbetas senare eftersom vi kommer att f\u00f6rvandla k\u00e4rnklasser till prenumeranter senare.<\/p>\n Innan jag g\u00e5r vidare tycker jag att det \u00e4r viktigt att se \u00f6ver bootstrap. \u00c4ven om din rubrik och dokumentation kan variera, \u00e4r det viktigt att notera att vi g\u00f6r f\u00f6ljande:<\/p>\n Det l\u00e5ter som mycket men koden \u00e4r ganska kort<\/a> :<\/p>\n Vid det h\u00e4r laget \u00e4r det dock dags att titta p\u00e5 hur det \u00e4r att dela upp barnklassen fr\u00e5n standard -API:et Widgets<\/a> till n\u00e5got som passar med den kodmodell som vi arbetar med.<\/p>\n Den h\u00e4r delen kommer sannolikt att str\u00e4cka sig \u00f6ver n\u00e5gra inl\u00e4gg eftersom det finns lite arbete att g\u00f6ra, men vi b\u00f6rjar med att skapa v\u00e5r egen widgetklass som kommer att \u00e4rva fr\u00e5n basklassen Widget.<\/p>\n G\u00f6r f\u00f6rst en API-<\/strong> katalog i src<\/strong> -katalogen och l\u00e4gg till en fil som heter Widget.php<\/strong>. Det \u00e4r h\u00e4r grunderna i widgeten kommer att ligga. Vi kommer in p\u00e5 administrativa och offentliga stilmallar och JavaScript-filer i n\u00e4sta inl\u00e4gg.<\/p>\n Vid denna tidpunkt b\u00f6r grunderna f\u00f6r filen se ut s\u00e5 h\u00e4r<\/a> :<\/p>\n Observera att det kr\u00e4vs ett enda argument. Jag har anv\u00e4nt widget-namn men du kan anv\u00e4nda vad det \u00e4r du vill s\u00e5 l\u00e4nge det representerar din widget.<\/p>\n Detta f\u00f6r att visa att klassen instansieras och laddas korrekt n\u00e4r plugin-programmet aktiveras. Om du inte ser detta \u00e4r n\u00e5got som inte st\u00e4mmer (vilket vi kommer att granska ett \u00f6gonblick).<\/p>\n D\u00e4refter \u00e4r det viktigt att se till att den h\u00e4r klassen l\u00e4ggs till i registret. S\u00e5 l\u00e4gg till f\u00f6ljande rader i koden i bootstrap:<\/a><\/p>\n Och nu, n\u00e4r du aktiverar plugin, b\u00f6r du se f\u00f6ljande:<\/p>\n\n
Uppdaterar The Bootstrap<\/h3>\n
\n
1 Instantiera registret<\/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 Uppdatera pluginklassen<\/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 Granska 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>\nDela upp en barnklass<\/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-widgets:](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-160983-61e7189c9c671.png\")
<\/a><\/p>\n