Guia Definitivo para Desenvolvimento de Plugins para WordPress: Construa o Seu Primeiro Plugin Personalizado do Zero

Por que escolher o desenvolvimento de plugins para o WordPress?

O WordPress se tornou o sistema de gerenciamento de conteúdo mais popular no mundo graças à sua excelente capacidade de expansão, que se deve principalmente à sua arquitetura de plugins. Ao desenvolver plugins personalizados, você pode adicionar qualquer funcionalidade que imaginar ao seu site sem precisar modificar o código do núcleo do WordPress. Isso significa que essas funcionalidades podem existir de forma independente dos temas utilizados e permanecer intactas mesmo após a troca de temas. O que é ainda mais importante é que um plugin de qualidade pode resolver problemas específicos dos usuários ou até se tornar um produto ou serviço independente.

Dominar o desenvolvimento de plugins significa que você passa de um usuário do WordPress para um criador. Seja para atender às necessidades personalizadas do seu próprio projeto ou para gerar receita através do desenvolvimento de plugins comerciais, entender os princípios fundamentais e as melhores práticas do desenvolvimento de plugins é o primeiro passo essencial. Este guia o guiará, partindo da estrutura mais básica, para construir gradualmente um plugin completo e que atenda aos padrões estabelecidos.

Construa a estrutura do seu primeiro plugin.

Um plugin padrão do WordPress é uma pasta que contém uma ou mais arquivos PHP, e o seu diretório raiz deve conter um arquivo principal. Este arquivo principal precisa conter informações específicas de cabeçalho do plugin, para que o WordPress consiga reconhecê-lo e gerenciá-lo.

Leitura recomendada Dominando o desenvolvimento de plug-ins do WordPress: Criando módulos de funções personalizadas eficientes a partir do zero。

Criar o arquivo principal do plugin

A primeira coisa que você precisa fazer é criar o arquivo principal do plugin. Esse arquivo geralmente tem o mesmo nome do plugin, por exemplo… my-first-plugin.phpNo topo deste arquivo, você deve adicionar um comentário de cabeçalho padrão para o plugin.

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://yourwebsite.com/my-first-plugin
 * Description:       这是一个用于学习的 WordPress 自定义插件示例。
 * Version:           1.0.0
 * Author:            你的名字
 * Author URI:        https://yourwebsite.com
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 * Domain Path:       /languages
 */

Este comentário é o “cartão de identidade” do plugin. Plugin Name(O nome do plugin) é o único campo obrigatório; os demais campos são utilizados para fornecer mais informações. A página “Plugins” no painel de administração do WordPress lerá essas informações e as exibirá. Após criar esse arquivo, você precisará colocá-lo no diretório de instalação do WordPress. /wp-content/plugins/ No interior da pasta, você pode criar uma subpasta chamada “my-first-plugin” e colocar o arquivo principal nela. Agora, após fazer login no painel administrativo do WordPress, você poderá ver e ativar o plugin na lista de plugins. Embora ele ainda não tenha nenhuma funcionalidade, você já deu o primeiro passo em direção ao sucesso.

Organize seus arquivos de plugins.

À medida que as funcionalidades aumentam, torna-se difícil manter todo o código em um único arquivo principal. Uma boa estrutura de organização dos arquivos é essencial. Um plugin típico pode conter os seguintes diretórios:
* /includes/Armazena os arquivos que contêm as funções principais e as definições das classes.
* /admin/Armazena os arquivos relacionados à interface de gerenciamento do backend.
* /public/Armazena os arquivos de funcionalidades front-end destinados aos visitantes do site.
* /assets/Armazena recursos estáticos como JavaScript, CSS e imagens.
* /languages/: Armazenar ficheiros de tradução internacional (.po/.mo).

Essa estrutura modular não só torna o código mais claro, mas também facilita a colaboração em equipe e a expansão de funcionalidades futuras. No arquivo principal… my-first-plugin.php Nesse contexto, você geralmente usa… require_once Para introduzir os arquivos de funcionalidades presentes nestes diretórios…

Compreender os conceitos de desenvolvimento do núcleo do WordPress: ganchos (hooks) e filtros (filters)

O núcleo do desenvolvimento de plugins para o WordPress é o mecanismo dos “ganchos” (Hooks). Esse mecanismo permite que o seu código seja inserido no fluxo de execução principal do WordPress em momentos específicos, permitindo assim alterar ou adicionar novas funcionalidades. Os ganchos são divididos em dois tipos: Ações (Actions) e Filtros (Filters).

Leitura recomendada Domine o desenvolvimento de plugins do WordPress do zero: implementação de funcionalidades avançadas e guia de melhores práticas。

Usar ganchos de ação para adicionar funcionalidades

Os ganchos de ação (action hooks) permitem que você execute suas funções personalizadas em um momento específico durante a execução do WordPress. Por exemplo, você pode querer realizar alguma ação ao publicar um artigo ou adicionar um menu à barra lateral do painel de administração.

