Tablero Kanban

[Discourse]

	Resumen	Kanban Board te permite mostrar y organizar temas utilizando una interfaz de tablero Kanban.
	Vista previa	Vista previa en Discourse Theme Creator
	Enlace al repositorio	https://github.com/discourse/discourse-kanban-theme
	¿Nuevo en los temas de Discourse?	Guía para principiantes sobre el uso de los temas de Discourse

Instalar este componente de tema

Dado que este es un #componente_de_tema_oficial mantenido por el equipo de Discourse, las solicitudes de #soporte, Contribute > Bug, Contribute > UX y Contribute > Feature pueden realizarse en las categorías correspondientes aquí en Meta, y deben etiquetarse con la etiqueta del componente de tema apropiado. Haz clic en un enlace a continuación para iniciar uno.

 Soporte  Error  UX  Función

¿Alojado por nosotros? Los componentes de tema están disponibles para su uso en nuestros planes Pro, Business y Enterprise.

Resumen

El componente de tema Kanban Board transforma la forma en que organizas y visualizas los temas de tu foro. Proporciona una interfaz de arrastrar y soltar que te permite mover temas entre diferentes columnas que representan categorías, etiquetas o asignaciones de usuarios, lo que lo hace ideal para la gestión de proyectos, la visualización de flujos de trabajo y la organización de contenido.

Características

Múltiples modos de organización

Kanban Board ofrece tres modos diferentes para organizar tus temas:

1. Modo categorías: Organiza los temas por sus categorías asignadas
2. Modo etiquetas: Organiza los temas por sus etiquetas asignadas
3. Modo asignación: Organiza los temas por los usuarios a los que están asignados

Puedes arrastrar temas entre listas para cambiar automáticamente los atributos correspondientes:

Rendimiento optimizado

Las listas se cargan de forma “perezosa” (lazy-loaded), lo que significa que el componente solo carga el contenido según sea necesario. Esto asegura un rendimiento razonable incluso al manejar grandes cantidades de categorías o temas.

Configuración y ajustes

Selección del modo de tablero predeterminado

El modo de tablero predeterminado se determinará automáticamente utilizando los siguientes criterios:

• Si es el nivel superior, usa el modo categorías
• Si es una categoría y hay subcategorías, usa el modo categorías
• De lo contrario, usa el modo etiquetas. (Listas construidas a partir de la lista de ‘etiquetas principales’)

Cambiar el modo del tablero

Puedes cambiar el modo del tablero usando el botón de filtro a la izquierda, y los cambios de configuración se reflejarán en la URL. Los usuarios pueden guardar sus configuraciones favoritas en su navegador.

Configuración

Los administradores del sitio pueden personalizar la configuración predeterminada del componente de tema a través de la configuración del tema:

Resumen

Configuración	Descripción
Mostrar categorías	Una lista de categorías donde debe aparecer el botón “Tablero”. Si se deja en blanco, se mostrará en todas partes. Para subcategorías, no incluyas el slug del padre. Usa @ para denotar la vista del nivel superior.
Modos predeterminados	Anula el modo de tablero predeterminado para cada categoría. Usa la sintaxis categoría:modo:parametros. Por ejemplo, soporte:asignado:david,sam,joffrey. Usa @ en lugar de categoría para denotar la vista del nivel superior (ej. @:etiquetas:pendiente,hecho). Usa @untagged para mostrar una columna sin etiquetar.
Vista predeterminada	Una lista de categorías donde el “Tablero” es la vista predeterminada. (Nota: aún no soporta la vista predeterminada del nivel superior)
Requerir confirmación	Mostrar un modal de confirmación antes de realizar cambios en las etiquetas/categoría de un tema
Mostrar etiquetas	Mostrar etiquetas en las tarjetas de temas
Estilo de tarjeta	Determinar el estilo visual de las tarjetas de temas (actualmente está disponible “detallado”)
Mostrar miniatura del tema	Mostrar la miniatura del tema en la parte inferior de la tarjeta
Mostrar indicadores de actividad	Mostrar un indicador de la actividad de una tarjeta. Se aplicarán diferentes estilos si el tema ha sido actualizado hace más de 7 días o más de 20 días

Los valores predeterminados para cada configuración se muestran a continuación:

Personalización de texto

