Spintax

Generazione di contenuti per WordPress — marcatura spintax legata ai campi ACF, ai post-meta e alle descrizioni prodotto WooCommerce.

Disponibile su: WordPress.org GitHub
Sito del progetto →

Spintax è una cassetta degli attrezzi per la generazione di contenuti in WordPress: un solo modello diventa testo unico e non duplicato su tutto il sito. Scrivete modelli riutilizzabili in marcatura spintax e inseriteli tramite shortcode e PHP — oppure legateli ai campi ACF, ai post-meta e ai campi prodotto di WooCommerce, così ogni contenuto corrispondente riceve la propria variante renderizzata al salvataggio, su pianificazione o a richiesta.

Marcatura

  • Enumerazioni{a|b|c} sceglie a caso un'opzione, anche annidata
  • Permutazioni[<config>a|b|c] prende N elementi, li mescola e li unisce con separatori a vostra scelta
  • Variabili%var% in ambito globale, di shortcode e locale: #set riestrae a ogni uso, #def estrae una volta per render
  • Condizioni{?VAR?then|else} si dirama in base al valore di una variabile, {?!VAR?then} inverte il controllo
  • Accordo del plurale{plural N: one|few|many} sceglie la forma grammaticale giusta in base al numero (RU/UK/BE e SR/HR/BS a tre forme, tipo inglese a due)
  • Modelli annidati — un modello dentro un altro con #include o [spintax]
  • Commenti di blocco/#…#/ non arriva mai nell'output

Collegamenti ad ACF e post-meta

Un collegamento unisce un modello a un solo campo di destinazione di un tipo di contenuto — per esempio «Articoli → ACF: hero_subtitle» — e il plugin riempie quel campo in ogni contenuto corrispondente. Le modifiche manuali sono conservate per impostazione predefinita e tracciate tramite hash; alcune opzioni decidono se il collegamento riempia solo i campi vuoti, rigeneri a ogni salvataggio o svuoti il campo quando il modello non produce nulla.

  • Bulk Apply — passaggi asincroni a blocchi tramite Action Scheduler, con un «Run now» sincrono e WP-CLI come ripiego se non è installato
  • Registri — il resoconto, passaggio per passaggio, di ciò che è stato scritto, saltato o svuotato
  • WP-CLIwp spintax bindings list|apply|test|export|import per portare lo staging in produzione
  • Migrazione — una procedura guidata una tantum per chi arriva da nested-spintax-for-acf

WooCommerce

Nella pagina di un singolo prodotto il plugin riconosce il prodotto corrente e lo espone al modello come %product_name%, %product_sku%, %product_type%, %product_categories%, %product_tags% e un %product_attribute_<slug>% per ogni attributo — così lo stesso modello su due prodotti produce due varianti messe in cache separatamente. Il prezzo resta fuori di proposito: è un dato commerciale volatile e, inserito in un modello, invaliderebbe la cache di render a ogni variazione.

Un collegamento a un campo prodotto va oltre e scrive il testo generato nella descrizione o nella descrizione breve del prodotto, con la stessa meccanica dei collegamenti ACF: pianificazione, Bulk Apply, WP-CLI, registri. Tre limiti sono voluti: solo quei due campi sono scrivibili, le modifiche manuali vincono per impostazione predefinita e ogni scrittura passa da WooCommerce stessa, così le sue cache, le tabelle di ricerca e gli hook di salvataggio restano coerenti. WooCommerce è sempre facoltativa: senza di essa le variabili semplicemente non compaiono e i collegamenti ai prodotti smettono di scrivere.

Cache e riservatezza

L'output renderizzato viene messo in cache tramite la WP Object Cache API (pronta per Redis / Memcached), con rigenerazione pianificata facoltativa per ciascun modello. Tutto gira sul vostro server — nessun servizio esterno, nessun tracciamento, nessun dato che lasci il sito.

Una sintassi, cinque motori

La sintassi è uno standard aperto e documentato. Il suo nucleo è compatibile con GTW — enumerazioni, permutazioni, variabili, inclusioni — e negli anni si è ampliato con primitive proprie: condizioni guidate dal valore, accordo del plurale, variabili #def estratte una sola volta. Cinque motori indipendenti la implementano su un unico corpus di test condiviso, e il riferimento completo si trova su spintax.net. Per scrivere fuori dall'amministrazione di WordPress c'è Spintax Studio, un editor Windows nativo e gratuito con anteprima dal vivo a due pannelli e validazione integrata.