 |
Résumé | Transformez un tableau dans un sujet en éléments recherchables que les membres peuvent mentionner avec +, accompagnés de liens et d’aperçus onebox. |
 |
Dépôt | Discourse Mentionables |
 |
Guide d’installation | Installer des plugins sur un site Discourse auto-hébergé |
 |
Soutien financier | Veuillez envisager de soutenir le développement continu pour aider à maintenir ces plugins fonctionnels avec les versions actuelles de Discourse. |
Donnez à votre communauté un vocabulaire partagé pour les sujets dont elle parle : livres,
produits, projets, lieux, ressources d’assistance ou n’importe quoi d’autre ayant une URL.
Les membres tapent + et une partie d’un nom, choisissent une suggestion et obtiennent un lien lisible sans avoir à mémoriser l’adresse.
Fonctionnalités
- Commencez par des URLs seules. L’importateur récupère les noms et génère des slugs ; ajoutez
vos propres noms et slugs comme remplacements optionnels. - Recherchez pendant la saisie. Tapez
+ou utilisez le bouton de la barre d’outils du composeur pour rechercher
dans votre catalogue. Fonctionne dans les deux composeurs Markdown et texte enrichi. - Liens inline lisibles. Les mentions apparaissent sous forme de pastilles compactes utilisant le nom
d’affichage de l’élément, avec un slug stable dans le Markdown du message. - Oneboxes natifs. Placez une mention sur sa propre ligne pour afficher un onebox en utilisant
les mises en page existantes de Discourse et les destinations prises en charge. - Aperçus sur ordinateur. Survolez ou focalisez une pastille inline pour ouvrir un aperçu flottant
avec un lien Ouvrir la page originale. Les clics ordinaires ouvrent la destination. - Un catalogue que vos administrateurs peuvent modifier dans Discourse. Importez depuis un tableau Markdown
dans le message d’ouverture d’un sujet. Aucun compte Google ou identifiants API ne sont nécessaires. - Un bouton tableau pour les administrateurs. Insérez un tableau mentionables vide depuis la
barre d’outils du composeur, puis remplissez vos éléments.
L’apparence du onebox dépend de la destination et de la prise en charge normale des onebox par Discourse.
Les destinations non prises en charge restent des liens. Les cartes flottantes nécessitent une connexion ;
les invités peuvent toujours suivre le lien de destination. Les mentions dans le code sont laissées telles quelles,
et les mentions dans les listes et les citations restent inline.
Mentionables de base et extension Pro
Mentionables de base est le plugin principal. Pro est un plugin compagnon optionnel
installé à côté de celui-ci ; Pro inclut les fonctionnalités de base via cette dépendance.
| Fonctionnalité | Mentionables de base | Avec l’extension Pro |
|---|---|---|
| Importer un tableau Markdown depuis le message d’ouverture d’un sujet | Oui | Oui |
| Conserver le sujet source dans une catégorie restreinte | Oui | Oui |
| Bouton du composeur réservé aux admins pour insérer un squelette de tableau | Oui | Oui, y compris les colonnes d’icônes |
Recherche avec + dans les composeurs Markdown et texte enrichi |
Oui | Oui |
| Pastilles de mention inline et oneboxes natifs autonomes | Oui | Oui |
| Aperçus flottants au survol sur ordinateur ou à la focalisation clavier | Oui | Oui, en mode survol par défaut |
| Importer depuis Google Sheets en utilisant un compte de service | — | Oui |
| Choisir entre les tableaux de sujets et Google Sheets | Tableaux de sujets uniquement | Oui |
| Synchronisation automatique toutes les 12 heures | — | Optionnel, désactivé par défaut |
| Importer des noms d’icônes et des couleurs HTML optionnels | — | Oui, depuis l’une ou l’autre source |
| Ouvrir les aperçus flottants au clic ou au toucher, y compris sur les appareils tactiles | — | Optionnel |
Les colonnes icon et icon_colour de Pro ajoutent une icône colorée avant le nom de la
mention. Par exemple, utilisez book et #2563eb pour un manuel. Avec
mentionables_pro_click_to_preview activé, cliquer ou toucher une pastille ouvre son
aperçu ; le lien Ouvrir la page originale dans l’aperçu vous mène à la cible.
Configuration rapide
-
Installez le plugin de base en utilisant le guide d’installation ci-dessus. Reconstruisez Discourse
après l’installation. -
Créez un sujet pour votre catalogue. En tant qu’administrateur, utilisez Insérer un tableau mentionables
dans la barre d’outils du composeur ou collez ce tableau dans le message d’ouverture :| name | url | slug | image_url | | ------------------ | ----------------------------------- | ------------------ | --------- | | Getting started | https://example.com/getting-started | getting-started | | | Community handbook | https://example.com/handbook | community-handbook | | | Events calendar | https://example.com/events | events-calendar | | -
Remplacez les URLs d’exemple par les vôtres, enregistrez le message et définissez
mentionables_topic_idsur l’ID numérique de ce sujet. Gardezmentionables_enabled
activé. Les installations Pro doivent sélectionnertopic_tabledansmentionables_source
pour cette configuration. -
Ouvrez Admin → Plugins → Mentionables, cliquez sur Démarrer l’importation, puis
Actualiser pour inspecter le rapport. Le travailleur de tâche en arrière-plan doit être en cours d’exécution. -
Rechargez votre navigateur, ouvrez un composeur et tapez
+pour essayer vos éléments.
Utilisez des noms de colonnes en minuscules. Seule url est obligatoire, commençant par http://
ou https://. Les lignes contenant uniquement une URL récupèrent un nom depuis la destination et génèrent
un slug. Vous pouvez fournir name, slug, ou les deux pour remplacer ces valeurs par défaut, en mélangeant
ces options dans un même tableau. Si aucun titre n’est disponible, l’URL devient le
nom d’affichage. Les URLs existantes conservent leurs slugs lorsque la source les omet.
image_url et description sont optionnels.
L’importateur lit le premier tableau non cité avec une colonne url dans le message
d’ouverture. Les réponses, les tableaux cités et les exemples de code encadrés sont ignorés. Les sujets sources
doivent être des sujets réguliers, non supprimés, plutôt que des messages personnels.
Confidentialité de la source et mise à jour de votre catalogue
Vous pouvez conserver le sujet source dans Staff ou une autre catégorie restreinte afin que seules
les personnes de confiance puissent le maintenir. Les noms, URLs et images importés sont
accessibles aux utilisateurs de mentionables. Restreindre le sujet ne rend pas le
catalogue importé privé. Gardez les informations confidentielles hors du tableau.
Chaque importation synchronise par URL : les URLs correspondantes sont mises à jour, les nouvelles URLs créent des enregistrements,
et les URLs supprimées de la source suppriment les enregistrements. La source complète doit être
valide ; les URLs ou slugs en double, les lignes invalides, les échecs de récupération et les jeux de données vides
laissent le catalogue inchangé. Utilisez Tout supprimer pour un effacement intentionnel.
Les sujets sources et les tableurs ne sont jamais modifiés. Le paramètre optionnel
mentionables_pro_sync_enabled de Pro exécute la même importation toutes les 12 heures.
Rechargez le navigateur après l’importation. Les messages cuits existants ne sont pas automatiquement
recuits, et changer explicitement un slug peut casser les références +slug antérieures.
Paramètres et informations complémentaires
| Paramètre | But |
|---|---|
mentionables_enabled |
Activer ou désactiver Mentionables. |
mentionables_topic_id |
Sujet contenant le tableau source dans son message d’ouverture. |
mentionables_autocomplete_limit |
Nombre maximal de suggestions ; cinq par défaut. |
mentionables_onebox_fallback |
Récupérer également les images/descriptions manquantes lorsqu’un nom est fourni ; désactivé par défaut. |
Consultez le README pour le guide de configuration complet, le comportement de l’importation et
le dépannage. Les captures d’écran utilisent des données d’exemple tirées des fixtures de test du plugin.
