{"id":231116,"date":"2022-12-13T13:11:00","date_gmt":"2022-12-13T10:11:00","guid":{"rendered":"https:\/\/wordpress.mediadoma.com\/?p=231116"},"modified":"2022-12-13T13:12:31","modified_gmt":"2022-12-13T10:12:31","slug":"widgets-do-wordpress-uma-abordagem-orientada-a-objetos","status":"publish","type":"post","link":"https:\/\/wordpress.mediadoma.com\/pt-pt\/widgets-do-wordpress-uma-abordagem-orientada-a-objetos\/","title":{"rendered":"Widgets do WordPress: uma abordagem orientada a objetos"},"content":{"rendered":"\n

Anos atr\u00e1s, criei o WordPress Widget Boilerplate<\/a><\/strong> com o objetivo de ser o seguinte:<\/p>\n

\n

Um clich\u00ea organizado e sustent\u00e1vel para criar widgets usando as melhores pr\u00e1ticas do WordPress.<\/p>\n<\/blockquote>\n

Desde ent\u00e3o, n\u00e3o mudou muito em rela\u00e7\u00e3o \u00e0 API de Widgets<\/a><\/strong> (que veremos mais adiante neste post), mas o que considero como "melhores pr\u00e1ticas" mudou. Al\u00e9m disso, o grau em que acho que essa API \u00e9 uma exemplo de programa\u00e7\u00e3o introdut\u00f3ria orientada a objetos no WordPress \u00e9 alta.<\/p>\n

N\u00e3o \u00e9 porque usa muitos princ\u00edpios orientados a objetos, n\u00e3o \u00e9 porque usa padr\u00f5es modernos (pelo menos no que diz respeito ao PHP moderno), mas porque usa algumas coisas que nos ajudam a reconhecer alguns, digamos, sinais sobre programa\u00e7\u00e3o orientada a objetos no WordPress.<\/p>\n

E isso \u00e9 algo que n\u00e3o deve ser subestimado: se voc\u00ea est\u00e1 procurando exemplos de programa\u00e7\u00e3o orientada a objetos no WordPress, procure por APIs que a empregam.<\/p>\n

Al\u00e9m disso, se voc\u00ea est\u00e1 procurando maneiras de avaliar seu pr\u00f3prio n\u00edvel de avalia\u00e7\u00e3o de um peda\u00e7o de c\u00f3digo (muito menos uma base de c\u00f3digo) para o uso de classes e alguns dos recursos mais avan\u00e7ados da OOP, por que n\u00e3o ter algum tipo de um teste decisivo para ver como voc\u00ea est\u00e1?<\/p>\n<\/p>\n

E a API Widgets faz exatamente isso.<\/p>\n

Widgets do WordPress: uma introdu\u00e7\u00e3o<\/h2>\n

Ent\u00e3o, em uma s\u00e9rie menor do que a minha \u00faltima, pretendo analisar a API de Widgets e fazer algumas coisas:<\/p>\n

    \n
  1. mostrar o esqueleto b\u00e1sico de um widget e por que ele \u00e9 orientado a objetos,<\/li>\n
  2. discutir quais coisas voc\u00ea deve ser capaz de perceber e por qu\u00ea,<\/li>\n
  3. atualize o Widget Boilerplate diretamente neste site primeiro e depois envie-o para o GitHub,<\/li>\n
  4. construir um widget usando a API com o clich\u00ea como base para nosso trabalho.<\/li>\n<\/ol>\n

    E neste post, vamos come\u00e7ar com o primeiro ponto acima.<\/p>\n

    Mas primeiro\u2026<\/h3>\n

    Antes de entrar neste post, recomendo a leitura dos seguintes posts:<\/p>\n

      \n
    1. Dois Pilares da Programa\u00e7\u00e3o Orientada a Objetos: Parte 1 de 2<\/a><\/strong><\/li>\n
    2. Dois Pilares da Programa\u00e7\u00e3o Orientada a Objetos: Parte 2 de 2<\/a><\/strong><\/li>\n
    3. Aulas de Resumo, Parte 1 – Comportamento de Abstra\u00e7\u00e3o<\/a><\/strong><\/li>\n
    4. Classes Abstratas, Parte 2 – Classes Abstratas e Interfaces<\/a><\/strong><\/li>\n<\/ol>\n

      Uma vez feito (ou se voc\u00ea sentir que j\u00e1 domina os t\u00f3picos), estamos prontos para come\u00e7ar.<\/p>\n

      [restringir pago="verdadeiro”]<\/p>\n

      No\u00e7\u00f5es b\u00e1sicas da API de widgets<\/h2>\n

      Se voc\u00ea ler a p\u00e1gina do manual em Widgets, ver\u00e1 muito conte\u00fado. Isso \u00e9 uma coisa boa, mas nem sempre \u00e9 a melhor jogada ao tentar destilar conte\u00fado para um p\u00fablico como voc\u00ea, quando voc\u00ea est\u00e1 procurando conselhos pr\u00e1ticos e orientados a objetos.<\/p>\n

      Ent\u00e3o, vou selecionar as partes relevantes da documenta\u00e7\u00e3o da API e aplic\u00e1-las ao c\u00f3digo que tamb\u00e9m fornecemos.<\/p>\n

      O que \u00e9 um widget?<\/h3>\n

      Acho que a maioria de n\u00f3s que trabalha com WordPress sabe o que \u00e9 um widget, mas \u00e9 importante definir o termo para que todos trabalhemos com a mesma ideia. O manual diz:<\/a><\/strong><\/p>\n

      \n

      Um widget \u00e9 um objeto PHP que gera algum HTML. O mesmo tipo de widget pode ser usado v\u00e1rias vezes na mesma p\u00e1gina (por exemplo, o widget de texto). Widgets podem salvar dados no banco de dados (na tabela de op\u00e7\u00f5es).<\/p>\n<\/blockquote>\n

      Com isso em mente, vamos dar uma olhada no c\u00f3digo de um widget personalizado, pelo menos um stub dele, e ver o que podemos coletar no que diz respeito \u00e0 sua natureza orientada a objetos.<\/p>\n

      A classe de widgets<\/h3>\n

      Antes mesmo de olharmos para o c\u00f3digo, sabemos que haver\u00e1 algum n\u00edvel de programa\u00e7\u00e3o orientada a objetos simplesmente porque a documenta\u00e7\u00e3o nos diz para fazer tr\u00eas coisas:<\/p>\n

        \n
      1. Crie a classe do seu widget estendendo a classe padr\u00e3o WP_Widget<\/a> e algumas de suas fun\u00e7\u00f5es.<\/li>\n
      2. Registre seu widget para que ele fique dispon\u00edvel na tela Widgets<\/strong>.<\/li>\n
      3. Certifique-se de que seu tema tenha pelo menos uma \u00e1rea de widget<\/a><\/strong> na qual adicionar os widgets.<\/li>\n<\/ol>\n

        Neste post, vou me concentrar no primeiro ponto (embora eventualmente cheguemos a como introduzimos nossos widgets em um tema antes que a s\u00e9rie termine).<\/p>\n

        Ent\u00e3o, vamos apresentar o c\u00f3digo<\/a><\/strong> como \u00e9 apresentado na documenta\u00e7\u00e3o e falar sobre o que podemos aprender com ele:<\/p>\n

        <?php\nclass AcmeWidget extends WP_Widget \n{ \n    public function __construct() \n    {\n    }\n\n    public function widget($args, $instance) \n    {\n    }\n\n    public function form($instance)\n    {\n    }\n\n    public function update($newInstance, $oldInstance)\n    {\n    }\n}<\/code><\/pre>\n
        Primeiro, notamos que embora tenhamos definido uma classe (que podemos nomear o que quisermos, do meu jeito), ela deve estender WP_Widget<\/strong>. Isso significa que no n\u00facleo do WordPress, existe uma classe WP_Widget<\/strong>. Voc\u00ea pode ver um detalhamento bem organizado do c\u00f3digo-fonte nesta p\u00e1gina.<\/a><\/strong><\/p>\n
        Em segundo lugar, a palavra-chave extends<\/strong> indica que estamos usando heran\u00e7a PHP,<\/a><\/strong> que \u00e9 um pilar central da programa\u00e7\u00e3o orientada a objetos.<\/p>\n
        Terceiro, existem quatro fun\u00e7\u00f5es que devemos implementar, duas das quais requerem argumentos. As fun\u00e7\u00f5es que devemos implementar s\u00e3o as seguintes:<\/p>\n