Calendar Discourse - Comment faire ?

[ben_t (Ben)]

Bonjour à tous,
Je suis un nouvel installateur/mainteneur de Discourse, mais un utilisateur depuis longtemps.
Je me sens un peu perdu face à certains plugins et au manque apparent de documentation. Pour l’instant, mon attention se porte sur le plugin Discourse Calendar.
J’ai trouvé deux sujets :
Le plugin lui-même : Discourse Calendar
Une demande d’aide : How to use the calendar plugin?

Aucun des deux n’explique vraiment comment utiliser le plugin, si ce n’est pour créer le calendrier principal dans le premier message et ajouter des événements dans les réponses à ce même message.
Les captures d’écran montrent plusieurs couleurs, ce qui me fait penser qu’il pourrait exister un moyen pour un calendrier de s’alimenter à partir de plusieurs catégories.

Dans les paramètres du plugin, il y a aussi le paramètre calendar categories, mais je ne suis pas sûr de savoir comment l’utiliser. J’ai réussi à faire apparaître un calendrier en haut d’une page d’affichage de catégorie, mais il est vide.
J’utilise actuellement categoryId=7;postId=19 où la catégorie 7 est celle en haut de laquelle je veux que le calendrier s’affiche. Ensuite, je ne suis pas clair sur le postID. J’ai essayé avec un message contenant un événement, puis avec un message ayant un calendrier en premier message et des dates en réponses. Le calendrier apparaît en haut de la catégorie (dans une boîte déformée et non défilante), mais aucun événement ne s’affiche, quel que soit le postID utilisé.

Le texte d’aide propose également : Autres paramètres valides : tzPicker, weekends et defaultView.
mais sans explication sur leur fonctionnement, leur utilité ou comment les utiliser.

En résumé, je cherche des pistes ou des liens vers des ressources expliquant le plugin avec plus de détails.

L’objectif final est d’avoir un calendrier capable de lire plusieurs messages au sein d’une catégorie. Ce que je fais actuellement, c’est d’indiquer aux utilisateurs de créer deux messages. Créer un nouveau sujet et y ajouter un événement. Inclure la description de l’événement, etc. C’est le fil de discussion dédié à cet événement.
Ensuite, je leur demande de copier le lien de ce sujet, d’aller dans le sujet épinglé « Calendrier principal des événements » et d’y répondre en insérant une date, puis en collant le lien vers l’événement. Ainsi, le calendrier du sujet « Calendrier principal des événements » contient tous les événements, mais il existe des sujets séparés permettant la discussion autour de chaque événement.

J’ai l’impression qu’il doit exister une meilleure méthode, mais je ne sais pas laquelle.

Merci beaucoup pour toute information.

[Benjamin_D (Benjamin Decotte)]

Salut !
Le Postid se trouve dans le JSON et correspond à l’ID du post où le calendrier est déclaré (et non l’ID du sujet).

Concernant les événements codés par couleur, je pense qu’ils proviennent (pour l’instant ) du plugin events (mais j’aurais pu manquer un commit !).

Et peut-être que cela répondra à certaines de vos questions :

@angus

Si vous installez uniquement le plugin discourse-calendar (et rien d’autre), il existe trois types d’éléments liés au temps que vous pouvez ajouter à l’éditeur de Discourse : [event], [calendar] et [date]. Les cas d’utilisation de ces éléments et leur interaction deviennent un peu confus si vous n’êtes pas déjà familier avec les plugins eux-mêmes et avec Discourse en général.

Par exemple, le plugin discourse-calendar existant vous oblige à créer des [dates] dans des posts du même sujet que le [calendar]. Cette fonctionnalité [event] (qui fait partie du même plugin) vous oblige à créer des [events], qui sont différents des [dates], mais qui sont également ajoutés à un calendrier qui ressemble exactement au [calendar] spécifique au sujet incluant les [dates], tout en se comportant de manière très différente.

[ben_t (Ben)]

Merci beaucoup. C’était bien PostID contre TopicID qui posait problème. Cela a tout éclairci. J’aimerais toujours qu’il existe une « page de manuel » ou quelque chose d’équivalent pour toutes les variables et entrées possibles du plugin, mais je continuerai à l’explorer.

