Dominando o desenvolvimento de plugins para o WordPress do zero: princípios, prática e técnicas avançadas

Os plugins do WordPress são o mecanismo central para expandir suas funcionalidades básicas. Com eles, é possível adicionar inúmeras funcionalidades ao site sem a necessidade de modificar o código-fonte do próprio WordPress. O desenvolvimento de plugins segue uma série de convenções e boas práticas para garantir sua segurança, desempenho e manutenibilidade. Um plugin padrão necessita, no mínimo, de um arquivo principal, cujo nome geralmente corresponde ao nome do próprio plugin. my-awesome-plugin.phpEste artigo começará com conceitos básicos e te guiará passo a passo no mundo do desenvolvimento de plugins.

Compreender os princípios básicos dos plugins

Um plugin para o WordPress é, essencialmente, um ou mais arquivos PHP que são armazenados no repositório oficial do WordPress. /wp-content/plugins/ Os plugins interagem com o núcleo do WordPress através da API (Application Programming Interface) e do sistema de ganchos (Hooks) fornecidos pelo próprio WordPress.

Mecanismo de funcionamento do sistema de ganchos

O sistema de “ganchos” (hooks) é o núcleo do desenvolvimento de plugins para o WordPress. Os desenvolvedores utilizam principalmente dois métodos para se integrar ao fluxo de trabalho padrão do WordPress: ações (Actions) e filtros (Filters). As ações permitem que você execute código personalizado em momentos específicos, enquanto os filtros permitem que você modifique os dados que são passados durante o processo.

Leitura recomendada Desenvolvimento de plugins para WordPress: Do básico ao avançado: Um guia passo a passo para criar suas próprias funcionalidades exclusivas。

Por exemplo, ao usar… add_action() Uma função pode registrar um “action hook”. Quando o WordPress chega a esse ponto de execução, a função de callback (resposta) que você associou será executada.

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

Informações do cabeçalho padrão do plugin

O arquivo PHP principal de cada plugin deve conter um bloco de comentários de cabeçalho padronizado, usado para fornecer informações metadados sobre o plugin para o WordPress. Essas informações controlam a forma como o plugin é exibido na página de gerenciamento de plugins no backend.

<?php
/**
 * Plugin Name: 我的超级插件
 * Plugin URI: https://www.example.com/my-super-plugin/
 * Description: 这是一个用来演示插件开发基础的示例插件。
 * Version: 1.0.0
 * Author: 张三
 * Author URI: https://www.example.com/
 * License: GPL v2 or later
 * Text Domain: my-super-plugin
 */

Carregamento e ativação de plugins

Quando um usuário ativa um plugin pelo painel administrativo do WordPress, o WordPress executa o código contido no arquivo principal desse plugin a cada vez que uma página é carregada (desde que esse código não esteja dentro de uma função ou não esteja protegido por condições específicas). Por isso, é geralmente recomendado que todo o código responsável pelas funcionalidades do plugin seja encapsulado em funções ou classes, e que essas funções ou classes sejam chamadas através de “ganchos” (hooks), a fim de evitar que o código seja executado quando o plugin não estiver ativado.

Construa o seu primeiro plugin.

Vamos criar um plugin simples cuja função é adicionar automaticamente uma declaração de direitos autorais no final de todo o conteúdo dos artigos do site.

Criar o arquivo do plugin principal

Primeiramente, em /wp-content/plugins/ Crie uma nova pasta no diretório e nomeie-a… my-first-pluginEm seguida, crie o arquivo principal dentro dessa pasta. my-first-plugin.phpE adicione as informações do cabeçalho do arquivo padrão mencionadas acima.

Leitura recomendada Desenvolvimento de plugins do WordPress do início ao fim: um guia completo para criar módulos altamente personalizáveis.。

Usar filtros para modificar o conteúdo de um artigo

Nós vamos usar. the_content Use filtros para modificar a saída dos artigos. Adicione o seguinte código ao seu arquivo principal:

function myfp_add_copyright_to_content($content) {
    // 确保只在文章主循环中、且非管理后台执行
    if (is_single() && !is_admin()) {
        $copyright_text = '<p><em>Os direitos de autor deste artigo pertencem a este site. Por favor, indique a fonte ao republicá-lo.</em></p>';
        $content .= $copyright_text;
    }
    return $content;
}
add_filter('the_content', 'myfp_add_copyright_to_content');

myfp_add_copyright_to_content A função recebe um parâmetro. $contentOu seja, o conteúdo do artigo. Utilizamos funções de avaliação de condições para isso. is_single()Assegure-se de que isso seja adicionado apenas na página de um único artigo. !is_admin() Isso evitará que essa informação sobre direitos autorais seja exibida no editor de backend.

Processamento de localização de plugins

Para que o plugin suporte múltiplas línguas, é necessário realizar o processamento de internacionalização (i18n). Primeiramente, isso já foi configurado no cabeçalho do arquivo principal. Text Domain: my-first-pluginEm seguida, carrega os arquivos de idioma durante a inicialização do 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

