Modelli personalizzati per sviluppatori e agenzie

In «Domini e modelli», proprietari e admin possono creare modelli propri da Creator Pro. Sono una cornice HTML per sviluppatori e agenzie che vogliono riutilizzare lo stesso layout su molte pagine. Per progettare una pagina non ti servono.

#Piano e permessi

Proprietari e admin possono creare, modificare ed eliminare modelli. Con Creator Free il pulsante «+ Modello» è bloccato e compare «I modelli del workspace sono disponibili a partire da Creator Pro.»

#Creare un modello

1. Apri «Domini e modelli»
2. Clicca «+ Modello»
3. Compila i campi e clicca «Crea»

«Chiave (a-zA-Z0-9_-)»

2–64 caratteri composti da lettere, cifre, _ e -. La chiave è unica all’interno del workspace e non si può cambiare in seguito.

«Nome»

Obbligatorio, fino a 120 caratteri, per esempio «Lancio del prodotto».

«Parti da»

Solo alla creazione: «Modello vuoto» o una copia di un modello integrato. Una copia riprende struttura, segnaposto e aspetto dell’originale ed è il modo più rapido per iniziare.

«Stato»

Solo in modifica: «Attivo» o «Disattivato».

«Contenuto HTML»

La cornice HTML, obbligatoria. Fino a 60.000 byte; le lettere accentate e altri caratteri speciali occupano più di un byte. Se l’HTML è più grande, LinkHarbor si rifiuta di salvarlo.

«Schema (JSON)» e «Valori predefiniti (JSON)»

Descrivono i valori regolabili del modello e i loro valori predefiniti. Entrambi devono essere JSON valido, e i valori predefiniti devono corrispondere allo schema. Ciascuno dei due può essere al massimo di 64 KB, un singolo testo al suo interno al massimo di 5.000 caratteri.

#Regole per l’HTML

L’HTML deve contenere un segnaposto nel punto in cui compare il contenuto della pagina.

Per motivi di sicurezza, LinkHarbor ripulisce l’HTML quando salvi:

• Sono ammessi i comuni elementi di testo e layout come div, section, header, p, a, img o table. script, iframe e noscript vengono rimossi insieme al loro contenuto, altri elementi come form, svg, link o meta senza il loro contenuto
• Gli attributi di evento come onclick e i link con javascript: vengono eliminati
• Un blocco style viene mantenuto, ma come il CSS personalizzato non può caricare nulla da altri server
• Le classi CSS vengono mantenute se iniziano con lh-, compaiono nei modelli integrati o sono definite nel blocco style del modello, per esempio con .hero { … }; le altre classi vengono rimosse. ID e attributi data- e aria- vengono mantenuti
• Gli stili inline sono ammessi, ma le dichiarazioni con url() verso altri server, @import o position: fixed vengono rimosse
• I segnaposto nel blocco style o in style="" inseriscono solo valori CSS validi, come colori tipo #1a2b3c, dimensioni tipo 24px o numeri tipo 0.5. Un valore con ; { } virgolette o url() resta vuoto. I campi il cui valore predefinito è un colore, una dimensione o un numero accettano solo valori di quel tipo quando la pagina viene salvata
• Le immagini sono possibili solo dalle tue risorse LinkHarbor o tramite segnaposto come {{avatar_url}}

Due errori bloccano il salvataggio: «Il CSS del modello non può caricare nulla da altri server …» se il blocco style contiene indirizzi esterni, e «Una sezione nell’HTML del modello … non è consentita o non è chiusa correttamente.» se un {{#if}}, {{#unless}} o {{#each}} non termina nello stesso testo, tag o attributo in cui inizia, oppure si trova in style, href o src.

I modelli salvati prima del 1 novembre 2026 hanno perso stili e classi quando sono stati salvati allora. Se ti servono, ricreali da una copia nuova.

#Usare un modello per una pagina

I modelli del workspace attivi compaiono quando crei una pagina e nell’editor in «Tema» → «Modello» nel gruppo «Modelli personali», con sopra i 17 modelli integrati in «Modelli integrati». La descrizione dice «Modello del workspace, creato in “Domini e modelli”.» Scegliere e cambiare funziona come con i modelli integrati, vedi Scegliere e cambiare modello.

• Se modifichi il modello, l’anteprima della pagina mostra subito la modifica. Va online solo quando pubblichi di nuovo la pagina. Se più pagine usano il modello, pubblica di nuovo ciascuna di esse
• Quando pubblichi, LinkHarbor salva una copia del modello nella versione. La pagina online resta quindi invariata, anche se il modello viene modificato o disattivato in seguito
• Nell’API e per gli assistenti AI un modello del workspace si chiama «ws:» più la sua chiave, per esempio ws:product-launch
• Gli spazi immagine propri li definisci tramite l’API (asset_slots), fino a 32 per modello

#Modificare, disattivare ed eliminare

L’elenco mostra nome, chiave, stato e data con i pulsanti «Modifica» ed «Elimina».

Disattivare

In modifica imposta «Stato» su «Disattivato». Le pagine che usano già il modello lo mantengono. L’editor mostra allora per esempio «Attuale: Lancio del prodotto (disattivato)». Il modello non si può più selezionare; chi ci prova vede «Questo modello del workspace è disattivato. Attivalo in “Domini e modelli” per usarlo in una pagina.»

Eliminare

Un modello eliminato scompare definitivamente dall’elenco e non conta più nel limite; puoi riutilizzarne la chiave per un nuovo modello. Finché una pagina lo usa, l’eliminazione è bloccata: «Questo modello è ancora usato da {count} pagina/e. Passa prima quelle pagine a un altro modello.» Al posto di {count} compare il numero di pagine.

I modelli disattivati contano comunque nel limite del tuo piano. Se ti serve spazio, eliminali.

#Con un piano inferiore o superiore

Con Creator Free tutti i modelli del workspace attivi vengono disattivati; l’elenco mostra allora «Disattivato dal piano». Le pagine pubblicate restano invariate, comprese quelle che usano un modello personalizzato. Nell’editor compare allora «(disattivato)» accanto ad «Attuale:». Dopo un passaggio a un piano superiore tornano attivi esattamente questi modelli. I modelli che hai disattivato o eliminato tu restano così.