WP-CLI Generator: Plugin WordPress per Creare Articoli in Massa

Il Progetto WP-CLI Generator

• Progetto: WP-CLI Generator
• Tipologia: plugin WordPress sviluppato su commissione
• Obiettivo: generazione automatica di articoli in massa
• Ambiente di esecuzione: WP-CLI e terminale del server
• Dati di partenza: file di testo con località e descrizioni
• Contenuti generati: articoli WordPress pubblicati
• Personalizzazione: servizio, prodotto, marchio, categoria e immagini
• SEO: titolo, meta description e frase chiave Yoast
• Tecnologia principale: PHP
• Integrazione: funzioni native WordPress e WP-CLI

Il progetto nasce dall’esigenza di produrre numerosi articoli con una struttura comune, mantenendo però dati specifici per ogni zona e introducendo variazioni controllate nei testi.

Una procedura manuale avrebbe richiesto numerosi passaggi ripetitivi:

• creazione del nuovo articolo;
• scrittura del titolo;
• definizione dello slug;
• inserimento del contenuto;
• assegnazione della categoria;
• impostazione dell’immagine in evidenza;
• compilazione dei campi Yoast;
• pubblicazione;
• ripetizione dell’intero processo per ogni località.

WP-CLI Generator concentra tutte queste operazioni in un unico processo automatizzato.

Plugin WordPress Basato su WP-CLI

Il plugin non utilizza una pagina grafica nel backend per avviare la generazione. Al contrario, registra un comando personalizzato disponibile nell’ambiente WP-CLI.

WP-CLI permette di gestire WordPress direttamente dal terminale. Questa modalità risulta particolarmente adatta alle operazioni massive perché evita di dipendere dai normali caricamenti delle pagine del pannello amministrativo.

Quando il comando viene eseguito, il plugin:

• carica i dati configurati;
• verifica la presenza dei file necessari;
• legge le località;
• associa ogni località alla relativa descrizione;
• costruisce titolo e slug;
• genera il contenuto;
• crea l’articolo;
• assegna categoria e immagine;
• compila i metadati SEO;
• mostra nel terminale l’avanzamento dell’operazione.

Il comando viene registrato soltanto quando WordPress rileva l’esecuzione attraverso WP-CLI. Di conseguenza, la logica di generazione non viene caricata inutilmente durante la normale navigazione del sito.

Configurazione di Servizio, Prodotto e Marchio

All’inizio del plugin è presente un’area di configurazione dedicata ai dati comuni degli articoli da generare.

Prima dell’esecuzione è possibile definire:

• nome del servizio;
• tipologia di prodotto;
• marchio;
• URL dell’immagine principale;
• ID dell’immagine in evidenza;
• ID della categoria WordPress.

Questi valori vengono riutilizzati nella costruzione dei titoli, degli slug, dei testi, delle immagini e dei metadati.

Una configurazione può quindi produrre un gruppo di articoli dedicato a uno specifico servizio e marchio. Modificando i parametri, lo stesso sistema può essere adattato a una nuova serie di contenuti.

Questa impostazione centralizzata riduce il rischio di inserire dati differenti o incoerenti nei singoli articoli.

File con Località e Descrizioni

WP-CLI Generator utilizza due file di testo come sorgente dei dati variabili.

Il primo file contiene l’elenco delle località da utilizzare nei titoli e nei contenuti. Il secondo contiene invece una descrizione specifica associata a ciascuna zona.

La struttura può essere organizzata in questo modo:

Il plugin legge le righe dei due file e collega ogni località alla descrizione che occupa la stessa posizione.

Per esempio, la prima località viene associata alla prima descrizione, la seconda località alla seconda descrizione e così via.

Prima di iniziare la generazione, il sistema controlla che entrambi i file esistano. Se uno dei due non è disponibile, WP-CLI interrompe il comando e mostra un errore nel terminale.

Inoltre, il plugin verifica il numero delle righe. Quando il numero di località non coincide con quello delle descrizioni, mostra un avviso che permette di individuare il problema prima di completare l’intera elaborazione.

Costruzione Automatica di Titoli e Slug

Per ogni località, il plugin combina servizio, prodotto, marchio e nome della zona.

Da questi dati genera automaticamente:

• titolo WordPress;
• slug dell’articolo;
• frase chiave Yoast;
• intestazioni interne;
• testi alternativi delle immagini;
• riferimenti presenti nel contenuto.

La struttura del titolo segue un modello coerente:

Lo slug viene invece elaborato attraverso la funzione nativa sanitize_title().

WordPress può quindi trasformare automaticamente il titolo in un indirizzo compatibile con gli URL, rimuovendo spazi e caratteri non adatti.

Questa procedura mantiene uniforme l’intera serie di articoli e riduce gli errori che potrebbero verificarsi digitando manualmente decine di slug.

Introduzioni con Variazioni Controllate

Il plugin contiene più introduzioni predisposte per lo stesso gruppo di articoli.

Durante ogni iterazione, il sistema seleziona casualmente una delle versioni disponibili e sostituisce le variabili con servizio, prodotto, marchio e località del contenuto in fase di creazione.

Le introduzioni possono includere:

