Portuguese (Português) translation by João Fagner (you can also view the original English article)
Nas três primeiras partes desta série, você começou a criar o seu widget do WordPress. Nesta parte, mostrarei como criar o formulário para o seu widget e certificar de que o WordPress possa atualizar quaisquer configurações nele.
Isto significará escrever duas funções para sua classe de Tutsplus_List_Pages_Widget
: a função form
e a função update
.
Para ver todas as partes desta série, clique nos links:
- 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
- O código do tutorial anterior, codificando e registrando seu widget.
Criando o Formulário
Para criar o formulário para o seu widget, você precisará preencher a função form
que você já adicionou à sua classe de Tutsplus_List_Pages_Widget
.
Abra o arquivo de plugin, encontre essa função e edite para que se pareça com:
function form( $instance ) { $defaults = array( 'depth' => '-1' ); $depth = $instance[ 'depth' ]; // markup for form ?> <p> <label for="<?php echo $this->get_field_id( 'depth' ); ?>">Depth of list:</label> <input class="widefat" type="text" id="<?php echo $this->get_field_id( 'depth' ); ?>" name="<?php echo $this->get_field_name( 'depth' ); ?>" value="<?php echo esc_attr( $depth ); ?>"> </p> <?php }
Isso adiciona a marcação para o campo, incluindo um campo de entrada ($depth
), que será usado para definir o quão fundo dentro da hierarquia de páginas ele deve ir. O padrão é -1
, que irá exibir todos os níveis.
Agora salve seu arquivo de plugin. Você verá que o widget agora tem um formulário:

No entanto se você digitar algo nele não vai salvar. Então você precisa permitir que o formulário salve a entrada.
Permitindo Que o Formulário Atualize
Para fazer isso, você precisa trabalhar com a função update
que você criou anteriormente. Edite para que se parece com isso:
function update( $new_instance, $old_instance ) { $instance = $old_instance; $instance[ 'depth' ] = strip_tags( $new_instance[ 'depth' ] ); return $instance; }
Isso substitui o valor antigo do campo de profundidade ($old_instance
) com o novo valor ($new_instance
) e higieniza usando strip_tags
. Agora, quando você digitar no campo do widget, será salvo:

Resumo
Agora você tem um formulário funcionando no seu widget, o que significa que tudo está no lugar certo para que seu widget possa ser exíbido no seu site. Isso será coberto no próximo tutorial.
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