Tutta la documentazione

Temi e aspetto

I 6 temi Éclair cambiano l’aspetto del tuo sito con un clic, con anteprima in tempo reale, senza toccare l’HTML né il posizionamento. Guida all’uso.

Aggiornato il 6 min di lettura

Indice
  1. Quali sono i 6 temi Éclair?
  2. Come cambiare tema?
  3. Cosa imposta ogni tema quando lo scegli?
  4. Quali altre impostazioni dell’aspetto puoi modificare?
  5. Perché un tema non rallenta il tuo sito?
  6. Come aggiungere il tuo CSS?
  7. Cosa non fanno i temi?
  8. Cosa fare se l’aspetto non cambia?
  9. Domande sui temi

I 6 temi Éclair cambiano l’aspetto del tuo sito con un clic: colore, font, intestazione e presentazione degli elenchi. Li provi sul tuo sito vero grazie all’anteprima in tempo reale, su computer o su smartphone, e non si pubblica nulla finché non salvi. I tuoi contenuti, la velocità e il posizionamento, invece, restano com’erano.

Lo stesso sito di una ceramista mostrato con i 6 temi di Éclair: Éclair, Editoriale, Atelier, Studio, Negozio e Contrasto
Un solo sito, sei stili: cambia solo il tema, il contenuto e l’HTML restano gli stessi.

Quali sono i 6 temi Éclair?

I temi Éclair sono inclusi nel CMS dalla versione 1.3.0. Ognuno ha il suo carattere e il suo pubblico:

TemaStilePer chi
ÉclairChiaro, moderno e versatile: il tema originaleTutti i siti
EditorialeStile rivista: caratteri con grazie, filetti sottili, capolettera, articolo in evidenzaBlog, media, autori
AtelierCaldo e artigianale: toni crema e terracotta, forme morbideArtigiani, ristoranti, benessere
StudioPortfolio minimalista: bianco e nero, titoli grandi, immagini al vivoFotografi, designer, agenzie
NegozioPensato per vendere: foto quadrate, intestazione fissa, pulsanti decisiNegozi, creativi
ContrastoMassima leggibilità: testo grande, contrasti forti, link sottolineatiServizi pubblici, associazioni, anziani

Tutti i temi mostrano gli stessi blocchi, il blog e il negozio leggero: scegli quello che somiglia al tuo mestiere, non quello che «contiene» una funzione.

Come cambiare tema?

Bastano cinque passaggi, anteprima compresa:

  1. Apri Impostazioni › Aspetto.
  2. In Tema, clicca sulla card che ti piace. Il suo colore, i suoi font, la sua intestazione e la presentazione degli elenchi si applicano subito ai campi qui sotto.
  3. Sotto Anteprima in tempo reale, scegli la pagina mostrata (Home, Blog, Un articolo, Il negozio o Un prodotto), poi passa da Computer a Smartphone. Puoi cliccare nell’anteprima: i link restano al suo interno.
  4. Regola quello che vuoi (colore principale, font, intestazione, elenchi, modalità scura): l’anteprima segue ogni modifica.
  5. Clicca su Salva. La cache delle pagine viene svuotata automaticamente: il tuo sito cambia subito.
Impostazioni › Aspetto di Éclair: le sei card dei temi, il tema Negozio selezionato e l’anteprima in tempo reale della home su computer
L’anteprima in tempo reale mostra il tuo sito vero con il tema scelto; non si pubblica nulla finché non salvi.

Cosa imposta ogni tema quando lo scegli?

Ecco le impostazioni consigliate che ogni tema applica, tutte modificabili in seguito:

TemaColore principaleFont (titoli / testo)IntestazioneElenchi
ÉclairViola #5b4cf0Sistema (moderno)Logo a sinistraGriglia di card
EditorialeRosso #b42318Serif elegante / Serif modernoCentratoGriglia di card
AtelierTerracotta #c2410cUmanistaLogo a sinistraGriglia di card
StudioNero #111111Neo-grottescoLogo a sinistraGriglia di card
NegozioVerde petrolio #0f766eGeometrico / Sistema (moderno)CentratoGriglia di card
ContrastoBlu #1d4ed8Sistema (moderno)Logo a sinistraElenco: immagine a sinistra

Quali altre impostazioni dell’aspetto puoi modificare?

Sempre in Impostazioni › Aspetto, sotto l’anteprima:

ImpostazioneCosa scegli
Intestazione«Logo a sinistra, menu a destra» oppure «Centrato: logo sopra il menu»
Elenchi di articoli e prodotti«Griglia di card» oppure «Elenco: immagine a sinistra»
LogoUn PNG o un WebP su sfondo trasparente, largo circa 400 px
Icona del sito (favicon)Un’immagine quadrata di almeno 512 px; senza icona, viene generato un fulmine del tuo colore
Colore principaleQualsiasi colore: il contrasto dei testi viene regolato automaticamente
Font dei titoli e Font del testoFont di sistema: zero download, visualizzazione istantanea
Modalità scura«Automatico (in base al dispositivo del visitatore)» oppure «Sempre chiaro»
Testo del piè di paginaIl tuo testo, e l’opzione Mostra «Realizzato con ⚡ Éclair»
CSS personalizzatoLe tue regole di stile, 64 KB al massimo

