Guia de Iniciação para Desenvolvimento de Plugins WordPress: Crie o Seu Primeiro Plugin do Zero

Por que escolher desenvolver um plugin para o WordPress?

O WordPress, como o sistema de gestão de conteúdo mais popular em todo o mundo, deve sua forte capacidade de expansão principalmente aos plugins. Ao desenvolver plugins, você pode adicionar qualquer funcionalidade personalizada ao seu site sem precisar modificar os arquivos principais, o que garante a compatibilidade durante as atualizações do WordPress. Seja para atender às necessidades de um projeto específico, resolver um problema comum ou compartilhar suas soluções com a comunidade e gerar receita, o desenvolvimento de plugins é uma habilidade de grande valor.

Aprender o desenvolvimento de plugins não só lhe permitirá compreender em profundidade o funcionamento do WordPress, como o sistema de ganchos (Hooks) e os códigos encurtados (Shortcodes), como também aprimorará suas habilidades de programação em PHP. Desde o aprimoramento de funções simples até a integração de aplicações mais complexas, tudo é possível.

Configurando seu ambiente de desenvolvimento de plugins

Antes de começar a escrever o código, ter um ambiente de desenvolvimento local adequado é de extrema importância. Isso permite que você realize testes e depurações de forma segura, sem afetar o site online.

Leitura recomendada Guia definitivo para o desenvolvimento de plugins do WordPress: construir plugins profissionais do zero。

Configurar o ambiente do servidor local

Recomendamos o uso de ferramentas de desenvolvimento local integradas, como o Local by Flywheel, DevKinsta ou XAMPP. Essas ferramentas são instaladas com um único clique e incluem Apache/Nginx, PHP e MySQL. Certifique-se de que a versão do PHP esteja compatível com o servidor de destino; geralmente, é recomendado usar a versão 7.4 ou superior para obter melhor desempenho e segurança.

Hospedagem para sites WordPress da UltraHost

Garantia de reembolso em 30 dias, largura de banda ilimitada e banco de dados, proteção contra DDoS gratuita; desconto de 50% na compra de 3 anos (planos de 4 TB a 10 TB).

página de acesso

Instale e configure o WordPress.

Instale uma nova instância do WordPress no seu servidor local. É recomendado usar o tema padrão (como a série Twenty Twenty) para desenvolvimento e testes, a fim de evitar problemas de compatibilidade com os temas.wp-config.phpNo arquivo, habilite (ou ative) a funcionalidade correspondente.WP_DEBUGConstantes – isso ajudará você a encontrar erros rapidamente durante o processo de desenvolvimento.

define( 'WP_DEBUG', true );

Prepare o editor de código.

Escolha um editor de código poderoso, como o Visual Studio Code, o PhpStorm ou o Sublime Text. Instale extensões relevantes, como o suporte inteligente para PHP e fragmentos de código para WordPress; elas podem aumentar significativamente a sua eficiência na programação.

Crie o seu primeiro arquivo de plugin.

Um plugin para o WordPress é, essencialmente, um ou mais componentes que estão localizados dentro do código do próprio WordPress./wp-content/plugins/Os arquivos PHP que estão no diretório… Agora, vamos começar com a estrutura mais básica.

Escreva as notas de cabeça do plugin.

