Guia Definitivo para Desenvolvimento de Plugins para WordPress: Construindo Funcionalidades Personalizadas do Zero

Ambiente de desenvolvimento de plugins para WordPress e preparações básicas

Antes de começar a escrever código, um ambiente de desenvolvimento estável e isolado é o primeiro passo para o sucesso. Isso não só protege o seu site de produção do código de teste, mas também torna o processo de depuração muito mais fácil.

Criar um ambiente de desenvolvimento local

Recomenda-se utilizar pacotes de software de servidor locais, como Local by Flywheel, XAMPP ou MAMP. Estas ferramentas permitem instalar, com um único clique, um ambiente completo que inclui PHP, MySQL e Apache/Nginx. Certifique-se de que a sua versão do PHP corresponde aos requisitos da versão do WordPress que pretende utilizar; geralmente, recomenda-se utilizar o PHP 7.4 ou versões superiores para obter um melhor desempenho e suporte de segurança.

Criar o arquivo principal do plugin

Cada plugin do WordPress deve ter um ficheiro principal, que é o ponto de entrada do plugin. Este ficheiro deve ser colocado em wp-content/plugins Em uma pasta separada na lista de conteúdos, e com um nome único. Por exemplo, se você quiser criar um plug-in de “saudação”, pode criar um com o nome my-first-plugin O diretório e, nele, crie o arquivo principal. my-first-plugin.php。

Leitura recomendada Guia Definitivo para Desenvolvimento de Plugins para WordPress: Construindo Plugins de Nível Comercial do Zero。

O início deste ficheiro deve incluir uma nota de cabeçalho de plug-in específica, que fornece informações básicas sobre o plug-in ao WordPress. Eis um exemplo básico:

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

A estrutura central do plug-in e o mecanismo de ganchos.

O cerne do desenvolvimento de plugins do WordPress é compreender e utilizar o seu sistema de “ganchos” (Hooks). Os ganchos permitem que o seu código seja “integrado” nos processos principais do WordPress em momentos específicos, alterando ou adicionando funcionalidades sem ter de modificar os ficheiros principais.

Compreender os ganchos de ação e os ganchos de filtro.

Os ganchos são divididos principalmente em duas categorias: ações e filtros. Os ganchos de ação executam o seu código quando um evento específico ocorre, como por exemplo, ao publicar um artigo ou carregar o painel de administração. Você usa add_action() Funções são usadas para realizar o “montagem” (ou configuração) de dados. Os ganchos (hooks) dos filtros, por outro lado, são utilizados para modificar os dados, permitindo que você altere seus valores antes que eles sejam enviados para o banco de dados ou para o navegador. add_filter() Função para montar.

Por exemplo, para adicionar texto personalizado no rodapé do site, você pode usar wp_footer Este gatilho de ação:

function myplugin_add_footer_text() {
    echo '<p style="text-align:center;">Obrigado por utilizar este website!</p>';
}
add_action( 'wp_footer', 'myplugin_add_footer_text' );

Criar a página de gerenciamento de plugins.

Muitos plugins necessitam de fornecer uma página de configuração no painel de administração do WordPress. Isto é normalmente feito através da montagem de um módulo. admin_menu Isso é feito usando ganchos de ação. Você precisa definir uma função, na qual irá usar add_menu_page() ou add_options_page() Use funções como onload e onsubmit para registar a página e definir outra função para apresentar o conteúdo HTML da página.

Leitura recomendada Do zero: Guia completo para o desenvolvimento de plugins do WordPress e tutorial prático。

function myplugin_add_admin_menu() {
    add_options_page(
        '我的插件设置', // 页面标题
        '我的插件',     // 菜单标题
        'manage_options', // 权限
        'myplugin-settings', // 菜单别名
        'myplugin_render_settings_page' // 用于显示页面内容的函数
    );
}
add_action( 'admin_menu', 'myplugin_add_admin_menu' );

