Introduzione allo sviluppo di plugin per WordPress: una guida passo passo per pubblicare un plugin indipendente e iniziare a generare entrate.

Molti sviluppatori desiderano trasformare le proprie competenze in WordPress in un reddito concreto, e lo sviluppo e la pubblicazione di plugin indipendenti rappresenta un percorso ideale. Questo approccio non solo permette di far utilizzare il proprio codice da migliaia di utenti, ma genera anche un reddito continuo. Tuttavia, creare da zero un plugin che rispetti gli standard ufficiali di WordPress, sia completo di funzionalità e sia idoneo alla vendita richiede conoscenze e competenze pratiche sistematiche. Questo articolo fornirà una guida pratica completa, che spiegherà passo dopo passo tutto il processo: dalla configurazione dell’ambiente di sviluppo, allo sviluppo effettivo del plugin, fino alla sua pubblicazione finale sul sito web.

Preparazioni e configurazione dell’ambiente di sviluppo

Prima di scrivere la prima riga di codice, è fondamentale creare un ambiente di sviluppo efficiente e standardizzato. Questo non solo migliora l’efficienza dello sviluppo, ma garantisce anche la qualità del codice.

Creare un ambiente di sviluppo locale

Il modo più consigliato per iniziare a utilizzare WordPress è installare un ambiente di sviluppo sul proprio computer locale. Puoi utilizzare strumenti integrati come XAMPP, MAMP, Local by Flywheel o Laragon, che permettono di installare rapidamente Apache, MySQL e PHP. Assicurati che la versione di PHP utilizzata sia compatibile con gli ambienti di hosting più comuni (solitamente non inferiore a 7.4) e attiva il modo di debug di WordPress: questo ti aiuterà a individuare eventuali errori durante la fase di sviluppo.

Si consiglia di leggere Dallo zero all’uno: Guida autorevole e tutorial pratico per lo sviluppo di plugin per WordPress。

在 wp-config.php Nel file, impostare le seguenti costanti per attivare il debug:

UltaHost – Hosting per siti WordPress

Garanzia di rimborso entro 30 giorni, larghezza di banda illimitata e accesso ai database, protezione gratuita contro gli attacchi DDoS; sconto del 50% per l’acquisto di un piano valido per 3 anni (da 3 a 4 TB di spazio di archiviazione).

pagina di accesso

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

Struttura di base di un plugin di pianificazione

为你的插件创建一个独立的文件夹。假设我们的插件名为“My First Plugin”，那么文件夹名可以是 my-first-pluginNella cartella dei plugin, sono necessari almeno i seguenti file principali:

1. 主文件：通常以插件名命名，如 my-first-plugin.phpQuesto è l’unico punto di accesso al plugin, che contiene anche le note relative alla parte iniziale del codice del plugin stesso.
2. 主类文件：如 class-my-first-plugin.phpViene utilizzato per organizzare la logica funzionale principale dei plugin.
3. assets Cartella: Contiene risorse JavaScript, CSS e immagini.
4. includes Cartella: Contiene altri file di classi ausiliarie o funzioni.
5. languages Cartella: Contiene i file di traduzione internazionalizzati (.po/.mo).

Scrivi il tuo primo plugin.

Ora creeremo lo “scheletro” del plugin per implementare una funzionalità di base.

Definire il file principale del plugin

Il ciclo di vita di un plugin inizia dal suo file principale. Nel file principale… my-first-plugin.php All’inizio del file del plugin, è necessario inserire le note relative alla parte superiore del plugin seguendo le specifiche di WordPress; queste note sono fondamentali affinché WordPress possa riconoscere correttamente il plugin stesso.

Si consiglia di leggere Partire da zero: Guida completa allo sviluppo di plugin per WordPress e condivisione delle migliori pratiche。

<?php
/**
 * Plugin Name:       My First Plugin
 * Plugin URI:        https://yourwebsite.com/my-first-plugin
 * Description:       一个用于演示的入门级 WordPress 插件，用于在文章末尾添加自定义内容。
 * Version:           1.0.0
 * Author:            Your Name
 * Author URI:        https://yourwebsite.com
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 * Domain Path:       /languages
 */

Implementare una classe di funzionalità principale

Un’ottima architettura di plugin utilizza solitamente la programmazione orientata agli oggetti (OOP – Object-Oriented Programming). Creiamo una classe principale per incapsulare tutte le funzionalità, al fine di evitare conflitti tra i nomi delle funzioni.

Prima di tutto, creare un file. class-my-first-plugin.php：

<?php
if ( ! defined( 'ABSPATH' ) ) {
    exit; // 防止直接访问
}

