Desenvolvimento de plugins do WordPress: construir extensões poderosas para websites do zero.

O WordPress, como o sistema de gestão de conteúdo mais popular em todo o mundo, deve sua grande capacidade de expansão em grande parte à sua arquitetura de plugins. Ao desenvolver plugins personalizados, os desenvolvedores podem adicionar qualquer funcionalidade necessária ao site. Este artigo irá guiá-lo desde o início, ajudando você a entender os conceitos fundamentais, a arquitetura e as melhores práticas do desenvolvimento de plugins para WordPress, até construir, no final, uma extensão para o site que seja segura, eficiente e de fácil manutenção.

Conceitos centrais dos plugins para WordPress

Antes de começar a escrever o código, é essencial entender a estrutura básica e o funcionamento dos plugins do WordPress. Um plugin é, essencialmente, um conjunto de um ou mais arquivos que expandem ou modificam as funcionalidades principais do site através da API (Interface de Programação de Aplicações) fornecida pelo WordPress.

A estrutura básica de um plugin

Um plugin padrão do WordPress precisa de pelo menos um arquivo principal. O nome desse arquivo principal geralmente é o mesmo que o nome do diretório do plugin. Por exemplo, se o nome do seu diretório de plugins for…my-awesome-pluginEntão, o nome do arquivo principal pode ser…my-awesome-plugin.phpA cabeça deste arquivo deve conter anotações com informações específicas sobre o plugin, que são essenciais para que o WordPress reconheça o plugin.

Leitura recomendada Guia de desenvolvimento de plugins para o WooCommerce: Criando funcionalidades personalizadas para lojas virtuais do zero。

/**
 * Plugin Name:      我的强大扩展
 * Plugin URI:        https://example.com/my-awesome-plugin
 * Description:       这是一个用于演示的WordPress插件。
 * Version:           1.0.0
 * Author:            你的名字
 * License:           GPL v2 or later
 * Text Domain:       my-awesome-plugin
 */

Compreender o mecanismo dos “ganchos” (hooks)

O núcleo do funcionamento dos plugins para o WordPress é o sistema de “ganchos” (Hooks). Existem dois tipos de ganchos: os Ganchos de Ação (Action Hooks) e os Ganchos de Filtro (Filter Hooks). Os Ganchos de Ação permitem que você execute código personalizado em momentos específicos, como após a publicação de um artigo ou durante o carregamento do menu do painel de administração. Já os Ganchos de Filtro permitem que você modifique os dados utilizados no processo, como o conteúdo do artigo, o título ou os resultados de uma busca.

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

Por exemplo, ao usar… add_action A função pode adicionar um texto no fundo da página quando o usuário visita o site:

add_action( 'wp_footer', 'my_custom_footer_message' );
function my_custom_footer_message() {
    echo '<p>Obrigado por visitar este site!</p>';
}

Crie o seu primeiro plugin.

Nesta seção, você será guiado passo a passo na criação de um simples plugin funcional, a fim de se familiarizar com o processo de desenvolvimento e o ambiente de trabalho.

Criar um diretório de plugins e arquivos

Primeiramente, no diretório de instalação do WordPress…wp-content/pluginsDentro da pasta, crie uma nova pasta, por exemplo…greeting-pluginNesse diretório, crie o arquivo PHP principal.greeting-plugin.phpE escreva as informações do cabeçalho do plugin acima mencionado.

Implementar uma função simples de saudação.

Vamos criar um widget que exibe mensagens de saudação no painel de controle do backend do site. Adicione o seguinte código ao arquivo principal para utilizá-lo. wp_dashboard_setup Action Hook.

Leitura recomendada Análise dos ficheiros de plug-in do núcleo do WordPress.。

add_action( 'wp_dashboard_setup', 'greeting_plugin_add_dashboard_widget' );
function greeting_plugin_add_dashboard_widget() {
    wp_add_dashboard_widget(
        'greeting_dashboard_widget', // 小部件ID
        '每日问候', // 小部件标题
        'greeting_dashboard_widget_content' // 回调函数，用于输出内容
    );
}
function greeting_dashboard_widget_content() {
    $user = wp_get_current_user();
    echo '<h3>你好，' . esc_html( $user-&gt;display_name ) . '！</h3>'echo '<p>Desejo que você tenha um dia de trabalho tranquilo e bem-sucedido!</p>';
}

