Iniciar uma jornada de desenvolvimento de plugins para o WordPress significa que você dominou a criação de recursos para uma audiência global.

Iniciar o caminho no desenvolvimento de plugins para o WordPress significa que você adquiriu a capacidade de adicionar novas funcionalidades, automatizar processos e criar valor único para milhões de sites em todo o mundo. Seja para atender a necessidades específicas do negócio ou para compartilhar suas soluções com a comunidade, entender a arquitetura e os princípios fundamentais do WordPress é o primeiro passo para o sucesso. Um plugin é, essencialmente, um conjunto de códigos PHP que segue as convenções e APIs do WordPress, integrando-se perfeitamente ao sistema principal. Ele pode modificar ou aprimorar o comportamento da plataforma através de “ganchos” (Hooks) e “filtros” (Filters).

Configurar o ambiente de desenvolvimento e criar plugins básicos

Antes de começar a escrever a primeira linha de código, um ambiente de desenvolvimento isolado e profissional é de extrema importância. Recomendamos o uso de ferramentas de desenvolvimento locais como Local by Flywheel, DevKinsta ou MAMP, que permitem configurar rapidamente um ambiente com PHP, MySQL e WordPress.

Criar o primeiro arquivo de plugin

Tudo começou com um arquivo PHP. No caso do WordPress… wp-content/plugins No diretório, crie uma nova pasta para o seu novo plugin. Por exemplo, vamos criar uma pasta chamada… my-first-plugin O diretório correspondente. Em seguida, crie o arquivo principal dentro desse diretório; geralmente, o nome do arquivo é o mesmo que o nome do diretório.my-first-plugin.php。

Leitura recomendada De zero a um: um guia completo para o desenvolvimento de plug-ins do WordPress e tutoriais práticos。

As notas de cabeça deste arquivo principal são como o “cartão de identidade” do plugin, fornecendo todas as metadados necessárias para que o WordPress reconheça o plugin. Aqui está a estrutura básica:

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

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

Após salvar o arquivo, faça login no painel administrativo do seu WordPress e vá para a página “Plugins”. Você deve ver um novo plugin chamado “Meu Primeiro Plugin”. Embora ele não tenha nenhuma funcionalidade no momento, você pode ativá-lo ou desativá-lo. Isso significa que você criou com sucesso a estrutura básica para um plugin.

Compreender os conceitos centrais: Ganchos de Ação (Action Hooks) e Filtros (Filters)

O núcleo do desenvolvimento de plugins para o WordPress é o mecanismo de “ganchos” (hooks). Os ganchos permitem que o seu código seja inserido no fluxo principal do WordPress em momentos específicos, para que a sua lógica seja executada.

Action Hook

Os “Action Hooks” executam código quando eventos específicos ocorrem, como a publicação de um artigo, o login de um usuário ou o carregamento de um modelo. Você os utiliza para automatizar certas ações ou processos em seu aplicativo. add_action() A função associa a sua função de callback (função de retorno) ao “gancho” (hook).

Por exemplo, queremos exibir uma mensagem personalizada no topo da página de edição de artigos no painel de administração. Podemos usar… edit_form_top Este é um gatilho de ação.

Leitura recomendada Como escolher e desenvolver plugins WordPress de alta qualidade: um guia do iniciante ao especialista.。

// 在文章编辑页面顶部添加自定义提示
add_action( 'edit_form_top', 'myplugin_edit_form_top_message' );
function myplugin_edit_form_top_message( $post ) {
    if ( 'post' === $post->post_type ) {
        echo '<div class="notice notice-info"><p>Este é um aviso personalizado vindo do ‘Meu Primeiro Plugin”!</p></div>';
    }
}

Ganchos de filtro

Os “Filter Hooks” são usados para modificar dados. Eles permitem que você altere os valores dos dados antes que eles sejam utilizados (por exemplo, armazenados em um banco de dados ou exibidos em um navegador). add_filter() Função.

Um exemplo clássico é modificar as últimas palavras do conteúdo de um artigo. Podemos usar… the_content Filtro.

// 在文章内容末尾附加版权信息
add_filter( 'the_content', 'myplugin_add_copyright_to_content' );
function myplugin_add_copyright_to_content( $content ) {
    if ( is_single() ) {
        $content .= '<p><small>© 2026 Todos os direitos reservados. Este texto foi otimizado pelo meu plugin.</small></p>';
    }
    return $content;
}

