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:
- 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!
Subscribe below and we’ll send you a weekly email summary of all new Code tutorials. Never miss out on learning about the next big thing.
Update me weeklyEnvato Tuts+ tutorials are translated into other languages by our community members—you can be involved too!
Translate this post