Los administradores pueden personalizar las etiquetas de texto utilizadas en toda la interfaz del tablero Kanban. Los siguientes elementos de texto se pueden personalizar:

Resumen

Traducción	Predeterminado	Descripción
no_topics	no hay temas	Se muestra cuando una columna no tiene temas
confirm_change_tags	¿Eliminar ‘#%{remove}’ y añadir ‘#%{add}’ a ‘%{title}’?	Mensaje de confirmación al cambiar etiquetas
confirm_close	¿Cerrar tema ‘%{title}’?	Confirmación al cerrar un tema
confirm_open	¿Reabrir tema ‘%{title}’?	Confirmación al reabrir un tema
confirm_change_category	¿Mover tema ‘%{title}’?	Confirmación al cambiar la categoría de un tema
menu_label	Tablero	Texto para el elemento del menú de navegación del tablero
copy_link	Copiar enlace al portapapeles	Tooltip para copiar un enlace
configure	Configurar tablero Kanban	Texto para el botón de configuración
fullscreen	Alternar pantalla completa	Texto para el botón de alternar pantalla completa
no_lists	No hay listas Kanban configuradas…	Se muestra cuando no hay listas configuradas
controls	Controles del Tablero Kanban	Encabezado para la sección de controles
last_post_by	Último mensaje por	Etiqueta para la información del último autor
modal.title	Configurar Kanban	Título del modal de configuración
modal.tags_placeholder	Etiquetas para mostrar…	Marcador de posición para el campo de entrada de etiquetas
modal.categories_placeholder	Categorías para mostrar…	Marcador de posición para el campo de entrada de categorías
modal.usernames_placeholder	Usuarios para mostrar…	Marcador de posición para el campo de entrada de usuarios
modal.apply	Aplicar	Texto para el botón de aplicar
modal.mode	Modo de tablero	Etiqueta para el selector de modo de tablero
modal.lists	Listas	Etiqueta para la sección de configuración de listas

Consejos para un uso efectivo

Configuración de columnas de etiquetas

Para la configuración más intuitiva en modo etiquetas, organiza tus etiquetas en un grupo de etiquetas con “solo una etiqueta de este grupo” habilitado. Esto asegura que los temas solo puedan tener una etiqueta de estado, haciendo que el tablero Kanban funcione como un tablero de flujo de trabajo tradicional.

Control del orden de las columnas en modo etiquetas

Puedes especificar el orden exacto de las columnas usando la configuración modos predeterminados. Por ejemplo, especificar hoja_de_ruta:etiquetas:descubrimiento,diseño,construcción,pruebas mostrará las columnas en ese orden específico:

Empoderar a tus usuarios

Dado que el mecanismo para mover temas entre columnas Kanban es cambiar la etiqueta, debes asegurarte de que tus usuarios objetivo puedan realmente hacer esto. Opciones:

1. Asegúrate de que tus usuarios objetivo sean @staff, @trust_level_4, o moderadores de categoría
2. Altera la configuración del sitio tiempo de edición de publicación (esto permite a los usuarios cambiar el título / etiquetas de sus propios temas durante mucho más tiempo)
3. Haz que todos los temas sean wikis (tendrán que editar la wiki para cambiar la etiqueta, lo cual no es ideal)

Preguntas frecuentes

¿Puedo usar el tablero Kanban en dispositivos móviles?

La funcionalidad de arrastrar y soltar actualmente no funciona en dispositivos móviles porque no soportan el arrastre y soltado de HTML5. Aún puedes ver el tablero en móviles, pero no podrás mover tarjetas entre columnas.

¿Por qué desaparece la pestaña del tablero después de configurarlo?

Si la pestaña del tablero desaparece después de la configuración inicial, es posible que necesites asegurarte de haber ingresado correctamente los nombres de las categorías en la configuración del tema. Asegúrate de usar el slug exacto de la categoría (con guiones bajos en lugar de guiones si corresponde) y configura tanto las categorías principales como las subcategorías por separado.

¿Cómo limito qué etiquetas se muestran en todo el sitio?

Puedes configurar qué etiquetas aparecen en el modo etiquetas usando la configuración modos predeterminados. Especifica exactamente qué etiquetas deben aparecer como columnas para evitar que aparezcan todas las etiquetas.

