Do zero: Infraestrutura básica para o desenvolvimento de plugins do WordPress.

Do zero: Infraestrutura básica para o desenvolvimento de plugins do WordPress.

Para desenvolver um plugin do WordPress, primeiro é necessário compreender a sua estrutura básica. O ficheiro mais importante de um plugin é o ficheiro principal, que é normalmente denominado com o nome do plugin, por exemplo:my-first-plugin.phpEste ficheiro contém não só todo o código funcional do plugin, mas também, e mais importante, os comentários do cabeçalho do plugin no topo. Este cabeçalho é fundamental para que o WordPress consiga identificar o plugin.

Os comentários no cabeçalho do plug-in devem incluir metadados específicos. Aqui está um exemplo básico:

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

Este ficheiro foi criado e colocado em/wp-content/plugins/Depois de adicionar o diretório, você poderá vê-lo na página “Plugins” do WordPress e ativá-lo ou desativá-lo. Em seguida, é fundamental compreender a ordem de carregamento e execução do código do plugin. Quando o WordPress carrega os plugins, ele faz isso em ordem alfabética./wp-content/plugins/Todos os ficheiros principais de plugins válidos na pasta de plugins. Por conseguinte, se o seu plugin depender das funcionalidades de outro plugin, não pode simplesmente assumir que o outro plugin já foi carregado. Neste caso, é necessário utilizarplugins_loadedEste gancho de ação garante que o código seja executado no momento correto.

Leitura recomendada Guia completo para o desenvolvimento de plugins do WordPress: desde o início até a criação de extensões de nível comercial.。

Compreender profundamente os ganchos: mecanismo de ações e filtros

A filosofia central do desenvolvimento de plugins do WordPress é o “Hooks”. Os Hooks permitem que você insira seu próprio código no fluxo de execução do núcleo do WordPress, dos temas ou de outros plugins, sem modificar os arquivos originais. Os Hooks são divididos em duas categorias principais: Hooks de ação e Hooks de filtro.

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

Os ganchos de ação (action hooks) permitem que você execute funções personalizadas quando eventos específicos ocorrem. Por exemplo, quando um artigo é publicado…publish_post), ao carregar recursos no cabeçalho da página web (wp_enqueue_scripts) ou durante a inicialização no painel de administração (admin_initPara usar um gancho de ação, você precisa usaradd_action()A função “monta” a sua função de callback no gancho.

add_action( 'init', 'myplugin_custom_init' );
function myplugin_custom_init() {
    // 在WordPress初始化时执行
    // 例如，注册一个自定义文章类型
}

Os filtros de ganchos são usados para modificar os dados. Eles permitem que você intercepte e modifique as variáveis que lhe são passadas e, em seguida, as devolva. Por exemplo, modificar o conteúdo de um artigo.the_content1) Alterar o comprimento das citações;excerpt_lengthou modificar os resultados da consulta (the_posts). Para usar o filtro, é necessário chamaradd_filter()Função.

add_filter( 'the_title', 'myplugin_custom_title' );
function myplugin_custom_title( $title ) {
    // 修改文章标题
    return '前缀：' . $title;
}

Criar um gancho (hook) personalizado

Além de utilizar as centenas de hooks integrados fornecidos pelo WordPress, os desenvolvedores de plugins avançados também podem criar os seus próprios hooks, que podem ser utilizados por outros desenvolvedores para ampliar as funcionalidades.do_action()Para criar um gancho de ação, useapply_filters()Para criar um gancho de filtro.

// 在插件代码中定义一个自定义动作钩子
do_action( 'myplugin_after_something_happens', $some_data );

// 在插件代码中定义一个自定义过滤器钩子
$value = apply_filters( 'myplugin_filter_some_value', $default_value );

Construir a funcionalidade do plugin: segurança e melhores práticas

Ao programar a funcionalidade do plug-in, a segurança é a principal consideração. Nunca confie na entrada do utilizador. Todos os dados provenientes de fontes externas (como formulários, parâmetros de URL e cookies) devem ser validados, limpos e escapados.

Leitura recomendada Guia de introdução ao desenvolvimento de plugins do WordPress: Desde o início até o domínio da criação de funcionalidades personalizadas.。

Validação de Dados e Escape

Para a entrada, usesanitize_text_field()、sanitize_email()、intval()Aguarde que as funções sejam limpas. Para os dados que são enviados para a página HTML, utilize <esc_html()、esc_attr()ouwp_kses_post()Fazer a escapagem para evitar ataques de cross-site scripting.

$user_input = $_POST['some_field'];
$clean_input = sanitize_text_field( $user_input );

// Na saída
echo '<div class="' . esc_attr( $class_name ) . '">'`. esc_html($clean_input)`.'</div>';

Interagir com a base de dados

O WordPress oferece…$wpdbO objeto global é usado para operações diretas no banco de dados, mas deve ser usado prioritariamente as funções integradas do WordPress, comoget_post()、update_option()etc. Se for necessário usar SQL, certifique-se de usá-lo.$wpdb->prepare()Métodos para prevenir a injeção de SQL.

global $wpdb;
$user_id = intval( $_GET['id'] );
$results = $wpdb->get_results(
    $wpdb->prepare( "SELECT * FROM {$wpdb->prefix}my_table WHERE user_id = %d", $user_id )
);

Adicionar menu e página de gestão

Criar uma página de configuração para um plug-in é uma necessidade comum. Você pode usaradd_menu_page()ouadd_options_page()Esperar que as funções adicionem itens de menu em segundo plano. Estas funções devem seradmin_menuChamado nos ganchos de ação.

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