Merci également pour le lien vers le plugin Événements. Comme le mentionne l’article vers lequel votre lien pointe, il est déroutant de voir comment Calendrier, Date et Événement sont liés ou non, surtout que le plugin Événements fait partie du plugin Calendrier.

[runinsideout (Chris O)]

@ben_t, votre cas d’usage décrit exactement le type de fonctionnalité que j’espérais… Divers groupes pourraient avoir des fils de discussion sur leurs événements, mais grâce à la création de leur événement dans leurs sujets, ils alimenteraient le calendrier Maître des événements qui regroupe tous les événements de tous les groupes. Ensuite, les lecteurs du calendrier principal des événements pourraient cliquer sur n’importe quel élément du calendrier et être redirigés vers le fil de discussion correspondant à l’événement.

Ne me méprenez pas, tel quel, je comprends l’idée d’un événement dans un fil qui n’apparaît pas dans le calendrier principal des événements (par exemple, un petit groupe organisant des réunions de planification en amont du grand événement prévu au calendrier principal),

Cependant, je pense que notre cas d’usage serait une excellente fonctionnalité à avoir, car je vois plusieurs applications possibles (calendriers sportifs scolaires, tableaux d’affichage communautaires…)

En passant, j’ai découvert une autre méthode pour créer le sujet où vous placez le calendrier dans le premier message, puis vous répondez au calendrier avec des dates qui sont ajoutées au message principal… sans avoir à aller dans les paramètres ni compter les numéros de fil…

Quelque part dans le premier message, mettez :

[calendar]
[/calendar]

J’ai trouvé cela sur la [page github|Discourse Calendar (and Event)].
Je pense que cela a peut-être été ajouté après votre publication.

… Je m’en vais maintenant régler cette histoire de couleurs !

[jrgong]

@Benjamin_D

Postid se trouve dans le json et est l’Id du post où le calendrier est déclaré (pas l’Id du sujet)

Quelqu’un peut-il partager les étapes pour trouver le Postid afin de déclarer le calendrier ? Je suis bloqué à cette étape et j’apprécierais vraiment l’aide.

Edit : je l’ai trouvé ! Au cas où quelqu’un aurait des difficultés, vous pouvez suivre les étapes suivantes pour trouver le postId. Prenons ce sujet comme exemple :

https://meta.discourse.org/t/discourse-calendar-how-to/165536/5

1. Supprimez le slug du sujet pour qu’il ressemble à ceci : https://meta.discourse.org/t/165536/5
2. Supprimez le numéro du post à la fin (/5) et remplacez-le par /posts.json, de sorte que l’URL ressemble à ceci ;
   https://meta.discourse.org/t/165536/posts.json
3. Ouvrez l’URL et vous trouverez le postId requis sur la première ligne :
   
   
4. Collez l’URL dans les paramètres du plugin calendrier, donc dans notre exemple, cela ressemblerait à ceci :
   
   
5. Votre calendrier dans la catégorie devrait maintenant afficher toutes les entrées [date] de ce sujet.

[Tara_Walton]

@ben_t

Le texte d’aide propose également Other valid settings: tzPicker, weekends and defaultView.
mais aucune explication sur la façon dont ils fonctionnent, ce qu’ils font ou comment les utiliser.

Quelqu’un peut-il répondre à ce que sont ces paramètres ? Je n’ai pas pu trouver de référence à ceux-ci, sauf dans ce message et il n’y a aucune explication.

[Benjamin_D (Benjamin Decotte)]

[calendar weekends="false"]
[/calendar]

masquerait les week-ends

[calendar defaultView="listNextYear"]
[/calendar]

afficherait la vue de liste par défaut (les autres options sont month ou basicWeek)

[calendar tzPicker="true"]
[/calendar]

permettrait à l’utilisateur de choisir le fuseau horaire dans le coin supérieur droit du calendrier

[Tara_Walton]

Utile, mais cela signifie-t-il que ces informations pour le réglage ne sont pas applicables, ou cela définit-il simplement le réglage par défaut pour le calendrier dans le message spécifié ?

[Benjamin_D (Benjamin Decotte)]

Désolé, je ne suis pas sûr de comprendre la question
Je dirais que les paramètres sont définis par élément, c’est-à-dire pour un calendrier (qui se trouve dans la publication spécifiée)

