Collections

Personnalisation Greffon
1
:information_source: Résumé Les utilisateurs créent des collections de sujets liés
:hammer_and_wrench: Lien du dépôt https://github.com/Alteras1/discourse-collections
:open_book: Guide d’installation Comment installer des plugins dans Discourse

Aperçu

Mobile

Collections

Cette fonctionnalité permet aux utilisateurs de créer des collections de sujets visibles lors de la consultation de ces derniers. Les collections peuvent inclure n’importe quelle URL et seront visibles sur tout sujet lié. Les collections peuvent être organisées en sections, et toute modification apportée à une collection est reflétée sur tous les sujets liés. Il n’y a aucune restriction sur le sujet à lier, ce qui permet aux utilisateurs de créer une collection à travers différentes catégories/étiquettes.

Titre et description

Champ facultatif disponible pour la saisie. S’ils sont fournis, ils seront affichés en haut de la liste.

Sections

Fonctionnalité d’organisation facultative. En ajoutant un en-tête de section, la collection peut être divisée en sections, permettant l’affichage de sections réductibles.

Sous-collections

Les utilisateurs peuvent également créer une sous-collection, qui n’est affichée que pour un seul sujet, permettant aux utilisateurs de lier des URL pertinentes (c’est-à-dire des messages spécifiques/ressources externes) uniquement pour ce sujet unique. Les URL de sujet ajoutées ne seront pas liées.

Autorisations

Le plugin permet à tout utilisateur de créer une collection pour ses propres sujets. Par défaut, les utilisateurs ne peuvent lier que leurs propres sujets et doivent ajouter d’autres utilisateurs en tant que responsables, qui peuvent ajouter leurs propres sujets à la collection. Ce paramètre peut être désactivé, permettant uniquement à des groupes spécifiques d’avoir un contrôle total sur n’importe quelle collection (par défaut Staff & TL4).

Démonstration des autorisations

Paramètres

Nom Description
collections enabled Activer/désactiver le plugin. Par défaut : true
collection by topic owner Autoriser le créateur du sujet à créer des collections. Par défaut : true
collection by topic owner allow groups Restreindre les créateurs de sujets autorisés à créer des collections. Limite collection by topic owner. Par défaut : TL1
subcollection by topic owner allow groups Restreindre les créateurs de sujets autorisés à créer des sous-collections. Limite collection by topic owner. Par défaut : TL1
collection modification by allowed groups Groupes autorisés à créer/modifier n’importe quelle collection. Par défaut : Admin Moderators TL4.
sections in subcollection Autoriser les en-têtes de section dans les sous-collections. Par défaut : true

Alternatives

Ce plugin est fortement inspiré par (et était à un moment basé sur) le plugin Discourse Doc Categories. Bien que le plugin Doc Categories possède un bon mécanisme d’indexation et un excellent affichage, sa conception était destinée à des pages de style wiki, où tout est compilé dans une seule catégorie. De même, l’indexation repose sur une saisie de texte formaté dans un sujet séparé, ce qui présente ses propres avantages et inconvénients.

Le composant de thème DiscoTOC - automatic table of contents permet également d’organiser des liens en dehors du corps du message, mais est limité à un seul sujet.

Si votre objectif est simplement une organisation de style wiki, Discourse Doc Categories serait plus adapté. Si vous avez juste besoin que certains sujets aient des liens vers d’autres sujets, DiscoTOC - automatic table of contents serait préférable.

Remarques

Ce plugin a été initialement conçu pour soutenir la migration du forum auquel je participe vers Discourse. En tant que forum axé sur l’écriture, les utilisateurs maintiennent des sujets séparés à des fins différentes, ce qui entraîne une situation où les liens entre sujets à travers les catégories sont pratiquement indispensables. Pour faciliter cela, j’ai créé ce plugin pour soutenir l’auto-organisation des utilisateurs.