Após concluir os passos acima, faça login no painel administrativo do WordPress e vá para a página de “Plugins”. Você deve ver um plugin chamado “My Powerful Extension”; ative-o. Em seguida, atualize a página do painel de controle (dashboard) para visualizar o novo widget “Saudação Diária” que foi adicionado.

Práticas Avançadas de Desenvolvimento de Plugins

Um plugin bem desenvolvido geralmente precisa lidar com opções de configuração, recursos estáticos e seguir normas de segurança.

Criar a página de gerenciamento de plugins.

Adicionar uma página de configurações para um plugin é um requisito comum. Isso geralmente é feito através de… add_menu_page ou add_submenu_page A função foi concluída. O código a seguir demonstra como adicionar um item de menu principal na barra lateral no lado de gestão posterior.

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

add_action( 'admin_menu', 'my_plugin_create_admin_page' );
function my_plugin_create_admin_page() {
    add_menu_page(
        '我的插件设置', // 页面标题
        '我的插件', // 菜单标题
        'manage_options', // 所需权限
        'my-plugin-settings', // 菜单slug
        'my_plugin_settings_page_content', // 用于渲染页面的回调函数
        'dashicons-admin-generic', // 图标
        80 // 菜单位置
    );
}
function my_plugin_settings_page_content() {
    // 检查用户权限
    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">
            
        <input type="hidden" name="trp-form-language" value="pt"/></form>
    </div>
    &lt;?php
}

Segurança e validação de dados

No desenvolvimento de plugins, processar diretamente as entradas dos usuários sem realizar nenhuma validação ou escape representa um sério risco de segurança. O WordPress disponibiliza uma série de funções para garantir a segurança.
Validação: verificar se os dados de entrada estão no formato esperado (por exemplo, se é um endereço de e-mail ou um número).
Limpeza (Sanitização): Limpar os dados de entrada e remover os caracteres não seguros (por exemplo, usando <). sanitize_text_field (Tratamento de campos de texto).
Escapar: Quando os dados são enviados para HTML, JavaScript ou URL, eles são escapados para evitar ataques XSS (por exemplo, usando <). esc_html, esc_js, esc_url）。

Ao salvar as opções de configuração, é essencial utilizar a função de limpeza:

$safe_value = sanitize_text_field( $_POST['my_field'] );
update_option( 'my_plugin_field', $safe_value );

Carregar scripts e tabelas de estilos

Para que a interface frontal (frontend) ou posterior (backend) do plugin fique bonita, é necessário carregar corretamente os arquivos CSS e JavaScript. Deve-se utilizar… wp_enqueue_script e wp_enqueue_style Funções, e certifique-se de que elas sejam carregadas apenas nas páginas em que são necessárias.

Leitura recomendada Guia Avançado de Desenvolvimento para Dominar os Campos Personalizados do WooCommerce: Desde a Criação até a Exibição。

add_action( 'admin_enqueue_scripts', 'my_plugin_load_admin_assets' );
function my_plugin_load_admin_scripts( $hook ) {
    // 仅在我们的插件设置页面加载
    if ( 'toplevel_page_my-plugin-settings' != $hook ) {
        return;
    }
    wp_enqueue_style(
        'my-plugin-admin-style',
        plugins_url( 'css/admin-style.css', __FILE__ )
    );
    wp_enqueue_script(
        'my-plugin-admin-script',
        plugins_url( 'js/admin-script.js', __FILE__ ),
        array( 'jquery' ), // 依赖jQuery
        '1.0.0',
        true // 在底部加载
    );
}

A publicação e manutenção de plugins

Após a conclusão do desenvolvimento, você provavelmente desejará compartilhar o produto com outros ou comercializá-lo. Isso envolve a otimização do código, a preparação para a internacionalização e o processo de lançamento.

Internacionalização e Localização

Para que o plugin possa ser usado por usuários em todo o mundo, é necessário suportar múltiplas línguas. Isso é alcançado através do uso das funções de tradução do WordPress. Todo o texto que precisa ser traduzido deve ser marcado adequadamente. __() ou _e() Encapsule a função e declare-a no cabeçalho do plugin.Text Domain。

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

