Boîte à outils pour développeurs

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

:information_source: Réservé au développement local uniquement. Inutile pour les sites de production.

Fonctionnalités

Fonctionnement

Par défaut, le composant est conçu pour être discret. Vous déclenchez donc une fenêtre modale en appuyant sur le caractère de barre oblique inversée ` de votre clavier. Vous pouvez également activer un bouton de déclenchement dans l’interface en activant un paramètre du thème.

Une fois la fenêtre modale affichée, vous avez accès à des actions, des liens et des 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 developer toolbox 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 toolbox ferme également la fenêtre modale de la toolbox.
custom links
Traduction Défaut
dev_utils.toggle_btn Developer Toolbox
dev_utils.modal.title Developer Toolbox
dev_utils.modal.cancel Annuler
dev_utils.actions.title Actions rapides
dev_utils.actions.toggle_alerts Basculer les alertes
dev_utils.actions.toggle_plugin_outlets Basculer les sorties
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 du 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 »