[Tara_Walton]

Mes excuses pour la confusion.
Dans les paramètres du calendrier Discourse, vous voyez l’image que j’ai postée précédemment.
Elle nécessite le categoryId et le postID, puis indique les autres paramètres valides, mais pas ce qu’ils font dans ce cas.

Je me demande s’il s’agit d’un problème de texte d’aide incorrect ou d’une mauvaise compréhension du fonctionnement de ces paramètres en relation avec le paramètre “catégories du calendrier”.

D’après mes essais, je ne vois rien se passer, mais je pourrais me tromper.

[Benjamin_D (Benjamin Decotte)]

@Tara_Walton

Mes excuses pour la confusion.

Oh, pas de souci, mon anglais est comme du gruyère, plein de trous, d’où mon interrogation.

@Tara_Walton

D’après mes essais, je ne vois rien se passer.

Je pense que cela devrait fonctionner sans les guillemets doubles, par exemple :
categoryId=31;postId=4867;tzPicker=true;weekends=false

[Ethsim2 (Ethan)]

@jrgong

Au cas où quelqu’un aurait du mal, vous pouvez suivre les étapes suivantes pour trouver le postId

J’ai constaté que vous aviez changé
meta.discourse.org/t/discourse-calendar-how-to/165536/6
en
meta.discourse.org/t/discourse-calendar-how-to/165536.json

[Heliosurge (Dan DeMontmorency)]

D’accord. Je pense que parfois les instructions sont écrites du point de vue d’un développeur et nécessitent plus d’informations étape par étape et d’images pour un profane. Le calendrier pourrait peut-être utiliser un #composant-thème pour clarifier la configuration au sein d’un sujet ou quelque chose de similaire.

[Ethsim2 (Ethan)]

Je n’ai finalement pas utilisé le calendrier “About-Topic”, car la façon la plus simple de créer un événement est toujours le premier message d’un sujet, et vous l’utiliseriez de toute façon pour le calendrier, pas pour les événements.

J’ai pu modifier le premier message des sujets existants dans les sous-catégories, puis la couleur des sous-catégories s’est affichée dans le calendrier affiché de la catégorie parente.

De plus, vous avez mentionné un composant de thème, ce qui suggère une ajustabilité ; le calendrier dont je parle, celui implémenté par le paramètre d’administration Events Calendar Categories, j’aimerais pouvoir l’ajuster :

• La taille du calendrier sur le site de bureau, le site mobile semble correct
• Le jour de début de la semaine

Je n’énumère pas trop de choses ici car je ne veux pas décourager les gens, j’imagine qu’il y a eu des problèmes de développement qui ont nécessité différentes manières pour un superutilisateur d’implémenter discourse-calendar.

[Heliosurge (Dan DeMontmorency)]

Autant que j’ai pu observer, je n’ai pas vu de composant compagnon pour le calendrier TC. Vous pourriez cependant être en mesure de créer un Theme component personnalisé en utilisant l’inspecteur d’éléments de votre navigateur pour identifier et ajuster la taille du calendrier sur le bureau. Assurez-vous simplement de le placer dans l’en-tête CSS du bureau.

L’équipe a récemment publié un plugin compagnon pour les flux en direct. Cela pourrait vous intéresser. Il utilise le chat et le calendrier.

Discourse Livestream

Summary Discourse Livestream allows you to create Livestream topics that let your users join and participate in chat Repository Link https://github.com/discourse/discourse-livestream Install Guide How to install plugins in Discourse Features [A screenshot of a Discourse forum with a YouTube video titled "Rick Astley - Never Gonna Give You Up" in the center. (Captioned by AI)] Open any topic to start a livestream event. …

[Ethsim2 (Ethan)]

Bien, j’aime ce plugin, ce n’est pas quelque chose que je fais assez souvent je suis plutôt du genre forum privé. Peut-être qu’un jour j’aurai assez d’argent pour faire du streaming de révisions de physique

Tant pis pour le calendrier par catégorie parente, ce serait bien si Uncategorized (potentiellement ?) affichait un calendrier sur la page d’accueil (ou la catégorie General), et fusionnait les événements de toutes les autres catégories.