class My_First_Plugin {

/**
     * 构造方法，初始化钩子
     */
    public function __construct() {
        // 在文章内容末尾添加自定义文本
        add_filter( 'the_content', array( $this, 'append_custom_content' ) );
        // 在管理后台添加一个设置菜单
        add_action( 'admin_menu', array( $this, 'add_admin_menu' ) );
    }

/**
     * 在文章内容末尾添加内容
     *
     * @param string $content 原始文章内容。
     * @return string 修改后的文章内容。
     */
    public function append_custom_content( $content ) {
        if ( is_single() && is_main_query() ) {
            $custom_text = get_option( 'mfp_custom_text', '感谢阅读！欢迎关注。' );
            $content .= '<div class="my-custom-content"><p>' . esc_html( $custom_text ) . '</p></div>';
        }
        return $content;
    }

/**
     * 在 WordPress 后台添加一个设置菜单项
     */
    public function add_admin_menu() {
        add_options_page(
            'My First Plugin 设置', // 页面标题
            '我的第一个插件',       // 菜单标题
            'manage_options',      // 权限
            'my-first-plugin',     // 菜单 slug
            array( $this, 'render_settings_page' ) // 回调函数
        );
    }

/**
     * 渲染设置页面的 HTML
     */
    public function render_settings_page() {
        ?>
        <div class="wrap">
            <h1>Impostazioni del mio primo plugin</h1>
            <form action="/it/options.php/" method="post" data-trp-original-action="options.php">
                <?php
                settings_fields( 'mfp_settings_group' );
                do_settings_sections( 'my-first-plugin' );
                submit_button();
                ?>
            <input type="hidden" name="trp-form-language" value="it"/></form>
        </div>
        &lt;?php
    }
}

Successivamente, nel file principale… my-first-plugin.php Dopo la nota di testo in cima alla pagina, introducete questa classe e istanziatela:

hosting.com Hosting condiviso

Prestazioni elevate con CPU AMD EPYC, storage SSD NVMe e LiteSpeed, supporto interno di esperti 24 ore su 24, 7 giorni su 7, misure di sicurezza avanzate, tra cui SSL, brute force, malware e protezione DDoS, risparmi fino a 73%

pagina di accesso

// 引入主类文件
require_once plugin_dir_path( __FILE__ ) . 'class-my-first-plugin.php';

// 初始化插件
function run_my_first_plugin() {
    new My_First_Plugin();
}
run_my_first_plugin();

Miglioramenti delle funzionalità dei plugin e aumento della sicurezza

Un plugin qualificato non deve solo soddisfare le esigenze funzionali, ma deve anche prendere in considerazione aspetti legati alla sicurezza e alla configurabilità.

Aggiungere opzioni di configurazione e funzionalità di validazione dei dati.

Per permettere agli utenti di personalizzare il testo da aggiungere, dobbiamo creare delle vere e proprie opzioni di configurazione. Questo richiede l’utilizzo dell’API di configurazione di WordPress.

在 My_First_Plugin Nel costruttore di una classe, aggiungere un “hook” per l’impostazione iniziale:

Si consiglia di leggere Guida completa allo sviluppo di plugin per WordPress: un corso pratico per partire da zero fino alla pubblicazione sul sito web.。

add_action( 'admin_init', array( this， 'register_settings' ) );

Successivamente, aggiungi nel classificatore il metodo per registrare le impostazioni:

public function register_settings() {
    // 注册一个设置项 `mfp_custom_text` 到 `mfp_settings_group`
    register_setting(
        'mfp_settings_group', // 选项组
        'mfp_custom_text',    // 选项名
        array(
            'type'              => 'string',
            'sanitize_callback' => 'sanitize_text_field', // 数据净化，防止 XSS
            'default'           => '感谢阅读！欢迎关注。',
        )
    );

// 添加一个设置区域
    add_settings_section(
        'mfp_main_section',
        '主要设置',
        null, // 回调函数，可为空
        'my-first-plugin' // 页面 slug
    );

// 在设置区域中添加字段
    add_settings_field(
        'mfp_custom_text_field',
        '自定义追加文本',
        array( $this, 'render_text_field' ), // 渲染字段的回调
        'my-first-plugin',
        'mfp_main_section'
    );
}

public function render_text_field() {
    $value = get_option( 'mfp_custom_text' );
    echo '<input type="text" name="mfp_custom_text" value="' . esc_attr( $value ) . '" class="regular-text">';
    echo '<p class="description">Questo testo verrà visualizzato alla fine di ogni articolo.</p>';
}

