Calendrier et événements de Discourse

[Discourse]

| |
| -|-|-|
| | Résumé | Discourse Calendar and Events ajoute des fonctionnalités de calendrier et d’événements dynamiques et interactives à votre site Discourse.
| | Guide d’installation | Ce plugin est inclus dans le cœur de Discourse. Aucune installation séparée n’est nécessaire.

Étant donné qu’il s’agit d’un plugin official maintenu par l’équipe Discourse, les demandes de Support, de rapport de bug, d’amélioration de l’expérience utilisateur (ux) et de nouvelles fonctionnalités (#feature) peuvent être soumises dans les catégories respectives ici sur Meta, en utilisant le tag approprié du plugin. Cliquez sur un lien ci-dessous pour en créer un.

 Support  Bug  UX  Fonctionnalité

Activation du calendrier et des événements

Le plugin Calendar and Events peut être activé soit par un interrupteur, soit via ses paramètres, tous deux accessibles depuis votre page admin/plugins :

Fonctionnalités

Comme on pouvait s’y attendre, Discourse Calendar and Events ajoute à la fois les fonctionnalités de calendrier et d’événements à votre site Discourse. Grâce à elles, vous pouvez créer des calendriers de sujets individuels pour suivre des occasions importantes ou des chronologies, afficher des calendriers dans des catégories, ajouter un calendrier des fêtes pour marquer les vacances, les absences ou les jours de maladie, créer des sujets d’événements interactifs, ainsi que montrer un résumé facile d’accès de tous vos événements à venir.

Calendriers

Des calendriers personnalisés peuvent être créés dans plusieurs sujets, et ceux que vous souhaitez rendre plus visibles peuvent être affichés au-dessus de la liste des sujets d’une catégorie.

Vous trouverez des informations plus détaillées sur la création et l’utilisation des calendriers ici :

Creating and managing calendars

This guide explains how to create and manage calendars in Discourse using the Calendar (and Event) plugin. Required user level: All users Calendars are a powerful feature in Discourse that allow you to organize and display events within your community. This guide will walk you through the process of creating calendars, adding events, and managing them effectively. Summary Enable the Calendar plugin Create a calendar in a topic or category Add events to you…

Événements

La fonctionnalité Événement permet d’insérer des éléments interactifs dans les sujets, que vos membres peuvent utiliser pour s’inscrire ou participer aux activités de votre communauté. Tous ces éléments sont résumés dans un calendrier dédié à l’échelle du site, avec la possibilité d’ajouter un lien facile d’accès à votre menu de navigation. Vous trouverez plus d’informations sur la création et l’utilisation de cette fonctionnalité ici :

Creating and managing events

This guide explains how to create and manage events using the Calendar and Event plugin in Discourse. It covers how to create events, set event options, interact with events, and view the upcoming events calendar. Required user level: All users (with appropriate permissions) Enabling events Events are a feature of the Calendar and Events plugin. To use this feature: Enable the Calendar and Events plugin Configure related settings For detailed instructions…

Cela ne doit pas être confondu avec le plugin Events de Pavilion (notez le pluriel).

Paramètres du calendrier

Nom	Description
calendar enabled	Active le plugin discourse-calendar. Cela ajoutera le support des balises [calendar][/calendar] dans le premier message d’un sujet.
holiday calendar topic id	ID du sujet du calendrier des congés/absences du personnel.
holiday status emoji	Définit l’emoji utilisé pour le statut de congé.
delete expired event posts after	Les messages contenant des événements expirés seront automatiquement supprimés après (n) heures. Définissez sur -1 pour désactiver la suppression.
all day event start time	Les événements sans heure de début spécifiée commenceront à cette heure. Le format est HH:mm. Pour 6 h 00, entrez 06:00.
all day event end time	Les événements sans heure de fin spécifiée se termineront à cette heure. Le format est HH:mm. Pour 18 h 00, entrez 18:00.
calendar categories	Affiche un calendrier en haut d’une catégorie. Les paramètres obligatoires sont categoryId et postId. Par exemple : categoryId=6;postId=453[1]. Autres paramètres valides : tzPicker[2], weekends[3] et defaultView[4].
calendar categories outlet	Permet de modifier l’issue (outlet) qui doit afficher le calendrier de la catégorie.
working days	Définit les jours ouvrables. Vous pouvez afficher la disponibilité d’un groupe en utilisant la balise timezones dans un message, par exemple : [timezones group=admins][timezones].
working day start hour	Heure de début des heures ouvrables.
working day end hour	Heure de fin des heures ouvrables.
close to working day hours extension	Définit la durée d’extension des heures ouvrables pour mettre en évidence les fuseaux horaires.
calendar automatic holidays enabled	Définit automatiquement le statut de congé en fonction de la région de l’utilisateur (note : vous pouvez désactiver des congés automatiques spécifiques dans les paramètres du plugin).
map events title	Mape le titre du calendrier de la barre latérale en fonction de la catégorie. Par défaut : « Événements à venir ».

Paramètres des événements

Nom	Description
discourse post event enabled	Active les fonctionnalités d’événement. Note : nécessite également que calendar enabled soit activé.
discourse post event allowed on groups	Groupes autorisés à créer des événements.
displayed invitees limit	Limite le nombre d’invités affichés pour un événement.
display post event date on topic title	Affiche la date de l’événement après le titre du sujet.
use local event date	Utilise la date locale après le titre du sujet au lieu du temps relatif.
discourse post event edit notifications time extension	Prolonge (en minutes) la période après la fin d’un événement pendant laquelle les invités marqués comme going continuent d’être notifiés des modifications apportées au message original.
discourse post event allowed custom fields	Permet à chaque événement de définir la valeur de champs personnalisés.
events calendar categories	Affiche un calendrier des événements en haut d’une catégorie.
sort categories by event start date enabled	Active le tri des sujets de catégorie par date de début d’événement.
disable resorting on categories enabled	Permet aux catégories de désactiver la capacité des utilisateurs à trier dans la catégorie d’événement.
sidebar show upcoming events	Affiche le lien « Événements à venir » dans la barre latérale sous « Plus ». Nécessite post event enabled.
map events to color	Assigne une couleur d’événement à un tag ou une catégorie spécifié.

Le point de terminaison discourse-post-event/events.json dispose désormais d’un paramètre supplémentaire pour basculer entre une réponse simple et détaillée. Pour obtenir la réponse détaillée, ajoutez ?include_details=true :

/discourse-post-event/events.json?include_details=true

Intégrations avec d’autres plugins

Vous pouvez utiliser un composant de ce plugin avec Right Sidebar Blocks. Assurez-vous que la route souhaitée est activée dans le composant Right Sidebar Blocks. Le nom du bloc sera upcoming-events-list. Historiquement, des paramètres supplémentaires étaient requis dans le plugin Calendar lui-même, mais cela a été simplifié.

Voici à quoi ressemblera le calendrier de la barre latérale par défaut.

Si vous ne souhaitez pas afficher l’heure, vous pouvez ajouter une valeur timeFormat vide dans le paramètre du bloc du composant.

Hébergé par nous ? Ce plugin est disponible sur nos offres Business et Enterprise Calendar | Discourse - Civilized Discussion

---

1. categoryId est la catégorie sur laquelle le calendrier sera affiché en haut.
   postId est le message dans lequel vous avez inséré le calendrier avec [calendar][/calendar]. ↩︎

2. Il peut afficher un sélecteur de fuseau horaire en haut à droite du calendrier. Désactivé par défaut, vous pouvez l’activer avec tzPicker=true. ↩︎

3. Il peut masquer les samedis et dimanches du calendrier. Activé par défaut. Vous pouvez le désactiver avec weekends=false. ↩︎

4. defaultView définit la vue du calendrier (jour, semaine, etc.). Il peut être défini comme suit :
   
   defaultView=agendaDay
defaultView=agendaWeek
defaultView=month (par défaut)
   defaultView=listNextYear ↩︎

[martyn_thomas]

Ce plugin est prometteur - mais il manque certaines fonctionnalités qui nous empêchent de passer du plugin de Pavilion

• Afficher les événements non journaliers avec l’heure de début sur le calendrier, actuellement tous les événements ressemblent à des événements d’une journée.

• Bouton « Ajouter un événement » dans le compositeur à côté du sélecteur de balises (pas caché dans le rouage)

• Limiter quelles catégories peuvent avoir des événements et si les événements sont obligatoires dans une catégorie

Les « nice to haves » :

• Les métadonnées d’événement dans le sujet n’apparaissent/ne sont saisies qu’en haut du sujet (au lieu de là où se trouve le curseur)
• possibilité de limiter quels groupes peuvent créer des événements dans une catégorie (par exemple, seul le groupe « EventPlanners » peut créer des événements dans la catégorie « Discussion », mais tous les utilisateurs peuvent créer des sujets non événementiels (ou modifier des sujets si le sujet est défini sur Wiki))
• changer l’URL de /upcoming-events en /calendar

[pokapow]

Bonjour,
Merci pour ce travail.

J’ai 2 questions UX :

• Est-il possible d’afficher le bouton « Ajouter un événement » à côté du bouton « Ajouter un lieu » dans l’éditeur de sujet ? Comme c’était le cas avec le plugin pavillion ?
  

• Est-il possible d’ajouter une entrée de menu supérieur Calendrier ? Je ne la trouve pas dans les paramètres
  

  

[AstonJ]

Cela semble excellent ! Quelques réflexions/questions :

Suis-je dans l’erreur en supposant que pour créer un calendrier, il suffit de créer un nouveau fil de discussion/sujet et d’y coller ceci :

Nom du Calendrier 

[calendar]
[/calendar]

Ensuite, pour ajouter des entrées au calendrier, il suffit de faire un nouveau message dans le même fil de discussion avec quelque chose comme ceci (en cliquant sur l’icône insérer date/heure dans les options de publication) :

Nom de l'événement/de l'entrée

[date-range from=2024-04-18 to=2024-04-19 timezone="Europe/London"]

Cela ajoute l’entrée au calendrier, ce qui est génial, cependant :

• Y a-t-il un moyen d’ajouter des entrées à un calendrier tout en permettant à ces entrées d’avoir également un fil de discussion/sujet dédié ? (Je vois que l’on peut ajouter des événements dans de nouveaux fils de discussion, mais il ne semble y avoir aucun moyen d’ajouter ces événements à un calendrier).
• Y a-t-il un moyen de mettre en avant les « Événements à venir » d’un calendrier spécifique dans les e-mails récapitulatifs ? Ou peut-être dans la colonne de gauche, et que chaque entrée soit liée au fil de discussion dédié pour cette entrée ?

Si ce n’est pas possible actuellement, avez-vous des projets pour l’ajouter ?

[haozi (耗子)]

@vinothkannans Pourriez-vous m’aider à examiner cette PR ?

FEATURE: add China holidays and region

[putty]

Y a-t-il des projets pour ajouter un flux URL auquel les utilisateurs peuvent s’abonner ? Je suis sûr que ce serait délicat pour tous les événements par rapport à ceux auxquels ils ont répondu.\n\nDeuxièmement, une couche supplémentaire serait incroyable si elle pouvait reconnaître les événements privés (ou peut-être s’agit-il simplement d’un flux URL différent par groupe).

[jordan-violet]

@putty

Y a-t-il des projets pour ajouter un flux d’URL auquel les utilisateurs peuvent s’abonner ? Je suis sûr que ce serait délicat pour tous les événements par rapport à ceux auxquels ils ont répondu.

Finding Discourse RSS feeds

A reference list of all the RSS feeds available in Discourse. Required user level: All users Here’s a list of most of the available RSS feeds in Discourse. RSS is a standardised, computer-readable format for content that allows it to be shared between sites and platforms easily. RSS links that contain an ID (categories, topics, badges, etc.) are defined by their ID. The links won’t break if the slug part of the URL changes, but the slug…

Il n’y a cependant pas de flux RSS pour l’URL /upcoming-events — ce serait un ajout intéressant !

[pokapow]

Qu’en est-il de la synchronisation CalDAV ?

[Matthias_Schuster (Matthias)]

Ce serait aussi pour moi une raison de changer, en effet.

[Heliosurge (Dan DeMontmorency)]

Cela nécessite plus de mises à jour car cela mentionne une insertion d’événement dans le compositeur et l’ajout de détails d’événement non tels qu’illustrés. À moins que l’événement ne soit un module complémentaire ?

[Isambard]

J’ai installé le plug-in et la balise calendrier fonctionne dans le premier message d’un sujet. Mais je ne vois aucune option d’événement ou de calendrier dans le menu d’engrenage :

Quelqu’un peut-il m’expliquer ce que je dois faire pour obtenir l’option d’événement dans le menu d’engrenage ?

[JammyDodger]

Vous devez activer la partie Événement du plugin discourse post event enabled

[Isambard]

Merci. J’ai d’une manière ou d’une autre manqué ce paramètre.

[Heliosurge (Dan DeMontmorency)]

Comment créer un événement pour qu’il s’affiche dans un sujet de catégorie avec des réponses qui sont des événements ?

Je vois que la création d’événement fonctionne pour la création de nouveaux sujets. Mais je cherche à avoir un calendrier dans un sujet où les réponses ajoutent des événements. Cela fonctionne partiellement avec l’insertion de date, mais ce n’est pas aussi bien que la création d’événement qui offre plus d’options.

[eve (Phú)]

Actuellement, les utilisateurs peuvent définir la région dans les préférences de leur profil.

J’aimerais leur permettre de définir leur région lors de l’inscription en affichant ce champ dans le formulaire d’inscription. Est-ce réalisable ?

[joo (slower)]

Une réponse supprimée apparaîtra-t-elle toujours dans le calendrier ?

[tonninseteli (se oli tonnin seteli)]

Je ne trouve aucun paramètre pour changer le premier jour de la semaine en lundi, est-ce facile à implémenter s’il manque ?

Un autre problème est que la saisie de l’heure et de la date est cassée, s’il s’agit d’un événement d’une journée entière, il devrait y avoir une option pour le sélectionner avant que les champs de saisie de l’heure ne gâchent les dates, et les dates semblent changer aléatoirement lors de la modification.

J’ai également remarqué qu’il est possible d’entrer 00:00 dans l’heure et la date, (ce qui fonctionne parfois, parfois pas) ce qui entraîne une erreur du calendrier qui provoque alors un conflit avec les brouillons, entraînant une erreur 422 répétée jusqu’à ce que la page soit restaurée à une révision antérieure, puis rééditée, etc.

[joo (slower)]

[quote=“slower, post:10, topic:277113, full:true, username:joo”]
Lorsque j’active cette automatisation, le contenu « Dernière modification par » est automatiquement ajouté au calendrier. Je cherche des conseils pour savoir s’il s’agit d’un bug ou d’un problème avec mes paramètres. Quelqu’un pourrait-il m’aider à clarifier ?

[/quote]Veuillez vous référer ici

[Jagster (Jakke Flemming)]

@tonninseteli

Je ne trouve aucun réglage pour changer le premier jour de la semaine en lundi, est-ce trivial à implémenter s’il manque ?

Il n’y a pas de tel réglage et c’est pourquoi je ne l’utilise pas. Et je parie que l’équipe corrigerait cette erreur si c’était une astuce triviale.