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

Conhecimentos básicos de desenvolvimento de plugins para WordPress

Antes de começar a escrever código, é essencial entender os conceitos básicos dos plugins do WordPress. Um plugin do WordPress é essencialmente um conjunto de um ou mais arquivos PHP, que, por meio das diversas funcionalidades fornecidas pelo WordPressAPIeHookpara expandir ou modificar as funcionalidades principais do WordPress. Os plugins podem ser tão pequenos quanto apenas adicionar um shortcode, ou tão grandes quanto construir uma plataforma completa de comércio eletrônico. Todos os plugins são armazenados em/wp-content/plugins/No diretório, cada plugin possui sua própria pasta separada.

O segredo para desenvolver plugins está em entender o WordPress动作钩子e过滤器钩子。动作钩子Permite executar código PHP personalizado em momentos específicos, como ao carregar a página ou ao publicar um artigo, e过滤器钩子permitem que você modifique vários dados gerados pelo WordPress durante a execução (como conteúdo de posts, títulos e resumos). Dominar o uso desses hooks é fundamental para o desenvolvimento de plugins.

Para que o plugin possa ser reconhecido pelo WordPress, todo plugin deve conter um comentário de cabeçalho padrão. Esse bloco de comentário geralmente fica no início do arquivo PHP principal do plugin e fornece ao WordPress informações básicas sobre o plugin, como nome, descrição, versão, autor etc. Sem esse cabeçalho, o plugin não aparecerá na lista de plugins do painel administrativo.

Leitura recomendada Compreender profundamente o desenvolvimento de plugins do WordPress: do nível iniciante até a criação de extensões profissionais.。

Crie o seu primeiro plugin.

Começaremos criando o plugin mais simples de “Hello World”. Este plugin exibirá uma mensagem de boas-vindas personalizada no topo do painel do administrador do WordPress.

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

Inicializar diretório do plugin e arquivo principal

Primeiro, você precisa no ambiente de desenvolvimento local ou no site de testes /wp-content/plugins/ Crie uma nova pasta no diretório. Nós a chamaremos de my-first-plugin. Em seguida, crie um arquivo PHP principal dentro dessa pasta; normalmente usamos o nome do plugin para nomeá-lo, aqui nós criamos my-first-plugin.php。

Nos my-first-plugin.php No início do arquivo, as informações de cabeçalho do plugin devem ser adicionadas. Esta é a “identidade” do plugin.

Escrever informações do cabeçalho do plugin e funções principais

Depois de criar o arquivo, abra-o e digite o seguinte código:

<?php
/**
 * Plugin Name:       我的第一个插件
 * Plugin URI:        https://yourwebsite.com/my-first-plugin
 * Description:       这是一个用于学习插件开发的入门示例，会在仪表盘显示欢迎信息。
 * Version:           1.0.0
 * Author:            你的名字
 * Author URI:        https://yourwebsite.com
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 */

Este comentário define as informações básicas do plugin. Depois de salvar o arquivo, faça login no painel do WordPress, acesse a página “Plugins” e você deverá ver um novo plugin chamado “Meu Primeiro Plugin”. Agora ative-o; ele ainda não tem nenhuma funcionalidade.

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

A seguir, vamos adicionar a primeira funcionalidade a ele. Vamos usar add_action() A função monta uma função personalizada em um gancho de ação (action hook) do WordPress. Adicione o seguinte código abaixo dos comentários no início do arquivo:

// 在仪表盘顶部添加欢迎信息
function my_first_plugin_admin_notice() {
    echo '<div class="notice notice-success is-dismissible"><p>Bem-vindo ao “Meu Primeiro Plugin”! Este é um começo de sucesso.</p></div>';
}
add_action( 'admin_notices', 'my_first_plugin_admin_notice' );

Aqui, criamos algo chamado… my_first_plugin_admin_notice A função em questão tem a função de exibir um trecho de código HTML usado para mostrar uma notificação no estilo do backend do WordPress. Em seguida, utilizamos essa função para implementar a notificação desejada. add_action( ‘admin_notices’, ‘my_first_plugin_admin_notice’ ) Monte essa função em… admin_notices Essa ação está acionada por um “gancho” (hook). Isso significa que, sempre que o WordPress estiver preparando para exibir notificações de gerenciamento no backend, nossa função será executada.

