Aller au contenu

Module v1.0.0

Configurer Carrousels & sliders

Composez des carrousels d'images qui défilent pour vos pages, et des sliders de bannière pour votre accueil : choisissez, ordonnez et habillez d'un titre, d'un texte et d'un lien des photos de votre médiathèque.

carrousels Ce que ce module apporte →

Ce qu'il fait

Des carrousels d'images CURATÉS pour le site : on choisit des images de la médiathèque, on les ordonne, on ajoute titre/texte/lien. Distinct de la médiathèque (modules/media) qui STOCKE/trie les fichiers — le Carrousel ne re-stocke aucune image, il référence des chemins existants. Même pattern que la Galerie (modules/gallery), une diapositive porte en plus un titre, un texte court et un lien.

  • Diapositives ordonnées, avec titre, texte court et lien au clic
  • Puise directement dans la médiathèque, aucun re-stockage
  • Défilement au clic, sans dépendance externe

Où le trouver

Les écrans que ce module ajoute à l'administration, une fois activé.

  • Carrousels /admin/carrousels
Carrousels
Carrousels

Ses droits

Ce que chaque rôle peut faire par défaut. Modifiable rôle par rôle depuis l'administration.

Droit Clé Administrateur Éditeur
Voir les carrousels carrousels.read ✓ ✓
Créer / modifier / supprimer des carrousels carrousels.write ✓ ✓

Piloter par une IA

Ce que ce module sait faire quand on le lui demande en langage naturel, et ce que chaque action engage.

  • lister lecture seule

    Liste les carrousels du site avec leurs diapositives : id, titre interne, visibilité, et pour chaque diapositive son id, son titre et son texte.

  • modifier écrit, annulable

    Modifie le titre ou le texte d'une diapositive EXISTANTE d'un carrousel. Annulable. Ne crée jamais de nouveau carrousel ni de nouvelle diapositive : la création se fait depuis l'écran carrousels, un nouveau bloc n'apparaît que si le thème le place. Params : id (requis, l'identifiant de la DIAPOSITIVE, via carrousels.lister) puis les champs à changer.

    « change le titre de la 2e diapositive du carrousel Accueil en « Nouvelle collection » » « corrige la faute dans le texte de la diapositive 12 »

Ses points de branchement

Pour greffer du code sans toucher au module : ce qu'il annonce, et ce qu'il écoute.

Ce qu'il annonce 3
carrousel.created
Émis après création d'un carrousel. Args: [array $carrousel]
carrousel.updated
Émis après update d'un carrousel (titre/slug/visibilité — pas les diapositives). Args: [int $id, array $new, array $old]
carrousel.deleted
Émis après suppression d'un carrousel (cascade sur ses diapositives). Args: [int $id, array $old]

Ses prises front

Les morceaux de page que ce module fournit, et les classes qu'ils posent. Un thème les habille par ces classes : il ne recopie pas le balisage, sinon il rate les corrections des versions suivantes.

views/carrousel.php 9 classes
  • s-carrousel
  • s-carrousel-cta
  • s-carrousel-diapo<?=
  • s-carrousel-pastille<?=
  • s-carrousel-pastilles
  • s-carrousel-piste
  • s-carrousel-prec
  • s-carrousel-suiv
  • s-carrousel-texte

Ses données

Les tables que ce module crée. Désactiver un module ne les efface pas : ses données restent en base et reviennent s'il est réactivé.

Les tables 2
  • carrousel_slides
  • carrousels