Il existe une timeline alternative où cela n’est qu’un composant de thème, où l’indexation se ferait via des divs saisies par l’utilisateur contenant des URL vers d’autres messages. Mais après avoir développé 90 % des outils, assistants et code nécessaires, j’ai réalisé que cela ne valait pas la peine et que les utilisateurs ignoreraient probablement tous les tutoriels écrits et se plaindraient quand même du fonctionnement. Cette voie a donc été abandonnée. Honnêtement, ce n’est pas une mauvaise solution, car elle serait bien plus légère qu’un plugin, mais elle aurait imposé aux utilisateurs une charge inutile pour s’assurer qu’ils avaient le bon formatage non pas sur un seul message, mais sur plusieurs.

J’ai actuellement marqué ceci comme experimental, car je ne suis pas encore à 100 % fixé sur les fonctionnalités de l’interface utilisateur (comme les icônes) et le système d’autorisations. De plus, je dois ajouter des tests unitaires automatisés.

21 « J'aime »
Post Collections, Topic-to-Topic Navigation Buttons, Menus, Anchor Links, and Topic TOC
2

Pour information : toutes les vidéos étaient cassées :thinking: (iPad)

1 « J'aime »
3

Ah, je pensais que Safari sur iOS prenait en charge WebM…

J’ai remplacé les vidéos par des MP4. Merci !

5 « J'aime »
4

Est-il possible d’activer les collections « publiques » comme sur Discourse Docs ?

1 « J'aime »
5

Désolé si ce n’était pas clair, toutes les collections sont « publiques ». Tous les utilisateurs verront la même collection sur le même sujet. Ce plugin est destiné à organiser des sujets, pas à être une sorte de « dossier de signets » privé pour les utilisateurs.

Sujet Discourse avec Collection vu par un utilisateur anonyme
Sujet Discourse avec Collection vu par un utilisateur anonyme1920×1243 155 KB

5 « J'aime »
6

Plugin mis à jour avec la prise en charge des emojis et des carrés de couleur dans la barre latérale !

5 « J'aime »
7

Cela semble vraiment tout à fait impressionnant. Et une documentation absolument brillante — cela mérite mon vote pour le plugin Customization le mieux documenté sur meta.discourse.org !

Avez-vous envisagé d’étendre cela pour couvrir également les listes de sujets ?

Je trouve souvent qu’il serait très utile d’avoir une collection de liens par catégorie ou par tag. Un exemple serait une catégorie privée dédiée à un groupe spécifique, qui utilise également d’autres outils (comme quelques dossiers dans Google Docs, un portail gouvernemental local, un canal de chat associé et une boîte de réception de groupe). Il serait idéal que les modérateurs de catégorie en aient le contrôle.

3 « J'aime »
8

Merci beaucoup !

C’est certainement quelque chose que j’ai déjà envisagé, mais je ne pense pas que cela s’intégrerait bien à la conception actuelle qui vise à organiser les sujets par les utilisateurs. Pas idéal pour le niveau de catégorie/étiquette, car il faudrait le limiter au contrôle des modérateurs. Le cas d’utilisation initial était de couvrir le lien de sujets connexes trop volumineux pour 1-2 sujets, mais trop petits pour une étiquette/catégorie.

Il est possible de faire afficher les listes de sujets par indexation dans la barre latérale des catégories via le plugin Discourse Doc Categories, bien qu’avec une méthode de configuration différente. C’est certainement un casse-tête d’avoir deux plugins qui font deux choses très similaires, mais je pense que la philosophie originale de chacun est suffisamment différente pour justifier des approches distinctes.

L’ajout d’une extension de compatibilité pour le Private Topics Plugin est une idée très intéressante du point de vue de l’utilisateur. Je devrai y réfléchir…

Il ne reste plus que le niveau par étiquette. Faire une PR pour Discourse Doc Categories (ou créer un nouveau plugin/TC) pour les étiquettes est une option, mais pas activement dans mes pensées. Peut-être à l’avenir.

9

