Créer et gérer des calendriers

[Discourse]

Ce guide explique comment créer et gérer des calendriers dans Discourse à l’aide du plugin Calendar (and Event).

Niveau d’utilisateur requis : Tous les utilisateurs

Les calendriers sont une fonctionnalité puissante dans Discourse qui vous permet d’organiser et d’afficher des événements au sein de votre communauté. Ce guide vous accompagnera dans le processus de création de calendriers, d’ajout d’événements et de leur gestion efficace.

Sommaire

• Activer le plugin Calendar
• Créer un calendrier dans un sujet ou une catégorie
• Ajouter des événements à votre calendrier
• Gérer les options et les paramètres du calendrier
• Utiliser la fonctionnalité de calendrier des jours fériés

Activation du plugin Calendar

Avant de pouvoir créer des calendriers, assurez-vous que le plugin « Calendar (and Event) » est activé sur votre instance Discourse. Pour plus de détails sur l’activation du plugin et ses paramètres associés, consultez la documentation du plugin Discourse Calendar and Event.

Création d’un calendrier

Calendrier de sujet

Pour intégrer un calendrier dans un sujet :

1. Créez un nouveau sujet ou modifiez le premier message d’un sujet existant

2. Ajoutez le code suivant sur des lignes séparées :

   [calendar]
   [/calendar]
   

3. Publiez ou mettez à jour le message

Le lundi est considéré comme le premier jour de la semaine dans les calendriers Discourse, quels que soient les paramètres régionaux du spectateur. Ceci n’est actuellement pas configurable.

Calendrier de catégorie

Pour créer un calendrier à l’échelle d’une catégorie :

1. Accédez à /admin/site_settings/category/discourse_calendar?filter=plugin=discourse-calendar

2. Dans le paramètre « calendar categories », ajoutez une entrée avec le format suivant :

   categoryId=123;postId=4949;tzPicker;defaultView=month
   

   • Remplacez 123 par l’ID de votre catégorie (trouvé dans l’URL lors de la visualisation de la catégorie)
   • Remplacez 4949 par l’ID du message de la description de la catégorie (trouvé en ajoutant .json à l’URL du sujet « À propos de la catégorie »)

3. Ajoutez l’ID de la catégorie au paramètre « events calendar categories »

4. Facultativement, définissez « discourse post event allowed on groups » pour contrôler quels groupes peuvent ajouter des événements

Ajout d’éléments à un calendrier

Calendrier de sujet

Pour ajouter un événement à un calendrier de sujet :

1. Répondez au sujet contenant le calendrier
2. Utilisez la fonction « Insérer date / heure » dans le menu du compositeur \u003ckbd\u003e+\u003c/kbd\u003e pour ajouter une date ou une plage de dates
3. Ajoutez une description au-dessus de la date
4. Soumettez la réponse

L’événement apparaîtra dans le calendrier après le rechargement du sujet.

Calendrier de catégorie

Pour ajouter un événement à un calendrier de catégorie :

1. Créez un nouveau sujet dans la catégorie
2. Cliquez sur le bouton d’engrenage et sélectionnez « Créer un événement »
3. Remplissez les détails de l’événement et publiez

L’événement apparaîtra sur le calendrier de la catégorie.

Options du calendrier

Vous pouvez personnaliser votre calendrier à l’aide de diverses options :

Option	Exemple	Description
Masquer les week-ends	weekends="false"	Masque le samedi et le dimanche
Masquer des jours spécifiques	hiddenDays="1,2"	Masque le lundi et le mardi (utilisez 0-6 pour dimanche-samedi)
Définir la vue par défaut	defaultView="basicWeek"	Options : month, basicWeek, listNextYear
Ignorer les fuseaux horaires	fullDay="true"	Traite tous les événements comme des événements d’une journée entière

Exemple d’utilisation :

[calendar weekends="false" hiddenDays="1,2" defaultView="basicWeek" fullDay="true"]
[/calendar]

Suppression des éléments du calendrier

Les éléments du calendrier peuvent être supprimés de ces manières :

• Les éléments de calendrier expirés peuvent être automatiquement supprimés à l’aide du paramètre « delete expired event posts after »
• Utilisez des minuteurs de sujet pour supprimer automatiquement les réponses
• Supprimez manuellement les messages si nécessaire

Calendrier des jours fériés

Le calendrier des jours fériés est une fonctionnalité spéciale pour la gestion des vacances du personnel du site :

1. Créez un sujet avec un calendrier dans le premier message
2. Définissez « holiday calendar topic id » sur l’ID de ce sujet
3. Les réponses à ce sujet seront traitées comme du temps de vacances pour l’utilisateur qui publie
4. Les entrées de vacances sont automatiquement et aléatoirement colorées
5. Un emoji (par défaut : ) apparaît à côté des noms des utilisateurs en vacances dans les cartes d’utilisateur et les @mentions
6. Facultativement, incluez les jours fériés spécifiques à la locale pour les utilisateurs en activant « calendar automatic holidays enabled »

FAQ

Q : Pourquoi certains événements semblent-ils s’étendre sur plusieurs jours ?
R : Le calendrier est toujours en UTC. Utilisez les paramètres « all day event start time » et « all day event end time » pour ajuster les différences de fuseaux horaires.

Q : Puis-je contrôler les couleurs des entrées du calendrier des jours fériés ?
R : Actuellement, il n’est pas possible de contrôler les couleurs des entrées du calendrier des jours fériés ni d’obtenir des entrées colorées dans les calendriers réguliers.

Q : Comment afficher les événements passés dans une vue de liste ?
R : Il existe actuellement un bug lors de l’utilisation de defaultView=listNextYear qui fait que la vue initiale est vide. En solution de contournement, les utilisateurs doivent passer à la vue mensuelle, revenir un mois en arrière, puis revenir à la vue de liste pour voir les événements passés.

Ressources supplémentaires

• Discourse Calendar (and Event)
• Creating and managing events