Guia definitivo para o desenvolvimento de plugins do WordPress: construa o seu primeiro plugin do zero.

Ambiente de desenvolvimento e preparações iniciais

Antes de começar a escrever qualquer código, um ambiente de desenvolvimento estável e profissional é a chave para o sucesso. Primeiramente, você precisa criar um ambiente de desenvolvimento para WordPress no seu computador local que seja o mais semelhante possível ao ambiente de produção. Isso geralmente pode ser feito usando softwares de ambiente integrado, como XAMPP ou MAMP, ou contêineres Docker, que são mais modernos. O ambiente local permite que você faça testes e depurações livremente, sem afetar o site online.

Em seguida, você precisará de um editor de código ou de um ambiente de desenvolvimento integrado (IDE). O Visual Studio Code, o PhpStorm ou o Sublime Text são ótimas opções, pois oferecem realce de sintaxe, sugestões de código e ferramentas de depuração, o que pode melhorar significativamente a eficiência do desenvolvimento. Além disso, verifique se a versão do PHP que você está utilizando é compatível com a versão do WordPress para a qual está trabalhando. A equipe oficial do WordPress recomenda o uso do PHP 7.4 ou de uma versão mais recente para obter melhor desempenho e segurança.

Finalmente, e este é um passo de extrema importância, é necessário familiarizar-se com o “Manual para Desenvolvedores de Plugins” oficial do WordPress. Este documento é considerado a bíblia do desenvolvimento de plugins, fornecendo informações detalhadas sobre todas as APIs principais, diretrizes de segurança e melhores práticas. Antes de começar a programar, reserve algum tempo para ler as seções “Criando Plugins” e “Noções Básicas de Plugins”, o que ajudará a estabelecer uma base sólida para o seu trabalho de desenvolvimento.

Leitura recomendada O guia completo para o desenvolvimento de plug-ins do WordPress: do zero à progressão avançada。

Crie o seu primeiro arquivo de plugin.

Um plugin para o WordPress é, essencialmente, um ou mais componentes que estão localizados dentro do código do próprio WordPress.wp-content/pluginsOs arquivos PHP localizados no diretório correspondente. Cada plugin deve ter um arquivo principal, que contém informações específicas sobre o plugin, utilizadas para comunicar ao sistema WordPress a sua existência e funcionalidades.

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

Estrutura do arquivo principal do plugin

O arquivo principal de um plugin é o ponto de entrada para o funcionamento do mesmo, e seu nome geralmente coincide com o nome do diretório onde o plugin está localizado. Por exemplo…my-first-plugin.phpNo início deste arquivo, você deve adicionar um comentário de cabeçalho de plugin que atenda aos padrões do WordPress. Esta é a única maneira pela qual o WordPress consegue reconhecer as informações sobre o plugin.

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

Cada item de informação nessa anotação é muito importante.Plugin NameÉ um campo obrigatório; ele será exibido na lista de plugins no painel administrativo do WordPress.Text DomainUsado para traduções internacionais.Domain PathIsso especifica a localização do arquivo de tradução.

Implementação das funcionalidades básicas do plugin

Após declarar o cabeçalho do plugin, você pode começar a adicionar o código das funcionalidades. Uma prática segura e padrão é encapsular toda a lógica das funcionalidades em funções ou classes e acioná-las através do sistema de ganchos (Hooks) do WordPress. Por exemplo, podemos criar uma função simples para adicionar texto no final da página.

// 定义一个函数，用于在页面底部输出内容
function my_first_plugin_display_footer_text() {
    echo '<p style="text-align: center; color: #666;">Obrigado por usar o meu primeiro plugin!</p>';
}
// 使用 add_action 钩子将函数挂载到 ‘wp_footer’ 动作上
add_action( 'wp_footer', 'my_first_plugin_display_footer_text' );

add_action()É uma função central usada para converter a sua função personalizada…my_first_plugin_display_footer_text\nLigado awp_footerNeste ponto específico de ação, quando o WordPress chegar à parte do rodapé da página, sua função será chamada automaticamente.

Leitura recomendada Guia Completo para Desenvolvimento de Plugins para WordPress: Construindo Plugins Profissionais do Zero。

Aprofundar os mecanismos centrais do WordPress

