O WordPress é um CMS muito poderoso e entre uns dos principais recursos desse sistema podemos destacar os plugins.

Para quem não sabe o que é um plugin, trata-se de um recurso adicional para o WordPress, que qualquer um, com um pouco de conhecimento, pode desenvolver. Após o plugin concluído ele pode ser ativado ou desativado no painel de controle do WordPress. Um detalhe interessante é que você pode criar um plugin e compartilhar com amigos ou interessados, bastando para isso que a pessoa coloque o plugin no diretório correto e ative ele. Para quem pretende dar suporte ao plugin que venha a criar, é interessante criar uma página para ele e manter aí um canal de comunicação com os usuários.

Veremos agora como fazer um plugin que exibirá uma mensagem sempre que um visitante abrir uma artigo, passo a passo:

1- Um plugin pode ser composto de apenas um arquivo ou uma série deles, caso o plugin seja composto por mais de um arquivo é aconselhável criar uma pasta com o mesmo nome do plugin e colocar todos os arquivos dentro dela. A pasta onde os plugins ficam armazenadas é dentro de wp-content/plugins, crie ai uma pasta com o nome do nosso plugin, no caso message. Dentro dessa pasta message crie um arquivo chamado message.php e abra ele no seu editor de texto preferido.

2- Logo no início do arquivo message.php você deve colocar as seguintes informações:

<?php

/*
Plugin Name: Message
Plugin URI: http://plugin url
Description: Show a message to everyone that visit your blog
Version: 1.0
Author: Your Name Here
Author URI: http://author url
*/

/**
* Message
*
* @author AuthorName <author @ email>
*
*/

?>

Esse cabeçalho é necessário para que o wordpress reconheça o plugin, mas não se esqueça de substituir os dados com os dados do seu proprio plugin. Veja como fazer isso:
Plugin Name: Aqui coloque o nome do seu plugin
Plugin URL: Aqui coloque o url do plugin (caso exista)
Description: Aqui coloque uma descrição curta do que o plugin faz
Version: Aqui coloque a versão do plugin
Author: Aqui coloque o nome do autor do plugin
Author URL: Aqui coloque a url do site do autor do plugin
@author: Aqui você coloque o nome do author seguido do email entre as tags <>

Nosso plugin não faz nada, mas para fins de teste, salve as alterações no arquivo, logue-se no painel do WordPress e ative o plugin Message. Note como embora nosso plugin não faça nada, ele já é reconhecido pelo WordPress, que permite a você ativar e desativar o mesmo.

Na imagem acima você vê o plugin que nós criamos chamado Message, juntamente com outros dois plugins padrões que vem junto com o WordPress, o Akismet e Hello Dolly.

3- Agora abra o arquivo message.php para edição novamente, vamos criar a função do plugin nesse passo. Após o cabeçalho do plugin que nós criamos no passo anterior, digite o seguinte.

$message = "You are welcome!";

function message($content){
	global $message;
	if(is_single()){
		$content = "<div>" . $message . "</div>" . $content;
	}
	return $content;
}

add_filter('the_content','message');

Existem varias coisas interessantes no exemplo acima, para entender melhor você precisa saber o seguinte, o WordPress possui um sistema de hooks (ganchos) que são uma espécie de eventos onde você pode adicionar funções. Existem dois tipos de hooks, ações e filtros, aqui nesse exemplo utilizamos o filtro the_content. Através do método add_filter nós podemos adicionar funções para os hooks do wordpress, então o que fiz foi dizer ao sistema para executar a função que criei “message” sempre que o filtro the_content for invocado.

Note ainda, que dentro da função que criei “message” utilizei a função is_single(), essa é uma função que retorna true caso a página em execução seja um post e false caso contrário. Isso nos permite filtrar ações para posts, páginas, pagina de entrada (home), etc. Por exemplo, se eu quisesse exibir a mensagem somente em páginas eu iria utilizar a função is_page() invés e is_single().

Outro detalhe importante quando se trabalha com filtros no WordPress é retornar o valor que você recebe na função. Isso é necessário porque o mesmo conteúdo que você editou poderá ser utilizado em outros filtros antes de ser exibido para o usuário. Não há um certo limite de filtros que você pode criar, claro que quanto mais filtros mais demorada será a execução do sistema.

4- Salve o plugin e ative-o no painel do WordPress, caso já não esteja ativado. Entre na página principal de seu blog (home), verá que nada acontece, mas agora experimente acessar algum post que você tenha criado. Se você seguiu os passos que descrevi aqui, você verá a mensagem logo acima do conteúdo do post.

Pessoal, como vocês devem ter percebido, existem vários recursos, funções e técnicas para se criar plugins para WordPress e a melhor forma para aprender é com exemplos práticos. Por conta disso, por hoje é só, nos próximos posts iremos avançar, criando plugins mais complexos, que envolvem mais recursos. Até mais.