En fait, cela fonctionnerait probablement bien pour mon cas d’utilisation. Je ne suis pas sûr qu’il soit suffisamment adaptable pour cela cependant (je vais jouer avec plus tard cette semaine).

Cela semble très intéressant. Quel cas d’utilisation avez-vous en tête ?

10

Pour les utilisateurs réguliers, la catégorie avec les sujets privés activés n’afficherait que leurs propres sujets. Je peux donc voir que ce serait l’un des rares endroits où laisser le plugin Collections extraire une collection du niveau des sujets vers le niveau de la catégorie par utilisateur aurait du sens.

Le forum auquel je participe a en fait une catégorie privée que les utilisateurs peuvent utiliser comme terrain de brouillon/test personnel. Et ils créent beaucoup de sujets, donc l’organisation des sujets pilotée par l’utilisateur se produit parfois ici.

11

J’espérais vraiment que ce soit un système de collection où les utilisateurs peuvent créer des catégories et y placer des sujets de leur choix, comme une galerie. Tant pis.

12

Comment est-ce que ce n’est pas ça ?

1 « J'aime »
13

Je suppose que vous ne pouvez pas créer de catégories.

14

J’apprécie vraiment l’interface utilisateur par glisser-déposer de ce Plugin pour créer des séquences arbitraires de Sujets (Topics) comme les chapitres d’un livre, qui peuvent être facilement réorganisées.

J’ai lancé un Composant de Thème (Theme Component) pour ajouter une navigation séquentielle pour les Collections, telle que \text{Précédent} \langle et \text{Suivant} \rangle ainsi que la pagination dans une fenêtre modale (Modal)…

Voici mon dépôt de travail

4 « J'aime »
15

Très nécessaire, j’examine cela aujourd’hui et c’était le dernier composant dont il semblait avoir besoin.

@Alteras J’ai un bug avec le X de fermeture de la modale sur la modale Créer des collections. On peut la survoler et cliquer dessus, mais elle ne ferme pas la modale tant qu’une actualisation de la page n’est pas effectuée.

1 « J'aime »
16

Oooo, c’est un joli concept. J’adore la modale pour visualiser rapidement les différents messages de sujet liés. Cela aide également à informer les utilisateurs qu’il existe une collection pour ceux qui n’ont pas la barre latérale ouverte 24h/24 et 7j/7 ou qui ne la gardent pas ouverte.

Je suis curieux de connaître la décision d’échanger le contenu du message au lieu de simplement rediriger l’utilisateur vers le sujet.

J’aime beaucoup l’idée d’utiliser < Précédent et Suivant > au-dessus de la chronologie pour naviguer entre les sujets sans avoir besoin de la barre latérale. Peut-être pourrait-il être avec la chronologie comme la table des matières (TOC), afin qu’il soit facilement accessible sur les sujets longs avec un premier message sans avoir à remonter… Ou peut-être simplement décorer le message du haut/bas…

Si cela vous convient, j’aimerais explorer l’ajout de certaines de ces idées directement dans le plugin, peut-être avec des paramètres de site supplémentaires pour les administrateurs. Bien sûr, je n’ai aucune objection à avoir un TC construit à partir du plugin, plus de personnalisation pour les utilisateurs. Faites-moi savoir si vous avez besoin d’aide avec votre TC. Vous devriez pouvoir récupérer les informations de collection actuellement affichées à partir du service ember service:collection-sidebar sans avoir à analyser le DOM.

Hmm… c’est vraiment étrange. Je n’arrive pas à le reproduire. J’ai récemment effectué quelques modifications pour mettre à jour le plugin afin de résoudre certains problèmes de dépréciation, cela a peut-être eu un impact ? Veuillez vérifier si le plugin est à jour. Veuillez également partager les détails de votre configuration (navigateur, mobile/bureau, version de Discourse).

3 « J'aime »
17

Je suis obsolète, peut-être c’est pour ça. J’étais encore sur le commit du 6 novembre.
ETA : Oubliez, la mise à jour a résolu le problème.

1 « J'aime »
18