• presentazione del servizio;
• riferimento alla località;
• informazioni sul prodotto;
• richiami al marchio;
• descrizione degli interventi;
• collegamento alla pagina dei contatti.

Questa logica introduce differenze controllate tra le pagine, pur mantenendo una struttura editoriale coerente.

La variazione automatica non sostituisce il controllo qualitativo dei contenuti. Tuttavia, rappresenta una base utile per evitare che ogni articolo inizi esattamente con lo stesso paragrafo.

Meta Description Generate Automaticamente

Oltre alle introduzioni, il plugin contiene diverse meta description predisposte.

Per ogni articolo, il sistema seleziona una variante e sostituisce le variabili con i dati relativi alla pagina generata.

Le meta description includono quindi:

• servizio;
• prodotto;
• marchio;
• località;
• riferimenti sintetici alle attività offerte.

Dopo la creazione dell’articolo, il testo selezionato viene salvato nel campo meta description di Yoast SEO.

Questo permette di evitare la pubblicazione di articoli completamente privi di descrizione nei risultati di ricerca.

Intestazioni e Sezioni Variabili

WP-CLI Generator applica variazioni anche alle intestazioni delle sezioni interne.

Per diversi blocchi sono disponibili due titoli alternativi. Il sistema sceglie la versione da utilizzare durante la generazione.

Le sezioni possono riguardare, per esempio:

• diagnosi e manutenzione;
• servizi tecnici;
• interventi urgenti;
• manutenzione preventiva;
• consigli per l’efficienza;
• procedura operativa.

Inoltre, il plugin modifica l’ordine di alcuni blocchi prima di inserirli nell’articolo.

Il risultato mantiene gli stessi argomenti fondamentali, ma non presenta necessariamente tutte le sezioni nella medesima sequenza.

Contenuto HTML Completo

Per ogni località, il plugin costruisce un contenuto HTML già organizzato e pronto per la pubblicazione.

La pagina generata può comprendere:

• introduzione;
• contatti;
• immagine con didascalia;
• presentazione della località;
• descrizione specifica della zona;
• blocchi informativi;
• elenchi dei servizi;
• procedura operativa;
• link interni;
• intestazioni H2, H3 e H4.

Le variabili presenti nel modello vengono sostituite prima della creazione del post.

In questo modo, il contenuto finale contiene già il nome corretto della zona, del servizio, del prodotto e del marchio.

Creazione degli Articoli con le API WordPress

Dopo aver costruito titolo, slug e contenuto, WP-CLI Generator crea il nuovo articolo attraverso la funzione nativa wp_insert_post().

Per ogni elemento vengono definiti:

• titolo;
• slug;
• tipo di contenuto;
• stato di pubblicazione;
• contenuto HTML;
• categoria.

Gli articoli vengono creati direttamente con stato pubblicato. Questa impostazione permette di rendere disponibili immediatamente tutte le pagine prodotte dal comando.

Quando è necessario eseguire una revisione prima della pubblicazione, il parametro può essere adattato per generare bozze anziché contenuti già online.

Assegnazione Automatica della Categoria

Tutti gli articoli creati durante una specifica esecuzione vengono associati alla categoria configurata nel plugin.

Questa funzione permette di mantenere ordinati i contenuti e di collegare ogni gruppo di pagine al relativo archivio WordPress.

L’utilizzo di una categoria comune consente inoltre di:

• filtrare gli articoli dal backend;
• applicare template specifici;
• costruire archivi dedicati;
• eseguire successive modifiche massive;
• controllare rapidamente i contenuti generati;
• assegnare regole SEO o grafiche comuni.

Immagine in Evidenza e Testo Alternativo

Dopo la creazione del post, il plugin assegna automaticamente l’immagine in evidenza configurata.

L’operazione utilizza la funzione WordPress set_post_thumbnail().

Inoltre, il sistema aggiorna il testo alternativo dell’allegato utilizzando servizio, prodotto e marchio.

Ogni articolo del gruppo viene quindi pubblicato con:

• immagine inserita nel contenuto;
• immagine in evidenza;
• testo alternativo coerente;
• didascalia costruita con i dati della pagina.

Questa automazione evita di dover impostare manualmente la stessa immagine per tutti gli articoli generati.

Compilazione dei Campi Yoast SEO

WP-CLI Generator aggiorna anche i principali metadati gestiti da Yoast SEO.

Per ogni articolo vengono compilati:

• titolo SEO;
• meta description;
• frase chiave principale.

Il titolo SEO utilizza il titolo dell’articolo e può aggiungere ulteriori elementi comuni. La meta description viene selezionata tra le varianti disponibili, mentre la frase chiave coincide con il titolo generato.

Il plugin utilizza update_post_meta() per salvare i dati nei campi associati al post.

Di conseguenza, ogni nuovo articolo dispone fin dalla creazione delle impostazioni SEO fondamentali previste dal progetto.

Log di Avanzamento nel Terminale

Durante l’esecuzione, il plugin comunica l’avanzamento direttamente nel terminale.

Il sistema mostra:

• avvio del comando;
• numero delle zone individuate;
• eventuali file mancanti;
• eventuale differenza tra località e descrizioni;
• conferma della creazione di ogni articolo;
• eventuali errori;
• messaggio conclusivo.