Implementare il supporto all’internazionalizzazione

Per permettere che il tuo plugin venga utilizzato da utenti in tutto il mondo, l’internazionalizzazione (i18n) è essenziale. Abbiamo già definito le impostazioni relative all’internazionalizzazione nelle note presenti all’inizio del codice del plugin. Text Domain 和 Domain PathOra, è necessario avvolgere tutte le stringhe destinate all’utente all’interno di una funzione di traduzione.

Hosting condiviso InterServer

Hosting condiviso $2,50 USD al mese, primo mese $0,1 USD codice promozionale tryinterserver, 461 script di applicazioni cloud, installazione con un clic.

pagina di accesso

Ad esempio, quando si visualizza la pagina delle impostazioni di rendering, si dovrebbero sostituire le stringhe hardcodate con valori dinamici.

<h1><?php esc_html_e( 'My First Plugin 设置', 'my-first-plugin' ); ?></h1>

在 append_custom_content Quando si ottiene il testo predefinito all’interno di un metodo:

$custom_text = get_option( 'mfp_custom_text', __( '感谢阅读！欢迎关注。', 'my-first-plugin' ) );

Infine, è necessario utilizzare strumenti come Poedit per analizzare le funzioni di traduzione presenti nel codice e generare i file di traduzione necessari. .pot I file di template vengono utilizzati per creare contenuti in diverse lingue, in base alle esigenze specifiche. zh_CN.po 和 .mo）的翻译文件，放入 /languages Indice.

Test, packaging e pubblicazione

Prima di inviare i plugin agli utenti, un test approfondito e un’imballaggio professionale rappresentano gli ultimi passaggi essenziali.

Eseguire un test funzionale completo.

I test dovrebbero coprire i seguenti aspetti:
1. 功能测试：确保“追加文本”功能在单篇文章页面正常工作，设置页面能保存和读取值。
2. 兼容性测试：在不同的 WordPress 版本（尤其是上一个主要版本）、PHP 版本以及几款热门主题下测试插件。
3. 安全测试：检查所有用户输入（如设置选项）是否都经过了像 esc_html、sanitize_text_field Un tale processo di purificazione o escape garantisce che gli utenti non amministratori non possano accedere alle pagine di configurazione.
4. 性能检查：确保插件没有在每次页面加载时引入不必要的数据库查询或重型脚本。

Pronto per la pubblicazione su WordPress.org.

Se decidi di rilasciare il plugin gratuitamente nel catalogo ufficiale di plugin di WordPress, devi:
1. 在 WordPress.org 上申请一个 SVN 仓库。
2. 为你的插件创建一个专业的 readme.txt File: Questo file utilizza un formato specifico (simile a Markdown) per visualizzare descrizioni, istruzioni per l’installazione, screenshot, log di aggiornamento, ecc., sulla pagina del catalogo dei plugin. Rappresenta un elemento fondamentale per la promozione dei plugin.
3. 确保代码符合 WordPress 编码标准。你可以使用 PHP_CodeSniffer 与 WordPress 标准规则来自动检查。
4. 使用 SVN 客户端将你的插件文件夹（包含所有文件）提交到仓库的 /trunk Indice. Etichetta (tag) il codice della versione stabile. /tags/1.0.0 Indice.

Prepararsi per la pubblicazione commerciale.

Se hai in programma di effettuare vendite commerciali (ad esempio attraverso il tuo sito web o piattaforme di mercato come CodeCanyon):
1. 添加许可证管理：实现一个系统来验证用户的购买凭证，可能通过 API 连接到你的销售平台。
2. 构建升级机制：为插件加入更新检查功能，当你在自己的服务器发布新版本时，能向已安装的用户推送更新通知。这通常通过向 WordPress 的更新系统注入自定义数据来实现。
3. 完善文档：编写清晰的使用文档、FAQ 和故障排除指南。
4. 选择支付和分发方案：集成 Stripe、PayPal 等支付网关，或使用 Easy Digital Downloads、WooCommerce 等成熟的电商插件来搭建你自己的销售门户。

Riassumendo