J’aime la rapidité. Ce n’est pas une conception réfléchie.

Puisque l’ordonnancement arbitraire des éléments est l’opportunité ici, où le séquençage n’est décidément pas lié à une chronologie, mon objectif initial est de réutiliser les comportements de menu imbriqués à défilement horizontal de base, comme nous l’avons dans l’affichage des Profils Utilisateurs, par exemple, où, sous le Titre de la Collection (fixe) et la Description (si/quand présente), se trouvent deux rangées à défilement/balayage horizontal – les En-têtes de Section et leurs Titres de Sujets associés en dessous.

multilevel-horizontal-swiping
multilevel-horizontal-swiping648×169 16.3 KB

Également dans la modale se trouve un affichage vertical rétractable (glissement rapide vers l’intérieur/l’extérieur depuis la gauche) reproduisant le comportement de la barre latérale gauche en dehors de la modale.
…

S’il vous plaît, allez-y !

2 « J'aime »
19

Maintenant que cela fonctionne (merci pour l’avertissement concernant la mise à jour ci-dessus), voici quelques points que j’ai relevés :

  1. Le bouton Collections est visible même lorsque l’utilisateur ne fait pas partie des groupes autorisés. Cela entraîne une Erreur de Serveur Interne (affichée avec élégance dans une barre rouge sur la modale) lors de la tentative de création d’une collection.
  2. Dans la barre latérale des collections, le bouton en bas propose l’option originale Créer une collection. Il faut utiliser le bouton sur la publication originale pour la gérer ; il serait très utile d’avoir une option Gérer directement depuis le bouton de la barre latérale de la collection.
  3. Serait-il possible de séparer les permissions pour les Collections et les Sous-collections ? Les sous-collections pourraient être immensément utiles pour les personnes qui souhaitent rassembler des sujets par elles-mêmes, sans l’impact généralisé qu’une Collection a sur tous les sujets liés.

Enfin, comment ce plugin gère-t-il deux collections liant le même sujet ? Deux sous-collections ? Cela me pousse davantage vers la suggestion n°3 pour une gestion plus facile des objectifs qui se chevauchent pour les utilisateurs qui apprécient la fonctionnalité de collection.

EDIT : J’ai réalisé que le point n°1 est une erreur liée à la modification de Collection par des groupes autorisés qui permettent des sujets non possédés. Néanmoins, un meilleur message d’erreur pourrait être utile !

1 « J'aime »
20

Donc, le paramètre modification de collection par des groupes autorisés est destiné au personnel et aux utilisateurs très privilégiés, c’est-à-dire les aides qui maintiennent les wikis. Bien qu’il semble que je doive corriger les erreurs.

Tant que modification de collection par des groupes autorisés est réglé suffisamment haut, les collections et sous-collections ne devraient être créées/modifiées que par le propriétaire du sujet (et le personnel). Les propriétaires de sujets devraient pouvoir ajouter des utilisateurs ordinaires comme mainteneurs aux collections ou sous-collections, qui peuvent ensuite ajouter leurs propres sujets. Je ne suis pas tout à fait sûr de vos paramètres pour justifier leur séparation.

Deux collections ne peuvent pas lier le même sujet. Une erreur devrait s’afficher lors de la tentative de lier un sujet déjà dans une collection. De même, une seule sous-collection est autorisée par sujet. C’est parce que les collections sont toutes publiques et ne devraient être créées que par les propriétaires de sujets.

Hmmm… J’ai l’impression qu’il serait peut-être préférable de créer un plugin séparé qui ne serait que des dossiers de favoris pouvant être consultés publiquement ou en privé… « Collections personnelles ? » « Bibliothèque de favoris ? » « Listes de lecture de sujets ? » Ou peut-être que je vais simplement étendre celui-ci. Mais le code sous-jacent et la philosophie seraient assez différents entre les deux fonctionnalités… C’est un peu dommage que le nom « Collections » soit assez large et puisse être interprété de nombreuses manières.

3 « J'aime »