No que diz respeito \u00e0 refatora\u00e7\u00e3o do WordPress Widget Boilerplate, estamos em um bom lugar. Muito trabalho foi feito de modo que a introdu\u00e7\u00e3o de novas classes, recursos e funcionalidades deve ser muito mais f\u00e1cil.<\/p>\n
E n\u00e3o s\u00f3 isso: deveria ser mais f\u00e1cil de seguir.<\/p>\n
Obrigado pelo trabalho no \u00faltimo post<\/a>, temos muito trabalho para construir \u2013 ou seja, uma interface administrativa b\u00e1sica.<\/p>\n Por fim, o \u00faltimo post dizia:<\/p>\n Nos pr\u00f3ximos artigos, isso continuar\u00e1 a evoluir, mas, como voc\u00ea pode ver, estamos nos certificando de que temos uma \u00fanica classe base de funcionalidade para conversar com o WordPress e uma classe espec\u00edfica para renderizar o formul\u00e1rio administrativo.<\/p>\n<\/blockquote>\n E \u00e9 a\u00ed que vamos pegar neste artigo. Especificamente, veremos como limpar e serializar os dados, bem como recuperar os dados salvos no widget.<\/p>\n Antes de entrarmos na serializa\u00e7\u00e3o, h\u00e1 um pequeno trabalho que precisaremos fazer em nossa vis\u00e3o administrativa. Lembre-se de postagens anteriores da s\u00e9rie que criamos um formul\u00e1rio que aceita:<\/p>\n Isso \u00e9 exibido bem, mas exclui alguns recursos importantes da API de Widgets<\/a>. Ou seja, precisamos ter certeza de que estamos nomeando corretamente nossos elementos usando as seguintes fun\u00e7\u00f5es:<\/p>\n E ent\u00e3o escreveremos nossa fun\u00e7\u00e3o simplesmente chamada get<\/a>, que explicarei momentaneamente.<\/p>\n As fun\u00e7\u00f5es acima s\u00e3o necess\u00e1rias porque ajudam o WordPress a acompanhar quantas inst\u00e2ncias do widget est\u00e3o sendo usadas e qual o usu\u00e1rio est\u00e1 editando. Em outras palavras, temos muitas funcionalidades de gra\u00e7a.<\/p>\n Antes de mostrar o c\u00f3digo, quero discutir brevemente o prop\u00f3sito da\u00a0 fun\u00e7\u00e3o get<\/strong> que vamos apresentar. Resumindo, \u00e9 uma maneira de passarmos uma chave (como na chave em um par chave\/valor) para uma fun\u00e7\u00e3o e, em seguida, fazer com que ela recupere facilmente um valor para n\u00f3s, de modo que mantenha nossa interface o mais limpa poss\u00edvel.<\/p>\n Ent\u00e3o, primeiro, o m\u00e9todo get<\/a> :<\/p>\n O importante a notar \u00e9 que este m\u00e9todo aceita n\u00e3o apenas a chave para o valor que estamos lendo, mas um array referente \u00e0 inst\u00e2ncia do array.<\/p>\n E agora, a interface do usu\u00e1rio refatorada<\/a> :<\/p>\n Mas isso ainda deixa falta de funcionalidade e deixa trabalho para n\u00f3s fazermos. Ou seja, precisamos higienizar os dados e pass\u00e1-los de volta para o WordPress, para que ele salve os dados.<\/p>\n Para os prop\u00f3sitos do nosso exemplo, seremos muito rigorosos no que permitimos. Ou seja, vamos suportar apenas o texto b\u00e1sico e vamos remover tudo de forma agressiva.<\/p>\n Isso significa que n\u00e3o vamos permitir marca\u00e7\u00e3o ou algo assim. Em vez disso, vamos remover tudo o que n\u00e3o \u00e9 texto b\u00e1sico. Podemos decor\u00e1-lo um pouco quando chegar a hora de exibi-lo no front-end, mas deixaremos isso para o post apropriado.<\/p>\n Para isso, vamos usar as seguintes fun\u00e7\u00f5es:<\/p>\n Lembre-se de que temos dois campos em nosso widget \u2013 o campo de t\u00edtulo e o campo de conte\u00fado. Dependendo do tipo de widget que voc\u00ea est\u00e1 construindo, voc\u00ea pode precisar apenas de uma \u00fanica classe ou fun\u00e7\u00e3o para limpar os dados. Em outras situa\u00e7\u00f5es, voc\u00ea pode precisar de algo mais complexo.<\/p>\n Tenha isso em mente enquanto analisamos este c\u00f3digo, pois essa n\u00e3o ser\u00e1 uma solu\u00e7\u00e3o de tamanho \u00fanico. Em vez disso, ser\u00e1 especificamente para isso.<\/p>\n De qualquer forma, para sanitizar os dados, vamos escrever uma classe espec\u00edfica para esse fim, e depois vamos disponibiliz\u00e1-la para nossa classe WidgetAdmin.<\/p>\n\n
The WordPress Widget Boilerplate: Refatorando Parte 10<\/h2>\n
Refatorando a IU<\/h3>\n
\n
\n
<?php\n\n\/**\n * If the value for the key exists in the current instance of the widget, then it will\n * retrieve it. Otherwise, it will return an empty value.\n *\n * @param string $key the used to identify the value of the widget.\n * @param array $instance the options for the instance of this widget\n *\/\nprotected function get($key, $instance)\n{\n return empty($instance[$key])? '': $instance[$key];\n}<\/code><\/pre>\n<?php\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<div class=\"widget-content\">\n <p>\n <input\n type=\"text\"\n id=\"<?php echo esc_attr($this->get_field_id('title')); ?>\"\n name=\"<?php echo esc_attr($this->get_field_name('title')); ?>\"\n value=\"<?php echo $this->get('title', $instance) ?>\"\n placeholder=\"Widget Title\"\n class=\"widefat\"\n \/>\n <\/p>\n\n <p>\n <textarea\n id=\"<?php echo esc_attr($this->get_field_id('content')); ?>\"\n name=\"<?php echo esc_attr($this->get_field_name('content')); ?>\"\n placeholder=\"Widget Content\"\n style=\"width:100%;\"><?php echo $this->get('content', $instance) ?><\/textarea>\n <\/p>\n\n <p>\n <input\n type=\"checkbox\"\n value=\"on\"\n name=\"<?php echo esc_attr($this->get_field_name('display-title')); ?>\"\n id=\"<?php echo esc_attr($this->get_field_id('display-title')); ?>\"\n <?php checked('on', $this->get('display-title', $instance), true); ?>\n class=\"checkbox\"\n \/>\n <label for=\"<?php echo esc_attr($this->get_field_id('display-title')); ?>\">Display Title?<\/label>\n <\/p>\n<\/div><!-- .widget-content -->\n<\/code><\/pre>\nSanitiza\u00e7\u00e3o e Serializa\u00e7\u00e3o<\/h3>\n
\n