Após salvar o arquivo, atualize qualquer página no backend do WordPress. Você verá uma caixa de mensagem verde de sucesso no topo da página. Parabéns! Seu primeiro plugin funcional foi instalado e está funcionando corretamente!

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 página de configurações ao plugin

Um plugin completo geralmente precisa fornecer opções de configuração para os usuários. Vamos adicionar uma página de configurações simples ao “Meu Primeiro Plugin”, permitindo que os usuários personalizem o texto exibido na mensagem de boas-vindas.

Criar item de menu de gerenciamento

Primeiro, precisamos adicionar um item de menu na barra lateral de administração do painel do WordPress. Para isso, é necessário usar add_action() Anexar função a admin_menu Gancho. Continue adicionando o seguinte código no arquivo principal do plugin:

// 添加插件设置页面到后台菜单
function my_first_plugin_add_menu() {
    add_menu_page(
        ‘我的第一个插件设置’， // 页面标题
        ‘第一个插件’，         // 菜单标题
        ‘manage_options’，     // 权限 (manage_options 表示管理员权限)
        ‘my-first-plugin-settings’， // 菜单 slug
        ‘my_first_plugin_settings_page’， // 用于显示页面内容的回调函数
        ‘dashicons-smiley’，   // 菜单图标 (Dashicons)
        100                    // 菜单位置
    );
}
add_action( ‘admin_menu’， ‘my_first_plugin_add_menu’ );

add_menu_page() A função é uma função principal do WordPress, usada para adicionar um menu de nível superior no painel administrativo. Definimos o título da página, o texto exibido no menu e a permissão de acesso (aqui definida para que apenas administradores possam acessar) manage_options), únicosluge o nome da função de retorno usada para exibir o conteúdo da página my_first_plugin_settings_page。

Leitura recomendada Guia para iniciantes em alojamento na nuvem: aprenda desde o início a implementar e gerir servidores na nuvem.。

Construir um formulário para a página de configurações

Em seguida, precisamos definir… my_first_plugin_settings_page função para renderizar o conteúdo HTML da página de configurações e processar a lógica de salvamento do formulário. Esta função criará um formulário simples, cujos dados serão enviados por meio do WordPress-ի options Salvar e ler por meio da API.

// 设置页面的内容
function my_first_plugin_settings_page() {
    // 检查用户权限
    if ( !current_user_can( ‘manage_options’ ) ) {
        wp_die( __( ‘你没有权限访问此页面。’ ) );
    }

// 保存表单数据
    if ( isset( $_POST[‘my_first_plugin_message’] ) ) {
        update_option( ‘my_first_plugin_custom_message’， sanitize_text_field( $_POST[‘my_first_plugin_message’] ) );
        echo ‘<div class="“notice" notice-success is-dismissible”><p>A configuração foi salva!</p></div>’;
    }

// 获取已保存的消息
    $saved_message = get_option( ‘my_first_plugin_custom_message’， ‘这是一个通过设置页面定制的欢迎消息！’ );

// 输出表单 HTML
    ?&gt;
    <div class="“wrap”">
        <h1>As configurações do meu primeiro plugin</h1>
        <form method="“post”" action="/pt/“”/" data-trp-original-action="“”">
            <table class="“form-table”">
                <tr>
                    <th scope="“row”"><label for="“custom_message”">Mensagem de boas-vindas personalizada</label></th>
                    <td>
                        <input type="“text”" id="“custom_message”" name="“my_first_plugin_message”" value="”NO NUMERIC NOISE KEY" 1001” class="“regular-text”" />
                        <p class="“description”">Digite o texto que você deseja exibir na notificação do painel.</p>
                    </td>
                </tr>
            </table>
            <?php submit_button( ‘保存更改’ ); ?>
        <input type="hidden" name="trp-form-language" value="pt"/></form>
    </div>
    &lt;?php
}

Nesta função, primeiro verificamos as permissões do usuário. Em seguida, verificamos se houve o envio de uma solicitação POST (ou seja, se o usuário clicou no botão Salvar). Se houve, usamos update_option() A função salva as mensagens do formulário no WordPress options na tabela do banco de dados e use sanitize_text_field() Realizar a filtragem de segurança. Em seguida, usamos get_option() Leia o valor salvo anteriormente; se ele não existir, use o valor padrão. Por fim, exibimos um formulário HTML que contém um campo de entrada.

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

