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:

• Introdução aos widgets e a API de Widgets
• Codificando e registrando seu widget
• Construindo seu widget
• Criando o formulário para o seu widget
• Exibindo seu widget na área correta do widget

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:

<?php 
/*Plugin Name: List Subpages Widget
Description: This widget checks if the current page has parent or child pages and if so, outputs a list of the highest ancestor page and its descendants. This file supports part 1 of the series to create the widget and doesn't give you a functioning widget.
Version: 0.1
Author: Rachel McCollin
Author URI: https://rachelmccollin.com
License: GPLv2
*/
?>

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:

<?php
class Tutsplus_List_Pages_Widget extends WP_Widget {
    
  function __construct() {
	}
	
	function form( $instance ) {
	}
	
	function update( $new_instance, $old_instance ) {		
	}
	
	function widget( $args, $instance ) {
		
	}
	
}
?>

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:

<?php
function tutsplus_register_list_pages_widget() {

    register_widget( 'Tutsplus_List_Pages_Widget' );

}
add_action( 'widgets_init', 'tutsplus_register_list_pages_widget' );
?>

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!