Documentation

Kulturae Agenda est un plugin WordPress pour créer, organiser et diffuser une programmation culturelle. Ce guide couvre l’installation, la création d’événements et de lieux, l’affichage de l’agenda, et les options avancées des offres Pro et Multi-sites.

Installation

Kulturae Agenda s’installe comme n’importe quel plugin WordPress, depuis une archive.zip. Aucune configuration serveur particulière n’est requise (WordPress 6.0+, PHP 8.0+).

Dans l’administration WordPress, ouvrez Extensions → Ajouter → Mettre en ligne une extension.
Sélectionnez le fichier kulturae-agenda-pro.zip téléchargé depuis votre espace client, puis Installer et Activer.
Un nouveau menu Kulturae Agenda apparaît dans la barre latérale. Vous pouvez déjà créer vos premiers événements.

Activer la licence

Les fonctionnalités avancées (calendrier, carte, QR Code, export, API…) se débloquent en activant votre clé de licence. Sans licence, le plugin fonctionne en version gratuite : événements illimités, vue liste et jusqu’à 5 lieux.

Rendez-vous dans Kulturae Agenda → Licence.
Saisissez votre clé au format KULT-XXXX-XXXX-XXXX-XXXX, disponible dans votre espace client.
Cliquez sur Activer. Le domaine du site est alors enregistré (1 domaine en Pro, 3 en Multi-sites).

Une licence peut être libérée puis réactivée sur un autre domaine à tout moment, sans frais — pratique lors d’une migration ou d’un changement de nom de domaine.

Créer un événement

Les événements sont un type de contenu à part entière, avec leur propre éditeur. Créez-en depuis Kulturae Agenda → Ajouter un événement.

Chaque événement rassemble :

Dates et horaires — ponctuel ou récurrent (quotidien, hebdomadaire, mensuel ou personnalisé).
Lieu — choisi dans votre base de lieux réutilisable (voir ci-dessous).
Classification — type d’événement (avec sa couleur), public visé et thématique.
Tarif et réservation — gratuit ou payant, avec un lien de réservation externe.
Image à la une, description et informations pratiques.

Un événement peut être mis « à la une » pour le mettre en avant sur votre site (voir le shortcode [kulturae_event]).

Gérer les lieux

Les lieux se gèrent séparément dans Kulturae Agenda → Lieux et se réutilisent d’un événement à l’autre : vous ne saisissez chaque salle qu’une fois.

À la saisie d’une adresse, la géolocalisation automatique (via OpenStreetMap) calcule les coordonnées GPS, utilisées ensuite par la vue carte. Vous pouvez aussi renseigner la latitude et la longitude manuellement.

Pro — lieux illimités et géolocalisation automatique. En version gratuite, jusqu’à 5 lieux avec saisie manuelle des coordonnées.

Afficher l’agenda

Insérez votre agenda n’importe où avec un shortcode ou un bloc Gutenberg. La page dédiée /agenda est aussi générée automatiquement.

Shortcodes

[kulturae_agenda] // agenda complet [kulturae_agenda view="calendar"] // ouverture sur le calendrier [kulturae_agenda category="12" limit="9"] [kulturae_event] // événement à la une, pleine largeur [kulturae_event id="128" height="520"]

Attributs de [kulturae_agenda]

Attribut	Valeurs	Rôle
`view`	list · calendar · map	Vue affichée à l’ouverture (par défaut : réglage du plugin).
`category`	ID	Limite l’agenda à un type d’événement.
`venue`	ID	Limite l’agenda à un lieu.
`limit`	nombre	Événements par page en vue liste.

Blocs Gutenberg

Dans l’éditeur de blocs, recherchez « Kulturae » :

Agenda — l’agenda complet avec ses vues et filtres.
Événement à la une — un événement mis en avant, pleine largeur.
Prochains rendez-vous — une liste courte des événements à venir, avec titre personnalisable.

Les trois vues

Vos visiteurs basculent entre trois façons de consulter la même programmation. La vue liste est toujours disponible ; le calendrier et la carte s’activent dans les réglages (offres Pro et Multi-sites).

Liste — des cartes claires (photo, lieu, horaire, tarif) avec recherche et filtres. Gratuit.
Calendrier mensuel (FullCalendar) — une lecture chronologique, idéale quand la programmation est dense. Pro.
Carte interactive (Leaflet) — les événements géolocalisés, regroupés par proximité (clustering). Pro.

Activez chaque vue dans Kulturae Agenda → Réglages, et choisissez la vue affichée par défaut.

Personnalisation

Adaptez l’agenda à l’identité graphique de votre site depuis Kulturae Agenda → Réglages.

Couleurs principale et secondaire, appliquées aux boutons, badges et éléments interactifs.
Couleur propre à chaque type d’événement, reprise dans la liste, le calendrier et la carte.
Marqueur de carte personnalisé — remplacez le repère par défaut par le logo de votre structure.

Pro — la personnalisation des couleurs et du marqueur est incluse dans les offres Pro et Multi-sites.

QR Code et export calendrier

Deux fonctionnalités pour relier votre agenda au monde extérieur, incluses dans les offres Pro et Multi-sites.

QR Code automatique — chaque événement dispose d’un QR Code pointant vers sa page. Idéal pour vos affiches, flyers et signalétique sur site.
Export .ics — vos visiteurs ajoutent un événement à Google Agenda, Outlook ou Apple Calendar en un clic.

Import / Export CSV

Importez une programmation existante ou sauvegardez vos événements depuis Kulturae Agenda → Import / Export (offres Pro et Multi-sites).

Le fichier CSV attend les colonnes suivantes :

titre, date_debut, heure_debut, heure_fin, lieu, categorie, tarif, gratuit, url_reservation

Les événements importés arrivent en brouillon : relisez-les avant publication.

Synchronisation multi-sites

L’offre Multi-sites permet d’activer Kulturae sur 3 domaines et de synchroniser la configuration entre plusieurs sites WordPress — utile pour un réseau culturel ou une collectivité multi-équipements.

Depuis Kulturae Agenda → Synchronisation, exportez les réglages, les couleurs et les taxonomies (types, publics, thématiques) au format JSON, puis importez-les sur un autre site pour aligner toute votre présence en ligne.

API REST

Chaque site expose une API REST publique en lecture seule, pour réutiliser vos événements et vos lieux dans une application mobile, un écran d’affichage dynamique ou un autre site (offres Pro et Multi-sites).

GET/wp-json/kulturae-agenda/v1/events

Consultez la référence complète de l’API : endpoints, paramètres, formats de réponse et exemples.