Desenvolvimento de plugins do WordPress do início ao fim: um guia completo para criar um site personalizado.

Por que aprender o desenvolvimento de plugins para o WordPress?

O WordPress é o sistema de gestão de conteúdos mais popular do mundo, e a sua grande capacidade de expansão deve-se principalmente ao mecanismo de plugins. Ao desenvolver plugins personalizados, os programadores podem ultrapassar as limitações dos temas e adicionar ao website as funcionalidades necessárias, desde códigos curtos simples até sistemas de comércio eletrónico complexos. Dominar as competências de desenvolvimento de plugins significa que pode não só satisfazer as necessidades de projetos específicos, mas também transformar as soluções em produtos e criar valor no vasto ecossistema do WordPress.

e aqueles que modificam diretamente o tópico.functions.phpEm comparação com os ficheiros, a utilização de plugins para agrupar funcionalidades é uma prática mais profissional e sustentável. Os plugins podem existir independentemente do tema, facilitando a reutilização de funcionalidades, a manutenção e atualização separadas. Um plugin bem estruturado, que siga os padrões de codificação e a filosofia de arquitetura do WordPress, garante a compatibilidade com o núcleo e outros plugins.

Do ponto de vista do desenvolvimento profissional, quer seja como freelancer oferecendo soluções personalizadas aos clientes, quer como gestor de produto criando plugins comerciais destinados a utilizadores de todo o mundo, esta competência tem uma grande procura no mercado e um elevado potencial de rentabilização.

Leitura recomendada Aprenda a desenvolver plugins do WordPress do zero: crie funcionalidades e extensões personalizadas.。

Configurando seu ambiente de desenvolvimento de plugins

Antes de começar a escrever a primeira linha de código, é fundamental configurar um ambiente de desenvolvimento local profissional. Isso permite que você teste e depure em um espaço seguro e isolado.

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

Configuração do ambiente do servidor local

Recomenda-se utilizar pacotes de software de servidor local integrados, como Local by Flywheel, DevKinsta ou XAMPP. Estas ferramentas instalam, com um único clique, o PHP, o MySQL/MariaDB e o servidor web (como o Apache ou o Nginx). Certifique-se de que o seu ambiente está a executar uma versão do PHP compatível ou atualizada em relação ao seu ambiente de produção (por exemplo, PHP 7.4 ou 8.0+) e que as extensões PHP necessárias, como o MySQLi ou o PDO, estão ativadas.

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

Escolha um editor de código poderoso ou um ambiente de desenvolvimento integrado (IDE). O Visual Studio Code, o PhpStorm ou o Sublime Text são excelentes opções. Eles devem incluir realce de sintaxe, dicas de código e integração de controle de versão.

A depuração é uma etapa fundamental do desenvolvimento. É essencial que vocêwp-config.phpO ficheiro ativa o modo de depuração do WordPress.WP_DEBUGA constante foi definida como…trueIsso irá mostrar os erros, avisos e notificações do PHP no ecrã, ajudando-o a identificar rapidamente o problema.

// 在 wp-config.php 中定义调试常量
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true ); // 将错误记录到 /wp-content/debug.log
define( 'WP_DEBUG_DISPLAY', false ); // 不在前端显示错误

Inicialização do sistema de controlo de versões

Usar o Git para controlo de versões desde o início. Inicialize um repositório na pasta raiz do seu plugin e crie um.gitignoreDocumentos, ignore coisas comonode_modules、vendor(Se usar o Composer) e qualquer ficheiro de configuração que contenha informações sensíveis. Isto irá ajudá-lo a acompanhar as alterações de código e a colaborar com a equipa.

Leitura recomendada Do zero: construa o seu primeiro plugin do WordPress.。

Crie o seu primeiro plugin para o WordPress.

Um plugin do WordPress básico requer apenas um arquivo PHP principal e deve incluir comentários com informações padrão sobre o plugin no início do arquivo.

Estrutura do arquivo principal do plugin

No seuwp-content/pluginsNo diretório, crie uma nova pasta, por exemplo…my-first-pluginDentro dessa pasta, crie o arquivo PHP principal, cujo nome geralmente é o mesmo do nome da pasta:my-first-plugin.php。

