Guia definitivo para o desenvolvimento de plugins do WordPress: o caminho para dominar, desde o início até a prática.

Para desenvolver um plugin para o WordPress, é necessário primeiro entender sua estrutura básica. Um plugin é, essencialmente, um ou mais arquivos PHP que seguem especificações específicas do WordPress e interagem com o núcleo do sistema através de um sistema de “ganchos” (hooks), permitindo a expansão ou modificação das funcionalidades do site. Para criar um plugin, você precisa no mínimo de um arquivo principal que contenha as anotações padrão de cabeçalho de um plugin; essas anotações são cruciais para que o WordPress reconheça o plugin.

Construa o seu primeiro plugin.

Vamos começar criando o plugin mais simples possível, que exibe a mensagem “Hello World”. Esse processo ajudará você a se familiarizar com a estrutura dos plugins, bem como com os procedimentos de ativação e desativação deles.

Criar o arquivo principal do plugin

Primeiramente, dentro do diretório de instalação do seu WordPress…wp-content/pluginsDentro da pasta, crie uma nova pasta, por exemplo…my-first-pluginDentro dessa pasta, crie um arquivo chamadomy-first-plugin.phpO arquivo principal de PHP. O nome deste arquivo geralmente é o mesmo que o nome da pasta.

Leitura recomendada Guia Definitivo para Desenvolvimento de Plugins para WordPress: Construa o Seu Primeiro Plugin do Zero。

Abramy-first-plugin.phpArquivo, insira as seguintes informações de cabeçalho do plugin padrão:

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:       这是一个用于学习的简单Hello World插件。
 * Version:           1.0.0
 * Author:            你的名字
 * Author URI:        https://example.com
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 */

Este comentário é de extrema importância. O WordPress realiza a análise (scanning) para…wp-content/pluginse todos os arquivos PHP em seus subdiretórios.Plugin Name:O sistema identifica os plugins e os exibe na página de gerenciamento de plugins, que fica em segundo plano (no backend).

Implementar funções básicas e ativar ganchos (hooks).

Em seguida, adicionaremos uma função simples ao plugin: exibir uma linha de texto personalizado no rodapé do site. Além disso, utilizaremos os ganchos de ciclo de vida do WordPress para demonstrar as ações que podem ser executadas quando o plugin é ativado ou desativado.

Abaixo dos comentários no cabeçalho, continue adicionando o seguinte código:

// 定义一个函数，在页脚输出信息
function my_first_plugin_display_footer_text() {
    echo '<p style="text-align: center;">Bem-vindo ao meu primeiro plugin para WordPress!</p>';
}
// 使用 ‘wp_footer’ 动作钩子挂载我们的函数
add_action( 'wp_footer', 'my_first_plugin_display_footer_text' );

// 插件激活时执行的操作
function my_first_plugin_activate() {
    // 可能在这里创建数据库表、设置默认选项等
    update_option( 'my_first_plugin_installed', current_time( 'mysql' ) );
}
register_activation_hook( __FILE__, 'my_first_plugin_activate' );

// 插件停用时执行的操作
function my_first_plugin_deactivate() {
    // 清理临时数据，但保留可能由用户创建的数据
    delete_option( 'my_first_plugin_installed' );
}
register_deactivation_hook( __FILE__, 'my_first_plugin_deactivate' );

Agora, faça login no painel administrativo do seu WordPress e vá para a página “Plugins”. Você deve ver um plugin chamado “Meu Primeiro Plugin”. Clique em “Ativar” (Enable). Em seguida, acesse a página frontal do seu site e role até o final; você verá o texto personalizado que foi adicionado. Este exemplo simples mostra o processo básico de criação e funcionamento de um plugin.

Leitura recomendada Guia completo para o desenvolvimento de plugins do WordPress: construa o seu primeiro plugin do zero.。

Compreender profundamente o sistema de ganchos (hooks) do WordPress

Os “ganchos” (hooks) são a pedra fundamental no desenvolvimento de plugins para o WordPress. Eles permitem que você insira o seu próprio código em pontos específicos da execução do código do núcleo do WordPress, sem a necessidade de modificar os arquivos originais do núcleo. Os ganchos são divididos principalmente em dois tipos: Ações (Actions) e Filtros (Filters).

Uso dos ganchos de ação (Action Hooks)

Os ganchos de ação (action hooks) são executados quando eventos específicos ocorrem, como a publicação de um artigo ou o carregamento da cabeça ou do rodapé da página. Eles não esperam retornar nenhum valor; sua única função é “executar um trecho de código”. Já usamos isso no primeiro plugin.wp_footerEste é um gatilho de ação.

Outro exemplo comum é…initO “hook” é um mecanismo que é acionado durante a inicialização do WordPress e é frequentemente utilizado para registrar tipos de artigos ou categorias personalizados.

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

function my_plugin_custom_init() {
    // 在这里注册自定义文章类型
}
add_action( 'init', 'my_plugin_custom_init' );

Os ganchos de ação (action hooks) funcionam através de…add_action( $hook_name, $function_to_add, $priority, $accepted_args )Montagem de funções.