¿Cómo cambio la apariencia de las tarjetas?

Puedes personalizar la apariencia de las tarjetas usando varias configuraciones:

• Usa la configuración “Estilo de tarjeta” para seleccionar el formato de visualización
• Habilita o deshabilita las etiquetas en las tarjetas con la opción “Mostrar etiquetas”
• Añade miniaturas a las tarjetas con la configuración “Mostrar miniatura del tema”
• Añade indicadores visuales de actividad con la configuración “Mostrar indicadores de actividad”

Funciones #pr-welcome:

• hacer las listas más configurables. ej. permitir a los administradores definir una combinación de asignación, etiquetas y categorías en una sola visualización

• Añadir soporte para arrastrar tarjetas en dispositivos móviles. Lamentablemente, no soportan arrastre y soltado de html

[satonotdead]

Este complemento ha mejorado mucho, ¡gracias al Equipo Central por involucrarse!

Me gustaría sugerir añadir una opción para mostrar siempre un tema fijado específico en la parte superior de la tabla Kanban.

Esto ayudaría a garantizar que la información importante (cómo usar 'soporte') permanezca visible para todos los usuarios, incluso cuando se utiliza la vista Kanban.

[ChrisBeach (Chris)]

¿Podrías aclarar qué se debe configurar en el ajuste de “modos predeterminados” si estoy usando etiquetas (no categorías) en mi tablero?

Esto es de la documentación y no está claro:

@Discourse

Anula el modo de tablero predeterminado para cada categoría. Utiliza la sintaxis categoría:modo:parámetros. Por ejemplo, soporte:asignado:david,sam,joffrey. Usa @ para denotar la vista de nivel superior. Usa @untagged para mostrar una columna sin etiqueta.

Básicamente, tengo dos etiquetas (todo y done) y quiero un tablero kanban que muestre las publicaciones etiquetadas con cualquiera de estas, de publicaciones en cualquier categoría.

[Moin]

Creo que @:tags:todo,done debería hacer lo que quieres

[ChrisBeach (Chris)]

¡Funcionó! Gracias @Moin

Editar: He actualizado la documentación en el OP para que esto quede más claro

[ShizukuYae]

Hola,

Gracias por el gran trabajo en el complemento.

Actualmente, en la configuración en modo de etiquetas, ¿hay alguna forma en la que pueda mostrar solo las tarjetas de la categoría pero no de la subcategoría?

[Lew_Grothe]

Empezando a explorar la posibilidad de migrar al tema Horizon: ¿alguien tiene información sobre la compatibilidad del componente Kanban? No figura en la lista y, en cierto modo, presupongo que no lo estará, ya que Horizon es muy rígido en ciertos aspectos, lo que dificultaría integrar la nueva interfaz de manera coherente.

Si no es así, ¿existe alguna forma de bifurcar el componente Kanban para adaptarlo y que funcione con Horizon?

[mcwumbly (Dave McClure)]

Debería funcionar bastante bien con Horizon.

[Lew_Grothe]

Acabo de iniciar Horizon en mi máquina de desarrollo y Kanban no funciona en absoluto; antes sí funcionaba con el tema predeterminado (de varias versiones atrás). Probablemente sea solo algo de administración, pero pensé en preguntar…

Investigaré más a fondo…

[Arkshine]

Lo probé y está funcionando en mi lado.
Algunas cosas que puedes verificar:

• ¿Está el componente adjunto al tema?
• ¿Ves algún error en la consola del navegador?

[nathank (Nathan Kershaw)]

@mcwumbly

Debería funcionar bastante bien con Horizon.

Lo he estado usando bastante bien con Horizon.

Recuerdo que tuve que ajustarlo un poco para obtener una vista más amplia del Kanban, ya que Horizon es un poco estrecho horizontalmente en el medio. Este es el CSS que utilicé:

// Permite que la vista Kanban ocupe todo el ancho del contenedor principal y controla el ancho de las columnas
@media (min-width: 40rem) {
    body.kanban-active:not(.has-full-page-chat,.wizard) #main-outlet-wrapper #main-outlet>*:not(.experimental-screen,.activate-account) {
        max-width: none;
    }
}
.discourse-kanban-container .discourse-kanban-list {
    width: 350px;
}