Nous sommes enfin au dernier article de la s\u00e9rie sur la refactorisation du WordPress Widget Boilerplate. \u00c0 la fin de cet article, nous aurons termin\u00e9 la branche de d\u00e9veloppement de notre code et nous serons pr\u00eats \u00e0 tout fusionner dans la branche principale.<\/p>\n
Il reste cependant encore un peu de travail \u00e0 faire. A savoir<\/a> :<\/p>\n La derni\u00e8re chose que nous allons examiner apr\u00e8s cela est de resserrer une partie de la logique conditionnelle avec un mot sur la mise en cache des donn\u00e9es (puisque nous en faisons d\u00e9j\u00e0 un peu dans les articles pr\u00e9c\u00e9dents).<\/p>\n<\/blockquote>\n Ce sont donc les deux choses que nous allons examiner dans cet article. Plus pr\u00e9cis\u00e9ment, nous allons examiner la gestion de la logique conditionnelle pour le frontal, puis la mise en \u0153uvre de la mise en cache de base.<\/p>\n Avant d’entrer dans la derni\u00e8re s\u00e9rie de d\u00e9tails, je veux m’assurer que vous ex\u00e9cutez la derni\u00e8re version du code<\/a> car c’est la seule fois o\u00f9 je pense qu’il est imp\u00e9ratif que le code soit pr\u00eat pour la derni\u00e8re s\u00e9rie de modifications.<\/p>\n Donc, si vous n’avez pas le code en cours d’ex\u00e9cution sur votre machine, c’est le moment. Le dernier morceau de code sur lequel nous devons travailler est assez petit.<\/p>\n Mais il est important de vous assurer que vous utilisez la derni\u00e8re version. Donc, une fois que vous avez extrait le dernier code, nous sommes pr\u00eats \u00e0 conclure.<\/p>\n Rappelez-vous dans le post pr\u00e9c\u00e9dent, nous avons rendu les informations g\u00e9n\u00e9rales du widget – le titre, le contenu et si le titre doit \u00eatre affich\u00e9 ou non – en affichant simplement les valeurs sur le front-end.<\/p>\n Mais maintenant, il est temps de configurer les informations pour s’assurer que nous n’allons pas seulement rendre les informations en fonction des options de la zone d’administration du widget, mais aussi s’il y a des informations.<\/p>\n Nous allons donc commencer par l’option la plus simple: L’option qui nous permet de basculer si le titre est affich\u00e9. En d’autres termes, nous allons supposer que les valeurs sont renseign\u00e9es et que cette option est coch\u00e9e dans le backend.<\/p>\n Pour rappel, le fichier Widget.php ressemble actuellement<\/strong> \u00e0 ceci<\/a> :<\/p>\n Nous allons donc d’abord refactoriser cette partie. Bien s\u00fbr, c’est une chose relativement facile \u00e0 introduire, n’est-ce pas? C’est-\u00e0-dire que la logique est la suivante\u00a0:<\/p>\n Cela peut \u00eatre r\u00e9solu avec une simple\u00a0 instruction if<\/strong> en \u00e9valuant la valeur de l’\u00a0 option display-title<\/strong> que nous avons. En raison de la fa\u00e7on dont nous avons construit la fonction tout au long de cette s\u00e9rie, si l’option est coch\u00e9e, elle a l’option on<\/strong> ; sinon, c’est vide.<\/p>\n Cela signifie que nous pouvons configurer une condition comme celle-ci dans le m\u00eame code que nous avons partag\u00e9 ci-dessus<\/a>\u00a0:<\/p>\n Ainsi, si l’option est coch\u00e9e, le titre sera affich\u00e9.<\/p>\n Je pense qu’une chose qui m\u00e9rite d’\u00eatre mentionn\u00e9e est qu’il y a des moments o\u00f9 les gens peuvent activer des widgets mais choisir de n’avoir aucun contenu. Bien s\u00fbr, vous pouvez dire que s’ils font cela, c’est de leur faute.<\/p>\n Il y a du vrai l\u00e0-dedans.<\/p>\n Mais je pense aussi que prendre soin des utilisateurs qui peuvent comprendre des choses ou qui ont peut-\u00eatre accidentellement fait quelque chose qu’ils ne savaient pas peut les aider. Peut-\u00eatre que cela fait de nous des d\u00e9veloppeurs responsables (ou peut-\u00eatre que cela nous rend plus agressifs \u2013 faites votre choix, je suis avec le premier).<\/p>\n Donc, dans ce cas, je pense qu’il vaut la peine de s’assurer que le titre et le contenu ne sont pas vides. Si c’est le cas, ne rendez rien.<\/p>\n Le code ressemble alors \u00e0 ceci<\/a> :<\/p>\n Et cela conclura cela en ce qui concerne le front-end. Mais qu’en est-il de la mise en cache dont nous avons parl\u00e9 dans un article pr\u00e9c\u00e9dent ?<\/p>\n La mise en cache, pour un widget comme celui-ci, est quelque chose que je consid\u00e8re comme facultatif, mais puisque nous avons int\u00e9gr\u00e9 la fonctionnalit\u00e9 de base dans le Boilerplate pour vider le cache, il s’ensuit logiquement d’introduire la fonctionnalit\u00e9 de mise en cache des donn\u00e9es, n’est-ce pas\u00a0?<\/p>\n Alors faisons \u00e7a. Cela ne devrait pas \u00eatre difficile non plus. En r\u00e9alit\u00e9, nous prenons simplement le titre, le contenu et la case \u00e0 cocher et mettons en cache les valeurs pour l’instance donn\u00e9e du widget.<\/p>\n Pour ce faire, nous devons localiser la fonction du widget<\/strong>, puis proc\u00e9der comme suit\u00a0:<\/p>\n Tout d’abord, nous allons introduire une fonction pour mettre en cache le widget<\/a>\u00a0:<\/p>\n Ensuite nous introduirons une fonction pour r\u00e9cup\u00e9rer la version en cache du widget<\/a> :<\/p>\n\n
Le passe-partout du widget WordPress\u00a0: refactorisation de la partie\u00a013<\/h2>\n
1 Rendu du Front-End<\/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?>\n<div id=\"<?php echo $args['id']; ?>\">\n <h3 class=\"widget-title\"><?php echo $instance['title']; ?><\/h3>\n <p><?php echo $instance['content']; ?><\/p>\n <pre><?php echo $instance['display-title']; ?><\/pre>\n<\/div><!-- #<?php echo $args['id']; ?>-->\n<\/code><\/pre>\n\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?>\n<div id=\"<?php echo $args['id']; ?>\">\n <?php if (isset($instance['display-title']) && 'on' === $instance['display-title']): ?>\n <h3 class=\"widget-title\"><?php echo $instance['title']; ?><\/h3>\n <?php endif; ?>\n <p><?php echo $instance['content']; ?><\/p>\n<\/div><!-- #<?php echo $args['id']; ?>-->\n<\/code><\/pre>\nUn corollaire \u00e0 ceci<\/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?>\n\n<?php if (empty($instance['title']) && empty($instance['content'])): return;\nendif; ?>\n\n<div id=\"<?php echo $args['id']; ?>\">\n <?php if (isset($instance['display-title']) && 'on' === $instance['display-title']): ?>\n <h3 class=\"widget-title\"><?php echo $instance['title']; ?><\/h3>\n <?php endif; ?>\n <p><?php echo $instance['content']; ?><\/p>\n<\/div><!-- #<?php echo $args['id']; ?>-->\n<\/code><\/pre>\n2 Pr\u00e9sentation de la mise en cache<\/h3>\n
<?php\n\n\/**\n * Caches the values for the instance of this widget.\n *\n * @param array $args argument provided by WordPress that may be useful in rendering the widget\n * @param array $instance the values of the widget\n *\/\nprivate function cacheWidget($args, $instance)\n{\n $cache = [];\n $cache['widget_id'] = $args['widget_id'];\n $cache['title'] = empty($instance['title'])? '': $instance['title'];\n $cache['content'] = empty($instance['content'])? '': $instance['content'];\n\n $instance['display-title'] = isset($instance['display-title'])? $instance['display-title']: '';\n $cache['display-title'] = $instance['display-title'];\n\n wp_cache_set($this->getWidgetSlug(), $cache, 'widget');\n}<\/code><\/pre>\n<?php\n\n\/**\n * @return array the cached instance of this widget if it's not empty\n *\/\nprivate function getCachedWidget()\n{\n $cache = wp_cache_get($this->getWidgetSlug(), 'widget');\n if (!empty($cache)) {\n return $cache;\n }\n return [];\n}<\/code><\/pre>\n