Caja de herramientas para desarrolladores

|||
-|-|-|
:discourse2: | Resumen | Developer Toolbox proporciona acceso rápido a enlaces, acciones y configuraciones comunes que se utilizan a menudo al desarrollar con Discourse.
:hammer_and_wrench: | Enlace del Repositorio | https://github.com/discourse/discourse-dev-utils
:open_book:|¿Nuevo en Temas de Discourse?| Guía para principiantes sobre el uso de temas de Discourse

:information_source: Solo para desarrollo local. No es útil para sitios de producción.

Características

Cómo funciona

El componente está diseñado por defecto para ser discreto, por lo que activas una ventana modal al pulsar el carácter de tilde/barra invertida ` en tu teclado. Alternativamente, puedes habilitar un botón de activación en la interfaz de usuario activando una configuración del tema.

Una vez que aparece la ventana modal, tienes acceso a algunas acciones, enlaces y configuraciones comunes que podrías necesitar mientras desarrollas con Discourse.

Configuraciones

Nombre Descripción
show header button Mostrar el activador de la caja de herramientas de desarrollo en el panel de encabezado
remove button from flow Fija el botón del encabezado en la parte inferior derecha. (Requiere que show_header_button esté habilitado)
actions close modal Activar una acción en la caja de herramientas también cerrará la ventana modal de la caja de herramientas.
custom links
Traducción Predeterminado
dev_utils.toggle_btn Dev Toolbox
dev_utils.modal.title Developer Toolbox
dev_utils.modal.cancel Cancelar
dev_utils.actions.title Acciones rápidas
dev_utils.actions.toggle_alerts Alternar Alertas
dev_utils.actions.toggle_plugin_outlets Alternar Salidas de Plugins
dev_utils.links.title Enlaces rápidos
dev_utils.links.themes Temas
dev_utils.links.components Componentes de Tema
dev_utils.links.colors Colores
dev_utils.links.settings Configuraciones
dev_utils.links.plugins Plugins
dev_utils.links.user_prefs Preferencias de Usuario
dev_utils.links.text Texto
dev_utils.links.plugin_api API de Plugins
dev_utils.links.docs Documentación de Discourse
dev_utils.common_settings.title Configuraciones comunes
dev_utils.common_settings.none Seleccionar una configuración
42 Me gusta

¡Gracias por este gran componente, Keegan!

Ahora mismo, el icono de la cabecera siempre se muestra. Una pequeña mejora podría ser mostrarlo solo a los administradores. Así, al navegar por el sitio como un usuario normal, la apariencia no se modifica.

5 Me gusta

Me gusta mucho este componente. ¡Gracias! :slight_smile: :+1:

Acabo de notar que el botón de Documentación de Discourse va al enlace de la API de Plugins en lugar de a la documentación.

2 Me gusta

Gracias por identificarlo @Lilly, he implementado una actualización que resuelve esto:

Gracias por la solicitud @manuel, lo he añadido ahora:

3 Me gusta

Esto se ve muy bien. Necesito identificar todas las salidas, pero tanto
Toggle Outlets
como
Toggle Alerts
parecen no hacer nada más que cerrar la ventana modal.

¿Se supone que deben mostrar o resaltar algo en la pantalla cuando se activan?

1 me gusta

Añadir/instalar este componente de tema además del Developer Toolbox hace que el botón Toggle Outlets funcione…

2 Me gusta

El enlace de la API de plugins no abre el archivo. ¿Parece que necesita actualizarse a app/assets/javascripts/discourse/app/lib/plugin-api.gjs?

2 Me gusta

Gracias, hice el PR :+1:

3 Me gusta

Gracias @Arkshine por la corrección, la he fusionado :tada:

También he añadido algunas actualizaciones (correcciones/modernizaciones) así como una nueva función donde ahora puedes añadir enlaces personalizados definiéndolos en la configuración del tema:

3 Me gusta

¿Podemos enviar la traducción de este componente en Crowdin? No encontré la entrada.

1 me gusta

Hola @th21, gracias por informarnos. Lo he añadido como un proyecto de traducción en Crowdin.

3 Me gusta

¿Cuál es el resultado esperado de “Alternar alertas”? se hizo clic y no pasó nada

1 me gusta

Está diseñado para ocultar cualquier alerta que tengas en tu instancia de Discourse. Si tienes alguna alerta en tu foro como esta:

La ocultará de la página. Es bastante útil, por ejemplo, al aplicar temas y quieres ver temporalmente la página sin ninguna alerta.

2 Me gusta