A seguir, um exemplo simples que utiliza… wp_footer Este gancho de ação exibe uma mensagem na área pública do rodapé do site. Você precisa adicionar o seguinte código ao arquivo principal do seu plugin.

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

Aqui,myplugin_add_footer_text É uma função que definimos nós.add_action() A função “liga” (ou “associa”) essa função a outro objeto ou contexto. wp_footer Essa ação está acionada por um “gancho” (hook). Quando o WordPress chegar à parte do rodapé da página, nossa função será chamada automaticamente.

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

Usar os ganchos dos filtros para modificar o conteúdo

Diferentemente dos ganchos de ação (action hooks), os ganchos de filtro (filter hooks) são usados para modificar dados. Sua função receberá um valor de entrada e, após o processamento, deve retornar um novo valor. Por exemplo, modificar o título de um artigo ou alterar a forma como o conteúdo é exibido.

Os exemplos abaixo demonstram como usar. the_content Um filtro que adiciona automaticamente um trecho de texto personalizado no final de todo o conteúdo dos artigos e páginas.

function myplugin_append_to_content( $content ) {
    $custom_text = '<div class="myplugin-note"><p><em>Este texto foi exibido de forma aprimorada graças ao meu plugin personalizado.</em></p></div>';
    // 仅在主循环的单篇文章页面添加
    if ( is_single() &amp;&amp; in_the_loop() &amp;&amp; is_main_query() ) {
        return $content . $custom_text;
    }
    return $content;
}
add_filter( 'the_content', 'myplugin_append_to_content' );

função myplugin_append_to_content Receber o original $contentNós utilizamos julgamentos condicionais para garantir que o texto seja adicionado apenas onde é necessário, e em seguida retornamos o conteúdo modificado.add_filter() A função completou o processo de registro.

Leitura recomendada Desenvolvimento de plugins do WordPress do início ao fim: crie funcionalidades personalizadas e extensões eficientes。

Criar uma página de gerenciamento para o plugin.

A maioria dos plugins necessita de uma página de configuração para que os usuários possam definir as opções desejadas. O WordPress disponibiliza uma API abrangente para criar interfaces de gerenciamento atraentes e padronizadas.

Adicionar o menu de gerenciamento de nível superior

Você pode adicionar um novo item de menu de nível superior para o seu plugin na barra de navegação esquerda do painel administrativo do WordPress. Isso é feito através de… add_menu_page() Implementado por funções. Geralmente, nós… admin_menu Este hook de ação chama essa funçã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 myplugin_add_admin_menu() {
    add_menu_page(
        '我的插件设置', // 页面标签
        '我的插件',     // 菜单标题
        'manage_options', // 所需权限
        'myplugin-settings', // 菜单 Slug
        'myplugin_settings_page_html', // 显示页面内容的回调函数
        'dashicons-admin-generic', // 图标（可选）
        80 // 菜单位置（可选）
    );
}
add_action( 'admin_menu', 'myplugin_add_admin_menu' );

Construir o conteúdo da página de configurações

Agora precisamos definir a função de callback mencionada acima. myplugin_settings_page_htmlPara renderizar o conteúdo HTML da página de configurações, uma versão simples seria a seguinte:

funcion myplugin_settings_page_html() {
    // Verificar os direitos do utilizador
    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
            // 输出设置字段和非ce字段
            settings_fields( 'myplugin_options' );
            do_settings_sections( 'myplugin-settings' );
            submit_button( '保存设置' );
            ?>
        <input type="hidden" name="trp-form-language" value="pt"/></form>
    </div>
    &lt;?php
}

Esta função cria um formulário que segue o estilo do backend do WordPress. Para processar todas as configurações de forma completa, você também precisa usar… register_setting(), add_settings_section() e add_settings_field() Funções como essas são utilizadas para definir os itens de configuração específicos, o que constitui o fluxo de trabalho completo da “Settings API”. Esta é a maneira recomendada para armazenar e recuperar as opções dos plugins de forma segura.

Implementar uma função prática de plugin: contagem do número de visualizações de um artigo.

Vamos combinar os conceitos acima para criar uma função prática: contar e exibir o número de visualizações de cada artigo.

Criar campos de um banco de dados e armazenar dados

Primeiramente, precisamos criar um local para armazenar o número de visualizações do artigo no momento de sua publicação. Geralmente, utilizamos a funcionalidade de meta-dados (post meta) do WordPress para isso. Podemos usar… add_post_meta Uma função poderia ser usada para isso, mas uma maneira mais elegante seria verificar e atualizar esse valor quando o artigo for visualizado.

function myplugin_track_post_views( $post_id ) {
    if ( ! is_single() ) {
        return;
    }
    if ( empty( $post_id ) ) {
        global $post;
        $post_id = $post->ID;
    }
    // 获取当前浏览次数
    $count = get_post_meta( $post_id, 'myplugin_post_views', true );
    // 如果为空，初始化为0
    $count = $count ? absint( $count ) : 0;
    $count++;
    // 更新数据库
    update_post_meta( $post_id, 'myplugin_post_views', $count );
}
// 在模板重定向时触发，确保只对真实访客计数
add_action( 'template_redirect', 'myplugin_track_post_views' );

