Esta é a terceira parte do nosso tutorial sobre plugins para WordPress e hoje nós avançaremos com o nosso estudo, criando uma página administrativa para o nosso Plugin. Na primeira parte do nosso estudo criamos um plugin básico que exibia mensagens em um widget no site do usuário (neste ponto as mensagens eram armazenadas em um array). Na segunda parte, falamos sobre as funções de ativação e desativação de plugins e as usamos para inserir nossas mensagens no banco de dados quando o plugin fosse inicializado e remover tudo quando ele fosse desativado. Evitando assim manter dados inúteis no banco de dados do usuário. Hoje andaremos mais um pouquinho, então mãos à Obra!

Nesta postagem vamos criar para o nosso plugin uma página administrativa onde poderemos adicionar mais mensagens no banco de dados. Para efeito de organização, vamos agrupar nossas funções em um arquivo separado (functions.php) e adicionaremos algumas funções novas nele. Também criaremos um arquivo, com o código da nossa página administrativa. Nosso css ficará no arquivo da própria página administrativa, mas futuramente ele também será separado. Então nosso diretório ficará assim:

Para criarmos o nosso menu vamos usar a função do WordPress add_menu_page(). Ela será chamada dentro da nossa função mw_create_menu() que usaremos como parâmetro na action ‘admin_menu’.

Além desses parâmetros temos o ’position’ que eu não usei. Ele serve para determinar a posição em que o menu será inserido. O nosso vai entrar após os itens padrões do menu. Feito isso, precisamos configurar nossa action ‘admin_menu’, associando nossa função a ela.

Neste ponto nosso menu já estará sendo exibido, mas se clicarmos nele, a página vai apresentar um erro poque ainda não criamos a função que vai renderizar ela. Esse é o nosso próximo passo.

Essa função será bem simples porque servirá apenas para fazer o include do arquivo que contem o código HTML da página.

Vamos criar uma página simples com informações do autor e um formulário para inserir novas mensagens. O formulário será enviado pelo método POST, então pegaremos as informações e salvaremos no banco de dados, na nossa tabela ‘messages_widget’.

Código HTML da nossa página, que colocaremos no nosso arquivo ‘mw_adm_page.php‘.

• Andre Brum Sampaio
• http://www.andrebrum.com.br/
• @andrebrumsampaio
• "@andrebrumsampaio
• 1.0

	<?php echo $message; ?>

Folha de Estilos no mesmo arquivo.

Por fim, precisamos criar a função responsável pela inserção de novas mensagens na tabela.

prefix . "messages_widget";
	if( isset( $author ) AND !empty( $author ) ) {
		if( isset( $message ) AND !empty( $message ) ) {
			$value = array('author' => $author , 'msg' => $message);
			$wpdb->insert( $table_name, $value );
			$db_error = $wpdb->last_error;
			if( !$db_error ) {
				echo "Sua mensagem foi adicionada ao Banco de Dados.";
				$author = "";
				$message = "";
			} else {
				print_r($db_error);
			}
		} else {
		echo "O campo mensagem não pode ser em branco";
		}
	} else {
		echo "Nome do autor é obrigatório.";
	}
}
?>

E assim acabamos o código desta fase e se tudo correu bem você deve ter uma página administrativa como a da imagem abaixo. Usei a imagem de uma ‘Aspas’ como logotipo da página só para ilustrar.

Se você chegou direto neste post e gostaria de ver a sequência completa da criação do nosso plugins, você pode acessar a primeira parte aqui e a segunda aqui.

Nosso plugin ainda está em inglês, mas em breve faremos a intercionalização dele.

Espero que tudo tenha dados certo!!