Para desenvolver plugins poderosos e flexíveis, é essencial compreender profundamente dois mecanismos centrais do WordPress: os Ganchos (Hooks) e os Filtros (Filters). Eles funcionam como pontes de interação entre os plugins, o núcleo do WordPress e outros plugins.

Uso de hooks de ação

Os “Action Hooks” (Ganchos de Ação) permitem que você insira o seu próprio código em momentos específicos da execução do WordPress. Por exemplo, quando um artigo é publicado, quando um usuário faz login ou quando um script é carregado. No exemplo acima…wp_footerÉ apenas um gancho de ação (action hook). Você pode usá-lo.add_action()Existe uma função para assinar a esses “ganchos” (hooks). Ela aceita pelo menos dois parâmetros: o nome do gancho e a função de callback.

// 在管理后台的文章编辑页面添加一个自定义元框
function my_first_plugin_add_custom_meta_box() {
    add_meta_box(
        'myplugin_sectionid',           // 元框的唯一ID
        '我的插件自定义选项',            // 元框标题
        'my_first_plugin_meta_box_callback', // 输出内容的回调函数
        'post'                          // 在‘文章’编辑页面显示
    );
}
add_action( 'add_meta_boxes', 'my_first_plugin_add_custom_meta_box' );

Uso de ganchos de filtro

Os “Filter Hooks” (Ganchos de Filtro) são diferentes dos “Action Hooks” (Ganchos de Ação), pois permitem que você modifique os dados antes que eles sejam salvos no banco de dados ou exibidos no navegador. Por exemplo, você pode alterar o conteúdo de um artigo, o seu título ou até mesmo os comentários.add_filter()Uma função é utilizada para aplicar um filtro. A função de callback que você registrou recebe os dados originais como parâmetro e deve retornar os dados modificados.

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 my_first_plugin_add_title_prefix( $title ) {
    // 仅当在主查询中且在单个文章页面时生效
    if ( is_single() && in_the_loop() && is_main_query() ) {
        return '【推荐】' . $title;
    }
    return $title;
}
add_filter( 'the_title', 'my_first_plugin_add_title_prefix' );

Compreender e utilizar com habilidade esses “ganchos” (hooks) é fundamental para distinguir desenvolvedores de plugins iniciantes daqueles mais experientes.

Segurança, otimização e lançamento de plugins

Um plugin completo não é apenas uma coleção de funcionalidades; é necessário também levar em conta aspectos como segurança, desempenho, manutenibilidade e a forma como ele será entregue aos usuários.

Implementar validação de dados e segurança

Nunca confie nos dados inseridos pelos usuários. Todos os dados recebidos devem ser verificados e processados com cuidado, a fim de evitar erros ou ataques cibernéticos.$_POST、$_GETou$_COOKIETodos os dados obtidos devem ser verificados e desinfetados (sanitizados). O WordPress disponibiliza uma série de funções auxiliares para isso.sanitize_text_field()、intval()、wp_kses()“等” é usado para limpar os dados. Ao exibir qualquer tipo de dados na interface do usuário (front-end), é necessário realizar a operação de escape (Escaping) também.esc_html()、esc_attr()ouwp_kses_post()Funções como essas são utilizadas para prevenir ataques de tipo Cross-Site Scripting (XSS).

Leitura recomendada Guia de Iniciação para Desenvolvimento de Plugins para WordPress: Construa o Seu Primeiro Plugin Personalizado do Zero。

Localização e tradução de plugins

Para que o seu plugin possa ser usado por usuários de todo o mundo, a internacionalização (i18n) é essencial. Você precisa utilizar as funções de tradução do WordPress para encapsular todas as strings direcionadas aos usuários. O mais básico é…__()Usado para exibir o resultado da tradução._e()Usado para a saída da tradução.

// 在插件代码中包装可翻译字符串
$greeting_message = __( ‘感谢使用我的插件！‘， ‘my-first-plugin’ );

// 在特定的钩子上加载翻译文件
function my_first_plugin_load_textdomain() {
    load_plugin_textdomain( ‘my-first-plugin’， false， dirname( plugin_basename( __FILE__ ) ) . ‘/languages/’ );
}
add_action( ‘plugins_loaded’， ‘my_first_plugin_load_textdomain’ );

