Aller au contenu

Module v1.2.0

Configurer Emplacements

Indiquez où vous trouver : un ou plusieurs lieux, avec ou sans jour précis, du commerce ambulant en tournée à la boutique à adresse fixe.

locations Ce que ce module apporte →

Ce qu'il fait

Le module du LIEU (celui qui a une adresse) : spots datés (commerce ambulant en tournée) ou adresses fixes (boutiques). Jour et horaires facultatifs, photo, texte de présentation, lien Google Maps.

  • Jour et horaires optionnels par lieu
  • Photo et texte de présentation
  • Lieu avec lien vers un plan
  • Mise à jour en un instant

Où le trouver

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

  • Emplacements /admin/locations
Emplacements
Emplacements

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 emplacements locations.read ✓ ✓
Créer / modifier / supprimer locations.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 emplacements : id, nom du lieu, ville, adresse, jour et horaire de présence, statut actif. Params : active_only (optionnel, bool).

  • creer écrit, annulable

    Crée un emplacement (spot daté ou adresse fixe). Actif par défaut.

    « ajoute un emplacement : Marché de Dijon, le samedi de 8h à 13h » « crée un nouveau point de vente à Lyon »

  • modifier écrit, annulable

    Modifie un emplacement existant. Annulable. Params : id (requis, via locations.lister) puis les champs à changer.

    « change l'horaire du marché de Dijon pour 9h-14h » « désactive l'emplacement de Lyon »

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
locations.created
Émis après création. Args: [array $location]
locations.updated
Émis après update. Args: [int $id, array $new, array $old]
locations.deleted
Émis après suppression. 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/emplacements.php 9 classes
  • s-location
  • s-location-address
  • s-location-city
  • s-location-image
  • s-location-map
  • s-location-name
  • s-location-text
  • s-location-when
  • s-locations

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
  • locations