Per quanto riguarda i prototipi rapidi e WordPress, finora abbiamo fatto due cose:<\/p>\n
A questo punto, abbiamo fatto abbastanza lavoro per giustificare l’inizio del refactoring del nostro codice. Cio\u00e8, inizieremo a convertire il prototipo in codice. Ma questo \u00e8 qualcosa che dovr\u00e0 essere fatto in due fasi.<\/p>\n
Innanzitutto, introdurremo semplicemente classi che rappresentano i diagrammi del post precedente e che incapsulano la responsabilit\u00e0 di ogni progetto.<\/p>\n
Successivamente, esamineremo l’organizzazione del codice in spazi dei nomi e pacchetti. Prima di poterlo fare, per\u00f2, dobbiamo assicurarci che il codice sia orientato agli oggetti e rimanga funzionale. Ecco cosa accadr\u00e0 in questo post.<\/p>\n
Se hai letto i post precedenti, nota che ho intenzione di seguire l’organizzazione che ho delineato nell’ultimo post. Non devi seguire questo particolare design, ovviamente.<\/p>\n
Se stai usando il controllo del codice sorgente, \u00e8 qui che ti consiglio di creare un ramo<\/a> del ramo principale (se stai usando Git) in modo da poter svolgere il tuo lavoro senza gravare sulla versione stabile del codice.<\/p>\n Questo \u00e8 un po’ oltre lo scopo della serie, quindi se non stai usando il controllo del codice sorgente, non preoccuparti. Se lo sei, sto optando per sviluppare<\/strong> come nome di questo ramo. Lo unir\u00f2 di nuovo al master\u00a0<\/strong> una volta che sar\u00f2 sicuro che sia funzionante.<\/p>\n Come per il lavoro abbozzato ieri, creer\u00f2 due classi:<\/p>\n Ci sar\u00e0 del riutilizzo del codice da ci\u00f2 che abbiamo gi\u00e0 visto, come vedrai nel codice seguente.<\/p>\n Innanzitutto, la nostra meta box<\/a> :<\/p>\n E poi, il nostro display<\/a> :<\/p>\n Quello che nel codice della meta box, nel codice della meta box, stiamo creando un’istanza esplicita del display in modo che possiamo chiamarlo come metodo di visualizzazione quando necessario.<\/p>\n Un’altra alternativa sarebbe quella di istanziare i due oggetti separatamente e quindi iniettare il display nella meta box tramite l’iniezione del costruttore o qualcosa di simile. Questo dovrebbe essere fatto in una classe di terze parti.<\/p>\n I vantaggi di questo derivano dal disaccoppiare un po’ di pi\u00f9 le due classi. Forse esamineremo come farlo nel prossimo post.<\/p>\n Dopodich\u00e9, dobbiamo andare avanti e definire la classe responsabile della visualizzazione dei messaggi nel contesto del Meta Box Display. Questo \u00e8 ci\u00f2 che chiameremo Post Messenger<\/a> :<\/p>\n Si noti qui che Post Messenger fa riferimento anche a Post Query<\/a>. Questa \u00e8 la classe in cui avviene la comunicazione al database. Ho anche incluso alcune funzioni di supporto per rendere il codice di visualizzazione un po’ pi\u00f9 semplice, come vedremo tra poco.<\/p>\n E questo \u00e8 tutto per le classi principali. Naturalmente, dobbiamo ancora parlare delle opinioni.<\/p>\n Le viste sono responsabili del rendering dell’HTML nel contesto della meta box. Non mi piace scrivere HTML nel contesto di PHP (n\u00e9 mi piace mischiare PHP nel contesto di HTML, ma questo \u00e8 inevitabile in questo progetto).<\/p>\n Ci sono alcuni grandi progetti di modelli per renderlo pi\u00f9 facile, ma sto divagando. Ad ogni modo, noterai che nel\u00a0 file post-list.php<\/strong> ci sono riferimenti a funzioni di supporto nella classe Post Query. Questo per assicurarmi di non esporre troppe propriet\u00e0 e di violare la legge di Demetra.<\/p>\n Diamo prima un’occhiata a quel file poich\u00e9 \u00e8 il pi\u00f9 complicato<\/a> :<\/p>\n Assomiglia al codice standard di WordPress, ma ricorda che poich\u00e9 questo file \u00e8 chiamato all’interno di Post Messenger<\/strong>, si riferir\u00e0 alla query come alla query che \u00e8 racchiusa da quella classe.<\/p>\n Gli ultimi due file sono abbastanza semplici. Uno di questi fornisce una descrizione<\/a> :<\/p>\n L’altro fornisce un messaggio quando non ci sono post<\/a> :<\/p>\n A parte questo, la funzionalit\u00e0 di base \u00e8 stata eseguita.<\/p>\n L’ultima cosa che dobbiamo fare \u00e8 avviare il plugin. Per fare ci\u00f2, modifichiamo il codice nel file del plugin principale in modo che appaia cos\u00ec<\/a> :<\/p>\n Ci\u00f2 si collegher\u00e0 a WordPress, istanzia il nostro plug-in e quindi lo metter\u00e0 in moto. Quando lo esegui all’interno della tua installazione di WordPress, dovrebbe apparire esattamente come nella prima versione.<\/p>\n L’unica differenza \u00e8 che ora abbiamo le cose organizzate in classi piuttosto che in singole funzioni.<\/p>\n In primo luogo, ci sono opportunit\u00e0 per il refactoring qui che ridurrebbe ulteriormente il disaccoppiamento (come diversi tipi di iniezione di dipendenza<\/a>, ecc.), Ma lo scopo di questa serie non \u00e8 quello di coprirlo.<\/p>\n Invece, \u00e8 prendere l’idea di vedere plugin scritti da molte funzioni procedurali e poi suddividerli in classi pi\u00f9 concettuali che incapsulano le loro responsabilit\u00e0.<\/p>\n In secondo luogo, se rivedi il codice sorgente nel repository per questa versione del progetto, vedrai che ho introdotto anche composer.json. Questo \u00e8 cos\u00ec che posso sfruttare PHP CodeSniffer<\/a> e gli standard di codifica di WordPress<\/a> durante la scrittura del codice.<\/p>\n Nell’ultima parte della serie, analizzeremo lo spazio dei nomi<\/a> e riorganizzeremo i file. Se il tempo lo consente, includeremo un caricatore automatico in modo da non dover includere manualmente i file nella parte superiore del nostro file di plug-in.<\/p>\n Infine, ho unito questo codice in master e l’ho etichettato come 0.2.1<\/a> (poich\u00e9 ho dovuto fare un piccolo aggiornamento rapido) poich\u00e9 \u00e8 ancora un lavoro in corso.<\/p>\nScrivere codice<\/h3>\n
\n
Il codice<\/h4>\n
<?php\n\/**\n * Registers the Meta Box with WordPress.\n *\n * @author Tom McFarlin\n * @since 0.2.0\n *\/\n\n\/**\n * Registers the Meta Box with WordPress. Defines the ID, title, display function,\n * and the post type on which it will live.\n *\n * @author Tom McFarlin\n * @since 0.2.0\n *\/\nclass Meta_Box {\n\n \/**\n * A reference to the class that will display the contents in the meta box.\n *\n * @access private\n * @var Meta_Box_Display\n *\/\n private $meta_box_display;\n\n \/**\n * Instantiates the class by setting its property equal to a reference to its display.\n *\/\n public function __construct() {\n $this->meta_box_display = new Meta_Box_Display();\n }\n\n \/**\n * The function responsible for hooking into the WordPress API.\n *\/\n public function init() {\n\n add_meta_box(\n 'three-recent-posts',\n 'Three Recent Posts',\n array( $this->meta_box_display, 'display' ),\n 'post',\n 'side'\n );\n }\n}\n<\/code><\/pre>\n<?php\n\/**\n * Defines the display for the meta box.\n *\n * @author Tom McFarlin\n * @since 0.2.0\n *\/\n\n\/**\n * Defines the display for the meta box that will render the content in the\n * context of its meta box.\n *\n * @author Tom McFarlin\n * @since 0.2.0\n *\/\nclass Meta_Box_Display {\n\n \/**\n * A reference to the class that will display the contents in the meta box.\n *\n * @access private\n * @var Post_Messenger\n *\/\n private $messenger;\n\n \/**\n * Instantiates the object by setting a property equal to that of the class\n * responsible for rendering the messages from the post query.\n *\/\n public function __construct() {\n $this->messenger = new Post_Messenger( $this );\n }\n\n \/**\n * If there are posts to display, renders them in the metabox. Otherwise, displays\n * a note that there are no posts to display.\n *\/\n public function display( $message) {\n $this->messenger->get_message();\n }\n}\n<\/code><\/pre>\n<?php\n\/**\n * Display content for the meta box when requested.\n *\n * @author Tom McFarlin\n * @since 0.2.0\n *\/\n\n\/**\n * Retrieves information from the class responsible for querying the database and\n * renders it in the context of our meta box when called via the Meta Box Display.\n *\n * @author Tom McFarlin\n * @since 0.2.0\n *\/\nclass Post_Messenger {\n\n \/**\n * A reference to the query resonsible for retrieving post information from\n * the database.\n *\n * @access private\n * @var WP_Query\n *\/\n private $query;\n\n \/**\n * A reference to the message that's displayed in the view of the\n * meta box.\n *\n * @access private\n *\/\n private $message;\n\n \/**\n * Instantiates the class by setting a reference to the query.\n *\/\n public function __construct() {\n $this->query = new Post_Query();\n }\n\n \/**\n * Retrieves the content to be displayed in the meta box.\n *\/\n public function get_message() {\n\n $this->get_description();\n\n if ($this->query->has_posts()) {\n $this->get_post_message();\n } else {\n $this->get_no_posts_message();\n }\n }\n\n \/**\n * Displays the description of the content of the meta box.\n *\n * @access private\n *\/\n private function get_post_message() {\n include_once 'post-list.php';\n }\n\n \/**\n * Displays the description of the content of the meta box.\n *\n * @access private\n *\/\n private function get_description() {\n include_once 'message-description.php';\n }\n\n \/**\n * Displays a message of there are no recent posts.\n *\n * @access private\n *\/\n private function get_no_posts_message() {\n include_once 'no-post-list.php';\n }\n}\n<\/code><\/pre>\n<?php\n\/**\n * Queries the database for three most recent posts.\n *\n * @author Tom McFarlin\n * @since 0.2.0\n *\/\n\n\/**\n * Queries the database for three most recent posts. Returns the query to the\n * caller so that it can be interrogates for posts or not.\n *\n * @author Tom McFarlin\n * @since 0.2.0\n *\/\nclass Post_Query {\n\n \/**\n * A reference to the WP_Query this class wraps.\n *\n * @access private\n * @var WP_Query\n *\/\n private $query;\n\n \/**\n * Instantiates the class by preparing instance data and executing the\n * query so the display can render the contents.\n *\/\n public function __construct() {\n\n $this->query = null;\n $this->get_posts();\n }\n\n \/**\n * Executes the query for returning the post recent posts ordered by date.\n *\n * @access private\n *\/\n private function get_posts() {\n\n $args = array(\n 'post_type' => 'post',\n 'post_status' => 'publish',\n 'orderby' => 'date',\n 'order' => 'desc',\n );\n $this->query = new WP_Query( $args );\n\n return $this->query;\n }\n\n \/**\n * A helper function to determine if the query has any posts.\n *\/\n public function has_posts() {\n return! $this->query->have_posts();\n }\n\n \/**\n * A helper function for retrieving the next post in the list of\n * posts\n *\/\n public function the_post() {\n return $this->query->the_post();\n }\n}\n<\/code><\/pre>\nLe visualizzazioni<\/h4>\n
<ol>\n <?php while ($this->query->has_posts()) { ?>\n <?php $this->query->the_post(); ?>\n <li>\n <a href=\"<?php get_the_permalink(); ?>\" target=\"_blank\">\n <?php echo get_the_title(); ?>\n <\/a>\n <\/li>\n <?php } ?>\n<\/ol><\/code><\/pre>\n<p>\n <span class=\"description\">\n Displays up to the three most recent posts.\n <\/span><!-- .description -->\n<\/p><\/code><\/pre>\n<p>There are no recent posts.<\/p><\/code><\/pre>\nAvvio del plug-in<\/h3>\n
<?php\n\/**\n * Three Recent Posts\n *\n * @package TRP\n * @author Tom McFarlin\n * @copyright 2017 Tom McFarlin\n * @license MIT\n *\n * @wordpress-plugin\n * Plugin Name: Three Recent Posts\n * Plugin URI: https:\/\/tommcfarlin.com\/three-recent-posts\/\n * Description: Displays the three mot recent posts in your post editor screen.\n * Version: 0.2.0\n * Author: Tom McFarlin\n * Author URI: https:\/\/tommcfarlin.com\n * Text Domain: three-recent-posts\n * License: GPL\n * License URI: http:\/\/www.gnu.org\/licenses\/gpl-3.0.txt\n *\/\n\ninclude 'class-meta-box.php';\ninclude 'class-meta-box-display.php';\ninclude 'class-post-messenger.php';\ninclude 'class-post-query.php';\n\nadd_action( 'add_meta_boxes', 'trp_start' );\n\/**\n * Starts the plugin.\n *\/\nfunction trp_start() {\n\n $meta_box = new Meta_Box();\n $meta_box->init();\n}\n<\/code><\/pre>\nAppunti<\/h2>\n
Messaggi di serie<\/h2>\n
\n