Criando Plugins no WordPress: O Básico
As duas últimas semanas de trabalho eu passei quase que exclusivamente dedicadas a criação de um plugin em WordPress que gerencia o conteúdo da página institucional da empresa onde eu trabalho, a Radig (www.radig.com.br). Depois de algumas limitações e uma série de ajustes o plugin ficou pronto e está quase perfeito, precisa de uns retoques e a correção de alguns bugs.
Criar plugins para o WordPress pode ser uma tarefa simples, mas algumas vezes pode ser algo que dê um certo trabalho. Na api do WordPress, as funções são membros isolados, quase sempre salvas em arquivos únicos, de nomes significativos em diretórios específicos. Não há orientação a objetos e de qualquer ponto de sua aplicação (seja um tema ou um plugin) é possível acessar funções que estejam presentes em qualquer diretório da aplicação.
Por isso o WordPress recomenda nomear funções novas (em plugins e temas) com nomes únicos, assim evita o conflito de nomes de função, já que quase sempre não há necessidade de se incluir arquivos ou definir escopos em funções. É importante também verificar se o nome do plugin que estamos criando já não existe no repositório do WordPress, pois se já existir pode haver conflitos em pesquisar um plugin ou atualizar o mesmo.
Criar plugins no WordPress é basicamente criar uma aplicação php, que se utiliza de funções do WordPress e algumas definidas pelo usuário. Um único arquivo php (de preferência com o nome do plugin), dentro de um diretório com o nome do plugin, já é o suficiente para a existência do plugin, mas é necessário ainda que esse arquivo php possua em seu cabeçalho o seguinte comentário:
1 2 3 4 5 6 7 | /* Plugin Name: Nome do Plugin Plugin URI: http://website-do-plugin.com Description: alguma descrição Version: 0.1 Author: jose */ |
Basta apenas informar Plugin Name e Author para que o WordPress reconheça o seu plugin e o coloque na lista de plugins instalados.
Nesse arquivo php, ou em outros que forem inclusos, deverão declarar suas funções e utilizar de funções básicas do WordPress para realizarem a modificação do conteúdo que é exibido ou armazenamento e busca de dados no banco de dados do WordPress. Para que o plugin faça a modificação do conteúdo ou busca/armazenamento é necessário interceptar algumas funções básicas do WordPress, como the_content (retorna o conteudo de um post), wp_head (imprime o conteúdo da seção head de uma página), etc.
Essa interceptação e feita utilizando filtros , que podem substituir uma dessas funções básicas do WordPress pela nossa função. O código para isso e bem simples:
1 2 3 4 5 6 7 8 | <?php add_filter('the_content', 'my_content'); function my_content() { echo 'my content'; } ?> |
A declaraçãoa cima faz com que o conteúdo de uma página ou post que seja buscado pela função the_content, seja substituído pela minha função my_content;
Uma extensa lista de filtros e ações permitem a manipulação do que será exibido e salvo na aplicação WordPress. Essa lista está na documentação do Wordpres.
Por ora o que tenho a dizer é isso. Postarei mais dicas de como fazer plugins em WordPress, mas se você não quer esperar e quer começar agora mesmo, leia a documentação oficial, pois apesar de deixar algumas coisas de fora, ajuda muito quem está começando.
Radig Soluções em TI