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

Preparação do ambiente de desenvolvimento de plugins para o WordPress

Antes de começar a escrever o código, você precisa de um ambiente de desenvolvimento local adequado. É fortemente recomendado não desenvolver plugins diretamente em um servidor de produção online. Um ambiente de desenvolvimento típico para WordPress inclui software de servidor local (como XAMPP, MAMP, Local by Flywheel ou Docker), um editor de código (como VS Code ou PHPStorm) e uma instalação nova do WordPress.

Você precisa garantir que a versão do PHP que está utilizando esteja compatível com a versão do WordPress alvo. Geralmente, o core do WordPress é compatível com várias versões do PHP. Para o desenvolvimento de plugins, é recomendado usar o PHP 7.4 ou uma versão mais recente, para ter acesso a sintaxes e funcionalidades mais modernas. Além disso, você deve ativar essa compatibilidade no painel administrativo do WordPress.WP_DEBUG“Modo” – isso pode ajudá-lo a localizar erros rapidamente durante o processo de desenvolvimento. No seu…wp-config.phpNo arquivo, encontre e defina as seguintes constantes:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

Com essa configuração, as mensagens de erro serão registradas em…/wp-content/debug.logO arquivo deve ser armazenado em um local apropriado e não exibido diretamente na página, para não afetar a experiência do usuário no lado front-end. Esta é a prática recomendada.

Leitura recomendada Do Zero ao Um: Um Guia Autoritário e Um Tutorial Prático para o Desenvolvimento de Plugins para WordPress。

Crie o seu primeiro arquivo de plugin.

Todos os plugins do WordPress estão armazenados em…/wp-content/plugins/O plugin está no diretório. Cada plugin geralmente possui uma pasta separada, e o nome da pasta deve ser conciso e refletir a função do plugin. Agora, vamos criar o primeiro 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

Criar o arquivo principal do plugin

Dentro da sua pasta de plugins, é necessário criar um arquivo PHP principal. O nome desse arquivo geralmente coincide com o nome da pasta, por exemplo:my-first-plugin.phpEste arquivo é a entrada para o plugin, e deve conter uma anotação de cabeçalho específica para o plugin. O WordPress utiliza essas informações metálicas para listar o seu plugin na página de gerenciamento de plugins em segundo plano.

<?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
 */

Depois de salvar esse arquivo, você poderá vê-lo na página de “Plugins” no painel administrativo do WordPress. Agora você pode ativá-lo. Embora ele ainda não tenha nenhuma funcionalidade real, este é um marco importante. No cabeçalho do plugin…Text DomaineDomain PathDestinado à internacionalização e localização, preparando o terreno para o lançamento de futuros plugins.

Segurança e estrutura básicas dos plugins

A segurança é a principal prioridade no desenvolvimento de plugins. Uma prática básica é impedir o acesso direto aos arquivos do seu plugin. Isso pode ser feito adicionando uma verificação de acesso direto no início dos arquivos. Modifique o seu arquivo principal e adicione o seguinte código após as notas de cabeçalho do plugin:

// 防止直接文件访问
if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

Este código verifica constantes.ABSPATHVerificar se o arquivo PHP está definido; caso não esteja (o que indica que alguém tentou acessá-lo diretamente através de um URL), interromper a execução do script. Esta é uma medida de segurança essencial que todos os plugins de qualidade para o WordPress devem possuir.

Leitura recomendada O guia completo para o desenvolvimento de plug-ins do WordPress: um tutorial prático do zero à publicação on-line。

Adicionar funcionalidades essenciais ao plugin

A função dos plugins é expandir as funcionalidades do WordPress. Vamos aprender como adicionar novas funcionalidades através de dois exemplos simples: criar uma página de gestão e adicionar conteúdo no lado frontal ( frontend) do site.

Adicione um menu de gerenciamento simples.

Primeiramente, vamos aprender como adicionar uma página de menu pertencente ao nosso próprio plugin na interface do administrador do backend. Isso requer o uso do sistema de “ganchos” (Hooks) do WordPress, especialmente…admin_menuAction Hook.