Cada plugin deve conter uma nota de cabeçalho em um formato padrão, através da qual o WordPress pode identificar as informações do plugin. No seu diretório de plugins (por exemplo…/wp-content/plugins/my-first-plugin/No ficheiro, crie um nome chamadomy-first-plugin.phpO arquivo principal.

Leitura recomendada Do iniciante ao especialista: guia completo para o desenvolvimento de plugins do WordPress.。

<?php
/**
 * Plugin Name:       我的第一个插件
 * Plugin URI:        https://example.com/my-first-plugin
 * Description:       这是一个用于学习的简单WordPress插件。
 * Version:           1.0.0
 * Author:            你的名字
 * Author URI:        https://example.com
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 * Domain Path:       /languages
 */

Este comentário define o nome, a descrição e outras informações que o plugin exibe na interface de administração do WordPress.Text Domain用于国际化翻译。

Construir uma estrutura de segurança básica para plugins

Para evitar acesso direto aos arquivos do seu plugin, você pode adicionar um código de proteção no início do arquivo. Esta é a melhor prática no desenvolvimento de plugins para o WordPress.

// 防止直接访问
if ( ! defined( 'ABSPATH' ) ) {
	exit; // 如果未定义ABSPATH（WordPress根目录的绝对路径），则退出
}

ABSPATHÉ uma constante definida pelo WordPress que representa o caminho absoluto onde o plugin está instalado. Ao verificar a existência dessa constante, é possível impedir que usuários externos acessem diretamente os arquivos do seu plugin através de um URL.

hospedagem compartilhada da hosting.com

Alto desempenho com CPUs AMD EPYC, armazenamento SSD NVMe e LiteSpeed, suporte interno especializado 24 horas por dia, 7 dias por semana, medidas de segurança avançadas, incluindo SSL, força bruta, malware e proteção contra DDoS, economia de até 73%

página de acesso

Implementar as funcionalidades principais: adicionar um menu de gerenciamento e opções de configuração.

Um plugin completo geralmente precisa disponibilizar uma interface de configuração no painel administrativo do WordPress. Vamos adicionar uma página de menu de gerenciamento simples utilizando a API fornecida pelo WordPress.

Use uma função para adicionar o menu de gerenciamento de nível superior.

Nós vamos usar.add_action()Anexar função aadmin_menuNo gancho, adicione um novo item de menu no backend. Continue adicionando o seguinte código no seu arquivo principal do plugin.

// 添加管理菜单
function mfp_add_admin_menu() {
    add_menu_page(
        '我的第一个插件设置', // 页面标题
        '我的插件',           // 菜单标题
        'manage_options',    // 所需权限（管理员）
        'my-first-plugin',   // 菜单slug
        'mfp_settings_page', // 显示页面内容的回调函数
        'dashicons-admin-generic', // 图标（使用Dashicons）
        80                    // 菜单位置
    );
}
add_action( 'admin_menu', 'mfp_add_admin_menu' );

Aqui,add_menu_page()A função é utilizada para criar um menu principal. Os parâmetros definem o título da página, o título do menu, as permissões de acesso, o identificador único (slug), a função de callback responsável por exibir o conteúdo da página, o ícone do menu e a posição do menu na barra lateral.

Leitura recomendada Guia Completo para Desenvolvimento de Plugins para WordPress: Do Zero até a Implementação Prática。

Criar uma função de callback para a página de configurações.

Agora, precisamos definir o que foi mencionado acima.mfp_settings_page()A função irá gerar o conteúdo HTML da página de gerenciamento.

// 设置页面回调函数
function mfp_settings_page() {
    // 检查用户权限
    if ( ! current_user_can( 'manage_options' ) ) {
        return;
    }
    ?>
    <div class="wrap">
        <h1></h1>
        <p>Bem-vindo à página de configuração do meu primeiro plugin! Aqui é onde você poderá adicionar formulários e opções no futuro.</p>
        <form action="/pt/options.php/" method="post" data-trp-original-action="options.php">
            <?php
            // 输出设置字段、非ce等（后续扩展）
            settings_fields( 'mfp_options_group' );
            do_settings_sections( 'my-first-plugin' );
            submit_button( '保存设置' );
            ?>
        <input type="hidden" name="trp-form-language" value="pt"/></form>
    </div>
    &lt;?php
}

Esta função verifica, em primeiro lugar, se o usuário atual possui…manage_optionsPermissões (geralmente de administrador), e em seguida, exiba um simples framework de página de configuração.settings_fields()edo_settings_sections()Isso foi reservado para a configuração das opções de registro do API no WordPress, para uso posterior.

Hospedagem Compartilhada InterServer

Hospedagem compartilhada $2.50 USD por mês, primeiro mês $0.1 USD código promocional tryinterserver, 461 scripts de aplicativos em nuvem, instalação com um clique.

página de acesso

Adicionar uma função simples no front-end para o plugin.

Além da interface de gerenciamento de backend, os plugins são mais comumente usados para fornecer funcionalidades para a parte frontal ( frontend) de um site. Vamos criar um código curto (shortcode) simples que permita que os usuários o utilizem em artigos ou páginas.

Usar uma função para registrar um código curto

Códigos curtos permitem que os usuários façam algo (como acessar uma função, enviar um pedido, etc.) de forma rápida e conveniente.[shortcode]Tais etiquetas simples permitem a inserção de funcionalidades dinâmicas no conteúdo. Utilize-as.add_shortcode()A função é registrada.

// 注册一个短代码
function mfp_hello_world_shortcode( $atts ) {
    // 短码属性，设置默认值
    $atts = shortcode_atts(
        array(
            'name' => '访客',
        ),
        $atts,
        'mfp_hello'
    );

// 安全地输出内容
    return '<p>Olá, '. esc_html($atts['name'])'. ‘! Esta é a saudação gerada pelo meu plugin.</p>'php
add_shortcode('mfp_hello', 'mfp_hello_world_shortcode');

add_shortcode()A função aceita dois parâmetros: o nome da tag de código curto (o nome usado pelo usuário) e a função de processamento correspondente.shortcode_atts()A função é utilizada para combinar os atributos inseridos pelo usuário com os valores padrão, garantindo a robustez do código.

Testando códigos curtos no front-end

Após salvar o arquivo do plugin, vá para a página “Plugins” no painel administrativo do WordPress e ative o “Meu Primeiro Plugin”. Em seguida, crie ou edite um artigo e insira o código do plugin diretamente no editor de conteúdo.[mfp_hello name="小明"]Após a publicação do artigo, a página frontal exibirá: “Olá, Xiao Ming! Esta é a saudação gerada pelo meu plugin.” Se o atributo `name` não for fornecido, como…[mfp_hello]Nesse caso, será exibido o texto padrão “Olá, visitante!”.

resumos

Ao seguir este guia, você completou o processo completo de criação de um plugin básico para o WordPress, partindo do zero. Você aprendeu sobre a estrutura básica de um plugin, a importância das notas de cabeça (header comments), como adicionar um menu de administração no backend e como criar um código curto, mas útil, para o frontend. Estes são os pilares fundamentais do desenvolvimento de plugins para o WordPress.

A verdadeira jornada no desenvolvimento de plugins acabou de começar. Em seguida, você pode explorar o poderoso API de configurações do WordPress para criar opções que possam ser salvas, e também utilizar os ganchos de ação (action hooks).add_action()(Hooks for filters)add_filter()Vamos modificar o comportamento central do plugin, aprender como adicionar suporte a internacionalização e como processar dados dos usuários de forma segura. Lembre-se: seguir os padrões de codificação do WordPress e dar atenção à segurança são essenciais para o desenvolvimento de plugins de alta qualidade.

Perguntas frequentes Perguntas frequentes

Quais são os conhecimentos prévios necessários para desenvolver um plugin para o WordPress?

Você precisa ter conhecimentos básicos de programação em PHP, entender HTML e CSS, e estar familiarizado com as operações básicas do WordPress (como publicar artigos e instalar temas/plug-ins). Não é necessário ter conhecimento avançado em programação orientada a objetos (OOP), mas isso será muito útil para o desenvolvimento de plug-ins mais complexos.

O nome do arquivo principal do plugin deve ser o mesmo que o nome da pasta?

Não é obrigatório, mas essa é uma prática recomendada fortemente, pois torna a estrutura mais clara. O arquivo PHP do plugin principal pode ter qualquer nome, mas as suas anotações no início devem estar corretas, e o arquivo deve estar localizado dentro da própria pasta do plugin. O nome da pasta geralmente corresponde ao “slug” do plugin.

Como depurar o código do meu plugin?

Além de ativar…WP_DEBUGVocê também pode usar…error_log()A função escreve as informações de depuração no log de erros do servidor, ou utiliza outro método para armazená-las.var_dump()ewp_die()Realize verificações de saída (apenas para o ambiente de desenvolvimento). O uso de plugins de depuração, como o Query Monitor, também é uma opção eficiente.

Como posso publicar o plugin que desenvolvi no diretório oficial de plugins do WordPress?

Primeiramente, você precisa garantir que o código do plugin atenda aos requisitos de publicação do WordPress, incluindo a licença compatível com o GPL, a qualidade do código, a segurança e a internacionalização. Em seguida, solicite um repositório SVN no WordPress.org, suba o seu código e siga o processo de revisão. A equipe oficial fornece um manual detalhado para o envio de plugins.