Aprenda a desenvolver plugins para o WordPress: crie a sua primeira extensão funcional 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 mundialmente graças à sua poderosa arquitetura de plugins. Os plugins permitem que os desenvolvedores adicionem praticamente qualquer funcionalidade ao site sem modificar o código principal, desde formulários de contato simples até sistemas de comércio eletrônico complexos. Aprender a desenvolver plugins significa que você poderá personalizar o WordPress de forma avançada para atender a necessidades comerciais específicas ou transformar suas próprias ideias em produtos reutilizáveis.

Desenvolver seus próprios plugins, em comparação com modificar diretamente o tema… functions.php Os arquivos possuem vantagens significativas. Os plugins são módulos funcionais independentes dos temas; portanto, quando você muda de tema, suas funcionalidades não são perdidas. Isso torna o código mais fácil de manter, atualizar e compartilhar entre diferentes projetos. Compreender os mecanismos centrais do desenvolvimento de plugins é um passo essencial para se tornar um desenvolvedor avançado de WordPress.

Monte o seu ambiente de desenvolvimento.

Antes de escrever a primeira linha de código, é essencial dispor de um ambiente de desenvolvimento local estável e eficiente. Isso permite que você realize testes e depurações sem afetar o site online.

Leitura recomendada Guia Prático para Desenvolvimento de Plugins para WordPress: Construa o Seu Primeiro Plugin Funcional do Zero。

Configuração do ambiente do servidor local

Recomendamos o uso de soluções de servidor local integradas, como o Local by Flywheel, XAMPP ou MAMP. Elas permitem instalar o Apache/Nginx, PHP e MySQL com apenas um clique. Certifique-se de que a versão do PHP esteja compatível com a versão do WordPress que você deseja usar; geralmente, é recomendado o uso do PHP 7.4 ou uma versão mais recente. Além disso, é necessário instalar uma nova instância do WordPress no servidor local para usar como um “ambiente de teste” (sandbox) para a verificação de plugins.

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

Editor de código e ferramentas de depuração

Escolha um editor de código poderoso, como o Visual Studio Code ou o PHPStorm. Esses editores oferecem realce de sintaxe, sugestões de código e integração com sistemas de controle de versão. Para a depuração, é necessário ativar o modo de depuração do WordPress. Isso requer a modificação dos arquivos localizados no diretório raiz do WordPress. wp-config.php Arquivo, será… WP_DEBUG A constante foi definida como… true。

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true ); // 将错误日志保存到 /wp-content/debug.log
define( 'WP_DEBUG_DISPLAY', false ); // 不要在页面上显示错误

Após ativar o modo de depuração, todos os erros, avisos e notificações do PHP serão registrados, o que ajudará você a localizar rapidamente o problema.

Crie o seu primeiro arquivo de plugin.

Um plugin para o WordPress pode ser tão simples que consista em apenas um arquivo, mas é essencial seguir uma boa estrutura. Vamos começar com um plugin básico do tipo “Hello World”.

Estrutura do arquivo principal do plugin

Primeiramente, no WordPress… /wp-content/plugins/ No diretório, crie uma nova pasta, por exemplo… my-first-pluginNeste diretório, crie um arquivo PHP principal; o nome do arquivo geralmente é o mesmo que o nome do diretório.my-first-plugin.php。

Leitura recomendada Guia de desenvolvimento personalizado de plugins para o WooCommerce: Crie sua própria loja online exclusiva。

Cada plugin deve conter um bloco de comentários com informações padrão no início do arquivo. O WordPress utiliza esse bloco para identificar o plugin e exibi-lo na interface de gerenciamento em segundo plano.

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

Após salvar o arquivo, faça login no seu painel de controle do WordPress e vá para a página “Plugins”. Você deve ver esse novo plugin na lista de plugins. Agora você pode ativá-lo, embora ele ainda não tenha nenhuma funcionalidade.

Adicionar a primeira funcionalidade: gerenciamento de menus

Em seguida, vamos adicionar uma função simples ao plugin: criar um novo item de menu na barra lateral do painel de administração do WordPress.

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

Nós vamos usar. add_action() Função para montar (ou associar) uma função de callback a… admin_menu Este “Action” está preso nesse gancho.

// 在插件主文件中，插件头部注释块之后，添加以下代码

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

// 钩子到 admin_menu 动作
add_action( 'admin_menu', 'mfp_add_admin_menu' );