Geralmente, usamos… plugins_loaded Use ações para carregar as traduções de forma segura. __() ou _e() Use funções como `str.format()` para envolver todas as strings que precisam ser traduzidas.

function myfp_load_textdomain() {
    load_plugin_textdomain(
        'my-first-plugin',
        false,
        dirname(plugin_basename(__FILE__)) . '/languages/'
    );
}
add_action('plugins_loaded', 'myfp_load_textdomain');

Modo de desenvolvimento de plugins avançados

Quando as funcionalidades de um plugin se tornam mais complexas, a adoção de métodos de desenvolvimento orientados a objetos (OOP – Object-Oriented Programming) e mais estruturados proporciona uma melhor organização, encapsulamento e manutenibilidade do código.

Adotar a programação orientada a objetos

Usar uma classe para encapsular todas as funcionalidades do plugin é uma escolha sábia. Isso pode evitar conflitos de nomes de funções e proporcionar uma estrutura de código mais clara.

Leitura recomendada Análise aprofundada: Domine o desenvolvimento de plugins para o WordPress do zero, desde os conceitos fundamentais até as práticas práticas.。

class My_Advanced_Plugin {
    public function __construct() {
        // 在构造函数中绑定所有钩子
        add_action('wp_footer', array($this, 'add_footer_notice'));
        add_filter('the_title', array($this, 'modify_post_title'));
    }

public function add_footer_notice() {
        echo '<p style="text-align:center;">O suporte técnico é fornecido pelo My Advanced Plugin.</p>';
    }

public function modify_post_title($title) {
        if (in_the_loop()) {
            return '📝 ' . $title;
        }
        return $title;
    }
}
// 实例化插件类
new My_Advanced_Plugin();

Adicionar a página de configurações do painel de administração

Muitos plugins precisam fornecer opções de configuração para os usuários. Adicionar uma página de configurações no painel administrativo do WordPress geralmente envolve o uso de… add_menu_page() ou add_submenu_page() Funções, em conjunto com a API Settings, para salvar as opções de forma segura.

class My_Plugin_Settings {
    public function __construct() {
        add_action('admin_menu', array($this, 'add_admin_menu'));
        add_action('admin_init', array($this, 'register_settings'));
    }

public function add_admin_menu() {
        add_options_page(
            '我的插件设置', // 页面标题
            '我的插件',     // 菜单标题
            'manage_options', // 权限
            'my-plugin-settings', // 菜单别名
            array($this, 'render_settings_page') // 回调函数
        );
    }

public function render_settings_page() {
        ?>
        <div class="wrap">
            <h1>Configurações do meu plugin</h1>
            <form method="post" action="/pt/options.php/" data-trp-original-action="options.php">
                <?php
                settings_fields('my_plugin_options_group');
                do_settings_sections('my-plugin-settings');
                submit_button();
                ?>
            <input type="hidden" name="trp-form-language" value="pt"/></form>
        </div>
        &lt;?php
    }

public function register_settings() {
        register_setting(&#039;my_plugin_options_group&#039;, &#039;my_plugin_option_name&#039;);
        // ... 添加设置字段和章节
    }
}

Criação de tabelas de banco de dados personalizadas

Para alguns plugins que precisam armazenar dados complexos, pode ser necessário criar tabelas de dados personalizadas. Esse trabalho deve ser realizado quando o plugin for ativado.

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

O WordPress fornece uma classe conveniente para operações no banco de dados. wpdbO código para criar uma tabela geralmente é colocado em um arquivo ou bloco de código que é executado por meio de um programa ou ferramenta específica. register_activation_hook Na função registrada.

function my_plugin_create_database_table() {
    global $wpdb;
    $table_name = $wpdb->prefix . 'my_custom_data';
    $charset_collate = $wpdb->get_charset_collate();

$sql = "CREATE TABLE $table_name (
        id mediumint(9) NOT NULL AUTO_INCREMENT,
        user_id mediumint(9) NOT NULL,
        data text NOT NULL,
        created_at datetime DEFAULT CURRENT_TIMESTAMP NOT NULL,
        PRIMARY KEY (id)
    ) $charset_collate;";

require_once(ABSPATH . 'wp-admin/includes/upgrade.php');
    dbDelta($sql);
}
register_activation_hook(__FILE__, 'my_plugin_create_database_table');

Segurança e distribuição de plugins

Antes de lançar um plugin, é essencial garantir sua segurança e compreender o processo básico de sua distribuição.

Implementar as melhores práticas de segurança

Todos os dados recebidos dos usuários, independentemente de sua origem… $_GET、$_POST Tanto os dados do banco de dados quanto os outros dados devem ser verificados, limpos e escapados (ou seja, os caracteres especiais devem ser convertidos em formas seguras para serem processados). Sempre use as funções fornecidas pelo WordPress para realizar essas operações. esc_html()、wp_strip_all_tags()、intval() também prepare() Métodos para lidar com consultas SQL a fim de prevenir ataques de XSS (Cross-Site Scripting) e SQL Injection.

