Estamos finalmente no post final da s\u00e9rie sobre refatora\u00e7\u00e3o do WordPress Widget Boilerplate. Ao final deste post, teremos o branch de desenvolvimento do nosso c\u00f3digo pronto e estaremos prontos para mesclar tudo no branch master.<\/p>\n
No entanto, ainda h\u00e1 um pouco de trabalho a fazer. A saber<\/a> :<\/p>\n A \u00faltima coisa que vamos ver depois disso \u00e9 refor\u00e7ar um pouco da l\u00f3gica condicional junto com uma palavra sobre cache de dados (j\u00e1 que j\u00e1 estamos fazendo um pouco disso em posts anteriores).<\/p>\n<\/blockquote>\n Ent\u00e3o, essas s\u00e3o as duas coisas que veremos neste post. Especificamente, veremos como lidar com a l\u00f3gica condicional para o front-end e como implementar o cache b\u00e1sico.<\/p>\n Antes de entrarmos na rodada final de detalhes, quero ter certeza de que voc\u00ea est\u00e1 executando a vers\u00e3o mais recente do c\u00f3digo<\/a>, pois esta \u00e9 a \u00fanica vez em que acredito ser imperativo ter o c\u00f3digo pronto para a rodada final de altera\u00e7\u00f5es.<\/p>\n Ent\u00e3o, se voc\u00ea n\u00e3o tem o c\u00f3digo rodando em sua m\u00e1quina, agora \u00e9 a hora. A \u00faltima parte do c\u00f3digo em que precisamos trabalhar \u00e9 bem pequena.<\/p>\n Mas \u00e9 importante certificar-se de que voc\u00ea est\u00e1 executando a vers\u00e3o mais recente. Assim que voc\u00ea fizer um pull do c\u00f3digo mais recente, estamos prontos para encerrar isso.<\/p>\n Lembre-se que no post anterior, renderizamos informa\u00e7\u00f5es gerais do widget \u2013 o t\u00edtulo, o conte\u00fado e se o t\u00edtulo deve ou n\u00e3o ser exibido \u2013 simplesmente exibindo os valores no front-end.<\/p>\n Mas agora \u00e9 hora de configurar as informa\u00e7\u00f5es para ter certeza de que n\u00e3o vamos apenas renderizar as informa\u00e7\u00f5es com base nas op\u00e7\u00f5es na \u00e1rea de administra\u00e7\u00e3o do widget, mas tamb\u00e9m se houver alguma informa\u00e7\u00e3o.<\/p>\n Ent\u00e3o vamos come\u00e7ar com a op\u00e7\u00e3o mais simples: A op\u00e7\u00e3o que nos permite alternar se o t\u00edtulo \u00e9 exibido. Em outras palavras, vamos supor se os valores est\u00e3o preenchidos e essa op\u00e7\u00e3o est\u00e1 marcada no backend.<\/p>\n Lembre-se, o\u00a0 arquivo Widget.php<\/strong> atualmente se parece com isso<\/a> :<\/p>\n Ent\u00e3o, vamos refatorar essa parte primeiro. Claro, \u00e9 uma coisa relativamente f\u00e1cil de introduzir, certo? Ou seja, a l\u00f3gica fica assim:<\/p>\n Isso pode ser resolvido com uma simples\u00a0 instru\u00e7\u00e3o if<\/strong>, avaliando o valor da\u00a0 op\u00e7\u00e3o display-title<\/strong> que temos. Devido \u00e0 maneira como constru\u00edmos a fun\u00e7\u00e3o ao longo desta s\u00e9rie, se a op\u00e7\u00e3o estiver marcada, ela ter\u00e1 a op\u00e7\u00e3o on<\/strong> ; caso contr\u00e1rio, est\u00e1 vazio.<\/p>\n Isso significa que podemos configurar uma condicional como esta no mesmo c\u00f3digo que compartilhamos acima<\/a> :<\/p>\n Dessa forma, se a op\u00e7\u00e3o estiver marcada, o t\u00edtulo ser\u00e1 exibido.<\/p>\n Uma coisa que acho que vale a pena mencionar \u00e9 que h\u00e1 momentos em que as pessoas podem ativar widgets, mas optam por n\u00e3o ter conte\u00fado. Claro, voc\u00ea pode argumentar que se eles fazem isso, ent\u00e3o a culpa \u00e9 deles.<\/p>\n H\u00e1 verdade nisso.<\/p>\n Mas tamb\u00e9m acho que cuidar de usu\u00e1rios que podem estar descobrindo as coisas ou que podem ter feito acidentalmente algo que eles n\u00e3o sabiam pode ajud\u00e1-los. Talvez isso nos torne desenvolvedores respons\u00e1veis \u200b\u200b(ou talvez nos torne mais agressivos \u2013 fa\u00e7a a sua escolha, estou com o primeiro).<\/p>\n Ent\u00e3o, neste caso, acho que vale a pena garantir que o t\u00edtulo e o conte\u00fado n\u00e3o estejam vazios. Se estiverem, ent\u00e3o n\u00e3o renderize nada.<\/p>\n O c\u00f3digo ent\u00e3o fica assim<\/a> :<\/p>\n E isso encerrar\u00e1 isso no que diz respeito ao front-end. Mas e o cache de que falamos em um post anterior?<\/p>\n O armazenamento em cache, para um widget como este, \u00e9 algo que considero opcional, mas como constru\u00edmos a funcionalidade b\u00e1sica no Boilerplate para liberar o cache, segue logicamente a introdu\u00e7\u00e3o da funcionalidade de armazenamento em cache de dados, certo?<\/p>\n Ent\u00e3o vamos fazer isso. Tamb\u00e9m n\u00e3o deve ser dif\u00edcil. Na realidade, estamos simplesmente pegando o t\u00edtulo, o conte\u00fado e a caixa de sele\u00e7\u00e3o e armazenando em cache os valores para a inst\u00e2ncia dada do widget.<\/p>\n Para fazer isso, precisamos localizar a fun\u00e7\u00e3o do widget<\/strong> e fazer o seguinte:<\/p>\n Primeiro, apresentaremos uma fun\u00e7\u00e3o para armazenar em cache o widget<\/a> :<\/p>\n Em seguida, apresentaremos uma fun\u00e7\u00e3o para recuperar a vers\u00e3o em cache do widget<\/a> :<\/p>\n Em seguida, revisitamos a fun\u00e7\u00e3o original para garantir que estamos exibindo o que \u00e9 necess\u00e1rio. Se o cache estiver vazio, n\u00e3o faremos nada al\u00e9m de exibir os valores como est\u00e3o<\/a>.<\/p>\n E isso encerra a funcionalidade do Widget Boilerplate completamente refatorado.<\/p>\n Este grave em particular tem sido longo. Pessoalmente, foi muito bom revisitar o WordPress Widget Boilerplate e traz\u00ea-lo para padr\u00f5es mais modernos.<\/p>\n Ainda h\u00e1 algumas coisas que preciso fazer, como atualizar o arquivo README e fornecer mais algumas instru\u00e7\u00f5es antes de mescl\u00e1-lo no\u00a0 branch master<\/strong>, mas se voc\u00ea estiver acompanhando toda esta s\u00e9rie, provavelmente estar\u00e1 a bordo com tudo. Al\u00e9m disso, aprecio seu tempo em conviver com ele e espero que tenha sido ben\u00e9fico para voc\u00ea em alguns n\u00edveis.<\/p>\n Com isso dito, procurarei migrar para conte\u00fado premium de formato mais curto, j\u00e1 que esta s\u00e9rie e a \u00faltima foram bastante longas. Como de costume, voc\u00ea sempre pode entrar em contato comigo ou oferecer solicita\u00e7\u00f5es de pull conforme necess\u00e1rio – \u00e9 de c\u00f3digo aberto e tamb\u00e9m recebe melhorias.<\/p>\n Por enquanto, por\u00e9m, isso encerra esta s\u00e9rie.<\/p>\n\n
The WordPress Widget Boilerplate: Refatorando Parte 13<\/h2>\n
1 Renderizando o 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>\nUm corol\u00e1rio disso<\/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 Apresentando o 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<?php\n\n\/**\n * Displays the widget based on the contents of the included template.\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 *\/\npublic function widget($args, $instance)\n{\n \/\/ Get a cached version of the widget. If it's empty, cache what we have.\n $cache = $this->getCachedWidget();\n if (empty($cache)) {\n $this->cacheWidget($args, $instance);\n }\n\n return $this->widgetDisplay->show($args, $instance);\n}<\/code><\/pre>\nO fim<\/h2>\n