/**
 * 注册一个自定义管理菜单
 */
function mfp_add_admin_menu() {
    add_menu_page(
        '我的第一个插件设置', // 页面标题
        '我的插件',          // 菜单标题
        'manage_options',    // 所需权限
        'my-first-plugin',   // 菜单别名 (slug)
        'mfp_display_admin_page', // 显示页面内容的回调函数
        'dashicons-smiley', // 菜单图标 (使用 Dashicon)
        6                    // 菜单位置
    );
}

/**
 * 管理页面的显示内容
 */
function mfp_display_admin_page() {
    ?>
    <div class="wrap">
        <h1></h1>
        <p>Olá, mundo! Esta é a minha primeira página de gerenciamento de plugins para o WordPress.</p>
    </div>
    &lt;?php
}

Salve o arquivo e atualize o painel administrativo do WordPress. Você verá um novo item no menu à esquerda chamado “Meus Plugins”. Ao clicar nele, será aberta uma página simples com uma mensagem de boas-vindas.

Aprofundando-se no assunto: Ganchos (Hooks) e Filtros (Filters)

A filosofia central do desenvolvimento de plugins para o WordPress é o conceito de “ganchos” (Hooks). Os ganchos permitem que o seu código seja integrado ao fluxo principal do WordPress em momentos específicos, permitindo a alteração ou adição de funcionalidades. Existem dois tipos principais de ganchos: Ações (Actions) e Filtros (Filters).

Leitura recomendada Guia de desenvolvimento e personalização de temas do WordPress: do iniciante ao especialista na criação de um site exclusivo.。

Compreender os ganchos de ação (action hooks)

Os ganchos de ação (action hooks) são acionados em momentos específicos durante a execução do WordPress, como ao salvar um artigo, ao carregar a cabeça da página ou ao exibir o rodapé. O seu plugin pode “ouvir” esses momentos e executar as suas próprias funções. Foi o que usamos acima. admin_menu É apenas um gancho de ação (action hook).

Outro exemplo comum é a adição automática de um texto no final do conteúdo de um artigo.

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

add_action( 'the_content', 'mfp_append_text_to_content' );

function mfp_append_text_to_content( $content ) {
    if ( is_single() && in_the_loop() && is_main_query() ) {
        $append_text = '<p><em>Este artigo foi gerado pelo meu primeiro plugin.</em></p>';
        $content .= $append_text;
    }
    return $content;
}

Modificar dados usando filtros

Os ganchos (hooks) de filtro são usados para modificar os dados antes que eles sejam salvos no banco de dados ou enviados para o navegador. Eles recebem os dados, modificam-nos e, em seguida, devem retornar os dados modificados. Um exemplo típico é a alteração do título de um artigo.

add_filter( 'the_title', 'mfp_modify_post_title' );

function mfp_modify_post_title( $title ) {
    // 只在非后台的主查询中修改
    if ( ! is_admin() && in_the_loop() ) {
        $title = '[重要] ' . $title;
    }
    return $title;
}

Compreender e utilizar corretamente os “ganchos” (hooks) é fundamental para criar plugins flexíveis e poderosos. O núcleo do WordPress disponibiliza milhares de hooks, que estão distribuídos ao longo de todo o ciclo de vida de um plugin.

Segurança de plugins e melhores práticas

Escrever código seguro e seguir as melhores práticas garante que seu plugin seja estável, eficiente e facilmente aceito por outros desenvolvedores.

Validação de Dados e Escape

Nunca confie nos dados inseridos pelo usuário ou nos dados provenientes do banco de dados. Sempre é necessário escapalar qualquer dado antes de exibi-lo no navegador (em HTML, JavaScript ou em atributos). O WordPress disponibiliza uma série de funções de ajuda para isso.

// 输出到 HTML 内容中
echo esc_html( $untrusted_data );
// 输出到 HTML 属性中
echo esc_attr( $untrusted_data );
// 输出到 URL 中
echo esc_url( $untrusted_data );
// 在 JavaScript 变量中输出
$js_data = wp_json_encode( $untrusted_data );

Antes de salvar os dados no banco de dados ou realizar julgamentos lógicos, é necessário realizar uma validação para garantir que os dados estejam no formato esperado (por exemplo, se são um endereço de e-mail, um número, etc.).

