=== Agenda Bamboche ===
Contributors: bamboche
Tags: agenda, évènements, calendrier, commune, mairie
Requires at least: 5.8
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 1.1.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

L’agenda des sorties de votre commune et des communes voisines, mis à jour chaque jour par Bamboche, en liste ou en calendrier. Gratuit.

== Description ==

Bamboche rassemble les sorties et les évènements de votre commune et des communes voisines : marchés, brocantes, lotos, concerts, spectacles, fêtes… Votre site affiche cet agenda gratuitement, sans rien saisir : indiquez simplement vos communes par leur code INSEE.

* Un bloc « Agenda Bamboche » pour l’éditeur, avec un aperçu.
* Le shortcode `[bamboche_agenda]` pour les autres éditeurs.
* Deux affichages : la liste des évènements à venir, ou le calendrier du mois.
* La couleur et le titre de votre site.
* L’agenda prend sa hauteur réelle : pas de barre de défilement dans la page.
* Coller l’adresse d’un agenda (https://bamboche.io/widget/…) seule sur une ligne l’affiche aussi.

= Service externe =

L’agenda est affiché depuis bamboche.io, dans un cadre (iframe) : les visiteurs de la page chargent l’agenda depuis https://bamboche.io. L’agenda ne dépose pas de cookie et ne contient ni publicité ni mesure d’audience.

* Conditions d’utilisation : https://bamboche.io/cgu
* Confidentialité : https://bamboche.io/pdc


== Installation ==

1. Installez et activez le plugin.
2. Dans Réglages › Agenda Bamboche, indiquez les codes INSEE de vos communes (ou collez l’adresse d’un agenda créé sur https://bamboche.io/agenda-pour-votre-site), et si besoin le rayon, la couleur et le titre.
3. Ajoutez le bloc « Agenda Bamboche » dans une page, ou le shortcode `[bamboche_agenda]`.

== Frequently Asked Questions ==

= Quelles sont les options du shortcode ? =

* `insee="60139,60500"` : d’autres communes que celles des réglages (codes INSEE).
* `rayon="10"` : ajoute les évènements à moins de 10 km de chaque commune (sans rayon : les évènements situés dans les communes, 30 km au plus).
* `vue="calendrier"` : le calendrier du mois au lieu de la liste.
* `couleur="#1d4e89"` : la couleur des dates et des boutons.
* `titre="Agenda de la commune"` : le titre affiché en haut.
* `mois="2026-12"` : le mois affiché par le calendrier.
* `id="…"` : un ancien agenda de collectivité (adresse https://bamboche.io/widget/…).
* `hauteur="900"` : la hauteur au chargement, avant que l’agenda ne prenne la sienne.

= Où trouver le code INSEE de ma commune ? =

Sur https://bamboche.io/agenda-pour-votre-site : cherchez vos communes, puis copiez l’adresse de l’agenda dans les réglages du plugin. Le code INSEE n’est pas le code postal.

= Comment ajouter un évènement ? =

Les évènements viennent de Bamboche : les associations et les organisateurs les publient sur bamboche.io ou dans l’application Bamboche.

== Changelog ==

= 1.1.1 =
* Sans rayon, l’agenda montre les évènements situés dans vos communes (leur contour officiel) ; le rayon ajoute les alentours.

= 1.1.0 =
* Agenda gratuit par communes : codes INSEE et rayon, dans les réglages, le bloc et le shortcode.
* Les agendas de collectivité (identifiant) fonctionnent toujours.

= 1.0.0 =
* Première version : bloc, shortcode, réglages, hauteur automatique.
