Unlimited Plugins, WordPress themes, videos & courses! Unlimited asset downloads! From $16.50/m
Advertisement
  1. Code
  2. WordPress
Code

Codificando e Registrando seu Widget do WordPress

by
Difficulty:IntermediateLength:ShortLanguages:
This post is part of a series called Introduction to Creating Your First WordPress Widget.
Introduction to Creating Your First WordPress Widget
Constructing Your WordPress Widget

Portuguese (Português) translation by João Fagner (you can also view the original English article)

Esta é a segunda parte de uma série que mostrará como criar seu primeiro widget do WordPress. Na primeira parte, você aprendeu sobre a API de Widgets e a classe WP_Widget. Nesta parte você aprenderá como iniciar o processo de construção de seu widget criando a classe e registrando.

Na íntegra, esta série consiste em cinco partes:

O Que Você Vai Precisar

Para acompanhar esta série, você vai precisar:

  • Uma instalação de desenvolvimento do WordPress
  • Um editor de código

Configurando o Plugin

Primeiro você precisa configurar seu plugin. Crie um novo arquivo no seu diretório wp-content/plugins. Eu chamei a minha de tutsplus-list-subpages-widget.php.

Adicione o seguinte ao arquivo:

Obviamente você vai querer mudar o nome do autor e a url, mas isto é o que é necessario para o plugin ser exibido na tela Plugins WordPress.

Salve o arquivo de plugin.

Criando a classe do Widget

O próximo passo é criar uma nova classe para estender a classe WP_Widget.

Digite este código em seu arquivo de plugin:

Vamos dar uma olhada no que consiste essa classe:

  • a função __construct vai fazer o que você espera -  vai construir a função. Dentro da função você vai definir coisas como o ID do widget, seu título e descrição.
  • a função do form irá criar o formulário na tela de Widgets que permite aos usuários personalizar ou ativar o widget.
  • a função de update garante que o WordPress atualize quaisquer configurações que os usuários de entrada na tela de Widgets.
  • a função do widget define o que é a saída pelo widget no front-end do site.

Os últimos três têm parâmetros que será explicado mais detalhadamente nos proximos tutoriais.

Registrando o Widget

Seu widget não vai funcionar se você não registrá-lo com o WordPress. Abaixo de sua classe, adicione a função e hook (gancho) para fazer isso:

A função register_widget() é uma função do WordPress cujo único parâmetro é o nome da classe que você acabou de criar.

Você então conecta sua função no hook (gancho) widgets_init para garantir que ele seja encontrado pelo WordPress.

Nota: Seu widget ainda não funcionará e não será exibido na tela de Widgets, então não se preocupe sobre como ativar o plugin ainda. Você precisará concluir todas as etapas desta série para ele funcionar.

Resumo

Agora você começou o processo de construção de seu primeiro widget do WordPress. Você criou um plugin para o widget, criou uma classe para construir o widget e registra-lo.

No próximo tutorial você vai aprender como construir o widget usando sua função de __construct.

Seja o primeiro a saber sobre novas traduções–siga @tutsplus_pt no Twitter!

Advertisement
Advertisement
Advertisement
Advertisement
Looking for something to help kick start your next project?
Envato Market has a range of items for sale to help get you started.