function myplugin_render_settings_page() {
    ?>
    <div class="wrap">
        <h2>Configurações do meu plugin</h2>
        <form method="post" action="/pt/options.php/" data-trp-original-action="options.php">
            
        <input type="hidden" name="trp-form-language" value="pt"/></form>
    </div>
    &lt;?php
}

Implementar a funcionalidade do plug-in e o processamento de dados.

Um plugin completo normalmente precisa de processar a entrada do utilizador, guardar as definições e interagir com a base de dados. O WordPress fornece uma API poderosa para simplificar estas operações.

Utilize a API de configurações para guardar as opções.

O processamento manual de envios de formulários e operações de base de dados é demorado e inseguro. A API de configuração do WordPress fornece uma forma padronizada e segura de registar, validar e guardar as definições. Inclui três funções principais:register_setting()、add_settings_section() e add_settings_field()。

Os exemplos a seguir mostram como registar uma definição de campo de texto:

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 myplugin_settings_init() {
    register_setting( 'myplugin_settings_group', 'myplugin_greeting_text' );

add_settings_section(
        'myplugin_section',
        '基础设置',
        null,
        'myplugin-settings'
    );

add_settings_field(
        'myplugin_field_greeting',
        '问候语',
        'myplugin_field_greeting_render',
        'myplugin-settings',
        'myplugin_section'
    );
}
add_action( ‘admin_init’， ‘myplugin_settings_init’ );

function myplugin_field_greeting_render() {
    $value = get_option( ‘myplugin_greeting_text’， ‘你好，世界！’ );
    echo ‘<input type=“text” name=“myplugin_greeting_text” value=“’ . esc_attr( $value ) . ‘” />’;
}

Criação de tabelas de banco de dados personalizadas

Para plugins que necessitam armazenar dados relacionais complexos, pode ser necessário criar tabelas de banco de dados personalizadas. Isso geralmente é feito quando o plugin é ativado. Você precisa escrever uma função e anexá-la ao gancho de ativação registrado do WordPress. Use dbDelta() A função executa instruções SQL para criar ou atualizar tabelas, processando de forma inteligente as alterações na estrutura da tabela.

Primeiro, registre o gancho de ativação no seu arquivo de plugin principal:

register_activation_hook( __FILE__， ‘myplugin_create_database_table’ );

Em seguida, defina a função que cria a tabela:

Leitura recomendada Guia introdutório ao desenvolvimento de plugins para WordPress: crie seu primeiro plugin do zero。

function myplugin_create_database_table() {
    global $wpdb;
    $table_name = $wpdb->prefix . ‘myplugin_data’;
    $charset_collate = $wpdb->get_charset_collate();

$sql = “CREATE TABLE $table_name (
        id mediumint(9) NOT NULL AUTO_INCREMENT，
        name varchar(100) NOT NULL，
        email varchar(100) NOT NULL，
        created_at datetime DEFAULT CURRENT_TIMESTAMP NOT NULL，
        PRIMARY KEY (id)
    ) $charset_collate;”;

require_once( ABSPATH . ‘wp-admin/includes/upgrade.php’ );
    dbDelta( $sql );
}

Segurança de plugins, internacionalização e preparação para lançamento

Os plugins desenvolvidos precisam de ser reforçados em termos de segurança, localizados para outros idiomas e empacotados de forma padronizada, para que possam ser fornecidos com segurança aos utilizadores ou submetidos aos repositórios oficiais.

Implementar as melhores práticas de segurança

A segurança é uma prioridade máxima no desenvolvimento de plugins. Sempre valide a entrada do utilizador (verificando o formato) e limpe-a (removendo partes prejudiciais). Utilize funções fornecidas pelo WordPress, como esc_html()、esc_attr()、sanitize_text_field() Para exportar ou processar dados. Ao executar consultas de banco de dados, use $wpdb->prepare() Métodos para prevenir ataques de injeção de SQL. Ao mesmo tempo, use current_user_can() Verifique as permissões dos usuários para garantir que apenas aqueles autorizados possam realizar operações sensíveis.

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