Abra este ficheiro e adicione os comentários de cabeçalho do plugin no topo do ficheiro. Estes comentários são necessários para que o WordPress reconheça o plugin.

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

<?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 o ficheiro, inicie sessão no painel de administração do WordPress e aceda à página “Plugins”. Deverá ver o “Meu Primeiro Plugin” na lista de plugins. Nesta altura, ative-o. Embora ainda não tenha nenhuma funcionalidade, já criou com sucesso um plugin.

Implementar uma funcionalidade simples: gerir notificações.

Vamos adicionar a primeira funcionalidade real a este plugin: exibir uma notificação personalizada na área de administração. Vamos utilizar a API de notificações de administração do WordPress.

No ficheiro principal do plugin, abaixo do comentário de cabeçalho, adicione o seguinte código. Nós utilizamosadmin_noticesUsamos um gancho (Action Hook) para exibir o nosso conteúdo numa localização específica.

Leitura recomendada Guia completo para o desenvolvimento de plugins do WordPress: de iniciante a tutoriais práticos avançados.。

// Gancho: exibir avisos no backend do administrador
add_action( 'admin_notices', 'mfp_display_admin_notice' );

/**
 * Uma função para exibir avisos de boas-vindas no backend do administrador.
 * Essa função é chamada por meio do gancho `admin_notices`.
 */
function mfp_display_admin_notice() {
    // Verifica se o usuário atual tem direitos de administrador para evitar a exibição para usuários normais.
    if ( ! current_user_can( 'manage_options' ) ) {
        return;
    }
    ? >}
    <div class="notice notice-success is-dismissible">
        <p><?php _e( '欢迎使用“我的第一个插件”！', 'my-first-plugin' ); ?></p>
    </div>
    &lt;?php
}

Explicação do código:add_action()A função irá utilizar a nossa função personalizada.mfp_display_admin_noticeMontar emadmin_noticesNeste gancho. Quando o WordPress executa a área de notificações em segundo plano, a nossa função é invocada. Dentro da função, verificam-se primeiro os direitos do utilizador e, em seguida, é apresentada uma notificação HTML que inclui um estilo de sucesso e um botão para fechar. Utilize-se__()ou_e()É uma boa prática internacionalizar o texto nas funções.

No fundo: ganchos, códigos curtos e opções.

Para desenvolver um plugin funcional, é necessário dominar vários mecanismos de extensão principais do WordPress: ganchos (Hooks), código curto (Shortcode) e a API de opções (Options).

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

Compreender e aplicar ações e filtros de hook

Os hooks são a base da arquitetura de plugins do WordPress, que permitem “injetares” o teu próprio código em pontos específicos da execução do código central. Os hooks são divididos em dois tipos: ações (Actions) e filtros (Filters).

Os ganchos de ação executam o seu código quando um evento específico ocorre, sem exigir um valor de retorno. Por exemplo,init(Inicialização),wp_enqueue_scripts(Carregar o estilo do script front-end)save_post(Ao guardar o artigo). O que utilizámos anteriormenteadmin_noticesÉ apenas um gancho de ação (action hook).

Os ganchos de filtro são usados para modificar os dados. Eles recebem um valor e pedem que você retorne o valor modificado. Por exemplo,the_titleOs filtros permitem-lhe alterar a saída dos títulos dos artigos.widget_textOs filtros permitem-lhe alterar o conteúdo do texto dos widgets.

// 使用过滤器修改文章标题
add_filter( 'the_title', 'mfp_modify_post_title' );
function mfp_modify_post_title( $title ) {
    if ( ! is_admin() && in_the_loop() ) {
        return '📢 ' . $title;
    }
    return $title;
}

Criar e usar códigos curtos

Os códigos curtos permitem que os utilizadores acedam a determinados serviços através de uma etiqueta simples (como, por exemplo, <).[my_shortcode]) Inserir conteúdo dinâmico num artigo ou página. Utilizaradd_shortcode()Usamos uma função para registrar códigos curtos.

