Création et gestion des calendriers

[Discourse]

Ce guide explique comment créer et gérer des calendriers dans Discourse en utilisant le plugin Calendar (et Event).

Niveau d’utilisateur requis : Tous les utilisateurs

Les calendriers sont une fonctionnalité puissante de Discourse qui vous permet d’organiser et d’afficher des événements au sein de votre communauté. Ce guide vous expliquera 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 (et Event)” est activé sur votre instance Discourse. Pour plus de détails sur l’activation du plugin et ses paramètres associés, veuillez consulter 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 premier jour de la semaine est défini par défaut sur Lundi, mais peut être configuré en utilisant le paramètre de site “calendar first day of week” (options : Samedi, Dimanche ou Lundi).

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;tzPicker;defaultView=month
   

   • Remplacez 123 par l’ID de votre catégorie (trouvé dans l’URL lors de la visualisation 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. Ouvrez le menu d’options ⊕ dans la barre d’outils du compositeur et utilisez la fonction “Insérer date / heure” 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 avoir rechargé le 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. Ouvrez le menu d’options ⊕ dans la barre d’outils du compositeur et sélectionnez “Create event” (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 en utilisant 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="month"	Options : month, week, listNextYear
Ignorer les fuseaux horaires	fullDay="true"	Traite tous les événements comme des événements de journée entière

Exemple d’utilisation :

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

Suppression d’éléments de calendrier

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

• Les éléments de calendrier expirés peuvent être automatiquement supprimés en utilisant le paramètre “delete expired event posts after” (supprimer les messages d’événement expirés après)
• Utilisez les minuteries de sujet pour supprimer automatiquement les réponses
• Supprimez manuellement les messages selon les besoins

Calendrier des jours fériés

Le calendrier des jours fériés est une fonctionnalité spéciale pour gérer les congés 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 répond
4. Chaque réponse doit contenir un horodatage ajouté via la fonction “Insert date / time” dans le menu d’options ⊕ du compositeur pour apparaître sur le calendrier
5. Les entrées de vacances sont colorées automatiquement et de manière aléatoire
6. Un emoji (par défaut : ) apparaît à côté des noms des utilisateurs en vacances dans les cartes utilisateur et les @mentions
7. 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 fuseau horaire.

Q : Puis-je contrôler les couleurs des entrées de calendrier ?
R : Pour les calendriers de catégorie et les événements à venir, vous pouvez attribuer des couleurs par balise ou par catégorie en utilisant le paramètre de site “map events to color”. Les entrées du calendrier des jours fériés sont colorées automatiquement et de manière aléatoire et ne peuvent pas être personnalisées.

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

Ressources supplémentaires

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

[hellekin]

J’ai du mal à comprendre comment créer un calendrier pour qu’il s’affiche dans une catégorie, et quoi faire pour le remplir une fois qu’il est là. Pour les sujets, c’est assez simple, mais le cas de la catégorie est plus obscur. Quelqu’un peut-il donner un exemple ?

[hellekin]

Créer un calendrier de catégorie

La différence entre un calendrier de sujet et un calendrier de catégorie est que le premier utilise à partir de la réponse d’un sujet spécifique, et affiche le calendrier dans le sujet lui-même, tandis que le second utilise dans n’importe quel sujet de la catégorie configurée, et affiche le calendrier des événements dans la catégorie.

1. Activer le plugin de calendrier

Dans /admin/site_settings/category/discourse_calendar?filter=plugin%3Adiscourse-calendar → calendar categories:
Vous voulez quelque chose comme : categoryId=123;postId=4949;tzPicker;defaultView=month

• categoryId est facile à trouver : c’est le nombre dans l’URL lorsque vous cliquez sur le #category

• postId peut être trouvé comme ceci : allez à la description de la catégorie (le sujet épinglé “À propos de la catégorie”) et ajoutez .json à l’URL : le postId se trouve au début du fichier JSON.

• Consultez la documentation de discourse-calendar pour les options disponibles.

• Ajoutez la catégorie (numérotée 123 dans notre exemple) à events calendar categories
  Vous voudrez peut-être définir discourse post event allowed on groups pour inclure les groupes que vous souhaitez autoriser à ajouter des événements.

2. Créer un événement

Vous pouvez créer un nouveau sujet dans la catégorie 123 et (depuis le bouton d’engrenage).
L’événement apparaîtra alors sur le calendrier de la catégorie.

[jrgong]

Existe-t-il un moyen d’afficher non pas les événements à venir, mais ceux de l’année écoulée ? Nous aimerions utiliser le plugin pour notre section de journal et lister toutes les entrées passées dans le premier article.

Lorsque vous utilisez l’extrait ci-dessous, la liste des événements est initialement vide. Ce n’est qu’en revenant à la vue mensuelle, en reculant d’un mois et en revenant à la vue liste que cela fonctionne.

[calendar defaultView=listNextYear fullDay=true]
[/calendar]

Voir le bug en action :

[Heliosurge (Dan DeMontmorency)]

Je suis également intéressé par cette fonction.

Je me demande s’il pourrait également y avoir des scripts d’explorateur de données pour accompagner la recherche par calendrier.

[Ryan_Scott]

Lorsqu’une personne de ma communauté publie un événement de calendrier, puis qu’un administrateur modifie cet événement, pourquoi le créateur original ne peut-il plus le modifier ?

C’est un problème majeur qui affecte des centaines de personnes.

[BetterSergio (Sergio)]

Clarifiez que pour l’instant, seul le calendrier des sujets commence le lundi et que le calendrier des catégories commence le dimanche à la place.

J’aimerais que cela soit configurable par l’administrateur, car chacun affiche le calendrier différemment…

[Сергей_Белошицкий]

Uh-huh. Cela a du sens, parce que je ne réalisais pas–

[opcourdis]

Pour que les vacances soient visibles dans le calendrier des vacances, il est utile de mentionner que la réponse doit contenir un horodatage que vous ajoutez depuis le menu des éditeurs.
De plus, comme indiqué précédemment, l’identifiant de la publication se trouve en ajoutant .json à l’URL de la publication. Je pense que cela devrait être ajouté à la documentation ici car si les catégories ont leur identifiant dans l’URL, l’identifiant de l’URL du sujet confondra les gens car son numéro peut être proche mais pas similaire au véritable identifiant du sujet.

Merci pour ce guide de toute façon, il y a beaucoup à couvrir car il y a de nombreuses fonctionnalités, ce qui est cool, excellent travail les développeurs !

[JammyDodger]

@Discourse

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

Ahh, la réécriture par l’IA a ajouté une terminologie « événement ». Idéalement, ce terme devrait être évité dans la partie « Calendrier » de la documentation afin de ne pas créer d’ambiguïté avec la fonctionnalité « Événement » supplémentaire du plugin.

[jerry_zen]

@Discourse

discourse-calendar

Je voudrais demander que mon discourse n’ait pas de calendrier ni de bouton d’engrenage après avoir activé le plugin, y a-t-il quelque chose qui ne va pas ?

[Moin]

L’icône d’engrenage a été remplacée par il y a quelque temps. Je pense que l’insertion de date a été déplacée dans ce menu plus (je pense qu’elle utilise également l’icône maintenant).

C’est certainement un très bon point. Il semble que cette documentation doive être mise à jour (et il y a probablement aussi d’autres sujets qui font encore référence à l’icône d’engrenage).

[jerry_zen]

Merci pour la réponse, et j’ai ensuite réalisé une autre erreur liée à cela. J’ai cette icône, mais elle est plus grande et au mauvais endroit, bloquant, comme vous pouvez le voir. C’est normal sur le téléphone, mais pas sur le bureau. D’ailleurs, pas de calendrier mais des événements dans la liste. Que puis-je faire

[Moin]

Le mode sans échec corrige-t-il la position de l’icône plus ?

@jerry_zen

pas de calendrier mais des événements dans la liste

À quel bouton de calendrier vous attendez-vous ?

@Discourse

Calendrier du sujet

Pour ajouter un événement au calendrier d’un sujet :

1. Répondez au sujet contenant le calendrier
2. Utilisez la fonction Insérer une date dans le compositeur pour ajouter une date ou une plage de dates
3. Ajoutez une description au-dessus de la date
4. Soumettez la réponse

Celui-là est maintenant

@Moin

[jerry_zen]

J’ai ce bouton d’insertion, comment puis-je ensuite publier un calendrier ? J’ai essayé le code [calendar], cela fonctionne, mais la date/l’heure inclut-elle le calendrier ?

Pour le gros bouton, j’ai essayé le mode sans échec, et c’est toujours comme ça. La reconstruction de l’application ne fonctionne pas, puis-je espérer que la prochaine mise à jour de la version corrigera cela ? Ou y a-t-il quelque chose que je puisse faire, à part tout refaire depuis le début

[ToddZ]

@Ryan_Scott

…puis un administrateur modifie ledit événement, pourquoi alors l’auteur original ne peut-il plus modifier ?

Ce paramètre semble être le coupable probable :