Exibir o número de visualizações no frontend.

Depois que os dados forem armazenados, precisaremos de uma função para recuperá-los e exibi-los. Podemos criar um “Shortcode” (código curto) para facilitar que os usuários o insiram no conteúdo dos artigos ou em ferramentas do lado esquerdo da página.

function myplugin_display_post_views_shortcode( $atts ) {
    $atts = shortcode_atts( array(
        'id' => get_the_ID(),
    ), $atts, 'myplugin_views' );

$post_id = absint( $atts['id'] );
    $views = get_post_meta( $post_id, 'myplugin_post_views', true );
    $views = $views ? $views : 0;

return '<span class="myplugin-view-count">Número de visualizações: ' . esc_html( $views ) . '</span>'php
add_shortcode('myplugin_views', 'myplugin_display_post_views_shortcode');

Agora, os usuários só precisam inserir um código curto no editor de artigos. [myplugin_views]Ou você pode adicionar um pequeno utilitário (“gadget”) que contém um “código curto” e, ao inserir esse código, a quantidade de vezes que o artigo foi visualizado será exibida na página. Este exemplo completo abrange todo o processo, desde o armazenamento de dados (ganchos/interações com o sistema) até a busca de informações e a exibição dos resultados no lado do usuário (o código curto utilizado para esse propósito).

resumos

Com este guia, você completou todo o processo de construção de um plugin personalizado para o WordPress, partindo do zero. Primeiramente, entendemos a estrutura básica de um plugin e criamos o arquivo principal que contém as informações de cabeçalho padrão. Em seguida, aprofundamos nosso conhecimento sobre os fundamentos do desenvolvimento de plugins para o WordPress – os ganchos (ações e filtros) – e aprendemos como usá-los para adicionar ou modificar funcionalidades. Depois disso, criamos uma página de gerenciamento profissional para o plugin, que é essencial para a interação com os usuários. Por fim, aplicamos a teoria na prática através de um caso prático de “contagem de visualizações de artigos”, implementando uma cadeia completa de funcionalidades que vai desde a gravação de dados até a exibição no frontend.

Lembre-se: o desenvolvimento de plugins de alta qualidade não se trata apenas de fazer com que as funções funcionem, mas também de prestar atenção à segurança do código, à sua manutenibilidade, ao seu desempenho e ao cumprimento dos padrões de codificação do WordPress. Praticando constantemente e explorando mais do API do WordPress, você será capaz de criar plugins poderosos e apreciados pelos usuários.

Perguntas frequentes Perguntas frequentes

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

Você precisa ter uma base sólida em programação em PHP, pois o WordPress e seus plugins são principalmente escritos em PHP. Além disso, é essencial ter um conhecimento básico de HTML, CSS e JavaScript, o que lhe ajudará a criar interfaces de usuário e funcionalidades interativas. Ter noção dos conceitos básicos do banco de dados MySQL também será útil para entender o modo como o WordPress armazena dados.

Como depurar o meu plugin do WordPress?

Primeiro, certifique-se de que em seu… wp-config.php Ative o modo de depuração do WordPress no arquivo. WP_DEBUG A constante foi definida como… trueIsso exibirá os erros e avisos do PHP na tela. Em segundo lugar, use… error_log() A função grava as informações de depuração no log de erros do servidor, o que representa um método de depuração muito confiável. No caso de variáveis complexas, é possível usar essa abordagem em combinação com outros métodos de análise. print_r() ou var_dump() E com error_log()Além disso, utilize as ferramentas de desenvolvimento do navegador (F12) para depurar problemas relacionados ao JavaScript e ao CSS do lado front-end.

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

Durante o desenvolvimento, é necessário consultar regularmente o manual oficial de desenvolvimento do WordPress para entender as mudanças nas funções e nos ganchos (hooks) entre as diferentes versões. function_exists() ou version_compare() Use instruções condicionais para verificar se uma função ou recurso está disponível, fornecendo assim uma solução alternativa compatível com versões anteriores do WordPress. Especifique claramente o intervalo de versões do WordPress com o qual a compatibilidade é garantida na descrição do plugin. Testar continuamente em ambientes de teste de várias versões do WordPress é a melhor prática para garantir a compatibilidade.

O que deve ser considerado ao desenvolver plugins comerciais?

Ao desenvolver plugins comerciais, a segurança, a qualidade do código e a experiência do usuário devem estar em primeiro lugar. É necessário implementar um sistema de autenticação confiável e seguro (por exemplo, utilizando chaves de licença). É essencial fornecer documentação para os usuários de forma clara e oportuna, bem como suporte técnico. Assegure-se de seguir as diretrizes oficiais de desenvolvimento de plugins do WordPress e o acordo de licença GPL. Considere o uso de plataformas profissionais como Freemius ou Easy Digital Downloads para gerenciar vendas, envios de atualizações e pedidos de suporte.