Nós adicionamos uma função no arquivo principal do plugin, por exemplo…mfp_add_admin_menuE então, use…add_actionA função o monta (ou o associa) em um determinado local ou sistema.admin_menuNo gancho.

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 mfp_add_admin_menu() {
    add_menu_page(
        '我的插件设置',          // 页面标题
        '我的插件',             // 菜单标题
        'manage_options',       // 权限要求
        'my-first-plugin',      // 菜单Slug
        'mfp_admin_page_html',  // 用于渲染页面内容的回调函数
        'dashicons-admin-generic', // 图标（使用Dashicons）
        30                      // 菜单位置
    );
}
add_action( 'admin_menu', 'mfp_add_admin_menu' );

Em seguida, precisamos definir as funções de callback (funções de retorno de chamada) que foram utilizadas acima.mfp_admin_page_htmlVeja o conteúdo HTML da página. Este é um exemplo muito simples:

function mfp_admin_page_html() {
    // 再次检查用户权限
    if ( ! current_user_can( 'manage_options' ) ) {
        return;
    }
    ?>
    <div class="wrap">
        <h1></h1>
        <p>Olá, mundo! Esta é a minha primeira página de gerenciamento de plugins.</p>
    </div>
    &lt;?php
}

Agora, atualize o seu painel administrativo do WordPress. Você deve ver um novo item no menu de navegação à esquerda chamado “Meus Plugins”.

Adicionar texto na parte inferior da página frontal

Além de gerenciar o lado backend, muitas vezes precisamos modificar o lado frontend. Por exemplo, queremos adicionar uma informação de copyright no final de todos os artigos e páginas. Desta vez, vamos usar…the_contentFilter hook.

Leitura recomendada Guia de Iniciação para Desenvolvimento de Plugins para WordPress: Construa sua Primeira Extensão de Funcionalidade do Zero。

O “Filter Hook” permite que você modifique os dados passados para uma função. Vamos criar uma função.mfp_add_footer_textEle recebe o conteúdo do artigo como parâmetro e adiciona o nosso próprio texto após ele.

function mfp_add_footer_text( $content ) {
    // 仅对主循环中的单篇文章和页面生效
    if ( is_single() && in_the_loop() && is_main_query() ) {
        $footer_text = '<p><em>Este artigo é suportado pelo meu primeiro plugin.</em></p>';
        $content .= $footer_text;
    }
    return $content;
}
add_filter( 'the_content', 'mfp_add_footer_text' );

Este código verifica, em primeiro lugar, se o ambiente atual é de um único artigo ou página, e se está dentro do ciclo de consulta principal, a fim de evitar a adição repetida de texto em outras áreas (como widgets ou resumos). Em seguida, ele adiciona o parágrafo HTML contendo as informações de copyright após o conteúdo original e retorna o resultado.

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

Práticas avançadas no desenvolvimento de plugins

Após dominar os conceitos básicos, conhecer algumas práticas avançadas pode tornar seu plugin mais profissional e mais robusto.

Implementar opções de plug-in configuráveis.

Um plugin maduro geralmente precisa permitir que os usuários façam configurações. O WordPress fornece uma API de configurações para simplificar o processo de criação de páginas de opções. Isso envolve o registro de configurações, a adição de campos de configuração e a organização dessas configurações em seções específicas. Embora seja mais complexo do que adicionar diretamente uma página de menu, esse método lida automaticamente com questões de segurança (como a verificação de Nonce) e com o salvamento dos dados dos formulários.

Geralmente, armazenamos as opções dos plugins em um array no WordPress.wp_optionsNa tabela. Você pode usar isso.add_option()、get_option()eupdate_option()Funções para operar os dados do seu plugin.

Use classes para organizar o código dos plugins.

