Informazioni del tema
Panoramica
Ogni tema in SelfComposer può avere diverse impostazioni e funzionalità. Il tema attivo può essere selezionato dal pannello in Impostazioni > Temi dove troviamo tutti quelli inseriti nella cartella "/cms-contents/themes/" con immagine, titolo, descrizione, versione e alcuni pulsanti: per le impostazioni tema e per le Etichette e per la guida all'utilizzo.
Ogni tema deve contenere il file theme.php in cui vengono inserite:
- Le informazioni del tema
- Per che moduli è predisposto
- Quali features aggiuntive sono abilitate
- Se sono attive le impostazioni tema
- Il tipo di paginazione
- I layout
- Le etichette
- Le posizioni dei menu
- Le posizioni delle vetrine
- Le posizioni della ricerca_avanzata
L'implementazione di queste funzionalità è descritta nell'apposita pagina del file.
Implementazione
Estrarre le informazioni del tema
Per ottenere le impostazioni di theme.php è sufficiente utilizzare theme.info
che contiene un array di tutti i contenuti di quel file.
Inserire un file come guida all'uso del tema
I file readme contengono le istruzioni per l'utilizzo del tema da parte dell'amministratore che gestirà il sito. Il file può avere nomi differenti, anche se in genere viene usato il nome "readme_" seguito dal codice della lingua della guida. Il file è di tipo ".md" e deve quindi rispettare la sintassi del linguaggio Markdown.
Per associare i file readme alla lingua corretta e mostrarli nel pannello, va aggiunto il relativo oggetto nel file theme.php, in questo modo:
'readme' => [ 'it' => 'readme_it', ],
La guida per l'utente comparirà all'interno della sezione "Temi" del pannello premendo sull'icona "i" del tema corrispondente.