Modifique a função de notificação para usar mensagens personalizadas.

Finalmente, precisamos modificar o que foi criado anteriormente. my_first_plugin_admin_notice Função, faça com que ela leia a mensagem das opções que salvamos, em vez de exibir um texto fixo.

// 修改后的通知函数
function my_first_plugin_admin_notice() {
    // 从数据库获取自定义消息
    $custom_message = get_option( ‘my_first_plugin_custom_message’， ‘欢迎使用“我的第一个插件”！这是一个成功的开始。’ );
    echo ‘<div class="“notice" notice-success is-dismissible”><p>’ . esc_html( $custom_message ) . ‘</p></div>’;
}

Agora, ative o plugin e você verá o menu “Primeiro Plugin” na barra lateral do painel administrativo. Clique para entrar, altere a mensagem e salve. Atualize outras páginas do painel administrativo e você perceberá que a mensagem de notificação no topo já foi alterada para o conteúdo personalizado por você. Com isso, um pequeno plugin com funcionalidades básicas de criar, ler, atualizar e excluir está concluído.

Boas práticas e técnicas avançadas no desenvolvimento de plugins

Desenvolver um plugin que seja mantível, seguro e com boa compatibilidade requer a adoção de algumas boas práticas.

Garantir segurança do código e sanitização de dados

A segurança é a principal prioridade no desenvolvimento de plugins. Nunca confie em dados inseridos pelos usuários ou provenientes de fontes externas. O WordPress disponibiliza uma ampla gama de funções para ajudá-lo a purificar, escapalar e verificar esses dados.
* 净化输入：使用函数如 sanitize_text_field()、sanitize_email()、sanitize_url() para processar os dados enviados pelo formulário.
* Saída com escape: ao enviar quaisquer dados para HTML, JavaScript ou URL, é obrigatório aplicar escape. Use esc_html()、esc_attr()、esc_url() e wp_kses_post() Funções como essas.
* 权限检查：在进行任何管理操作之前，务必使用 current_user_can() Verifique se o usuário atual tem a permissão correspondente, por exemplo current_user_can( ‘manage_options’ )。
* Verificação de nonce: para operações que envolvem alterações de dados (como envio de formulários, solicitações AJAX), use wp_nonce_field()、wp_verify_nonce() para evitar ataques de falsificação de solicitação entre sites. Podemos melhorar o formulário da página de configurações anterior, adicionando a verificação de nonce para aumentar a segurança.

Implementar a internacionalização de plugins

Para permitir que seu plugin seja usado por usuários do mundo todo, a internacionalização é uma etapa indispensável. Isso exige que você prepare para tradução todas as strings de texto voltadas para o usuário.
1. Usando o domínio de texto: defina-o nos comentários do cabeçalho do plugin Text Domain(Por exemplo, my-first-plugin), e use em todas as strings que precisam ser traduzidas __(‘文本’， ‘my-first-plugin’) ou _e(‘文本’， ‘my-first-plugin’) Envoltório de função.
2. Gerar arquivos de tradução: use ferramentas como o Poedit para escanear todas as strings traduzíveis no plugin e gerar .pot Arquivo de modelo e depois traduza para vários idiomas .po e .mo Documentos.
3. Carregar o domínio de texto: durante a inicialização do plugin, use load_plugin_textdomain() A função carrega seu arquivo de tradução.

Gerenciar o ciclo de vida dos plugins

Um plugin profissional deve lidar adequadamente com os eventos de ativação, desativação e desinstalação. Você pode fazer isso criando as funções de gancho correspondentes.
* 激活钩子：使用 register_activation_hook() Registre uma função para ser executada quando o plugin for ativado. Normalmente é usada para criar tabelas no banco de dados, inicializar opções padrão ou verificar a compatibilidade do ambiente.
* 停用钩子：使用 register_deactivation_hook()Geralmente usado para limpar dados temporários ou interromper tarefas programadas.
* Gancho de desinstalação: usar register_uninstall_hook()Observação: este gancho é usado para ser executado quando o usuário exclui completamente o plugin do WordPress, para limpar todas as opções do banco de dados, tabelas personalizadas e arquivos criados pelo plugin. A operação deve ser realizada com cautela e o usuário deve ser claramente informado.

