Home » WordPress » Como construir um plugin WordPress em 5 minutos

Como construir um plugin WordPress em 5 minutos

Best WordPress hosting 2024

Sim, você leu o título corretamente – você pode criar um plugin WordPress, e começar a usá-lo em seu site em apenas alguns minutos.

Não será um enorme plugin de fazer tudo, mas os plugins nem sempre precisam ser complicados. Neste tutorial vou mostrar como adicionar um plugin simples que adicionará código personalizado à seção <head> do site WordPress. Aqui está exatamente o que você vai aprender:

Lembre-se, temos apenas alguns minutos, então vamos começar!

Por que você deve criar plugins WordPress em vez de adicionar código ao arquivo functions.php do tema

Você provavelmente sabe que sempre pode adicionar pequenos scripts personalizados ao arquivo functions.php do tema do WordPress. E isso é ótimo. Mas desta forma tem suas falhas.

  1. Se você trocar o tema do WordPress em seu site, todos os scripts personalizados serão desativados com o tema.
  2. Se você não usar temas infantis em seu site WordPress, um dia você poderá esquecer o código personalizado que tem no arquivo functions.php de seu tema, e todo o código será perdido se você atualizar seu tema.
  3. É muito mais fácil e rápido ativar ou desativar o plugin do que procurar e desativar o código personalizado no arquivo functions.php do seu tema, se você precisar dele.

Portanto, a razão para criar seus próprios plugins WordPress é clara, eu acho.

Como criar um simples plugin para WordPress

Abra qualquer editor de texto básico (como Notepad), ou qualquer editor de código (como VS Code, Notepad++). O editor de texto básico funcionará perfeitamente agora, e copie este código para ele:

<?php
/**
 * Plugin Name: My Custom Plugin
 * Description: My first WordPress plugin built just in 5 minutes
 * Version: 1.0
 * Author: ImakeITwork
 * Author URI: https://HowToSetup.website
 * Text Domain: my-custom-plugin
 *
 * @author HowToSetup.website
 * @copyright Copyright (c) 2022, HowToSetup.website
**/

function add_fathom_analytics() {
    ?>
        <script src="https://cdn.usefathom.com/script.js" data-site="GPXXQRXX" defer></script>
    <?php
}
add_action('wp_head', 'add_fathom_analytics');

A seção superior, que está entre os símbolos /** e **/, descreve seu plugin. Substitua o nome do plugin por qualquer nome que você queira. Mudar Descrição, autor – todas estas informações não são críticas, mas serão visíveis depois que você carregar o plugin em seu site. Certifique-se de que seu nome de plugin é o mesmo do domínio de texto, basta substituir todos os espaços e outros símbolos especiais por traços, como você vê no exemplo – Meu plugin personalizado tornou-se meu plugin personalizado no exemplo.

Agora é hora de adicionar sua funcionalidade de plugin. Neste exemplo, estou adicionando o código Fathom Analytics à seção <head> do site. Primeiro eu crio uma função:

function some_function_name() {
// some code here
}

Essa função pode ser o que você quiser – css personalizado, javascript, código php, lógica condicional do WordPress, etc.

Depois eu chamo essa função usando o gancho WordPress:

add_action('wp_head', 'some_function_name');

Isso é tudo – o código está pronto. Salve este arquivo como my-custom-plugin.php (ou qualquer nome que você usou no Domínio Texto, e salve-o como arquivo .php).

Como preparar seu plugin WordPress personalizado para carregar em seu site

Pode parecer complicado, mas na verdade não é nada complicado. Se você quiser carregar seu plugin para seu site diretamente do painel de administração do WordPress, você precisa comprimi-lo – salve o arquivo como .zip .

Veja como você faz isso no Windows 11:

compress wordpress plugin to zip archive

Basta clicar com o botão direito do mouse no arquivo de plugin que você acabou de criar, e selecionar Compactar como arquivo ZIP.

O mesmo truque pode ser feito em outros sistemas operacionais, ou você pode usar software de terceiros como o 7zip para comprimir seu plugin do WordPress para o formato Zip.

Aqui está o resultado:

compress wordpress file to .zip

É isso – agora seu plugin para WordPress está pronto para ser usado.

Como carregar e instalar o plugin do WordPress via painel de administração do WordPress

Uma vez que seu plugin WordPress recém-construído esteja pronto, abra o painel de administração de seu site. Em seguida, vá para Plugins >> Adicionar Novo, e clique no botão Upload Plugin, no topo da página.

how to upload plugin to wordpress

Clique em Choose File e selecione seu arquivo .zip do plugin do WordPress.

upload wordpress plugin using admin panel

Clique em Instalar Agora.

upload custom wordpress plugin to wordpress using admin panel

Se você fez tudo corretamente, seu plugin deve ser instalado agora. Pressione o botão Ativar Plugin para começar a usá-lo.

install and activate wordpress plugin

É isso – seu plugin personalizado para WordPress está funcionando. Você pode visualizar todos os detalhes inseridos anteriormente na página de Plugins de seu site.

buld your first wordpress plugin in few minutes

Agora, se alguma vez precisar desativar ou remover seu plugin do site, você poderá fazê-lo na página de Plugins.

Fathom analytics