Lo sviluppo di plugin per WordPress rappresenta un processo sistematico che va dalla generazione di idee alla loro realizzazione finale, fino alla loro commercializzazione. Inizia con la definizione di requisiti chiari e l’utilizzo di un ambiente di sviluppo standard; l’elemento fondamentale è il rispetto delle specifiche di codifica di WordPress, l’impiego della sua ricca API basata sui “hook” (meccanismi di interazione tra moduli), nonché la rigorosa attenzione ai principi di sicurezza e internazionalizzazione. Organizzare il codice in modo oggettivo permette di creare plugin facilmente mantenibili. Le fasi finali di test, packaging e pubblicazione costituiscono il collegamento tra lo sviluppatore e gli utenti di tutto il mondo; sia che si scelga di condividere il plugin in modo open-source sia di venderlo commercialmente, una presentazione professionale è di fondamentale importanza. Seguendo i passaggi indicati in questa guida, sarai in grado di creare plugin per WordPress con una struttura chiara, sicuri e affidabili, in linea con gli standard di pubblicazione, compiendo così un passo importante verso la generazione di entrate attraverso la tecnologia.

FAQ - Domande frequenti

È necessario utilizzare la programmazione orientata agli oggetti per sviluppare plugin per WordPress?

Non è obbligatorio, ma è fortemente consigliato. L’utilizzo della programmazione orientata agli oggetti (OOP) e delle classi per organizzare il codice permette di incapsulare le funzionalità del tuo plugin all’interno di spazi di nome (namespace) indipendenti, riducendo notevolmente il rischio di conflitti con i nomi delle funzioni del tema o di altri plugin. Inoltre, rende la struttura del codice più chiara e facilita la manutenzione e l’espansione dello stesso.

Nelle note presenti nella parte iniziale del plugin, cosa significano `Text Domain` e `Domain Path`?

Text DomainIl campo “(Text field)” contiene un identificatore unico che indica a WordPress quale “pacchetto di file di traduzione” utilizza il tuo plugin. Di solito, questo identificatore coincide con il nome della cartella del plugin o con il nome del file principale del plugin stesso.Domain Path Si definisce quindi il percorso relativo al directory radice del plugin; WordPress cercherà nella directory indicata il file corrispondente alla lingua richiesta. .mo Traduci il file. Ad esempio:Domain Path: /languages Ciò significa che il file di traduzione è memorizzato all’interno del plugin. /languages All’interno della cartella.

Come posso assicurarmi che il mio plugin non rallenti la velocità del sito web dell’utente?

Ottimizzare le prestazioni dei plugin è fondamentale. Evitare di eseguire query complesse al database ad ogni caricamento della pagina e, dove possibile, utilizzare l’API Transients per memorizzare in cache i dati che possono essere conservati. Per i file JavaScript e CSS del lato client, caricarli soltanto nelle pagine in cui sono effettivamente necessari, basandosi su condizioni specifiche (ad esempio…). is_admin() 或 is_single()Vengono caricati utilizzando… wp_enqueue_script() 和 wp_enqueue_style() Le funzioni vengono introdotte con le corrette dipendenze e i numeri di versione appropriati. Vengono effettuate revisioni del codice periodicamente al fine di eliminare operazioni ridondanti.

Dovrei pubblicare il plugin su WordPress.org o venderlo direttamente?

Tutto dipende dai tuoi obiettivi. Pubblicare il tuo plugin su WordPress.org è gratuito: ti permette di raggiungere un vasto numero di utenti, di costruire una reputazione e di generare entrate tramite donazioni o inviando gli utenti ai tuoi servizi a pagamento. Tuttavia, in questo caso i plugin devono seguire la licenza GPL e sottoporsi a determinati requisiti di revisione. Vendere il tuo plugin con una licenza commerciale ti offre il controllo totale sui prezzi, sulle strategie di marketing e sui canali di supporto; inoltre, puoi sviluppare plugin più complessi e funzionali, ma devi gestire personalmente gli aspetti legati ai pagamenti, alla verifica delle licenze, alle notifiche di aggiornamento e al supporto ai clienti.

Come gestire in modo sicuro i cambiamenti nella struttura del database quando gli utenti aggiornano i plugin?

Questo è un problema comune, ma di natura complessa. Quando una nuova versione del tuo plugin richiede modifiche al database (ad esempio, la creazione di nuove tabelle o l’aggiunta di campi), è assolutamente vietato eseguire tali operazioni ogni volta che la pagina viene caricata. CREATE TABLE La migliore pratica consiste nel memorizzare il numero di versione del database come una configurazione opzionale di WordPress (ad esempio, tramite un valore configurabile nell’interfaccia di amministrazione di WordPress). <code>yourplugin_db_version</code>Durante l’inizializzazione del plugin, viene verificato se la versione del database corrente del codice è coerente con quella memorizzata. In caso di discrepanza, viene chiamata una funzione dedicata all’aggiornamento per eseguire le modifiche SQL necessarie, dopodiché viene aggiornato il numero di versione memorizzato. Questo garantisce che l’operazione di aggiornamento venga eseguita una sola volta.