Criar uma página de gerenciamento de plugins e suas opções.

Para permitir que os usuários configurem o seu plugin, você precisa criar uma página de configurações para eles. O WordPress disponibiliza uma API avançada para adicionar páginas ao menu de gerenciamento e para manipular as opções disponíveis.

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

Adicionar menu de gerenciamento

fazer uso de add_menu_page() ou add_options_page() As funções permitem adicionar um menu de nível superior ou subnível ao seu plugin. Geralmente, plugins simples são adicionados ao menu “Configurações” como uma página subordinada.

Primeiramente, precisamos criar uma função que seja acionada durante a inicialização do administrador para registrar o menu.

// 在管理后台添加设置菜单
add_action( 'admin_menu', 'myplugin_add_admin_menu' );
function myplugin_add_admin_menu() {
    add_options_page(
        '我的插件设置',          // 页面标题
        '我的插件',             // 菜单标题
        'manage_options',      // 所需权限
        'myplugin-settings',   // 菜单别名 (slug)
        'myplugin_render_settings_page' // 用于输出页面内容的回调函数
    );
}

Página de configurações de renderização e opções de salvamento

Em seguida, precisamos definir… myplugin_render_settings_page Uma função é utilizada para gerar o formulário HTML da página e para lidar com o salvamento dos dados do formulário. Vamos usar a API de Configurações (Settings API) do WordPress para registrar, verificar e salvar as opções de forma segura.

Leitura recomendada Como escolher e desenvolver plugins WordPress de alta qualidade: do início ao fim.。

// 渲染设置页面
function myplugin_render_settings_page() {
    ?>
    <div class="wrap">
        <h1>Configurações do meu plugin</h1>
        <form action="/pt/options.php/" method="post" data-trp-original-action="options.php">
            <?php
            // 输出必要的安全字段和隐藏字段
            settings_fields( 'myplugin_settings_group' );
            // 输出设置章节和字段
            do_settings_sections( 'myplugin-settings' );
            // 输出提交按钮
            submit_button();
            ?>
        <input type="hidden" name="trp-form-language" value="pt"/></form>
    </div>
    <?php
}

// 初始化设置
add_action( 'admin_init', 'myplugin_settings_init' );
function myplugin_settings_init() {
    // 注册一个设置组和字段
    register_setting(
        'myplugin_settings_group', // 设置组名
        'myplugin_option_message'  // 选项名，将保存在 wp_options 表中
    );

    // 添加一个设置章节
    add_settings_section(
        'myplugin_section_basic',
        '基础设置',
        null, // 章节描述回调函数，可以为空
        'myplugin-settings' // 页面别名
    );

    // 向章节添加一个字段
    add_settings_field(
        'myplugin_field_message',
        '自定义消息',
        'myplugin_field_message_render', // 渲染字段 HTML 的函数
        'myplugin-settings',
        'myplugin_section_basic'
    );
}

// 渲染 ‘自定义消息’ 字段
function myplugin_field_message_render() {
    $option = get_option( 'myplugin_option_message' );
    ?>
    <input type='text' name='myplugin_option_message' value='<?php echo esc_attr( $option ); ?>'>
    <p class="description">As mensagens inseridas aqui serão exibidas na interface frontal.</p>
    &lt;?php
}

Agora, você pode ver uma página de configurações em “Configurações” -> “Meus Plugins”, que contém um campo de entrada de texto, e pode salvar as mensagens. Para usar esta funcionalidade, você pode fazê-lo na interface do usuário. get_option( 'myplugin_option_message' ) Obtenha o seu valor.

Implementar códigos curtos personalizados

Os códigos curtos (shortcodes) permitem que os usuários utilizem etiquetas simples entre parênteses quadrados (como…) [my_shortcode]Incorporar conteúdo dinâmico em artigos, páginas ou ferramentas é uma maneira amigável ao usuário de utilizar as funcionalidades avançadas oferecidas pelos plugins.

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

Registar um código curto

fazer uso de add_shortcode() Uma função para registrar seu código curto. Ela aceita dois parâmetros: o rótulo do código curto e a função de processamento.

