Markdown Reader

Calendar Documentation Fr

Fonctionnalité : Calendar #

Calendrier personnel par utilisateur. Chaque membre gère ses propres événements (one-shot, sans récurrence en v1) et peut, en option, partager publiquement son calendrier via un widget intégrable. Chaque événement peut être marqué public ou privé.

Installation et Configuration

Par FTP : Déposer le répertoire calendar/ dans /plugins/.

Par package manager : Sélectionner calendar dans la liste des plugins disponibles.

Chemins :

Plugin principal : /plugins/calendar/calendar.php
Bibliothèque : /plugins/calendar/lib/calendar.lib.inc.php
Widget public : /plugins/calendar/widget/calendar.widget.php
Handlers : /plugins/calendar/handlers/ (sauvegarde/suppression d'événement, plage d'événements, réglages)
CSS / JS : /plugins/calendar/css/, /plugins/calendar/js/

Paramètres de configuration :

| Variable | Valeur par défaut | Description |

|---|---|---|

| $basedatadisplay | 'yes' | Visible dans l'interface de gestion |

| $basedisplevel | BASE_LEVEL_USER | Accessible aux utilisateurs connectés |

| $ftype | 1 | Module de contenu |

Utilisation

L'utilisateur connecté voit son calendrier et peut :

Créer / éditer / supprimer des événements one-shot.
Configurer le partage via deux réglages :

- share_enabled — active le widget public du calendrier.

- share_default_public — définit si les nouveaux événements sont publics par défaut.

Lorsque le partage est activé, une URL de widget est fournie :

text

?obj=calendar.widget&uid=ID_utilisateur

Widget public : un visiteur non connecté qui accède au calendrier avec un uid en paramètre se voit servir le widget public de cet utilisateur, soumis à un double verrou : le partage doit être activé (share_enabled) et seuls les événements marqués publics sont affichés.

Hooks et Points d'entrée

text

?obj=calendar.php                        — Calendrier personnel (utilisateur connecté)
?obj=calendar.php&uid=ID                 — Widget public (visiteur)
?obj=calendar.widget&uid=ID              — Widget public intégrable
?obj=calendar_event_save.mod             — Création / édition d'un événement
?obj=calendar_event_delete.mod           — Suppression d'un événement
?obj=calendar_events_range.mod           — Récupération des événements d'une plage de dates
?obj=calendar_settings_save.mod          — Enregistrement des réglages de partage

Dépendances

Beamreactor\Calendar\Calendar — gestion des événements
Beamreactor\Calendar\CalendarSharing — logique de partage public
Beamreactor\Sanitizer\Parser

Sécurité

Le calendrier personnel est réservé aux utilisateurs connectés. L'exposition publique repose sur un double verrou : le partage doit être explicitement activé par le propriétaire, et seuls les événements marqués publics sont visibles dans le widget. Les entrées sont assainies via Parser::sanitize().