Para realizar verificações de capacidade relacionadas à execução de operações administrativas ou críticas, é essencial utilizar funções de verificação de capacidade. current_user_can('manage_options') ou check_ajax_referer()。

Preparando o plugin para ser submetido ao diretório oficial.

Se você deseja distribuir o plugin gratuitamente para usuários em todo o mundo, pode enviá-lo para o diretório de plugins do WordPress.org. Isso requer que você siga rigorosamente alguns padrões, incluindo o uso do SVN para controle de versões, a garantia da qualidade do código e a disponibilização de arquivos de tradução, entre outros. Um bom exemplo de plugin bem desenvolvido e compatível com esses requisitos é o… (nome do plugin). readme.txt O arquivo é necessário e segue um formato específico, utilizado para exibir informações na página de detalhes do plugin.

resumos

O desenvolvimento de plugins para o WordPress é um processo que começa com a compreensão do sistema de ganchos (hooks) do core do WordPress, e avança gradualmente para o aprendizado da construção de funcionalidades, do gerenciamento do painel de administração, do processamento de dados, até a atenção à segurança e à distribuição dos plugins. Iniciantes devem começar criando um plugin com filtros simples, e depois tentar programar de forma orientada a objetos, adicionar páginas de configuração e operar tabelas de banco de dados personalizadas. Lembre-se de que a segurança é a principal prioridade no desenvolvimento; o uso proficiente das muitas funções de segurança disponíveis no WordPress é essencial para criar plugins confiáveis. Seguir os padrões de desenvolvimento e as melhores práticas garantirá que seu plugin seja fácil de manter e também estabelecerá uma base para futuras publicações no diretório oficial do WordPress ou em lojas de plugins.

Perguntas frequentes Perguntas frequentes

Quantos arquivos um plugin precisa ter no mínimo?

Um plugin precisa de no mínimo um arquivo PHP. Basta que esse arquivo contenha as informações corretas de cabeçalho do plugin e seja armazenado em um local apropriado. /wp-content/plugins/ No diretório ou em seus subdiretórios, o WordPress será capaz de reconhecer e carregá-lo.

Claro, à medida que as funcionalidades se tornam mais complexas, dividir o código em vários arquivos (como JavaScript, CSS, arquivos de classes PHP separados, etc.) é uma maneira melhor de organizá-lo.

Qual é a diferença entre os ganchos (hooks) e os filtros (filters) dos plugins do WordPress?

Embora os Ganchos de Ação (Action Hooks) e os Ganchos de Filtro (Filter Hooks) sejam por vezes chamados coletivamente de “ganchos”, eles têm usos diferentes.

Os ganchos de ação (action hooks) permitem que você insira um código personalizado em pontos específicos do ciclo de vida do WordPress. Eles não esperam um valor de retorno; sua única função é executar uma ação, como enviar um e-mail ou registrar um evento no log. A função central para trabalhar com ganchos de ação é… add_action() e do_action()。

Os ganchos (hooks) dos filtros permitem que você “modifique” o valor de uma variável (geralmente uma string ou um array). Eles esperam que a sua função de callback retorne um valor modificado. A função central é… add_filter() e apply_filters()。

Em termos simples: uma ação é “fazer algo”, enquanto um filtro é “alterar dados”.

Como evitar que os nomes das funções dos plugins entrem em conflito com o tema ou com outros plugins?

O melhor método é usar a programação orientada a objetos e encapsular todas as suas funcionalidades em uma única classe. Dessa forma, apenas o nome da classe e o nome dos métodos precisam ser únicos.

Se você utilizar programação procedural, deve adicionar um prefixo único e de alta reconhecibilidade a todos os nomes de suas funções, constantes e variáveis globais. Geralmente, o nome de um plugin ou uma abreviação é usado como prefixo. Por exemplo, se o seu plugin se chamar “Super Tool”, os nomes das funções poderiam ser algo como: stool_get_data()、stool_OPTION_KEY Assim.

Outra maneira mais eficaz de isolar seu código é usar os espaços de nomes (namespaces) do PHP.

Como lidar com as configurações e opções dos usuários no desenvolvimento de plugins?

O WordPress recomenda fortemente o uso da sua API Settings para gerenciar as opções dos plugins. Essa API cuida do armazenamento seguro dessas opções (em…) wp_options A validação não realizada pelo sistema CE (Conformity Assessment), a renderização dos campos e o envio dos formulários são métodos seguros e padronizados.

Os passos principais incluem: usar register_setting() Registre um grupo de opções e use-o. add_settings_section() e add_settings_field() Adicione áreas de configuração e campos, e por fim, utilize-os no lado front-end. settings_fields() e do_settings_sections() Assim, o formulário de configuração completo será gerado. Ao salvar as opções, use… update_option() Função.