Per il colore principale, Éclair punta a un contrasto di almeno 4,5:1 tra i link e lo sfondo, la soglia del criterio WCAG 1.4.3 per il testo normale. Se il tuo colore non basta, i link usano una versione più scura (più chiara in modalità scura), e il testo dei pulsanti diventa bianco o nero, a seconda di ciò che si legge meglio.

Perché un tema non rallenta il tuo sito?

Perché ogni tema è solo un foglio di stile da 1,5 a 3 KB, aggiunto a quello di base. Il tema Éclair, invece, non aggiunge nulla: è lo stile di base.

  • L’HTML non cambia da un tema all’altro: velocità, accessibilità, dati strutturati e posizionamento restano identici.
  • Solo il tema attivo viene inserito nella pagina, insieme al resto del CSS: nessun file in più da scaricare.
  • La modalità scura automatica funziona con ognuno dei 6 temi.
  • Gli stili del negozio vengono inseriti solo quando è aperto: un sito vetrina non li carica mai.

Come aggiungere il tuo CSS?

Per andare oltre il tema (il colore di un pulsante, le spaziature, lo stile di un blocco), incolla le tue regole in Impostazioni › Aspetto › CSS personalizzato, poi salva.

  • Hanno la precedenza sul tema: vengono aggiunte dopo di esso in ogni pagina.
  • Sopravvivono agli aggiornamenti da Éclair 1.5.0: sono salvate insieme ai tuoi dati, in data/, che l’aggiornamento non tocca.
  • I delimitatori della modalità scura funzionano: le regole comprese tra /*dark*/ e /*/dark*/ scompaiono quando la modalità scura è impostata su «Sempre chiaro».
  • Per sicurezza, il carattere <, le regole @import e i caratteri di controllo vengono rimossi, e il campo accetta al massimo 64 KB.

Per esempio, per pulsanti con gli angoli leggermente arrotondati e un piè di pagina più scuro in modalità scura:

.btn { border-radius: 6px; }

/*dark*/@media (prefers-color-scheme: dark) { .site-footer { background: #0d0d12; } }/*/dark*/

Cosa non fanno i temi?

  • Non cambiano la struttura delle pagine. Per spostare un elemento o aggiungere un’area, bisogna modificare i template PHP di app/theme/, come spiega la pagina Per sviluppatori. Un aggiornamento li sostituisce: tieni una copia dei tuoi file.
  • Non c’è un catalogo di temi da scaricare e non ci sono estensioni: i 6 temi sono inclusi in Éclair. L’assenza di estensioni è una scelta, per la velocità e per la sicurezza.
  • Niente web font nelle impostazioni: solo font di sistema, già presenti sul dispositivo del visitatore.
  • Il CSS personalizzato non importa nulla: senza @import, non può caricare un altro foglio di stile.

Cosa fare se l’aspetto non cambia?

SintomoSoluzione
Il sito non è cambiatoL’anteprima non salva nulla: clicca su Salva. Il CSS è integrato in ogni pagina, non c’è nessun vecchio file da aggiornare.
«Il negozio» e «Un prodotto» mancano nell’anteprimaCompaiono solo dopo l’apertura del negozio, e «Un prodotto» solo se c’è un prodotto pubblicato.
Una regola del tuo CSS personalizzato viene ignorataVerifica che non contenga né < né @import, che vengono rimossi al salvataggio. Se resta senza effetto, rendila più specifica: una regola più specifica del tema ha la precedenza.
«CSS personalizzato troppo lungo: massimo 64 KB.»Raggruppa o alleggerisci le tue regole.
Alcune regole sparisconoSono comprese tra /*dark*/ e /*/dark*/, e la modalità scura è impostata su «Sempre chiaro»: è voluto.
Le tue modifiche a theme.css sono spariteL’aggiornamento ha sostituito app/. Sposta le tue regole nel CSS personalizzato.

Le istruzioni originali sono anche nella guida ufficiale di Éclair, e il dettaglio delle versioni dalla 1.3.0 alla 1.5.0 nel registro delle versioni.

Domande sui temi

Cambiare tema fa perdere i miei contenuti o il mio posizionamento?

No. I temi Éclair non toccano né i tuoi contenuti né l’HTML delle tue pagine: titoli, dati strutturati, velocità e accessibilità restano identici. Cambia solo l’aspetto.

Posso tornare al tema originale?

Sì, in qualsiasi momento: scegli la card Éclair in Impostazioni › Aspetto, poi salva. Le sue impostazioni consigliate si applicano di nuovo, e il tuo CSS personalizzato resta al suo posto.

La modalità scura funziona con tutti i temi?

Sì: si applica automaticamente in base al dispositivo del visitatore, con ognuno dei 6 temi. Per evitarla, imposta la Modalità scura su «Sempre chiaro».

Quale tema scegliere per vendere online?

Il tema Negozio è pensato per vendere: foto quadrate, intestazione fissa, pulsanti decisi. Anche gli altri temi mostrano il negozio; le istruzioni sono in Il negozio leggero.

Il mio CSS personalizzato sopravvive agli aggiornamenti?

Sì, da Éclair 1.5.0: è salvato in data/, che l’aggiornamento non tocca. Vengono sostituite solo le modifiche fatte direttamente in app/theme/.