Manuale · 2

Primi passi

Avvio

make run          # compila app admin + server e avvia sulla porta 8080

Oppure con un binario già pronto:

./illusioncms -addr :8080 -data ./data

Apri http://localhost:8080/cms-admin. Al primissimo avvio crei l’accesso amministratore (nome utente, password di almeno 8 caratteri). Dopo accedi con questi dati.

Una nuova installazione non ha ancora pagine – fino ad allora ogni indirizzo, anche /, restituisce la pagina 404. In Pagine crei il tuo primo sito con + Crea sito oppure ne riprendi uno esistente tramite importazione.

Tutti i contenuti si trovano nella cartella dati (./data): il database illusion.db e i caricamenti in media/. Maggiori dettagli in Funzionamento.

Provare il sito demo

Per conoscerlo, IllusionCMS include una demo pronta: due siti di esempio (Bäckerei Morgenrot con un sottoalbero in inglese e Kulturverein Lindenhof), il page builder con blocchi e un blocco globale, Collections con tutti i tipi di campo, una sorgente REST, Workflows con un node personalizzato, Pens, reindirizzamenti e file di esempio.

Durante la configurazione: quando crei il primo account amministratore, spunta Installa anche il sito demo (disattivato per impostazione predefinita). Dopo pochi secondi la demo è importata e la sorgente REST punta automaticamente all’indirizzo con cui hai aperto l’admin. La casella compare solo durante la configurazione e solo nelle build con demo integrata – i binari delle release la hanno sempre, quelli compilati da te solo dopo scripts/build-demo.sh (o make demo).
Come download: ogni release contiene la demo anche come file illusioncms-vX.Y.Z-demo.icb. Importala come bundle in un’istanza nuova in Impostazioni → Sincronizzazione – attenzione, un bundle sostituisce l’intero contenuto (prima IllusionCMS crea un backup). Dopo, la sorgente REST termine-api punta all’indirizzo segnaposto http://demo.invalid: in Sorgenti REST inserisci l’indirizzo della tua istanza, ad es. http://localhost:8080/api/v1/collections/termine/items. La richiesta di esempio della Collection live Anfragen viene ripresa solo se durante l’importazione spunti Riprendi dal bundle anche le voci delle Collections con dati live.

Il secondo sito ha il dominio lindenhof.localhost; Chrome e Firefox lo aprono in locale su http://lindenhof.localhost:8080/, su un server inserisci un tuo dominio. Quando la demo non ti serve più, elimina i siti in Pagine (poi Pulizia rimuove i file inutilizzati) oppure sostituisci tutto con un tuo bundle.

L’admin in sintesi

Menu principale (a sinistra): Pagine, Statistiche, CSS & JS, Snippets, File, Collections, Sorgenti REST, Workflows, Pens, Import, Reindirizzamenti, Manuale, Impostazioni. In fondo si trovano Aspetto (Chiaro/Scuro/Sistema), Lingua (bandiera) e la freccia per comprimerlo in una barra di icone stretta. Se la finestra è poco alta, scorre solo l’elenco delle voci di menu.
Cerca (in alto nel menu, Ctrl+K da qualsiasi punto – anche dall’editor di codice): la tavolozza comandi. Digita, Invio, fatto – trova pagine (titolo o percorso), siti web, snippet, CSS/JS, Collections, Workflows, sorgenti REST e sezioni del manuale e della documentazione API, e può eseguire alcune azioni (svuotare la cache, aprire il sito web, uscire). Senza termine di ricerca mostra i risultati aperti di recente.
Istanza (in cima al menu): Locale oppure una connessione salvata verso un altro server – in quel caso l’intero admin lavora in diretta con quel server (vedi Più istanze).
Le Impostazioni sono suddivise in sezioni che scegli a sinistra (anche con Ctrl+K, ad es. “Impostazioni: Token API”): Sincronizzazione (bundle, sincronizzazione con un server, backup – vedi Bundle), Connessioni, Utenti, Token API, Il mio account (password) e Sistema (interruttore dell’admin, dati dei paesi delle statistiche, versione installata, tempo di attività, cache delle pagine).
Apri sito web apre il sito pubblico in una nuova scheda. Con più siti compare una selezione. Se l’admin gira sotto il dominio di un sito, gli altri si aprono tramite il proprio dominio – i siti senza dominio sono allora disattivati, perché il dominio dell’admin ha sempre la precedenza.
Le modifiche non salvate si riconoscono dal punto arancione (sul pulsante Salva e sulle schede). Quando esci, il CMS chiede conferma.
Cronologia: pagine, snippet, file CSS/JS e Workflows hanno un pulsante Cronologia. Prima di ogni salvataggio il CMS mette al sicuro la versione precedente (più salvataggi entro 2 minuti contano come un’unica sessione di modifica, al massimo 100 versioni). Nella cronologia vedi l’HTML/Head o il codice di ogni versione e quali campi differiscono da quella attuale; Ripristina la recupera – la versione attuale viene prima salvata a sua volta. Per le pagine, URL e pubblicazione restano invariati. Anche una reimportazione che sovrascrive una pagina modificata lascia una versione.
Modificato contemporaneamente? Se qualcun altro (o tu in una seconda scheda) ha salvato una pagina, uno snippet, un file CSS/JS, un Workflow o una voce di Collection dopo che l’hai aperto, al salvataggio il CMS chiede conferma invece di sovrascrivere silenziosamente quelle modifiche.

La tua prima pagina

Pagine → (la prima volta + Crea sito) → seleziona la home page → + Pagina.
Inserisci il titolo, lo slug (parte dell’URL) viene proposto automaticamente. Se esistono layout di pagina, ne scegli uno – altrimenti nasce una pagina vuota con un titolo.
Scrivi nella scheda HTML – l’anteprima dal vivo a destra si aggiorna mentre digiti.
Spunta Pubblicata, salva con Ctrl+S.