Como criar um plugin do WordPress

Criar um plugin para WordPress pode parecer desafiador no início, mas com um pouco de orientação, é um processo relativamente simples. Aqui está um guia passo a passo para ajudá-lo a criar seu próprio plugin:


Passo 1: Planejamento

  1. Defina a funcionalidade: Determine o que o plugin deve fazer (ex: criar um shortcode, adicionar um widget, integrar uma API, etc.).
  2. Nome do plugin: Escolha um nome único para evitar conflitos com outros plugins.

Passo 2: Estrutura do Plugin

A estrutura básica de um plugin é composta por uma pasta com um ou mais arquivos PHP.

  1. Localização: Crie uma pasta dentro do diretório wp-content/plugins com o nome do seu plugin.
    Exemplo: wp-content/plugins/meu-plugin.

  2. Arquivo principal: Dentro dessa pasta, crie um arquivo PHP principal. O nome geralmente reflete o do plugin.
    Exemplo: meu-plugin.php.


Passo 3: Cabeçalho do Plugin

O arquivo principal deve conter um cabeçalho com informações sobre o plugin:

 
<?php
/**
* Plugin Name: Meu Plugin
* Plugin URI: https://seusite.com/meu-plugin
* Description: Este é um plugin de exemplo.
* Version: 1.0
* Author: Fabiano Abreu
* Author URI: https://seusite.com
* License: GPL2
*/

Passo 4: Adicione Funcionalidades

Você pode começar a adicionar funcionalidades ao plugin. Aqui estão alguns exemplos comuns:

Exemplo 1: Adicionar um Shortcode

Adicione um shortcode para exibir uma mensagem personalizada:

 
function meu_shortcode() {
return ‘<p>Olá, este é o meu plugin!</p>’;
}
add_shortcode(‘meu_shortcode’, ‘meu_shortcode’);
 

Agora, ao usar [meu_shortcode] em uma página ou post, a mensagem será exibida.

Exemplo 2: Adicionar um Hook

Adicione uma mensagem ao rodapé do site:

function mensagem_rodape() {
echo ‘<p style=”text-align: center;”>Obrigado por visitar nosso site!</p>’;
}
add_action(‘wp_footer’, ‘mensagem_rodape’);
 

Exemplo 3: Criar um Menu no Admin

Adicione uma página de configurações no painel:

 

function meu_menu_plugin() {
add_menu_page(
‘Configurações do Meu Plugin’,
‘Meu Plugin’,
‘manage_options’,
‘meu-plugin-config’,
‘meu_plugin_pagina_config’,
‘dashicons-admin-generic’,
90
);
}

function meu_plugin_pagina_config() {
echo ‘<h1>Configurações do Meu Plugin</h1>’;
echo ‘<p>Aqui você pode configurar o plugin.</p>’;
}

add_action(‘admin_menu’, ‘meu_menu_plugin’);


Passo 5: Teste o Plugin

  1. Ative o plugin no painel do WordPress em Plugins > Plugins Instalados.
  2. Teste se as funcionalidades estão funcionando como esperado.

Passo 6: Organização Avançada

Conforme o plugin cresce, organize os arquivos e use boas práticas:

  • Separe funcionalidades em arquivos diferentes.
  • Utilize classes e namespaces para evitar conflitos.
  • Adicione um arquivo de desinstalação (uninstall.php) para limpar dados quando o plugin for removido.

Passo 7: Publicação (Opcional)

Se desejar compartilhar seu plugin com outros:

  1. Valide o código: Siga os padrões de codificação do WordPress.
  2. Publique no repositório: Acesse WordPress Plugin Directory e envie seu plugin.

Deixe um comentário

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *