 |
Résumé | Discourse Calendar and Event ajoute des fonctionnalités de calendrier et d’événements dynamiques et interactives à votre site Discourse. |
 |
Guide d’installation | Ce plugin est intégré au cœur de Discourse. Il n’est pas nécessaire d’installer le plugin séparément. |
Activation du calendrier (et des événements)
Le plugin Calendar peut être activé soit par l’interrupteur, soit via ses paramètres, tous deux accessibles depuis votre page admin/plugins :
Fonctionnalités
Sans grande surprise, Discourse Calendar (et Event) ajoute à la fois les fonctionnalités de calendrier et d’événements à votre site Discourse. Avec celles-ci, vous pouvez créer des calendriers de sujets individuels pour suivre des occasions ou des chronologies importantes, afficher des calendriers dans les catégories, ajouter un calendrier des fêtes pour marquer les vacances, les absences ou les arrêts 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 :
Événements
La fonctionnalité Event permet d’insérer des éléments interactifs dans les sujets, que vos membres peuvent utiliser pour s’inscrire à des activités de votre communauté ou y participer. Tous 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 :
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 de la balise [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’émoji utilisé pour le statut de jour férié. |
| delete expired event posts after | Les messages avec des événements expirés seront automatiquement supprimés après (n) heures. Définir sur -1 pour désactiver la suppression. |
| all day event start time | Les événements pour lesquels aucune heure de début n’est spécifiée commenceront à cette heure. Le format est HH:mm. Pour 6 h 00, saisissez 06:00. |
| all day event end time | Les événements pour lesquels aucune heure de fin n’est spécifiée se termineront à cette heure. Le format est HH:mm. Pour 18 h 00, saisissez 18:00. |
| calendar categories | Affiche un calendrier en haut d’une catégorie. Les paramètres obligatoires sont categoryId et postId. Par ex. : categoryId=6;postId=453[1]. Autres paramètres valides : tzPicker[2], weekends[3] et defaultView[4]. |
| calendar categories outlet | Permet de modifier le module (outlet) qui affichera le calendrier de la catégorie. |
| working days | Définir les jours ouvrables. Vous pouvez afficher la disponibilité d’un groupe en utilisant la balise timezones dans un message, par ex. : [timezones group=admins][timezones] |
| working day start hour | Heure de début des heures de travail. |
| working day end hour | Heure de fin des heures de travail. |
| close to working day hours extension | Définir le temps d’extension dans les heures de travail pour mettre en évidence les fuseaux horaires. |
| calendar automatic holidays enabled | Définir automatiquement le statut de jour férié en fonction de la région de l’utilisateur (note : vous pouvez désactiver des jours férié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énements. 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 sur 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 | Étend (en minutes) la période après la fin d’un événement pendant laquelle les invités going continuent d’être notifiés des modifications dans le message original. |
| discourse post event allowed custom fields | Permet à chaque événement de définir la valeur des 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 possibilité pour les utilisateurs de trier sur la catégorie d’événement. |
| sidebar show upcoming events | Affiche le lien des événements à venir dans la barre latérale sous “Plus”. Nécessite post event enabled. |
| map events to color | Attribue une couleur d’événement à un tag ou une catégorie spécifique |
Le point de terminaison
discourse-post-event/events.jsondispose désormais d’un paramètre ajouté pour basculer entre une réponse simple et détaillée. Pour obtenir la réponse détaillée, vous pouvez ajouter?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. Vous devrez vous assurer que l’itinéraire souhaité est activé 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 voulez pas 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
categoryId est la catégorie sur laquelle le calendrier sera affiché en haut.
postId est le message dans lequel vous avez placé le calendrier avec[calendar][/calendar]. ↩︎il peut afficher un sélecteur de fuseau horaire en haut à droite du calendrier. Par défaut à False, vous pouvez l’activer avec
tzPicker=true. ↩︎il peut masquer les samedis et dimanches du calendrier. Par défaut à True. Vous pouvez le définir sur False avec
weekends=false. ↩︎defaultView définira 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↩︎