resumos

Este artigo leva você a começar do zero e a vivenciar completamente o processo central de desenvolvimento de plugins para WordPress. Primeiro, você conheceu os conceitos básicos de plugins, especialmente o papel central dos hooks de ação e dos hooks de filtro. Em seguida, você criou com as próprias mãos uma estrutura de plugin que inclui pasta, arquivo principal e informações padrão de cabeçalho, e por meio de add_action() Funções e admin_notices O gancho implementou a primeira funcionalidade de exibição. Em seguida, ao adicionar uma página de configurações ao plugin, você aprendeu a usar add_menu_page() Criar menu do painel administrativo e como usá-lo update_option() e get_option() Realizamos operações de adição, remoção, alteração e consulta de dados. Por fim, discutimos as melhores práticas que devem ser seguidas no desenvolvimento profissional, como codificação segura, internacionalização e gestão do ciclo de vida dos plugins. Ao seguir esses passos e princípios, você terá a capacidade de desenvolver plugins para o WordPress de forma independente, simples, práticos e seguros, e poderá, a partir daí, explorar funcionalidades mais complexas.

Perguntas frequentes Perguntas frequentes

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

Você precisa dominar a sintaxe básica da linguagem PHP, pois o código do plugin é escrito principalmente em PHP. Ao mesmo tempo, é necessário ter certo conhecimento de HTML, CSS e JavaScript básico para construir a interface de front-end e as interações. O mais importante é estar familiarizado com a arquitetura central do WordPress, especialmente com suaHookSistema (ações e filtros);选项API、数据库APItambémREST API. Também é crucial entender os padrões de codificação do WordPress e as melhores práticas de segurança.

Como depurar e testar meu plugin?

Há várias formas de depurar o desenvolvimento de plugins do WordPress. Primeiro, no seu wp-config.php O ficheiro foi aberto. WP_DEBUG e WP_DEBUG_LOG constante, isso registrará erros e avisos do PHP em /wp-content/debug.log no arquivo, facilitando a identificação de problemas. Em segundo lugar, para códigos com lógica complexa, pode-se usar error_log() A função registra o valor da variável no log. Além disso, recomenda-se desenvolver em um ambiente de desenvolvimento local (como Local by Flywheel, XAMPP) ou em um site de teste temporário, para evitar impactar o site de produção. Usar um sistema de controle de versão (como Git) para gerenciar alterações no código também é uma boa prática.

Como meu plugin pode ser compatível com diferentes versões do WordPress?

Para garantir a ampla compatibilidade do plugin, durante o desenvolvimento deve-se prestar atenção aos seguintes pontos: evitar usar funções introduzidas apenas nas versões mais recentes do WordPress; se for indispensável usá-las, deve-se usar function_exists() Faça verificações condicionais e forneça soluções alternativas. Nos comentários do cabeçalho do plugin, por meio de Requires at least e Tested up to O campo declara claramente a faixa de versões do WordPress que você oferece suporte. Teste seu plugin regularmente na versão mais recente do WordPress e atualize a declaração de compatibilidade em tempo hábil. Seguir os padrões oficiais de codificação do WordPress também pode reduzir ao máximo os problemas de compatibilidade causados por atualizações do núcleo.

Como distribuir meu plugin após a conclusão do desenvolvimento?

Existem principalmente dois caminhos para distribuir plugins. O primeiro é publicá-los gratuitamente no diretório oficial de plugins do WordPress, o que permite que seu plugin seja descoberto e baixado por milhões de usuários em todo o mundo. Você precisa acessar o site WordPress.org para enviar seu plugin e garantir que o código esteja de acordo com as suas especificações e padrões de revisão. O segundo caminho é vender seu plugin como um produto comercial através do seu próprio site. Nesse caso, você é responsável por todo o processo de vendas, pagamentos, verificação de licenças e suporte ao cliente. Para plugins comerciais, geralmente se utiliza a programação orientada a objetos (OOP) para organizar melhor a estrutura do código, e podem ser integrados frameworks para simplificar funções como o gerenciamento de licenças e notificações de atualizações. Independentemente do método escolhido, é muito importante fornecer documentação clara e suporte ágil aos usuários.