En ce qui concerne les prototypes rapides et WordPress, nous avons fait deux choses jusqu’\u00e0 pr\u00e9sent\u00a0:<\/p>\n
\u00c0 ce stade, nous avons fait suffisamment de travail pour justifier de commencer \u00e0 refactoriser notre code. Autrement dit, nous allons commencer \u00e0 convertir le prototype en code. Mais c’est quelque chose qui va devoir \u00eatre fait en deux phases.<\/p>\n
Dans un premier temps, nous allons simplement introduire des classes qui repr\u00e9sentent les diagrammes du post pr\u00e9c\u00e9dent et qui encapsulent la responsabilit\u00e9 de chaque projet.<\/p>\n
Apr\u00e8s cela, nous verrons comment organiser le code en espaces de noms et packages. Avant de pouvoir le faire, nous devons nous assurer que le code est orient\u00e9 objet et reste fonctionnel. C’est donc ce qui va se passer dans ce post.<\/p>\n
Si vous avez lu les messages pr\u00e9c\u00e9dents, notez que je pr\u00e9vois de suivre l’organisation que j’ai esquiss\u00e9e dans le dernier message. Vous n’\u00eates pas oblig\u00e9 de suivre cette conception particuli\u00e8re, bien s\u00fbr.<\/p>\n
Si vous utilisez le contr\u00f4le de source, c’est l\u00e0 que je recommande de cr\u00e9er une branche<\/a> hors de la branche master (si vous utilisez Git) afin que vous puissiez faire votre travail sans nuire \u00e0 la version stable du code.<\/p>\n C’est un peu au-del\u00e0 de la port\u00e9e de la s\u00e9rie, donc si vous n’utilisez pas le contr\u00f4le de source, pas de soucis. Si c’est le cas, j’opte pour d\u00e9velopper<\/strong> comme nom de cette branche. Je le fusionnerai dans master\u00a0<\/strong> une fois que je serai s\u00fbr qu’il est fonctionnel.<\/p>\n Selon le travail esquiss\u00e9 hier, je vais cr\u00e9er deux classes :<\/p>\n Il y aura une certaine r\u00e9utilisation du code \u00e0 partir de ce que nous avons d\u00e9j\u00e0 vu, comme vous le verrez dans le code suivant.<\/p>\n Tout d’abord, notre meta box<\/a> :<\/p>\n Et ensuite, notre affichage<\/a> :<\/p>\n Que dans le code de la m\u00e9ta-bo\u00eete, dans le code de la m\u00e9ta-bo\u00eete, nous instancions explicitement l’affichage afin que nous puissions appeler sa m\u00e9thode d’affichage en cas de besoin.<\/p>\n Une autre alternative consisterait \u00e0 instancier les deux objets s\u00e9par\u00e9ment, puis \u00e0 injecter l’affichage dans la m\u00e9ta-bo\u00eete via une injection de constructeur ou quelque chose de similaire. Cela devrait \u00eatre fait dans une classe tierce.<\/p>\n Les avantages de cela viennent du d\u00e9couplage un peu plus des deux classes. Peut-\u00eatre verrons-nous comment proc\u00e9der dans le prochain article.<\/p>\n Apr\u00e8s cela, nous devons continuer et d\u00e9finir la classe responsable de l’affichage des messages dans le contexte de l’affichage de la Meta Box. C’est ce que nous appellerons le Post Messenger<\/a> :<\/p>\n Notez ici que Post Messenger fait \u00e9galement r\u00e9f\u00e9rence \u00e0 Post Query<\/a>. Il s’agit de la classe o\u00f9 se produit la communication avec la base de donn\u00e9es. J’ai \u00e9galement inclus quelques fonctions d’assistance pour rendre le code de vue un peu plus simple, comme nous le verrons dans un instant.<\/p>\n Et c’est tout pour les classes de base. Bien s\u00fbr, nous devons encore parler des points de vue.<\/p>\n Les vues sont responsables du rendu du HTML dans le contexte de la m\u00e9ta-bo\u00eete. Je n’aime pas \u00e9crire du HTML dans le contexte de PHP (je n’aime pas non plus m\u00e9langer PHP dans le contexte de HTML, mais c’est in\u00e9vitable dans ce projet).<\/p>\n Il existe d’excellents projets de mod\u00e8les pour faciliter cela, mais je m’\u00e9loigne du sujet. Quoi qu’il en soit, vous remarquerez que dans le\u00a0 fichier post-list.php<\/strong>, il y a des r\u00e9f\u00e9rences aux fonctions d’assistance dans la classe Post Query. C’est pour m’assurer que je n’expose pas trop de propri\u00e9t\u00e9s et que je ne viole pas la loi de D\u00e9m\u00e9ter.<\/p>\n Voyons d’abord ce fichier car c’est le plus compliqu\u00e9<\/a> :<\/p>\n Il ressemble \u00e0 ce code WordPress standard, mais rappelez-vous que puisque ce fichier est appel\u00e9 dans le Post Messenger<\/strong>, il va faire r\u00e9f\u00e9rence \u00e0 la requ\u00eate en tant que requ\u00eate envelopp\u00e9e par cette classe.<\/p>\n Les deux derniers fichiers sont assez simples. L’un d’eux fournit une description<\/a> :<\/p>\n L’autre fournit un message lorsqu’il n’y a pas de messages<\/a>\u00a0:<\/p>\n En dehors de cela, la fonctionnalit\u00e9 de base est termin\u00e9e.<\/p>\n La derni\u00e8re chose que nous devons faire est de d\u00e9marrer le plugin. Pour ce faire, nous modifions le code dans le fichier principal du plugin pour qu’il ressemble \u00e0 ceci<\/a> :<\/p>\n Cela s’accrochera \u00e0 WordPress, instanciera notre plugin, puis le mettra en mouvement. Lorsque vous l’ex\u00e9cutez dans votre installation de WordPress, il devrait ressembler exactement \u00e0 ce qu’il \u00e9tait lors de la premi\u00e8re version.<\/p>\n La seule diff\u00e9rence est que nous avons maintenant des choses organis\u00e9es en classes plut\u00f4t qu’en fonctions individuelles.<\/p>\n Tout d’abord, il existe ici des opportunit\u00e9s de refactorisation qui r\u00e9duiraient encore plus le d\u00e9couplage (comme diff\u00e9rents types d’ injection de d\u00e9pendances<\/a>, etc.), mais le but de cette s\u00e9rie n’est pas de couvrir cela.<\/p>\n Au lieu de cela, il s’agit de prendre l’id\u00e9e de voir des plugins \u00e9crits par de nombreuses fonctions proc\u00e9durales, puis de les diviser en classes plus conceptuelles qui encapsulent leurs responsabilit\u00e9s.<\/p>\n Deuxi\u00e8mement, si vous examinez le code source dans le r\u00e9f\u00e9rentiel de cette version du projet, vous verrez que j’ai \u00e9galement introduit composer.json. C’est pour que je puisse tirer parti de PHP CodeSniffer<\/a> et des normes de codage WordPress<\/a> lors de l’\u00e9criture de code.<\/p>\n Dans la derni\u00e8re partie de la s\u00e9rie, nous passerons en revue l’ espacement des noms<\/a> et r\u00e9organiserons les fichiers. Si le temps le permet, nous inclurons un chargeur automatique afin que nous n’ayons pas \u00e0 inclure manuellement des fichiers en haut de notre fichier de plugin.<\/p>\n Enfin, j’ai fusionn\u00e9 ce code dans master et l’ai marqu\u00e9 comme 0.2.1<\/a> (car j’ai d\u00fb faire un petit correctif) car c’est encore un travail en cours.<\/p>\nCode d’\u00e9criture<\/h3>\n
\n
Le code<\/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>\nLes vues<\/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>\nAmorcer le plugin<\/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>\nRemarques<\/h2>\n
Messages de la s\u00e9rie<\/h2>\n
\n