Uso dos ganchos de filtro (Filter Hooks)

Os ganchos (hooks) dos filtros são usados para modificar os dados. Eles são enviados para você antes que os dados sejam utilizados (por exemplo, armazenados em um banco de dados ou exibidos em um navegador). Após a sua manipulação, você retorna o valor modificado.the_contentOs filtros permitem-lhe alterar o conteúdo dos artigos.

function my_plugin_add_disclaimer_to_content( $content ) {
    if ( is_single() ) {
        $disclaimer = '<p><em>Este texto foi processado pelo meu plugin.</em></p>';
        $content .= $disclaimer;
    }
    return $content; // 必须返回修改后的内容
}
add_filter( 'the_content', 'my_plugin_add_disclaimer_to_content' );

O filtro hook passou com sucesso.add_filter( $hook_name, $function_to_add, $priority, $accepted_args )Montagem de funções. Prioridade$priorityDetermina a ordem de execução de várias funções quando elas são montadas no mesmo “gancho” (hook). Quanto menor o número, maior a prioridade.

Leitura recomendada Guia de introdução para iniciantes no desenvolvimento de plugins do WordPress: crie o seu primeiro plugin funcional do zero.。

Arquitetura de plugins e melhores práticas de segurança

À medida que as funcionalidades dos plugins se tornam mais complexas, uma boa arquitetura e medidas de segurança rigorosas são essenciais para garantir que os plugins sejam estáveis, fáceis de manter e seguros.

Adotar a programação orientada a objetos

对于功能丰富的插件，建议使用类（Class）来组织代码。这有助于封装功能，避免函数名冲突，并使代码结构更清晰。

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

<?php
/**
 * Plugin Name: 高级示例插件
 */
if ( ! class_exists( 'Advanced_Sample_Plugin' ) ) {
    class Advanced_Sample_Plugin {
        public function __construct() {
            // 在构造函数中挂载钩子
            add_action( 'wp_footer', array( $this, 'display_message' ) );
            add_filter( 'the_title', array( $this, 'modify_title' ) );
        }

public function display_message() {
            echo &#039;<p>Mensagem proveniente da categoria de plugins avançados.</p>';
        }

public function modify_title( $title ) {
            return '前缀 - ' . $title;
        }
    }
    // 初始化插件类
    new Advanced_Sample_Plugin();
}

Implementar medidas de proteção de segurança

A segurança dos plugins do WordPress é de extrema importância. O princípio fundamental é: nunca confie no que os usuários inserem. Tudo o que vem de…$_GET，$_POST，$_COOKIETodos os dados obtidos a partir de variáveis ultraglobais devem ser verificados, limpos e escapados.

1. 验证：检查数据是否符合预期格式（如是否为邮箱、数字）。使用sanitize_email()，is_email()Funções como essas.
2. 清理：移除数据中非法或不安全的字符。对于文本输入，使用sanitize_text_field()Para o conteúdo que permite o uso de HTML, utilize:wp_kses_post()ouwp_kses()。
3. 转义：在将数据输出到HTML、JavaScript或URL时，确保其被安全编码。使用esc_html()，esc_js()，esc_url()Funções como essas.

Por exemplo, ao lidar com um atributo de código abreviado:

