Veuillez mieux documenter le plugin Discourse Calendar

[mattdm (Matthew Miller)]

Continuant la discussion de Discourse Calendar — car mon message là-bas sera bientôt automatiquement supprimé après un mois.

Le message principal décrivant ce plugin a besoin d’être retravaillé. C’est vraiment confus. Spécifiquement :

Confusion des événements

Il semble y avoir trois choses distinctes appelées « événement » :

1. Le plus basique : une réponse avec une [date], qui est affichée dans un calendrier dans le premier message du sujet.
2. Un premier message dans un sujet qui contient [event], utilisé par la fonctionnalité optionnelle « état alpha » décrite séparément ici.
3. Un plugin complètement séparé avec un nom similaire : Events instead of Event.

C’est… confus.

Syntaxe peu claire pour l’événement simple dans un seul sujet

1. Comment définir le nom de l’événement ? La description du plugin montre du texte avec des événements, mais pas comment cela a été réellement défini.
2. Comment créer des événements récurrents ?
3. Le calendrier des jours fériés affiche des couleurs. Le calendrier régulier peut-il aussi avoir des couleurs, et si oui, comment ?
4. La fonctionnalité « events » séparée peut apparemment produire un flux ical. Un calendrier « basique » le peut-il ?

Plus de questions sur le calendrier des jours fériés

Utilise-t-il la même syntaxe que le calendrier par sujet, ou celle de « event » ? Est-il limité aux « vacances du personnel », ou pourrait-il être utilisé par quiconque peut répondre à un sujet donné ? D’où viennent les couleurs ? L’emoji « Flair des vacances » est-il modifiable ? Est-il possible de le rendre visible à n’importe qui, ou à un groupe arbitraire, pas seulement au personnel ?

Etc…

J’ai trouvé la réponse à certaines de ces questions par moi-même ou en demandant de l’aide. Mais cela doit vraiment être documenté dans le sujet de documentation du plugin.

Il serait probablement aussi bon d’expliquer certaines des limitations — le jour de début de semaine ne suit pas votre locale et n’est pas configurable, l’ensemble est confus sur les fuseaux horaires… et s’il y a une feuille de route ou des plans pour aborder certains de ces points ou ajouter de nouvelles fonctionnalités (ou s’il n’y en a pas !), veuillez également le préciser.

Merci ! C’est une petite fonctionnalité Discourse astucieuse qui pourrait être très utile à beaucoup de gens, mais elle est aussi assez confuse.

[nathank (Nathan Kershaw)]

Ce post est un wiki - vous pouvez donc y apporter vos propres contributions facilement. Ce serait très utile pour tous.

[mattdm (Matthew Miller)]

Je peux, bien que certaines choses ne seront que des suppositions !

[JammyDodger]

J’ai repéré ceci dans les sujets connexes lors d’un rafraîchissement des sujets Calendrier et Événement (encore une victoire pour les sujets connexes )

Je viens de les réorganiser de sorte que les deux fonctionnalités apparaissent maintenant correctement comme un seul sujet de plugin, ce qui devrait, espérons-le, dissiper une partie de la confusion :

Discourse Calendar (and Event)

Summary Discourse Calendar and Event adds dynamic and interactive calendar and event features to your Discourse site. Install Guide This plugin is bundled with Discourse core. There is no need to install the plugin separately. Enabling Calendar (and Event) The Calendar plugin can be enabled either by the toggle or from its settings, both accessible from your admin/plugins page: [/admin/plugins] Features Somewhat unsurprisingly, Discourse Calendar …

J’ai également divisé bon nombre des détails « comment faire » en quelques guides pour leur donner un peu d’espace :

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…

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 Event) plugin. To use this feature: Enable the Calendar (and Event) plugin Configure related settings For detailed instruct…

L’objectif principal était de leur donner une structure plus cohérente (bien que j’aie ajouté un petit rafraîchissement pour faire bonne mesure). Ils étaient un peu épineux à lisser, mais je pense qu’ils sont dans un meilleur état qu’auparavant. Après y avoir réfléchi, je pense qu’il y a encore quelques choses que j’aimerais faire, donc je ne vais pas encore sortir la .

Mais j’espère que nous allons dans la bonne direction.