Usar namespaces e classes

Para plugins complexos, recomenda-se o uso de namespaces em PHP e programação orientada a objetos (POO) para organizar o código. Isso pode evitar conflitos de nomes de funções e melhorar a modularidade e a legibilidade do código.

<?php
namespace MyFirstPluginAdmin;

class Admin_Menu {
    public function __construct() {
        add_action( 'admin_menu', [ $this, 'add_menu_page' ] );
    }

public function add_menu_page() {
        add_menu_page( ... );
    }
}

// 初始化
new Admin_Menu();

Além disso, é necessário adicionar suporte à internacionalização para o plugin (utilizando…) __() e _e() Funções eficientes, opções de desinstalação e limpeza adequadas, e a adesão aos padrões de codificação do WordPress são todos componentes essenciais de um plugin de qualidade.

resumos

O desenvolvimento de plugins para o WordPress é uma jornada que vai do básico ao avançado. Começa com a criação de um arquivo simples que seja reconhecido pelo WordPress e, em seguida, você utiliza um sistema poderoso, composto por ações (actions) e ganchos de filtros (filter hooks), para expandir as funcionalidades do plugin. Cada passo dessa jornada é baseado no entendimento da arquitetura do WordPress. O ambiente de desenvolvimento local é o seu “laboratório”, as ferramentas de depuração são os seus “microscópios”, e a segurança, bem como as melhores práticas de desenvolvimento, são as pedras fundamentais para garantir que o seu plugin seja estável e confiável.

Ao criar um simples plugin de menu de gerenciamento, você já praticou os processos fundamentais do desenvolvimento de plugins. Em seguida, você pode tentar integrar opções de configuração, criar tabelas de banco de dados personalizadas, adicionar funcionalidades de códigos curtos (shortcodes), ou desenvolver uma pequena ferramenta. Praticando continuamente e referenciando o código-fonte dos plugins principais, bem como as implementações de outros plugins de qualidade, você será capaz de lidar com requisitos cada vez mais complexos e, no final, criar plugins de nível profissional para o WordPress.

Perguntas frequentes Perguntas frequentes

Um plugin para WordPress precisa de no mínimo quantos arquivos?

Um plugin para o WordPress necessita, no mínimo, de um único arquivo PHP. Basta que esse arquivo contenha as devidas informações de comentários de cabeçalho do plugin para que o WordPress o reconheça e o ative na lista de plugins do backend. Claro, para plugins mais avançados e com funcionalidades mais extensas, o código geralmente é organizado em vários arquivos e pastas a fim de facilitar a manutenção.

Como evitar conflitos de nomes de funções no desenvolvimento de plugins?

Existem dois principais métodos para evitar conflitos de nomes de funções. O primeiro é adicionar um prefixo único a todas as suas funções, por exemplo, utilizando abreviaturas ou nomes curtos de plugins. mfp_ ou myplugin_O segundo método é utilizar as classes e namespaces do PHP para encapsular suas funções dentro de métodos de classe. Esta é uma abordagem mais moderna e recomendada, que resolve de forma eficaz os problemas de conflitos de nomes.

Como adicionar uma página de opções de configuração para o meu plugin?

Adicionar uma página de configurações para um plugin geralmente envolve o uso de… add_options_page() ou add_submenu_page() Use uma função para registrar a página e, em seguida, utilize o API de Configurações (Settings API) do WordPress para criar, verificar e salvar opções de forma segura. O API de Configurações inclui… register_setting()、add_settings_section() e add_settings_field() Funções como essa simplificam o processo de criação de formulários de configurações padronizados e cuidam automaticamente da segurança e do armazenamento de dados.

Após o desenvolvimento estar concluído, como posso publicar o plugin no diretório oficial do WordPress?

Para publicar um plugin no diretório oficial do WordPress.org, você precisa primeiro solicitar um repositório SVN para o seu plugin no próprio WordPress.org. Em seguida, é necessário garantir que o código do seu plugin atenda aos requisitos e normas oficiais, incluindo qualidade do código, segurança, licença (que deve ser compatível com a GPL) e a existência de um arquivo readme.txt padrão. Depois disso, use ferramentas SVN para enviar o seu código para o repositório especificado. A equipe do WordPress irá revisar o plugin, e, se for aprovado, ele será adicionado ao diretório oficial para que os usuários possam baixá-lo e instalá-lo.