Guia completo para o desenvolvimento de plugins do WordPress: construa o seu próprio plugin do zero.

A maneira mais poderosa de ampliar a funcionalidade de seu site WordPress é desenvolver seus próprios plugins. Seja para atender a uma necessidade comercial específica ou para compartilhar sua criatividade com a comunidade, o domínio das habilidades de desenvolvimento de plugins é fundamental para aprimorar seus recursos do WordPress. Este artigo o guiará por todo o processo de criação de um plug-in do WordPress totalmente funcional e compatível com os padrões a partir do zero.

Ambiente de desenvolvimento e preparação básica

Um ambiente de desenvolvimento estável e eficiente é essencial antes de você começar a escrever o código. Isso não apenas aumentará sua produtividade, mas também garantirá que o código do plug-in seja implantado sem problemas no futuro.

Criar um ambiente de desenvolvimento local

Recomenda-se o uso de software de ambiente de servidor local, como Local by Flywheel, XAMPP ou MAMP. Essas ferramentas permitem a implantação com um clique de ambientes completos contendo Apache/Nginx, MySQL/MariaDB e PHP. Certifique-se de que sua versão do PHP corresponda aos requisitos mínimos da versão do WordPress que você planeja suportar; geralmente, os funcionários do WordPress recomendam versões específicas do PHP.

Leitura recomendada O desenvolvimento de plug-ins do WordPress é uma extensão do núcleo do WordPress.。

Entendendo a estrutura do plug-in do WordPress