function my_shortcode_handler( $atts ) {
    // 使用 shortcode_atts 设置默认值并提取属性
    $atts = shortcode_atts( array(
        'url' => '#',
    ), $atts, 'my_shortcode' );

// 清理并转义 URL 属性
    $clean_url = esc_url( $atts['url'] );

return "<a href='/pt/{$clean_url}/'>Link seguro</a>"php
add_shortcode('my_shortcode', 'my_shortcode_handler');

Adicionar uma interface de gerenciamento e suporte à internacionalização para o plugin.

Um plugin maduro geralmente requer opções de configuração e deve levar em conta o suporte a múltiplas línguas.

Criar a página de configurações de gerenciamento

Use a API de Configurações (Settings API) do WordPress para criar páginas de gerenciamento seguras e padronizadas. Esta é a maneira recomendada, pois ela lida com questões de segurança (verificação de nonce) e consistência na interface dos formulários.

A seguir, está um exemplo simplificado de como adicionar um menu principal e uma página de configurações:

class My_Plugin_Admin {
    public function __construct() {
        add_action( 'admin_menu', array( $this, 'add_admin_menu' ) );
        add_action( 'admin_init', array( $this, 'settings_init' ) );
    }

public function add_admin_menu() {
        add_menu_page(
            '我的插件设置', // 页面标题
            '我的插件',     // 菜单标题
            'manage_options', // 权限
            'my-plugin',      // 菜单slug
            array( $this, 'options_page_html' ) // 回调函数，输出页面内容
        );
    }

public function settings_init() {
        register_setting( 'my_plugin_settings', 'my_plugin_options' ); // 注册设置

// 添加设置区域和字段
        add_settings_section( 'my_plugin_section', '主要设置', null, 'my-plugin' );
        add_settings_field( 'api_key', 'API密钥', array( $this, 'api_key_field_html' ), 'my-plugin', 'my_plugin_section' );
    }

public function api_key_field_html() {
        $options = get_option( 'my_plugin_options' );
        ?>
        <input type='text' name='my_plugin_options[api_key]' value='<?php echo esc_attr( $options['api_key'] ?? '' ); ?>'>
        <?php
    }

public function options_page_html() {
        // 检查用户权限
        if ( ! current_user_can( 'manage_options' ) ) return;
        ?>
        <div class="wrap">
            <h1></h1>
            <form action="/pt/options.php/" method="post" data-trp-original-action="options.php">
                <?php
                settings_fields( 'my_plugin_settings' );
                do_settings_sections( 'my-plugin' );
                submit_button();
                ?>
            <input type="hidden" name="trp-form-language" value="pt"/></form>
        </div>
        &lt;?php
    }
}
new My_Plugin_Admin();

Implementar a internacionalização de plugins

Para que o plugin possa ser usado por usuários de todo o mundo, é necessário suportar múltiplas línguas. Isso é alcançado através do uso de…__( ‘Text’， ’text-domain’ )e_e( ‘Text’， ’text-domain’ )As funções de tradução envolvem todo o texto visível para os usuários para realizar a tradução. Você as definiu anteriormente nos comentários no início do plugin.Text Domain: my-first-pluginFoi preparado exatamente para isso.

1. 在代码中，对所有需要翻译的字符串使用翻译函数：

    echo __( ‘欢迎使用我的插件！’， ‘my-first-plugin’ );
    $title = esc_html__( ‘设置页面’， ‘my-first-plugin’ );

2. 使用如Poedit这样的工具，扫描插件代码中的翻译字符串，生成.potArquivos de modelo. Com base neles, os tradutores criam as versões correspondentes para cada idioma..poE o compilado.moArquivos (como)zh_CN.po/mo）。
3. 将这些语言文件放置在插件的languagesNo diretório correspondente. O WordPress carregará automaticamente as traduções apropriadas de acordo com as configurações de idioma do site.

resumos

O desenvolvimento de plugins para o WordPress é um processo que vai desde scripts simples até aplicações complexas. O ponto-chave é entender e utilizar com habilidade o sistema de ganchos (hooks), integrando suas funcionalidades de forma transparente no ciclo de vida do WordPress através de ações (actions) e filtros (filters). Seguir os princípios da arquitetura orientada a objetos (Object-Oriented Architecture) pode melhorar a organização e a manutenibilidade do código. A segurança é a pedra fundamental do desenvolvimento; é essencial verificar, limpar e escapalar qualquer entrada fornecida pelo usuário. Por fim, crie uma interface de administração profissional utilizando a API Settings e utilize funções de internacionalização (internationalization) para expandir o alcance do seu plugin para todo o mundo. Comece criando algo simples…my-first-plugin.phpComeçando a praticar gradualmente esses conceitos, você será capaz de desenvolver plugins para o WordPress que sejam poderosos, seguros e populares.

Perguntas frequentes Perguntas frequentes

Quais são os conhecimentos básicos necessários para desenvolver um plugin do WordPress?

Você precisa dominar a linguagem de programação PHP, pois os plugins são principalmente escritos em PHP. Além disso, é necessário ter um conhecimento básico de HTML, CSS e JavaScript para construir interfaces e interações no lado front-end. O mais importante é entender o funcionamento básico do WordPress, como temas, ganchos (hooks), ciclos e métodos de armazenamento de dados.

Posso testar o plugin localmente sem afetar o site online?

Claro que sim, e isso é fortemente recomendado. Você deve desenvolver os plugins em um ambiente de desenvolvimento local (como usando ferramentas como XAMPP, MAMP, Local by Flywheel, etc.) ou em um servidor de teste independente. Isso evitará que erros no código causem o colapso do site online ou a perda de dados.

Como depurar o código do meu plugin?

O WordPress disponibiliza vários ferramentas de depuração. Primeiramente,wp-config.phpAtivar o modo de depuração no arquivo: DefiniçãoWP_DEBUGConstantes são…trueIsso exibirá diretamente os erros, avisos e notificações do PHP na página. Para um depuramento mais complexo, é possível usar…error_log()A função grava as informações no log de erros do servidor ou utiliza plugins de depuração especializados, como o Query Monitor, que fornece detalhes sobre consultas ao banco de dados, ganchos (hooks), erros do PHP, entre outros.

Após a conclusão do desenvolvimento, como enviar o plugin para o diretório oficial do WordPress?

Você precisa acessar o WordPress.org e criar uma conta. Em seguida, use o ferramenta Subversion (SVN) para enviar o código do seu plugin para o repositório SVN fornecido pelo WordPress. Antes de enviar, verifique se o código do plugin atende aos padrões e guias oficiais de desenvolvimento de plugins, incluindo requisitos de segurança, qualidade do código, documentação e internacionalização. Após a aprovação, o seu plugin será exibido no diretório oficial para que os usuários possam baixá-lo e instalá-lo.