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!