Um plug-in mais básico do WordPress pode ser um único arquivo PHP, mas um plug-in bem estruturado geralmente contém vários diretórios e arquivos. O arquivo principal do núcleo deve conter os comentários padrão do cabeçalho do plug-in, que são fundamentais para que o WordPress identifique o plug-in. Um diretório típico de plug-in pode incluir o arquivo principal (por exemployou-plugin-name.php）、includes/(para classes funcionais essenciais),admin/(Interface do administrador),public/(função de front-end),assets/(CSS, JavaScript, imagens) e olanguages/(Documento de internacionalizaçã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

Crie o seu primeiro plugin.

Vamos dar o primeiro passo criando um simples plug-in “Hello World”. Esse plug-in adicionará um item de menu à barra lateral de administração de seu site e exibirá uma mensagem de saudação em sua página.

Escreva o arquivo principal do plug-in e as informações de cabeçalho

Primeiramente, no WordPress…wp-content/pluginsCrie uma nova pasta na pasta principal, por exemplo:my-first-pluginDentro dessa pasta, crie um arquivo chamadomy-first-plugin.phpdo arquivo. Um comentário de cabeçalho específico do plug-in deve ser adicionado ao início do arquivo:

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

Esse comentário fornece informações básicas sobre o plug-in, que o WordPress lê e exibe na página de administração Plugins. Entre elas estãoText DomainPara a internacionalização.

Adição de menus e funções administrativas

Em seguida, usaremos a API do WordPress para adicionar um menu de administração. Vá em frente e adicione o seguinte código abaixo dos comentários no cabeçalho do mesmo arquivo:

Leitura recomendada Uma análise detalhada do WooCommerce: o guia completo para criar um site de comércio eletrônico profissional desde o início。

// Impedir o acesso direto
defined( 'ABSPATH' ) || exit;

/**
 * Adicionar menu de administração
 */
função mfp_add_admin_menu() {
    add_menu_page(
        'My first plugin settings', // título da página
        'My Plugins', // título do menu
        'manage_options', // permissões (admin)
        'my-first-plugin', // slug do menu
        'mfp_display_admin_page', // função de retorno de chamada para exibir a página
        'dashicons-smiley', // ícones (Dashicons)
        6 // Posição do menu
    );
}
add_action( 'admin_menu', 'mfp_add_admin_menu' );

/**
 * Exibir o conteúdo da página de administração
 */
function mfp_display_admin_page() {
    ? >
    <div class="wrap">
        <h1></h1>
        <p>Olá mundo! Esta é minha primeira página de plug-in do WordPress.</p>
    </div>
    &lt;?php
}

Depois de salvar o arquivo, faça login no backend do WordPress e vá para a página “Plugins”, onde deverá aparecer “My First Plugin”. Depois de ativá-lo, um item de menu chamado “My Plugins” aparecerá na barra de menu do administrador à esquerda; clique nele para ver a saudação que produzimos.

Desenvolvimento de núcleo de plug-in avançado

Um plug-in útil precisa processar dados, fornecer opções e interagir de forma segura com o sistema principal do WordPress.

Uso de Action Hooks e Filter Hooks

A arquitetura do plug-in do WordPress é construída com base em ganchos, que são divididos em Ações e Filtros. As ações permitem executar o código em um momento específico (por exemplo, ao publicar uma postagem), enquanto os filtros permitem modificar os dados (por exemplo, o conteúdo da postagem) antes de exportá-los.

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

Por exemplo, usamoswp_footerA ação adiciona uma mensagem ao rodapé no front-end do site:

função mfp_add_footer_text() {
    echo '<p style="text-align:center;">Obrigado por usar o meu primeiro plugin!</p>';
}
add_action( 'wp_footer', 'mfp_add_footer_text' );

Por exemplo, ao usar…the_contentO filtro adiciona um texto personalizado no final de cada postagem:

função mfp_append_to_content( $content ) {
    se ( is_single() ) {
        $extra_text = '<div class="mfp-note"><em>Este artigo foi aprimorado pelo My First Plugin.</em></div>'.
        $content . = $extra_text.
    }
    return $content.
}
add_filter( 'the_content', 'mfp_append_to_content' );

Criar a página de configurações do plugin

Para que os usuários configurem o plug-in, precisamos criar uma página de configurações com um formulário. Isso geralmente envolve o uso da API de configurações do WordPress, que lida com segurança com o registro, o salvamento e a validação das opções.

Leitura recomendada Desenvolvimento de plug-ins do WordPress: Criando módulos funcionais personalizados do zero ao um。

Primeiro, registre-se para uma opção de configuração:

// 在admin_menu钩子之后注册设置
function mfp_register_settings() {
    register_setting(
        'mfp_settings_group', // 选项组
        'mfp_custom_message', // 选项名
        array(
            'type' => 'string',
            'sanitize_callback' => 'sanitize_text_field', // 清理回调函数
            'default' => '这是默认的问候信息。'
        )
    );
}
add_action( 'admin_init', 'mfp_register_settings' );

Em seguida, na seçãomfp_display_admin_pageque gera um formulário para salvar essa opção:

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

function mfp_display_admin_page() {
    // Verificar as permissões do usuário
    Se ( ! 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( 'mfp_settings_group' ); // 输出安全字段
            do_settings_sections( 'my-first-plugin' ); // 如果有设置区块，这里输出
            ?>
            <table class="form-table">
                <tr>
                    <th scope="row"><label for="mfp_custom_message">Mensagens personalizadas</label></th>
                    <td>
                        <input name="mfp_custom_message"
                               type="text"
                               id="mfp_custom_message"
                               value="<?php echo esc_attr( get_option( 'mfp_custom_message' ) ); ?>"
                               class="regular-text">
                        <p class="description">Digite a mensagem personalizada que deseja exibir no rodapé.</p>
                    </td>
                </tr>
            </table>
            
        <input type="hidden" name="trp-form-language" value="pt"/></form>
    </div>
    &lt;?php
}

Lançamento e manutenção de plugins

Após a conclusão do desenvolvimento, talvez você queira compartilhar seus resultados com outras pessoas ou implantá-los em um ambiente de produção, o que requer algumas etapas adicionais para garantir a qualidade e a capacidade de manutenção do plug-in.

Preparação para Internacionalização e Localização

Para que o seu plug-in seja usado por usuários de todo o mundo, ele deve estar preparado para a internacionalização (i18n). Isso significa que todas as strings voltadas para o usuário devem ser agrupadas usando as funções de tradução do WordPress.

Modificar todo o texto de saída anterior, por exemplo:

echo '<p>' . esc_html__( 'Obrigado por usar meu primeiro plugin! , 'my-first-plugin' ) . '</p>';

Uso em descrições e funções de plugins__()ou_e()e outras funções. Em seguida, você pode usar uma ferramenta como o Poedit para criar o.potArquivo de modelo, para que o tradutor possa criá-lo..poe.moArquivos de idioma.

Segurança de código e otimização de desempenho

A segurança é fundamental. Sempre valide (Validação) e sanitize (Sanitização) a entrada do usuário e escape (Escapando) a saída. Use o Nonce fornecido pelo WordPress para evitar a falsificação de solicitações entre sites (CSRF) e use as Verificações de capacidade para validar as permissões do usuário.

Quanto ao desempenho, faça uso criterioso do cache transitório do WordPress (API Transients) para armazenar os resultados de consultas demoradas e evitar a execução de operações complexas de banco de dados em cada carregamento de página. Além disso, certifique-se de enfileirar scripts e estilos corretamente (usando owp_enqueue_scriptewp_enqueue_style) e especificar as dependências.

resumos

O desenvolvimento de plug-ins do WordPress é o processo de transformar ideias em funcionalidade e exige que os desenvolvedores estejam familiarizados com PHP, a API principal do WordPress e boas práticas de engenharia de software. Cada etapa é fundamental, desde a configuração do ambiente e a criação dos arquivos básicos do plug-in até a extensão da funcionalidade com ganchos, a criação da interface de configurações do usuário e a preparação para o lançamento. Seguir práticas seguras de codificação, preparar-se para a internacionalização e otimizar o desempenho tornará seu plug-in mais profissional e confiável. Continuar aprendendo o Codex do WordPress e os recursos para desenvolvedores é fundamental para aprimorar continuamente suas habilidades de desenvolvimento de plugins.

Perguntas frequentes Perguntas frequentes

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

Você precisará ter uma base sólida em programação PHP, pois o WordPress e seus plug-ins são escritos principalmente em PHP. Também é necessário um conhecimento básico de HTML, CSS e JavaScript para lidar com interfaces e interações de front-end. Compreender os conceitos básicos dos bancos de dados MySQL (por exemplo, consultas) também ajuda, mas as funções do WordPress (por exemplo, oWP_Query) encapsulou a maioria das operações do banco de dados.

Como depurar o meu plugin do WordPress?

Primeiro, certifique-se de que…wp-config.phpO ficheiro foi aberto.WP_DEBUGeWP_DEBUG_LOG. Isso registra erros, notificações e avisos do PHP no arquivowp-content/debug.logno arquivo em vez de exibi-lo na página. Em segundo lugar, você pode usar a opçãoerror_log()gera informações de depuração personalizadas. Além disso, as guias Console e Rede nas Ferramentas do desenvolvedor do navegador são essenciais para a depuração de solicitações JavaScript e AJAX.

Como o meu plugin é compatível com o tema ou outros plugins?

Para maximizar a compatibilidade, sempre use as APIs e funções oficiais do WordPress e evite usar funções não divulgadas ou manipular o banco de dados diretamente. Use prefixos exclusivos para suas funções, classes e variáveis (como em nosso exemplo com o prefixomfp_) para evitar conflitos de nomes. Sempre que possível, forneça filtros (apply_filters) Permita que outros desenvolvedores modifiquem o comportamento do seu plug-in e acionem discretamente suas próprias ações extensíveis (do_action）。

Como devo distribuir e vender meu plug-in?

Para plug-ins gratuitos, a maneira mais fácil é enviar para o diretório oficial de plug-ins do WordPress. Isso exige que você siga as diretrizes relevantes e garanta que o código esteja em conformidade com os padrões. Para plugins premium (pagos), você pode vendê-los em seu próprio site por meio de uma loja digital (por exemplo, integração com Easy Digital Downloads ou WooCommerce). De qualquer forma, fornecer documentação clara, suporte oportuno para atualizações e código seguro é fundamental para o sucesso.