echo '<h2>' . esc_html__( '设置', 'my-awesome-plugin' ) . '</h2>';
$button_text = __( '点击保存', 'my-awesome-plugin' );

Em seguida, use uma ferramenta como o PoEdit para extrair todas as strings de tradução e gerar o resultado desejado..potDocumentos, para os tradutores criarem..poe.moArquivos de idioma.

Otimização de código e desempenho

Um plugin de qualidade deve levar em conta o desempenho. Evite executar todo o código a cada carregamento da página; em vez disso, organize a lógica do código em pontos de intervenção („hooks“) apropriados. Para consultas de banco de dados complexas, considere o uso de mecanismos de cache, como a API „Transients“ do WordPress.set_transient(), get_transient(), delete_transient()。

Ao mesmo tempo, é necessário garantir que o plugin limpe os dados que criou (como tabelas e opções) ao ser desinstalado. Isso pode ser feito registrando um “hook” de desinstalação. Crie uma função no arquivo principal do plugin e utilize-o para realizar essa limpeza. register_uninstall_hook Registre-o.

register_uninstall_hook( __FILE__, 'my_plugin_uninstall' );
function my_plugin_uninstall() {
    // 删除插件创建的所有选项
    delete_option( 'my_plugin_option_1' );
    delete_option( 'my_plugin_option_2' );
    // 如果创建了数据库表，这里也需执行DROP TABLE语句
}

resumos

O desenvolvimento de plugins para o WordPress é um processo que transforma ideias em funcionalidades reais. O seu núcleo reside no entendimento profundo e no uso avançado do sistema de ganchos (hooks), da API e dos padrões de codificação do WordPress. Desde a criação da estrutura básica do plugin, até à implementação das funcionalidades desejadas, à garantia da segurança, à otimização do desempenho, bem como à preparação para a internacionalização e ao lançamento do produto final, cada etapa requer uma atenção meticulosa. Seguir as melhores práticas (como validação de dados, escape de caracteres para segurança, carregamento de recursos conforme necessário) não só permite criar extensões poderosas, mas também assegura a sua estabilidade, segurança e manutenibilidade, oferecendo assim um valor confiável aos usuários.

Perguntas frequentes Perguntas frequentes

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

Você precisa ter conhecimentos básicos da linguagem de programação PHP, pois a lógica central do plugin foi escrita em PHP. Além disso, é necessário ter um entendimento básico de HTML, CSS e JavaScript para construir interfaces e interações no lado front-end. O mais importante é estar familiarizado com os conceitos fundamentais do WordPress, como artigos, páginas, roles de usuários e o sistema de ganchos (hooks) do framework.

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

É recomendado ativar o modo de depuração do WordPress no ambiente de desenvolvimento.wp-config.phpNo arquivo, será…WP_DEBUGA constante foi definida como…trueIsso exibirá erros, avisos e notificações do PHP na tela. Além disso, é possível utilizar…error_log()A função grava informações de depuração personalizadas no log de erros do servidor ou utiliza os painéis Console e Network dos ferramentas de desenvolvimento do navegador para verificar problemas relacionados a 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 fornecidas pelo WordPress para executar tarefas, evitando chamadas diretas ao banco de dados ou alterações nos arquivos principais do sistema. Adicione um prefixo único aos nomes de suas funções, classes e opções para prevenir conflitos de nomes. Quando possível, forneça “ganchos de filtro” (filter hooks) que permitam que outros desenvolvedores modifiquem o comportamento do seu plugin, o que pode aumentar significativamente a sua extensibilidade e a sua facilidade de uso.

Os plugins devem ser enviados para o diretório oficial de plugins do WordPress?

Se o seu plugin for universal, útil e atender aos requisitos do guia do diretório de plugins do WordPress (gratuito, sem código malicioso, licenciado sob a GPL, etc.), submetê-lo ao diretório oficial é uma ótima opção. Isso pode gerar uma grande exposição, um mecanismo de atualização automática e a confiança dos usuários. Para plugins comerciais ou com funcionalidades específicas, você pode optar por distribuí-los no seu próprio site, mas também é necessário fornecer documentação clara e suporte de atualização.