Por exemplo, criamos um código abreviado. [display_greeting]Ele pode exibir diferentes saudações de acordo com a hora e, opcionalmente, aceitar um… name Parâmetros.

// 注册自定义短代码
add_shortcode( 'display_greeting', 'myplugin_render_greeting_shortcode' );
function myplugin_render_greeting_shortcode( $atts ) {
    // 设置默认属性值
    $attributes = shortcode_atts(
        array(
            'name' => '访客',
        ),
        $atts,
        'display_greeting'
    );

    // 获取当前小时
    $hour = date( 'H' );
    $greeting = '';

    if ( $hour < 12 ) {
        $greeting = '早上好';
    } elseif ( $hour &lt; 18 ) {
        $greeting = &#039;下午好&#039;;
    } else {
        $greeting = &#039;晚上好&#039;;
    }

    // 构建输出
    $output = sprintf(
        &#039;<div class="myplugin-greeting"><p><strong>%s, %s!</strong> Bem-vindo(a) ao nosso site.</p></div>',
        esc_html( $greeting ),
        esc_html( $attributes['name'] )
    );

    return $output;
}

Os usuários agora podem inserir conteúdo no editor. [display_greeting name="张三"]Durante a renderização da página, esse texto será substituído por uma saudação personalizada.

resumos

O desenvolvimento de plugins para o WordPress é um processo poderoso e flexível, cujo essência reside na compreensão e no uso do sistema de ganchos (hooks) e da API do core. Começando com a criação de um arquivo PHP que contém as cabeças padrão, você pode expandir as funcionalidades através de ganchos de ações (actions) e filtros (filters), utilizar a API de configurações para criar interfaces amigáveis ao usuário, e ainda fornecer códigos encurtados (shortcodes) que facilitam a utilização do plugin. Dessa forma, você constrói um plugin com uma estrutura básica e módulos de funcionalidades comuns. Ao combinar esses módulos, aprofundando suas funcionalidades e seguindo os padrões de codificação e as melhores práticas de segurança do WordPress, você será capaz de criar plugins poderosos que atendam a uma variedade de necessidades.

Perguntas frequentes Perguntas frequentes

Quais são os conhecimentos básicos necessários para desenvolver plugins para o WordPress?

Você precisa ter conhecimentos básicos da linguagem de programação PHP, pois os plugins são principalmente escritos em PHP. Além disso, um entendimento básico de HTML, CSS e JavaScript será útil para criar interfaces de usuário e funcionalidades interativas. O mais importante é estar familiarizado com os conceitos fundamentais do WordPress, como os ganchos (Hooks), o ciclo de execução (The Loop) e a estrutura hierárquica dos templates.

Como depurar um plugin do WordPress que está em desenvolvimento?

Recomenda-se ativar o modo de depuração do WordPress no ambiente de desenvolvimento local. wp-config.php No arquivo, será… WP_DEBUG A constante foi definida como… trueVocê também pode instalar plugins de monitoramento de consultas (como o Query Monitor) para rastrear consultas ao banco de dados, execuções de “ganchos” (hooks) e carregamentos de scripts. Isso é muito útil para a otimização de desempenho e a verificação da lógica do código.

Como meu plugin pode suportar internacionalização?

O WordPress utiliza o framework GNU gettext para a internacionalização. Você deve definir isso no topo do arquivo principal do seu plugin. Text Domain e Domain PathNo código, use… __()、_e() As funções `str_replace`, `str_replace_all`, `str_replace_if`, etc., são usadas para envolver todas as strings que precisam ser traduzidas. Em seguida, ferramentas como o Poedit são utilizadas para gerar o texto traduzido. .pot Arquivo de modelo, para que os tradutores possam criá-lo. .po e .mo Documentos.

Como enviar meu plugin de forma segura para o diretório oficial de plugins do WordPress?

Primeiramente, você precisa criar uma conta no WordPress.org e enviar o seu plugin. O seu código deve seguir os padrões de codificação do WordPress e não deve conter nenhum código encriptado ou obstruído. O diretório do plugin, o arquivo principal, as capturas de tela e o arquivo README devem seguir estruturas específicas. A equipe de revisão verificará a qualidade do código, a segurança e o acordo de licença (que deve ser compatível com a GPL).