GMC Builder — Documentazione (WordPress)
GMC Builder for WordPress costruisce landing page, sezioni hero e layout completi attraverso tre superfici di authoring: un editor visuale drag-and-drop, un editor JSON raw con validazione e l'authoring assistito da AI tramite il server GMC Builder MCP incluso. Tutte e tre scrivono lo stesso formato di layout portabile, che il plugin renderizza lato server in PHP — nessun servizio di page-builder esterno è coinvolto. Requisiti: WordPress in una release supportata e PHP 8.1 o superiore.
Installazione
- Nell'amministrazione di WordPress, vai su Plugin → Aggiungi nuovo → Carica plugin.
- Carica lo zip
wp-gmc-builderricevuto con l'acquisto (puoi riscaricare l'ultima build dal tuo account in qualsiasi momento). - Clicca Installa ora, poi Attiva.
L'editor visuale è incluso nel plugin, quindi non serve alcuna installazione aggiuntiva per iniziare a costruire.
Configurazione
- Download Key. Dopo l'acquisto ricevi una Download Key insieme all'email di licenza. Inseriscila nella schermata delle impostazioni del plugin — il campo compare dopo l'attivazione. La chiave sblocca gli aggiornamenti con licenza in un clic dal server di aggiornamento; lasciala inserita in modo che gli aggiornamenti continuino ad arrivare finché il tuo abbonamento è attivo.
- Blocchi dinamici di catalogo. I blocchi Tours, social-gallery e lead-form attingono i dati dal prodotto GMC corrispondente (Tours, gallery o Lead Capture). Quel prodotto serve installato solo se usi effettivamente il blocco; se la fonte dati manca, il blocco degrada in modo controllato invece di rompere la pagina.
- Temi. L'aspetto dei layout è governato da temi basati su design token, ed è incluso un helper di migrazione da YOOtheme per i layout provenienti da quel builder.
Uso del plugin
L'editor visuale
L'editor drag-and-drop offre anteprime responsive per desktop, tablet e mobile. Componi le pagine da quindici elementi sicuri che coprono struttura, testo, media, schema FAQ e mappe degli alloggi, oltre ai blocchi nativi del catalogo Tours, gallery e lead-form. Tutto ciò che salvi passa attraverso uno schema rigoroso lato server che normalizza il layout e rimuove il markup non supportato. Il plugin aggiunge inoltre contesto SEO automatico e output Schema.org, ed esegue un audit di accessibilità integrato sul tuo lavoro.
Modifica come JSON raw
Ogni layout è memorizzato come JSON portabile, e puoi modificare quel JSON direttamente. L'editor raw scrive esattamente lo stesso formato validato dell'editor visuale, quindi puoi passare liberamente dall'uno all'altro. Poiché i layout sono semplice JSON, possono essere esportati, versionati e ripristinati senza dipendere da un servizio di builder in hosting — utile per i backup e per spostare i layout tra siti.
Authoring assistito da AI (MCP)
Il plugin include il server GMC Builder MCP, che permette a un assistente AI di creare i layout per te. I layout generati dall'AI passano attraverso la stessa validazione lato server e vengono salvati nello stesso formato portabile, quindi il risultato è intercambiabile con qualsiasi cosa costruita visualmente o a mano.
Pubblicare un layout
Per pubblicare un layout salvato, inserisci lo shortcode [gmc_builder id="my-layout"] in un articolo, una pagina o un blocco Shortcode. Il rendering avviene lato server in PHP e non dipende da alcun servizio esterno.
Aggiornamenti e licenza
Gli aggiornamenti sono automatici. Il plugin controlla da solo il server di aggiornamento GMC / FuerteventuraTV (circa ogni 12 ore) e mostra le nuove versioni in Plugin o in Bacheca → Aggiornamenti, finché il tuo abbonamento è attivo. La Download Key inserita nelle impostazioni del plugin è ciò che autorizza questi aggiornamenti con licenza in un clic.
Il software è rilasciato sotto licenza GNU GPL. La licenza annuale ti dà la build ufficiale, gli aggiornamenti con licenza in un clic e il supporto per un sito. Se lasci scadere la licenza, tutto ciò che hai costruito continua a essere renderizzato — i layout esistenti restano sul tuo sito e continuano a funzionare; smetti solo di ricevere aggiornamenti e supporto. Per l'uso su più siti o in progetti per clienti, contattaci per un accordo volume o agenzia.
Supporto
Per assistenza, rispondi all'email di acquisto o scrivici su WhatsApp al +34 633 168 995 — lo stesso numero compare nella tua email di licenza. Includi nome e versione del prodotto, le tue versioni di WordPress e PHP, e un URL pubblico o uno screenshot (con eventuali chiavi oscurate). Rispondiamo in inglese, italiano e spagnolo.
Se il prodotto non funziona come descritto e non riusciamo a risolvere il problema, puoi richiedere un rimborso entro 14 giorni dall'acquisto.
Tutto incluso
87 funzionalità reali, raggruppate per area: questa è la vera profondità di GMC Builder, non una vetrina di punti forti.
Tre modi per costruire (un solo formato di layout)
- Editor visuale drag-and-drop — componi le pagine trascinando i blocchi su una tela live, senza scrivere una riga di codice.
- Editor JSON grezzo con validazione — incolla o scrivi a mano un layout: viene validato al salvataggio con anteprima live; utenti esperti e controllo di versione restano cittadini di prima classe.
- Authoring AI / MCP — lascia che Claude, Codex o qualsiasi assistente compatibile MCP costruisca, validi, renderizzi e salvi interi layout al posto tuo.
- Ogni interfaccia scrive lo stesso layout portabile — passa liberamente da visuale a JSON ad AI: non divergono mai, perché tutti e tre passano da un unico schema.
- Sicuro garantito su ogni percorso — ogni layout (costruito a mano, importato o generato dall'AI) è soggetto allo stesso contratto di validazione ed escaping lato server, così un input errato o ostile può solo essere rifiutato o reso inerte, mai rompere la pagina.
Generazione pagine con AI (BYOK)
- Dal prompt alla pagina — descrivi la pagina in linguaggio naturale ("landing per una scuola di surf con hero, 3 vantaggi, una FAQ e una CTA") e ricevi un layout completo e valido.
- Output sempre valido garantito — la risposta del modello viene sempre passata attraverso lo schema, con retry-and-repair automatico (rimanda al modello gli errori esatti di validazione) prima che qualsiasi cosa venga restituita o salvata.
- Usa la tua chiave (BYOK) — funziona con qualsiasi provider compatibile OpenAI: OpenAI, NVIDIA NIM, Groq, o un gateway locale/self-hosted (vLLM/Ollama). Scegliendo il provider si imposta automaticamente l'endpoint corretto.
- Funziona subito senza chiave — un generatore offline deterministico integrato produce un layout plausibile (hero, vantaggi, tour, galleria, FAQ, CTA, form contatti, mappa alloggi) con testi reali quando non è configurata nessuna chiave API.
- La tua chiave non lascia mai il server — la chiave del provider è memorizzata solo lato server, usata unicamente per chiamare il provider, mai inviata al browser e oscurata in qualsiasi messaggio di errore.
- Raggiungibile ovunque — lo stesso generatore alimenta il pulsante "Genera con AI" dell'editor, lo strumento MCP
generate_layoute il generatore da CLI.
Esperienza dell'editor visuale
- Interfaccia completa del builder — palette di blocchi, tela live, pannello Impostazioni/tratti, pannello Stile mappato ai design token del tema e albero Livelli/struttura.
- Anteprime responsive per dispositivo — passa tra desktop, tablet e mobile per vedere esattamente come si riadatta la pagina.
- Annulla / ripeti e sicurezza sulle modifiche non salvate — annulla/ripeti dedicati, indicatore di modifiche pendenti sul Salva e un avviso prima di uscire con lavoro non salvato.
- Anteprima dal server — un'anteprima con un click renderizza l'HTML autorevole attraverso il motore reale, così ciò che vedi è esattamente ciò che ottengono i visitatori (il browser non simula mai il render).
- Selettore media, non base64 — inserisci immagini dalla libreria media nativa (WordPress wp.media / Joomla com_media) invece di incollare URL o incorporare pesanti blob base64.
- Genera-con-AI e controllo di accessibilità integrati nella barra strumenti — abbozza con l'AI ed esegui un audit di accessibilità senza lasciare la tela.
- Utilizzabile da telefono — sui piccoli viewport dell'admin la barra strumenti va a capo e i pannelli si impilano, così il Salva resta raggiungibile e la tela continua a funzionare.
- Interfaccia completamente traducibile — ogni etichetta dell'editor (salva, annulla, ripeti, anteprime, AI, accessibilità, media) è localizzabile.
Libreria di elementi (16 blocchi sicuri)
- Section — banda a larghezza piena con padding verticale, stile di sfondo (nessuno/muted/chiaro/primario/scuro) e larghezza del contenuto interno (stretta/predefinita/ampia/piena).
- Row + Column — una griglia responsive a 12 colonne; imposta l'ampiezza di ciascuna colonna (1–12), l'allineamento verticale e l'allineamento del testo; su mobile le colonne si impilano automaticamente.
- Heading — scegli il livello HTML (h1–h6) indipendentemente dalla dimensione visiva, con preset di allineamento e colore.
- Text — testo formattato con una allow-list sicura di formattazione inline (grassetto, link, elenchi, citazioni…), dimensione e allineamento.
- Image — sorgente, testo alternativo, dimensioni, link opzionale, allineamento e raggio degli angoli; caricamento lazy con proporzioni riservate per evitare lo spostamento del layout.
- Button — etichetta, URL, stili primario/secondario/outline/link, dimensione, opzione a larghezza piena e allineamento; i link esterni ricevono automaticamente
rel="noopener noreferrer". - Spacer & Divider — spaziatura verticale precisa e righe orizzontali stilizzate.
- HTML / Embed — inserisci markup personalizzato, sanificato su un'ampia allow-list (script, style, iframe e gestori di eventi vengono rimossi).
- FAQ — un accordion accessibile (details/summary nativi) che genera anche il markup schema.org FAQPage per i rich-results a partire dai tuoi contenuti sottoposti a escaping.
- Mappa Stay22 — una mappa alloggi incorporabile per le pagine turistiche; l'host dell'embed è fisso e vengono usati solo il tuo id affiliato e l'indirizzo, sanificati e caricati in lazy.
- Elemento SEO — metadati invisibili a livello di pagina (tipo di pagina, nome, descrizione, breadcrumb, override dello schema) che alimentano l'output dei dati strutturati.
Contenuti dinamici nativi del catalogo
- Griglia Tours — una griglia live di card dei tuoi GMC Tours (colonne, limite di elementi, toggle per prezzo e riga meta, etichetta CTA personalizzata).
- Griglia galleria social — una griglia media live dal tuo feed Instagram o Facebook (colonne, limite, destinazione del link).
- Blocco form contatti — inserisci in qualsiasi layout un form GMC Lead Capture salvato tramite il suo slug.
- Fail-open per progettazione — se il prodotto GMC corrispondente (Tours, galleria, Lead Capture) non è installato, il blocco degrada a un innocuo commento HTML invece di rompere la pagina.
- Niente shortcode da incollare — questi sono blocchi di prima classe collegati al tuo catalogo, non embed di terze parti incollati a mano.
SEO & dati strutturati
- schema.org JSON-LD automatico — ogni pagina emette un unico blocco
@graphpulito che combina WebPage (o Article/Product/Event), BreadcrumbList, Organization e FAQPage, generato dai tuoi contenuti, senza markup manuale. - Un solo blocco, nessun duplicato — ogni FAQ della pagina confluisce nell'unico graph a livello di pagina, così non spedisci mai nodi FAQPage duplicati.
- Controllo per pagina — l'elemento SEO ti permette di impostare tipo di pagina, nome, descrizione e un percorso di breadcrumb, e di forzare lo schema on/off per quella pagina.
- In armonia con Yoast / Rank Math — un interruttore globale disattiva i dati strutturati di GMC Builder così i siti che già emettono schema non producono duplicati.
- Best-effort di default — anche senza elemento SEO, un sensato nodo WebPage viene derivato dal primo heading e dal primo blocco di testo.
- Output sicuro — il JSON-LD è sottoposto a escaping esadecimale così i dati strutturati non possono mai uscire dal loro tag script.
Accessibilità
- Audit WCAG integrato — controlla un layout per i problemi di accessibilità più comuni mentre costruisci, cosa che i tipici page builder non offrono.
- Segnalazioni concrete e a basso rumore — evidenzia testo alternativo mancante nelle immagini, immagini con link senza nome, livelli di heading saltati, h1 mancante o multiplo, etichette dei controlli vuote, voci FAQ vuote o incomplete, contrasto colore sospetto e lingua della pagina mancante.
- In sola lettura e sicuro — l'audit legge il layout e riporta errori/avvisi; non modifica mai i tuoi contenuti né renderizza nulla.
- Raggiungibile ovunque — eseguilo dal pulsante di controllo accessibilità dell'editor, dallo strumento MCP
audit_layouto dall'auditor da CLI.
Temi & kit
- Temi basati su design token — colori, tipografia, spaziature, padding, gap, raggio e larghezza del contenitore vivono come semplici token compilati in variabili CSS; ristile un intero sito scambiando i token.
- Override del tema a livello di sito — applica una mappa di token JSON globalmente senza toccare i singoli layout.
- Kit portabili — esporta i token del tema più tutti i layout come un unico kit JSON e importalo in un'altra installazione per avviare un nuovo sito.
- Import/export del kit con un click — dall'admin (con un toggle "applica tema"), più endpoint REST/authoring; gli import sono limitati per dimensione e tipo e non possono sovrascrivere layout non correlati.
- Kit Surf Camp pronto per il turismo — una pagina completa a tema (hero, vantaggi, griglia tour, galleria, FAQ con schema, mappa Stay22) su un tema colore intercambiabile, pronta da importare.
Migrazione da YOOtheme Pro
- Importatore unidirezionale — converti un layout YOOtheme Pro esistente in un layout GMC Builder invece di ricostruire pagina per pagina.
- Mappatura sicura — sezioni, griglie, heading, testo, immagini e pulsanti vengono convertiti; tutto ciò che non è supportato viene saltato anziché riversato come HTML grezzo, così non passa nulla di non sicuro.
- Disponibile headless — esegui l'importatore da CLI per conversioni in batch.
Motore di render, prestazioni & affidabilità
- Un solo motore senza framework, output identico — lo stesso renderer PHP gira su Joomla e WordPress, così un layout appare uguale su entrambi; nessun UIkit o framework di tema richiesto.
- Render 100% lato server — l'HTML autorevole è sempre prodotto in PHP; il browser non reimplementa mai il renderer.
- Blindato contro XSS/clickjacking — tutto viene sottoposto a escaping, HTML/testo formattato passano per allow-list rigorose, URL e stili inline vengono sanificati e il posizionamento che abilita il clickjacking viene rimosso.
- Schema auto-riparante — i layout vengono normalizzati al salvataggio e al render: default riempiti, valori limitati, nodi illegali rimossi, così le pagine memorizzate sono sempre sicure da renderizzare.
- Cronologia versioni & annulla — ogni salvataggio crea uno snapshot della versione precedente (fino a 20 conservate); elenca e ripristina versioni anteriori, e i ripristini sono a loro volta annullabili.
- Editing concorrente sicuro — i controlli di concorrenza ottimistica rifiutano una sovrascrittura obsoleta (HTTP 409) invece di calpestare silenziosamente la modifica di qualcun altro.
- Duplica & elimina layout — copia un layout in uno slug fresco a prova di collisione, oppure rimuovi un layout e la sua cronologia.
- Front-end veloce — riuso di renderer/schema per richiesta, un transient di HTML renderizzato in cache (WordPress) legato alla versione del layout e al tema, immagini caricate in lazy e proporzioni riservate (nessuno spostamento del layout).
- CSS responsive e attento al movimento — griglia mobile-first, tabelle/parole lunghe a prova di overflow e rispetto di
prefers-reduced-motion.
Pubblicazione & shortcode
- Shortcode Joomla — inserisci
{gmcbuilder id=my-layout}in qualsiasi articolo, categoria o modulo personalizzato. - Shortcode WordPress — usa
[gmc_builder id="my-layout"]ovunque funzionino gli shortcode. - Blocco Gutenberg per WordPress — un blocco dinamico "GMC Layout" per l'editor a blocchi (lo shortcode resta comunque supportato).
- Risoluzione flessibile dell'id — i layout si risolvono per slug (option/meta), id numerico del post (post meta) o come fallback un file JSON nella cartella uploads.
- Il foglio di stile si carica da solo — il CSS di base viene emesso automaticamente ogni volta che un layout viene renderizzato; niente da accodare a mano.
Sviluppatore, API & automazione
- Server MCP integrato — un server Model Context Protocol autonomo (solo libreria standard Python, nessuna dipendenza) che espone
list_elements,validate_layout,render_layout,get_layout,set_layout,generate_layouteaudit_layout. - Due modalità MCP — la modalità LOCAL pilota le CLI di base senza installazione CMS (crei una pagina e vedi l'HTML renderizzato offline); la modalità REST legge/scrive i layout reali su un sito Joomla o WordPress live con dati dinamici in tempo reale.
- API REST di authoring — leggi il contratto degli elementi, ottieni/salva/elimina layout, elenca/ripristina snapshot, renderizza bozze inline ed esporta/importa kit (WordPress
gmc-builder/v1/*; Joomla tramite il corecom_ajax). - Toolkit da CLI — descrivi elementi, valida, renderizza, genera con AI (con una modalità offline
--mock), esegui audit di accessibilità, importa da YOOtheme e costruisci/applica kit — tutto scriptabile e headless. - API di estensione stabile — aggiungi o sostituisci fonti di dati dinamici, post-elabora l'HTML finale renderizzato e renderizza i tuoi tipi di elemento personalizzati (filtri WordPress / eventi Joomla); il markup degli elementi personalizzati viene ri-sanificato attraverso la stessa allow-list.
- Layout portabili e git-friendly — i layout sono semplice JSON che puoi esportare, confrontare, versionare e ripristinare senza alcun servizio di builder ospitato.
Sicurezza & privacy
- Protetto da admin ovunque — l'authoring richiede una vera capacità di amministratore (Joomla
core.manage/core.admin, WordPressmanage_options) più protezione CSRF/nonce su ogni cambiamento di stato. - I segreti non trapelano mai al browser — le chiavi licenza/AI memorizzate non vengono mai restituite al DOM; un invio vuoto preserva la chiave, un controllo esplicito la rimuove e i campi usano
autocomplete="new-password". - A prova di path-traversal — lo store dei file è confinato alla root del sito; percorsi assoluti, segmenti con punti e fughe tramite symlink vengono rifiutati.
- Niente collegamenti esterni per renderizzare — le pagine vengono renderizzate interamente sul tuo server, senza dipendenza da un page builder esterno.
Fiducia & licenza
- GPLv2 o successiva, posseduto non affittato — il software resta tuo; una licenza scaduta non svuota mai le tue pagine live, non disabilita l'editor e non ferma il rendering. La licenza copre aggiornamenti e supporto.
- Self-hosted, dati portabili — i layout sono JSON sul tuo sito; i temi sono semplici file di token; nulla dipende da un servizio ospitato per mostrare una pagina.
- Aggiornamenti con un click su licenza — inserisci la tua Download Key (dall'email di licenza) e l'estensione controlla da sola il server di aggiornamento GMC / FuerteventuraTV e propone le nuove versioni nella normale schermata di aggiornamento del CMS finché il tuo abbonamento è attivo.
- Editor visuale incluso, nessun CDN esterno richiesto — GrapesJS (MIT) viene fornito localmente in bundle con un CDN fissato e verificato per integrità solo come fallback; le licenze di terze parti (GrapesJS, CodeMirror, Spectrum) sono incluse.
- Licenza per un sito, adatta alle agenzie — 49 €/anno per sito coprono la build ufficiale, gli aggiornamenti e il supporto per un sito; accordi multi-sito/agenzia su richiesta.
- Supporto onesto & rimborso — supporto in inglese, italiano e spagnolo; rimborso entro 14 giorni se non funziona come descritto.
Joomla & WordPress
- Piena parità Joomla ↔ WordPress, rilasciata in lockstep — gli stessi 16 elementi, lo stesso schema, gli stessi byte dell'editor visuale e un output renderizzato identico byte per byte su entrambi i CMS; le due build avanzano versione per versione insieme.
- Compatibilità — Joomla 5.x e 6.x (richiede 5.0+, testato fino a 6.9) e WordPress 6.0+ (testato fino a 6.8); PHP 8.1 o superiore su entrambi.
- Specifiche Joomla — pubblica tramite uno shortcode di plugin di contenuto, usa il selettore nativo com_media ed espone l'authoring tramite il core
com_ajax; l'editor visuale e le impostazioni vivono nel componente admincom_gmcbuilder(opzioni SEO/AI/tema come parametri del plugin). - Specifiche WordPress — aggiunge un menu admin di primo livello "GMC Builder" con un elenco dei layout e una schermata Licenza & AI, un blocco Gutenberg "GMC Layout", il selettore immagini wp.media, una cache transient di HTML renderizzato e autenticazione REST via nonce o Application Password.
