IllusionCMS
FR
Manuel · 2

Premiers pas

Démarrer

make run          # compile l’app d’admin + le serveur et démarre sur le port 8080

Ou avec un binaire prêt à l’emploi :

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

Ouvrez http://localhost:8080/cms-admin. Au tout premier démarrage, vous créez l’accès administrateur (nom d’utilisateur, mot de passe d’au moins 8 caractères). Ensuite, vous vous connectez avec ces identifiants.

Une nouvelle installation n’a encore aucune page – jusque-là, chaque adresse, y compris /, renvoie la page 404. Sous Pages, créez votre premier site avec + Créer un site ou reprenez un site existant par import.

Tous les contenus se trouvent dans le dossier de données (./data) : la base de données illusion.db et les fichiers téléversés sous media/. Plus de détails dans Exploitation.

Essayer le site de démonstration

Pour découvrir IllusionCMS, une démo prête à l’emploi est fournie : deux sites d’exemple (Bäckerei Morgenrot avec une sous-arborescence anglaise et Kulturverein Lindenhof), le constructeur de pages avec ses blocs et un bloc global, des Collections avec tous les types de champs, une source REST, des Workflows avec un node personnalisé, des Pens, des redirections et des fichiers d’exemple.

  • Lors de la configuration : en créant le premier compte administrateur, cochez Installer aussi le site de démonstration (désactivé par défaut). Après quelques secondes, la démo est importée et la source REST pointe automatiquement vers l’adresse sous laquelle vous avez ouvert l’admin. La case n’apparaît que lors de la configuration et seulement dans les builds avec démo intégrée – les binaires des releases l’ont toujours, ceux que vous compilez vous-même seulement après scripts/build-demo.sh (ou make demo).
  • En téléchargement : chaque release contient aussi la démo sous forme de fichier illusioncms-vX.Y.Z-demo.icb. Importez-la comme bundle dans une instance neuve sous Paramètres → Synchronisation – attention, un bundle remplace l’intégralité du contenu (IllusionCMS crée d’abord une sauvegarde). Ensuite, la source REST termine-api pointe vers l’adresse fictive http://demo.invalid : sous Sources REST, saisissez l’adresse de votre instance, p. ex. http://localhost:8080/api/v1/collections/termine/items. La demande d’exemple de la Collection live Anfragen n’est reprise que si vous cochez lors de l’import Reprendre aussi du bundle les entrées des Collections avec données live.

Le second site a le domaine lindenhof.localhost ; Chrome et Firefox l’ouvrent en local sous http://lindenhof.localhost:8080/, sur un serveur vous saisissez votre propre domaine. Quand vous n’avez plus besoin de la démo, supprimez les sites sous Pages (Nettoyer retire ensuite les fichiers inutilisés) ou remplacez tout par votre propre bundle.

L’admin en un coup d’œil

  • Menu principal (à gauche) : Pages, Statistiques, CSS & JS, Snippets, Fichiers, Collections, Sources REST, Workflows, Pens, Import, Redirections, Manuel, Paramètres. Tout en bas se trouvent l’apparence (Clair/Sombre/Système), la langue (drapeau) et la flèche pour replier le menu en une barre d’icônes étroite. Si la fenêtre est peu haute, seule la liste des entrées de menu défile.
  • Rechercher (en haut du menu, Ctrl+K depuis n’importe où – même depuis l’éditeur de code) : la palette de commandes. Tapez, Entrée, c’est fait – elle trouve les pages (titre ou chemin), les sites, Snippets, CSS/JS, Collections, Workflows, sources REST et les sections du manuel et de la documentation de l’API, et peut exécuter quelques actions (vider le cache, ouvrir le site, se déconnecter). Sans terme de recherche, elle affiche les derniers résultats ouverts.
  • Instance (tout en haut du menu) : Local ou une connexion enregistrée vers un autre serveur – l’admin entier travaille alors en direct avec ce serveur (voir Plusieurs instances).
  • Paramètres sont organisés en sections que vous choisissez à gauche (aussi via Ctrl+K, p. ex. « Paramètres : Tokens API ») : Synchronisation (Bundles, synchronisation avec un serveur, sauvegardes – voir Bundles), Connexions, Utilisateurs, Tokens API, Mon compte (mot de passe) et Système (interrupteur de l’admin, données pays des statistiques, version installée, durée de fonctionnement, cache des pages).
  • Ouvrir le site ouvre le site public dans un nouvel onglet. S’il y a plusieurs sites, une sélection apparaît. Si l’admin tourne sous le domaine d’un site, les autres s’ouvrent via leur propre domaine – les sites sans domaine sont alors grisés, car le domaine de l’admin est toujours prioritaire.
  • Vous reconnaissez les modifications non enregistrées au point orange (sur le bouton Enregistrer et sur les onglets). Si vous quittez la page, le CMS vous demande confirmation.
  • Historique : les pages, Snippets, fichiers CSS/JS et Workflows ont un bouton Historique. Avant chaque enregistrement, le CMS sauvegarde l’état précédent (plusieurs enregistrements en moins de 2 minutes comptent comme une seule session de modification, 100 versions au maximum). Dans l’historique, vous voyez le HTML/Head ou le code de chaque version et les champs qui diffèrent de la version actuelle ; Restaurer la rétablit – la version actuelle est d’abord sauvegardée elle-même. Pour les pages, l’URL et la publication restent telles quelles. Une réimportation qui écrase une page modifiée laisse elle aussi une version.
  • Modifié en même temps ? Si quelqu’un d’autre (ou vous-même dans un deuxième onglet) a enregistré une page, un Snippet, un fichier CSS/JS, un Workflow ou une entrée de Collection après que vous l’avez ouvert, le CMS vous demande confirmation à l’enregistrement au lieu d’écraser ces modifications en silence.

Votre première page

  1. Pages → (la première fois, + Créer un site) → sélectionner la page d’accueil → + Page.
  2. Saisir un titre ; le Slug (partie de l’URL) est proposé automatiquement. Si des mises en page existent, vous en choisissez une – sinon une page vide avec un titre est créée.
  3. Écrire dans l’onglet HTML – l’aperçu en direct à droite se met à jour pendant la saisie.
  4. Cocher Publiée, enregistrer avec Ctrl+S.