Boîte à outils pour développeur

|||
-|-|-|
:discourse2: | Résumé | Developer Toolbox donne un accès rapide aux liens, actions et paramètres courants souvent utilisés lors du développement avec Discourse.
:hammer_and_wrench: | Lien du dépôt | https://github.com/discourse/discourse-dev-utils
:open_book:|Nouveau dans les thèmes Discourse ?| Guide pour débutants sur l’utilisation des thèmes Discourse

:information_source: Pour le développement local uniquement. Pas utile pour les sites de production.

Fonctionnalités

Comment ça marche

Le composant est conçu par défaut pour être discret, vous déclenchez donc une modale en tapant le caractère accent grave \ sur votre clavier. Alternativement, vous pouvez activer un bouton de déclenchement dans l’interface utilisateur en activant un paramètre de thème.

Une fois la modale apparue, vous avez accès à des actions, liens et paramètres courants dont vous pourriez avoir besoin lors du développement avec Discourse.

Paramètres

Nom Description
show header button Afficher le déclencheur de la boîte à outils de développement dans le panneau d’en-tête
remove button from flow Fixe le bouton d’en-tête en bas à droite. (Nécessite que show_header_button soit activé)
actions close modal Le déclenchement d’une action dans la boîte à outils fermera également la modale de la boîte à outils.
custom links
Traduction Défaut
dev_utils.toggle_btn Boîte à outils de développement
dev_utils.modal.title Boîte à outils de développement
dev_utils.modal.cancel Annuler
dev_utils.actions.title Actions rapides
dev_utils.actions.toggle_alerts Activer/Désactiver les alertes
dev_utils.actions.toggle_plugin_outlets Activer/Désactiver les sorties de plugin
dev_utils.links.title Liens rapides
dev_utils.links.themes Thèmes
dev_utils.links.components Composants de thème
dev_utils.links.colors Couleurs
dev_utils.links.settings Paramètres
dev_utils.links.plugins Plugins
dev_utils.links.user_prefs Préférences utilisateur
dev_utils.links.text Texte
dev_utils.links.plugin_api API de plugin
dev_utils.links.docs Documentation Discourse
dev_utils.common_settings.title Paramètres courants
dev_utils.common_settings.none Sélectionner un paramètre
42 « J'aime »

Merci pour ce super composant, Keegan !

Pour l’instant, l’icône d’en-tête s’affiche toujours. Une petite amélioration serait de ne l’afficher que pour les administrateurs. Ainsi, lorsque l’on navigue sur le site en tant qu’utilisateur normal, l’apparence n’est pas modifiée.

5 « J'aime »

J’aime beaucoup ce composant. Merci ! :slight_smile: :+1:

Je viens de remarquer que le bouton Discourse Docs mène au lien de l’API des plugins au lieu de la documentation.

2 « J'aime »

Merci d’avoir identifié cela @Lilly, j’ai publié une mise à jour qui résout ce problème :

Merci pour la demande @manuel, je l’ai ajoutée maintenant :

3 « J'aime »

Cela semble très bien – je dois identifier toutes les prises, mais les deux Toggle Outlets et Toggle Alerts ne semblent rien faire d’autre que de fermer la fenêtre modale.

Sont-elles censées afficher/montrer ou mettre en surbrillance quelque chose à l’écran lorsqu’elles sont activées ?

1 « J'aime »

L’ajout/l’installation de ce composant de thème en plus de la Developer Toolbox fait fonctionner le bouton « Toggle Outlets »…

2 « J'aime »

Le lien de l’API du plugin n’ouvre pas le fichier. Il semble qu’il doive être mis à jour vers app/assets/javascripts/discourse/app/lib/plugin-api.gjs ?

2 « J'aime »

Merci, j’ai fait la PR :+1:

3 « J'aime »

Merci @Arkshine pour la correction, je l’ai fusionnée :tada:

J’ai également ajouté quelques mises à jour (corrections/modernisations) ainsi qu’une nouvelle fonctionnalité vous permettant d’ajouter des liens personnalisés en les définissant dans le paramètre du thème :

3 « J'aime »

Pouvons-nous soumettre la traduction de ce composant sur Crowdin ? Je n’ai pas trouvé l’accès.

1 « J'aime »

Salut @th21 merci de nous avoir informés. Je l’ai ajouté en tant que projet de traduction dans Crowdin.

3 « J'aime »

Quel est le résultat attendu de “Activer/Désactiver les alertes” ? Cliqué et rien ne s’est passé

1 « J'aime »

Il est destiné à masquer toutes les alertes de votre instance Discourse. Si vous avez des alertes sur votre forum comme celle-ci :

Elle sera masquée de la page. C’est très utile par exemple, lors de la création de thèmes et que vous souhaitez voir temporairement la page sans aucune alerte.

2 « J'aime »