add_action( 'admin_menu', 'myplugin_add_admin_menu' );
function myplugin_add_admin_menu() {
    add_options_page(
        'My Plugin Settings', // título da página
        'My Plugins', // título do menu
        'manage_options', // permissões
        'myplugin-slug', // alias do menu
        'myplugin_settings_page' // função de retorno de chamada para renderizar a página
    );
}
function myplugin_settings_page() {
    // Saída do HTML da página de configurações
    echo '<div class="wrap"><h1>configurar</h1></div>';
}

Preparação para o lançamento do plugin: internacionalização e organização do código

Quando o plugin estiver funcional, será necessário prestar atenção à internacionalização e à organização do código, de modo a alcançar um público mais vasto e facilitar a manutenção.

Implementar a internacionalização de plugins

A internacionalização (i18n) permite que o seu plugin seja traduzido para outras línguas. Para isso, é necessário utilizar as funções de tradução do WordPress.__()、_e()、_x()Inclua todas as cadeias de caracteres visíveis para os utilizadores no pacote e declare-as no cabeçalho do plug-in.Text Domain(Por exemplo,my-first-plugin）。

// 在代码中
$greeting = __( 'Hello, World!', 'my-first-plugin' );
_e( 'This text will be echoed and translatable.', 'my-first-plugin' );

// 然后，使用如Poedit等工具生成 .pot 翻译模板文件。

Organização modular de código

Evite amontoar todo o código no arquivo principal. Uma boa prática é dividir o código de diferentes funcionalidades em diferentes arquivos..phpNo arquivo, e inclua-os no arquivo principal. Por exemplo:
- includes/admin/ O diretório armazena o código relacionado ao back-end.
- includes/public/ O diretório armazena o código relacionado ao front-end.
- includes/class-*.php Armazene as principais definições de classe.
- assets/css/ e assets/js/ Armazenar folhas de estilo e scripts.

Leitura recomendada Guia definitivo para o desenvolvimento de plugins do WordPress: dicas essenciais para criar funcionalidades personalizadas do zero.。

A utilização da programação orientada a objetos permite organizar melhor o código, evitar conflitos de nomes de funções e aumentar a reutilização. Defina uma classe principal e instale todos os ganchos necessários no seu método de construção.

class My_First_Plugin {
    public function __construct() {
        add_action( 'init', array( $this, 'init_method' ) );
        add_filter( 'the_content', array( $this, 'filter_content' ) );
    }
    public function init_method() {
        // 初始化
    }
    public function filter_content( $content ) {
        return $content . '<p>Conteúdo adicional do plug-in.</p>';
    }
}
new My_First_Plugin();

resumos

O desenvolvimento de plugins para o WordPress é um processo que integra funcionalidades personalizadas de forma transparente no ecossistema do WordPress. A sua base começa com um ficheiro de cabeçalho de plugin que cumpre os padrões. O núcleo do desenvolvimento reside na utilização eficiente de hooks de ação e de filtro, para expandir ou modificar o comportamento do WordPress de forma orientada por eventos. Durante a programação, é necessário priorizar a segurança e validar, limpar e escapar os dados de forma rigorosa. À medida que a funcionalidade do plugin cresce, uma boa organização do código (incluindo design orientado a objetos e estrutura de ficheiros modular) e suporte à internacionalização são passos fundamentais para melhorar a manutenibilidade, a profissionalidade e o alcance dos utilizadores do plugin. Seguindo estas melhores práticas, conseguirá criar plugins para o WordPress que sejam robustos, seguros e fáceis de distribuir.

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

Perguntas frequentes Perguntas frequentes

Quais são os conhecimentos básicos necessários para desenvolver um plugin do WordPress?

Você precisa dominar os fundamentos da linguagem PHP, pois o WordPress e os seus plugins são escritos em PHP. Além disso, é necessário ter um conhecimento básico de HTML, CSS e JavaScript para lidar com a apresentação e a interação do front-end. Por último, mas não menos importante, é importante compreender o funcionamento básico do WordPress e o seu sistema de hooks, que é o mecanismo central para o desenvolvimento de plugins.

Como evitar que o nome da função do meu plugin entre em conflito com outros plugins?

A melhor prática é usar a programação orientada a objetos (OOP) e encapsular as suas funções numa classe, de forma que os nomes dos métodos dentro da classe sejam independentes. Se utilizar a programação procedimental, deve adicionar um prefixo único a todos os funções, classes e constantes. Este prefixo pode ser a abreviatura do seu plug-in ou o nome da marca, por exemplo:myplugin_ouacme_E assegure-se de manter a consistência em todo o código.

Onde devo carregar os ficheiros JavaScript e CSS do plug-in?

Para garantir a correção e o desempenho, nunca ligue diretamente os ficheiros de recursos nos modelos HTML. Deve utilizar a função enqueue fornecida pelo WordPress. Para os recursos front-end, utilize owp_enqueue_script()ewp_enqueue_style()e montá-lo emwp_enqueue_scriptsNa ação Hook. Para os recursos utilizados apenas na interface de gestão de back-end, estes são montados.admin_enqueue_scriptsNo gancho.

Como os plugins armazenam as suas próprias configurações e dados?

Para configurações simples de um único valor, pode-se utilizar a API de opções do WordPress, ou seja,add_option()、get_option()eupdate_option()Funções. Para dados mais complexos e estruturados (como uma lista de itens de formulário), deve-se criar tabelas de banco de dados personalizadas. Pode-se usardbDelta()A função é ativada quando o plugin é iniciado (por meio de…)register_activation_hookCriar ou atualizar a estrutura de tabelas de forma segura.