// 注册一个短代码
add_shortcode( 'mfp_current_time', 'mfp_render_current_time_shortcode' );
/**
 * 渲染显示当前时间的短代码。
 * @param array $atts 短代码属性。
 * @param string $content 短代码包裹的内容（如果有）。
 * @return string 渲染后的HTML。
 */
function mfp_render_current_time_shortcode( $atts = [], $content = null ) {
    // 使用 shortcode_atts 设置默认属性并合并用户输入
    $atts = shortcode_atts( [
        'format' => 'Y-m-d H:i:s',
    ], $atts, 'mfp_current_time' );

// 根据格式获取当前时间
    $current_time = date( $atts['format'] );

// 返回输出
    return '<p class="mfp-time">Hora atual: ' . esc_html( $current_time ) . '</p>';
}

Os utilizadores podem introduzir informações no editor.[mfp_current_time format="F j, Y"]Para mostrar a hora num formato específico.

Armazenar as definições utilizando a API de opções.

Os plugins geralmente precisam salvar algumas informações de configuração. O WordPress fornece uma API de opções, que é usada para...wp_optionsO banco de dados armazena, recupera e atualiza os dados de forma segura.

fazer uso deadd_option()、get_option()、update_option()edelete_option()Os funções são usadas para manipular dados. Para uma organização mais clara, recomenda-se adicionar um prefixo unificado a todos os nomes das teclas de opção.

// 定义默认选项
define( 'MFP_DEFAULT_MESSAGE', '你好，世界！' );

// 插件激活时设置默认选项（需要注册激活钩子）
register_activation_hook( __FILE__, 'mfp_set_default_options' );
function mfp_set_default_options() {
    if ( false === get_option( 'mfp_custom_message' ) ) {
        add_option( 'mfp_custom_message', MFP_DEFAULT_MESSAGE );
    }
}

// 在代码中获取选项值
$message = get_option( 'mfp_custom_message', MFP_DEFAULT_MESSAGE );
echo esc_html( $message );

Criar plugins profissionais: segurança, gestão e publicação.

À medida que as funcionalidades dos plugins se tornam cada vez mais complexas, é necessário considerar a organização do código, a segurança, a interface do utilizador e o processo de publicação.

Seguir as melhores práticas de segurança

A segurança é a base do desenvolvimento de plugins. O princípio fundamental é: nunca confiar na entrada do utilizador. Validar, limpar e escapar todos os dados provenientes do utilizador, da base de dados ou de APIs externas.
* Validação: verificar se os dados estão no formato esperado (por exemplo, se é um endereço de e-mail ou um número), usandofilter_var()、preg_match()Ou funções do WordPress, comois_email()。
* Limpeza (Sanitização): Limpar os dados e remover os caracteres não seguros. Para a entrada de texto, utilizesanitize_text_field()Para conteúdo HTML, utilize <wp_kses_post()Para os URLs, utilizeesc_url_raw()。
* Escapar: Quando os dados são enviados para HTML, JavaScript ou URL, eles devem ser escapados de acordo com o contexto. Use <esc_html()、esc_attr()、esc_js()、esc_url()Funções como essas.
* Validação CAPTCHA: Todas as operações que possam alterar a base de dados (como o envio de formulários) devem incluir a validação CAPTCHA, utilizandowp_nonce_field()、wp_verify_nonce()。

Criar a página de configurações de gerenciamento

Para os plugins que exigem configuração do usuário, é necessário fornecer uma página de configuração de gerenciamento clara. O WordPress fornece uma API de configuração para simplificar esse processo, que lida automaticamente com a validação de CAPTCHA, a verificação de permissões e o armazenamento de dados.

Você precisa usar…add_options_page()ouadd_menu_page()Depois de adicionar a página para funções, use-a.register_setting()、add_settings_section()eadd_settings_field()Para definir os campos de configuração.

Código da organização e preparação para o lançamento

