Annonces (popup) — documentation Sillon

Ce qu'il fait

Annonces ponctuelles en bandeau ou modale : programmables (fenêtre de dates), ciblables par page (all/include/exclude), fréquence d'affichage (always/session/visitor), priorité. Modèles de base data-only (bandeau, modale) extensibles par site via le filtre popup.models — le kit fournit les modèles, chaque site branche la prise front (views/popup.php) et style les classes s-popup-*.

Bandeau ou fenêtre au choix
Programmation sur une période de dates
Ciblage de certaines pages
Fréquence d'affichage réglable

Où le trouver

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

Annonces /admin/popup

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 annonces (popups)	`popup.read`	✓	✓
Créer / modifier les annonces	`popup.write`	✓	✓
Supprimer une annonce	`popup.delete`	✓	—

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 popups (annonces) du site : id, nom interne, modèle, statut, fenêtre de dates, ciblage, fréquence, priorité. Params : status (optionnel, draft|active).
creer écrit, annulable

Crée une annonce (bandeau en haut de page, ou modale par-dessus la page). Active par défaut : une annonce est temporaire et se retire en un clic. Donnez une fenêtre de dates pour qu'elle ne s'affiche que sur la période.

« annonce la fermeture du magasin du 15 au 20 août » « mets un bandeau « Livraison offerte ce week-end » jusqu'à dimanche »
modifier écrit, annulable

Modifie une annonce existante : texte, statut (activer/désactiver), fenêtre de dates, nom interne, priorité, bouton. Annulable. Params : id (requis, via popup.lister) puis les champs à changer.

« désactive l'annonce de fermeture » « prolonge l'annonce jusqu'au 25 août »

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 4

popup.created: Émis après création. Args: [array $popup]
popup.updated: Émis après update. Args: [int $id, array $new, array $old]
popup.deleted: Émis après suppression. Args: [int $id, array $old]
popup.models: Filter — étend/modifie les modèles disponibles (slug => {label, help, kind, fields}). Args: [array $models]. C'est LE point d'extension pour qu'un site ajoute ses propres modèles.

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/popup.php 0 classes

Aucune classe littérale : cette prise construit son balisage en PHP.

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 1

popups