À medida que o número de funcionalidades de um plugin aumenta, colocar todas as funções no espaço de nomes global pode facilmente levar a conflitos de nomes de funções. A melhor prática é usar classes PHP para encapsular as funcionalidades do plugin. Isso não só ajuda a organizar o código de forma mais eficaz, como também permite aproveitar os recursos da programação orientada a objetos, como o carregamento automático de classes, o uso de espaços de nomes (se você estiver utilizando PHP 5.3 ou versões mais recentes) e uma maior capacidade de encapsulação.

Um arquivo principal de um plugin baseado em classes pode ter a seguinte aparência:

if ( ! defined( 'ABSPATH' ) ) exit;

class My_First_Plugin {
    public function __construct() {
        // 在构造函数中挂载所有钩子
        add_action( 'admin_menu', array( $this, 'add_admin_menu' ) );
        add_filter( 'the_content', array( $this, 'add_footer_text' ) );
    }

public function add_admin_menu() { /* ... */ }
    public function add_footer_text( $content ) { /* ... */ }
}

// 初始化插件
new My_First_Plugin();

Esse método agrupa todos os métodos relacionados em uma única classe, o que melhora significativamente a manutenibilidade do código.

resumos

Este guia te ajudou a completar todo o processo de criação de um plugin personalizado para o WordPress, partindo do zero. Você aprendeu como configurar o ambiente de desenvolvimento, criar uma estrutura de arquivos segura para o plugin, utilizar ganchos de ação (action hooks) e ganchos de filtro (filter hooks) para expandir as funcionalidades de gestão do lado backend e a exibição no lado frontend, além de entender conceitos avançados de desenvolvimento, como a programação orientada a objetos e o uso de APIs. O núcleo do desenvolvimento de plugins reside na compreensão do sistema de ganchos do WordPress, que oferece inúmeras oportunidades para modificar o comportamento da plataforma sem alterar o código-fonte. A prática contínua, começando com a criação de funcionalidades simples e evoluindo para plugins mais complexos, é o caminho ideal para dominar essa habilidade.

Perguntas frequentes Perguntas frequentes

Que tipo de conhecimento em PHP é necessário para desenvolver o plugin ###?
Você precisa dominar a sintaxe básica do PHP, incluindo variáveis, arrays, funções, condições de avaliação e ciclos. O mais importante é entender como interagir com a API do WordPress, por exemplo, como usar os hooks (ganchos).add_action, add_filterE funções comuns do WordPress. O conhecimento de Programação Orientada a Objetos (POO) é muito útil ao desenvolver plugins complexos.

Como depurar um plugin que você mesmo desenvolveu?

AtivarWP_DEBUGO modelo é o passo mais crucial. Veja.wp-content/debug.logLog de erros no arquivo. Além disso, você pode usar isso no código.var_dump()ouerror_log()A função exibe informações de depuração. Por exemplo,error_log( print_r( $variable, true ) );É possível registrar o conteúdo de qualquer variável no arquivo `debug.log`. O uso de plugins de depuração profissionais, como o Query Monitor, também pode aumentar significativamente a eficiência no processo de desenvolvimento.

Posso usar bibliotecas PHP de terceiros em um plugin?

Sim, mas é necessário proceder com cautela. Para evitar conflitos de versões com outras extensões ou temas que utilizem bibliotecas específicas, recomenda-se o uso do Composer, uma ferramenta de gerenciamento de dependências em PHP, que também oferece funcionalidades de carregamento automático dessas bibliotecas. Ao embalar e lançar sua extensão, você pode optar por incluir os arquivos da biblioteca em sua própria extensão (assegurando-se de seguir as licenças correspondentes), ou pedir que os usuários instalem a dependência manualmente no servidor.

Como publicar um plugin no diretório oficial do WordPress após a sua conclusão?

Você precisa acessar o WordPress.org para enviar seu plugin para revisão. O código do seu plugin deve estar de acordo com os padrões e guias oficiais de codificação, como garantir a segurança e realizar a internacionalização (utilizando as funcionalidades adequadas).__()e_e()A biblioteca fornece um conjunto de funções e inclui uma documentação detalhada.readme.txtArquivo. Após a aprovação da revisão, seu plugin estará disponível para ser pesquisado e instalado por usuários em todo o mundo.