Implementar a internacionalização de plugins

Para que o seu plugin possa ser utilizado por utilizadores de todo o mundo, é necessário prepará-lo para a internacionalização (i18n). Isto significa que todas as cadeias de caracteres orientadas para o utilizador não devem ser escritas diretamente no código, mas sim envolvidas nas funções de tradução do WordPress. A função mais utilizada é () Usado para exibir o resultado da tradução.() Para obter as cadeias de caracteres traduzidas, bem como _e() Usado para exportar a tradução diretamente.

No seu código, deve ser escrito da seguinte forma:

$greeting = __( ‘你好，世界！’， ‘my-first-plugin’ );
echo esc_html( $greeting );

_e( ‘设置已保存。’， ‘my-first-plugin’ );

Nota: o segundo parâmetro da função de tradução, “Domínio de texto” (Text Domain), deve corresponder ao definido no cabeçalho do plugin. Text Domain Completamente consistente. Então, você pode usar ferramentas como o Poedit para gerar .pot Arquivo de modelo, para que os tradutores possam criá-lo. .po e .mo Arquivo de tradução.

resumos

O desenvolvimento de plugins do WordPress é um processo de transformar ideias em funcionalidades, que se baseia numa compreensão profunda da arquitetura central do WordPress, especialmente do sistema de hooks. Cada passo, desde a configuração do ambiente, à escrita do ficheiro principal, à utilização de hooks de ações e filtros, até ao processamento de dados com a API de definições e a API de base de dados, segue um padrão claro. Por fim, através de práticas de segurança rigorosas e suporte completo à internacionalização, o seu plugin pode passar de um projeto pessoal para um produto publicável. Depois de dominar estas bases, pode explorar áreas mais complexas, como tipos de artigos personalizados, integração de REST API e desenvolvimento de blocos no Gutenberg, para criar extensões do WordPress mais robustas e modernas.

Perguntas frequentes Perguntas frequentes

É necessário dominar o PHP para desenvolver plugins para o WordPress?

Sim, o PHP é a principal linguagem de programação para o desenvolvimento do WordPress e dos seus plugins. É necessário dominar conceitos básicos de sintaxe PHP, funções, arrays, programação orientada a objetos, etc. Ao mesmo tempo, é fundamental ter um conhecimento básico de HTML, CSS e JavaScript, pois estes são necessários para lidar com a apresentação e a interatividade do front-end.

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

Recomenda-se ativar o modo de depuração do WordPress. No wp-config.php No arquivo, será… WP_DEBUG A constante foi definida como… trueIsso irá mostrar todos os erros, avisos e notificações do PHP na tela. Ao mesmo tempo, pode-se usar error_log() A função irá escrever as informações de depuração no registo de erros do servidor ou utilizar as ferramentas de desenvolvimento do navegador para depurar o JavaScript front-end.

Como evitar que os nomes das funções em um plugin entrem em conflito com outros plugins?

Para evitar conflitos de nomes de funções, nomes de classes ou nomes de constantes, deve-se sempre usar um prefixo único. A melhor prática é usar o nome do plugin ou uma abreviatura como prefixo. Por exemplo, se o seu plugin se chamar “Awesome Slider”, pode usar algo como as_ ou awesome_slider_ Como prefixo para todas as funções personalizadas. Para os nomes de classes, também devem seguir o mesmo princípio.

É possível enviar plugins pagos para o diretório oficial de plugins do WordPress?

Não. O catálogo oficial de plugins do WordPress aceita apenas plugins que respeitem a licença GPL e sejam totalmente gratuitos. Se você estiver desenvolvendo um plugin pago (avançado), precisará distribuí-lo e vendê-lo no seu próprio site. No entanto, muitos plugins pagos oferecem uma versão gratuita com funcionalidades básicas para serem enviados ao catálogo oficial, funcionando como uma forma de promover e oferecer uma versão de teste do seu plugin avançado.