Não coloque todo o código no ficheiro principal. À medida que o plug-in cresce, o código deve ser dividido em diferentes ficheiros por módulos funcionais. Uma estrutura de diretórios típica pode incluir:
* /admin: Armazenar códigos relacionados com o back-end (página de configurações, etc.).
* /publicArmazenar o código relacionado ao front-end.
* /includesArmazene as classes e funções de funcionalidades principais.
* /assetsArmazenar CSS, JavaScript e imagens.
* /languages: Armazenar ficheiros de tradução internacional (.po/.mo).

fazer uso derequire_onceouinclude_onceIntroduza estes ficheiros nas localizações apropriadas. Considere utilizar o Composer para gerir as dependências PHP e o NPM/Yarn para gerir os recursos front-end.

Antes da publicação, certifique-se de que o seu plugin está em conformidade com o Manual de Desenvolvimento de Plugins e os Padrões de Codificação oficiais do WordPress. Utilize ferramentas como o PHP_CodeSniffer para verificar. Escreva código claro e legível.readme.txtDocumentos que descrevem detalhadamente as funcionalidades, os passos de instalação, as capturas de ecrã e os registos de atualização.

resumos

O desenvolvimento de plugins do WordPress é uma jornada que começa com a compreensão da infraestrutura (arquivos de plugins, ganchos) e avança para conceitos fundamentais (códigos curtos, API de opções) e, finalmente, para o desenvolvimento profissional (segurança, arquitetura, publicação). Ao começar com a criação de um plugin simples de “Hello World” e, gradualmente, adicionar funcionalidades como notificações de back-end, códigos curtos e opções de configuração, você poderá dominar todo o processo de desenvolvimento de forma sistemática. Lembre-se de que escrever código seguro, eficiente e fácil de manter, além de seguir as normas e as melhores práticas do ecossistema do WordPress, é fundamental para criar plugins de sucesso. Aprender continuamente, ler a documentação oficial e estudar o código-fonte de plugins excelentes ajudará você a aprimorar suas habilidades e passar de iniciante a especialista.

Perguntas frequentes Perguntas frequentes

Para desenvolver plugins, é necessário ter conhecimentos profundos de PHP?
Sim, é necessário ter uma base sólida em PHP, uma vez que o núcleo do WordPress e os seus plugins são escritos em PHP. É necessário compreender conceitos como a sintaxe do PHP, funções, arrays, programação orientada a objetos, etc. Além disso, é fundamental ter um conhecimento básico de HTML, CSS e JavaScript para criar interfaces e interações front-end nos plugins.

Quais são as diferenças entre os ficheiros functions.php dos plugins e dos temas?

Coloque o código de funcionalidade no ficheiro do tema.functions.phpNo caso dos ficheiros, a funcionalidade fica associada ao tema. Quando muda de tema, estas funcionalidades deixam de funcionar. Os plugins, por outro lado, são módulos independentes do tema, cujas funcionalidades funcionam em qualquer tema ativado, o que facilita a reutilização, manutenção e distribuição da funcionalidade. Para funcionalidades que se destinam a uma utilização a longo prazo ou a ser distribuídas a outras pessoas, deve dar-se prioridade ao desenvolvimento de plugins.

Como depurar o código do meu plug-in?

Ativar o modo de depuração do WordPress é o primeiro passo mais importante, através das configurações.WP_DEBUGPara exibir erros, utilize constantes relacionadas, como por exemplo:error_log()A função regista as informações das variáveis no registo de erros do servidor oudebug.logNo arquivo. Além disso, pode-se instalar plugins de depuração profissionais, como o Query Monitor, que fornece informações detalhadas sobre consultas de banco de dados, ganchos, scripts e outros, sendo uma ferramenta poderosa para desenvolvedores.

Como o meu plugin implementa a internacionalização multilíngue?

O WordPress utiliza a estrutura GNU gettext para a internacionalização. No seu plugin, utilize a função de tradução para todas as cadeias de caracteres orientadas para o utilizador, como por exemplo:()、_e()、esc_html()Especifique o domínio de texto (Text Domain). Em seguida, use ferramentas como o Poedit para analisar o código do plug-in e gerar.potFicheiros de modelo, com base nos quais os tradutores criam versões em diferentes idiomas..poe.moArquivo, coloque-o no plugin./languagesBasta colocá-lo na pasta correspondente.