Em seguida, você pode usar ferramentas como o Poedit para criar o conteúdo desejado..potArquivo de modelo, para que os tradutores possam criá-lo..poe.moArquivo de traduçã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

Preparar para publicar no catálogo oficial.

Quando você estiver preparando para lançar um plugin publicamente, é necessário seguir os requisitos oficiais do WordPress para o lançamento. Isso inclui a elaboração de um documento detalhado…readme.txtO arquivo (com um formato semelhante ao dos cabeçalhos dos plugins, mas com mais seções, como descrição, instalação, dúvidas comuns, capturas de tela, etc.) deve conter código que atenda aos padrões de codificação do WordPress. É necessário realizar testes abrangentes antes de submeter o código a uma plataforma de controle de versão, como o GitHub. Por fim, você pode solicitar um repositório SVN no WordPress.org e enviar o código do seu plugin para o diretório oficial de plugins, permitindo que usuários de todo o mundo o encontrem e o instalem.

resumos

O desenvolvimento de plugins para o WordPress é um processo que transforma ideias em funcionalidades e as integra na maior ecossistema de sistemas de gestão de conteúdo do mundo. Desde a configuração do ambiente e a criação dos arquivos básicos, passando pela compreensão aprofundada do sistema de ganchos (hooks), que é o mecanismo central de interação do WordPress, até a atenção final à segurança, à internacionalização e à preparação para a publicação, cada etapa é de extrema importância. Seguir as melhores práticas, especialmente as diretrizes de codificação segura e os padrões do WordPress, não só permite criar plugins estáveis e confiáveis, como também garante sua longevidade e compatibilidade. Lembre-se: plugins de qualidade resultam da compreensão das necessidades dos usuários e do respeito pelos mecanismos da plataforma. Agora que você já domina o caminho básico para criar plugins do zero, é hora de iniciar sua jornada de desenvolvimento e agregar valor ao mundo do WordPress com seu código.

Perguntas frequentes Perguntas frequentes

É necessário ter conhecimento avançado em PHP para desenvolver plugins?

Sim, dominar bem o PHP é fundamental para o desenvolvimento de plugins para o WordPress. Isso porque o próprio WordPress, assim como a maioria de seus plugins e temas, é escrito em PHP. Você precisa entender a sintaxe do PHP, funções, classes e objetos, além de saber como interagir com bancos de dados (geralmente MySQL/MariaDB).

Como depurar o meu plugin do WordPress?

Recomendo alguns métodos: Primeiramente,wp-config.phpO documento está ativado.WP_DEBUGMostre os erros e avisos do PHP. Em segundo lugar, use…error_log()A função grava informações de depuração no log de erros do servidor. Para um depuramento mais avançado, é possível usar o Xdebug em conjunto com um IDE para realizar depuração com pontos de interrupção. Além disso, muitos desenvolvedores também utilizam plugins de depuração, como o Query Monitor, para verificar consultas ao banco de dados e o andamento da execução de funções de interrupção (hooks).

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

Para maximizar a compatibilidade, seu plugin deve utilizar o máximo possível das APIs e ganchos (hooks) fornecidos oficialmente pelo WordPress, evitando a modificação direta dos arquivos principais ou o uso de funções não públicas (geralmente aquelas que começam com o caractere “_”). Ao modificar qualquer dado global ou resultado de exibição, é necessário verificar as condições antes de fazer qualquer alteração.is_admin()、is_single()Para funcionalidades que podem entrar em conflito com outros plugins, considere oferecer uma opção para que os usuários escolham se desejam ativá-las ou não.

Após o lançamento de um plugin, como fornecer atualizações para os usuários?

Se você publicar o plugin no diretório oficial do WordPress.org, o serviço de atualização será automático. Você só precisa atualizar o número da versão no arquivo principal do plugin (por exemplo, de…)1.0.0mudar para1.0.1Você deve adicionar o novo código ao repositório SVN oficial, e o WordPress enviará automaticamente notificações de atualização para todos os usuários. Se você estiver distribuindo o plugin por conta própria, será necessário implementar um mecanismo personalizado de verificação de atualizações, o que geralmente envolve hospedar um arquivo JSON com informações sobre as versões em um servidor remoto e verificar essas informações periodicamente através de solicitações HTTP no próprio plugin.