Sección de mensajes para la barra lateral

[Moin]

	Resumen	Añade enlaces a las bandejas de entrada de mensajes personales y de grupo en la barra lateral, incluyendo indicadores de mensajes no leídos
	Vista previa	Theme Creator
	Repositorio	GitHub - moin-Jana/sidebar-messages-section: Adds personal and group message inbox links to the sidebar, including unread message indicators. · GitHub
	Guía de instalación	Cómo instalar un tema o un componente de tema
	¿Nuevo en los temas de Discourse?	Guía para principiantes sobre el uso de temas de Discourse

Instalar este componente de tema

El componente añade una sección Mensajes a la barra lateral con enlaces a las bandejas de entrada de mensajes personales: tanto la bandeja personal del usuario como cualquier bandeja de grupo a la que tenga acceso. La sección también incluye un botón para redactar un nuevo mensaje personal junto al título de la sección.

Bandeja de entrada personal

Por defecto, el componente añade un enlace a la bandeja de entrada personal para todos los usuarios. Con la configuración show_personal_inbox, los administradores también pueden ocultarla por completo o mostrarla solo para los usuarios autorizados a crear mensajes privados, según la configuración del sitio “Grupos con mensajes personales habilitados”. Esto refleja cómo aparece el enlace a la bandeja de entrada personal en el menú de notificaciones, en el perfil del usuario y en la sección Comunidad de la barra lateral.

Para evitar enlaces duplicados a la bandeja de entrada personal, es posible que desees eliminar el enlace de mensajes en la primera sección de la barra lateral. Para hacerlo, abre el menú Más y selecciona Personalizar esta sección, luego elimina el enlace de Mensajes de la sección.

Bandejas de entrada de grupo

Todas las bandejas de entrada de grupo que contengan al menos un mensaje y de las cuales el usuario sea miembro aparecerán automáticamente en su barra lateral. Los administradores pueden ocultar bandejas de entrada de grupo específicas mediante la configuración hide_group_inboxes, lo cual puede ser útil cuando una bandeja de grupo ya no se utiliza activamente.

Una configuración separada, use_group_page_inbox, te permite elegir si los enlaces a las bandejas de grupo se abren en la interfaz de mensajes del usuario (/my/messages/group/{group_name}) o en la página del grupo (/g/{group_name}/messages/inbox).

Indicador de no leído

Cada enlace a una bandeja muestra el estado actual de los mensajes según la preferencia del usuario de “Mostrar un contador de los elementos nuevos”: ya sea un punto o el contador numérico. Los valores superiores a 100 se muestran como 99+.

Configuración avanzada de bandejas de grupo

Para personalizar el orden de las bandejas de grupo o cambiar el nombre mostrado en la barra lateral, puedes utilizar la configuración advanced_group_inbox_configuration.

En esta configuración puedes:

• seleccionar un grupo desde un menú desplegable
• definir opcionalmente un nombre personalizado que se mostrará en la barra lateral
• reordenar los grupos configurados utilizando los botones en la parte inferior

El nombre personalizado también es útil dentro de la configuración misma.
Si no se proporciona un nombre, la entrada se etiquetará como grupo 1, grupo 2, etc. (según su posición). Agregar un nombre temporal puede facilitar el reordenamiento, y puedes eliminarlo antes de guardar si lo deseas.

Los grupos con mensajes que no se agreguen a la configuración avanzada seguirán apareciendo en la barra lateral, listados después de los configurados y ordenados por su ID de grupo.

Los grupos listados en la configuración hide_group_inboxes siempre estarán ocultos, independientemente de si también están presentes en la configuración avanzada o tienen mensajes. Una advertencia exclusiva para administradores ayuda a resaltar cuando un grupo se agrega a ambas configuraciones.

Puedes ver un ejemplo de configuración y cómo afecta al orden y a los nombres mostrados en las capturas de pantalla a continuación:

Posición de la sección de mensajes

Para cambiar la posición de la sección de mensajes, puedes usar CSS, por ejemplo:

@nathank

/* Asegura que la sección de Mensajes aparezca primero en el contenedor flexbox */
.sidebar-section-wrapper {
  order: 1;
}
.sidebar-section-wrapper[data-section-name="inbox-section"] {
  order: 0;
}

Alternativamente, puedes instalar el componente Discourse Sidebar Menu Reorder y usar inbox-section como nombre de sección al ajustar su posición. También puedes utilizar la configuración de orden del componente Control de visualización del menú de navegación (barra lateral).

[Lilly]

¡Vaya, bien hecho Moin!

[NateDhaliwal]

Sugerencia menor: ¿quizás javascripts/discourse/api-initializers/group-inboxes-in-sidebar.gjs debería ser un archivo JS en lugar de GJS?

¡Gran componente!

---

Pasé los últimos 10 minutos revisando el código y examinando las clases principales y debo decir lo notable que fue (y es) que Discourse fue hecho de tal manera que todo encaja tan bien.

[Moin]

Sí, la API ofrece casi todo lo que necesitas para que la sección se vea y funcione como todas las demás. El chat también la utiliza, lo que probablemente influyó en el desarrollo. Las características se desarrollaron al mismo tiempo.
Desafortunadamente, get badgeText(), que muestra el número de temas no leídos en las secciones principales, no es compatible, por lo que tuve que ser un poco creativo con los números.

[putty (Derek Putnam)]

@Moin

Para evitar enlaces duplicados a la bandeja de entrada personal, es posible que desees eliminar el enlace de mensajes en la primera sección de la barra lateral.

No pude encontrar una configuración de administrador para esto, así que PSA, esto lo ocultará a través de CSS:

.sidebar-section-link[data-link-name="my-messages"] {
    display: none;
}

[Moin]

¿Por qué prefieres que el enlace se oculte con CSS en lugar de usar la opción existente para que los administradores personalicen la barra lateral? Ocultar con CSS parece más propenso a romperse que usar las opciones integradas de Discourse.

@Moin

Para personalizar esta sección:

1. Haz clic en Más en la barra lateral
2. Selecciona Personalizar esta sección en la parte inferior del menú extendido

[putty (Derek Putnam)]

Derp, tienes razón. Estaba pensando demasiado, creyendo que sería una configuración en la consola de administración y/o una funcionalidad central.

[Heliosurge (Dan DeMontmorency)]

No eres el único que estaba mirando allí.

---

¡Este es un componente genial!

[Moin]

He expandido la nota:

@Moin

Para evitar enlaces duplicados a la bandeja de entrada personal, es posible que desee eliminar el enlace de Mensajes en la primera sección de la barra lateral. Puede hacerlo abriendo el menú Más y seleccionando Personalizar esta sección, luego elimine el enlace de Mensajes de la sección.

[Heliosurge (Dan DeMontmorency)]

Sí lo hiciste. Pero como administradores, a menudo estamos acostumbrados a revisar el panel de administración. . Por lo que al leer las instrucciones por encima, podríamos pasar por alto algunos detalles.

Incluso con las actualizaciones principales, estoy seguro de que muchos de nosotros no siempre leemos todos los detalles hasta que algo que usamos se ha movido a otra área.

Hace mucho, mucho tiempo, con Android, si no recuerdo mal, Gingerbread solía tener Navegación y Mapas. Pasé unos 10 minutos buscando Navegación después de que la fusionaran con Mapas en una actualización.

[nathank (Nathan Kershaw)]

Este es un Componente de Tema brillante que se adapta a los sitios que dependen mucho de los Mensajes. ¡Gracias @moin por tu excelente trabajo!

Para hacerlo aún mejor para aquellos que usan Grupos con bastante frecuencia (los Mensajes son un gran componente de esto), ¿te importaría considerar estas sugerencias?

Posición seleccionable en la barra lateral

Para enfatizar más los Mensajes en la interfaz de usuario, me gustaría tenerlos en la parte superior de la Barra lateral (es decir, justo debajo de los enlaces). Básicamente, quiero que las personas puedan ver fácilmente sus Mensajes recientes (por grupo) de un vistazo sin depender de las notificaciones.

He utilizado este CSS para lograrlo, pero sospecho que no soy el único para quien esto sería útil:

/* Asegura que la sección de Mensajes aparezca primero en el contenedor flexbox */
.sidebar-section-wrapper {
  order: 1;
}
.sidebar-section-wrapper[data-section-name="inbox-section"] {
  order: 0;
}

Abrir las bandejas de entrada de grupo en el contexto del grupo

Quiero que mis usuarios puedan encontrar e interactuar fácilmente con sus Grupos. Me parece lógico que trabajen con los Mensajes en la Bandeja de entrada a la que se accede desde la página del Grupo (es decir, /g/el-grupo/messages/inbox) en lugar de su página de Bandeja de entrada Personal (es decir, /my/messages/group/el-grupo)

Esto les da una página limpia centrada en el grupo, con fácil acceso a los otros miembros y configuraciones del grupo:

Sería genial tener esto gobernado por una configuración en el TC.

[Moin]

@nathank

Sería genial tener esto gobernado por una configuración en el TC.

He pensado en esto, sobre qué ruta es un mejor valor predeterminado y una configuración, pero la eliminé por alguna razón que no recuerdo ahora mismo. Le echaré un vistazo mañana más tarde. Creo que fue sobre el indicador de mensajes no leídos. ¿Aún preferirías esta ruta si la consecuencia fuera que no habría indicador de mensajes no leídos?

Creo que la posición actual es la misma que la sección de mensajes que estaba en el núcleo.
Ya existe un gran componente sobre cómo cambiar el orden de las secciones en la barra lateral: Navigation (sidebar) menu display control
Para evitar conflictos porque ambos componentes intentan anular el orden, tendría sentido que los administradores que deseen un orden diferente utilicen el componente existente (el autor confirmó que funciona usando “inbox-section” como nombre de la sección).
Tendré que ver si puedo ofrecer una configuración adicional para esto. En cualquier caso, quiero evitar que los componentes interfieran entre sí.

[nathank (Nathan Kershaw)]

@Moin

He pensado en esto, sobre qué ruta es una mejor opción predeterminada y una configuración, pero la eliminé por alguna razón que no recuerdo ahora mismo. Le echaré un vistazo mañana más tarde. Creo que tenía que ver con el indicador de mensajes no leídos. ¿Seguirías prefiriendo esta ruta si la consecuencia fuera que no habría indicador de mensajes no leídos?

He estado jugueteando con esto en mi bifurcación y he encontrado lo mismo. Funciona, pero pierde tanto el indicador de mensajes no leídos como el resaltado de enlaces en la barra lateral. ¡Ambas cosas son de gran valor!

He hecho una PR para donde llegué:

Add group page inbox as an option

Pero para que realmente funcione, necesita que el indicador de no leído y el resaltado de enlaces funcionen, ¿verdad?

@Moin

Ya existe un gran componente sobre el cambio del orden de las secciones en la barra lateral: Control de visualización del menú de navegación (barra lateral)

¡Buen punto! Esa es una idea mucho mejor. Para mi vergüenza, soy uno de los autores de ese TC.

[Moin]

¿Por qué usaste href en lugar de route? Creo que href no funcionaba en absoluto con los indicadores de no leído. Me preocupaba más que los números en la ruta group.messages.inbox no estuvieran disponibles de la manera en que puedes usarlos en userPrivateMessages.

[nathank (Nathan Kershaw)]

¡Porque soy un desarrollador lamentable y probé un montón de cosas hasta que algo funcionó! Probablemente también debido a mi poco saludable dependencia de una IA generativa no tan inteligente .

He intentado utilizar rutas, pero no pude hacer que sobrescribieran las rutas existentes. Así que lo dejé.

Me pregunté si era posible obtener esos números o ese comportamiento simplemente secuestrando el enlace para ir a una ubicación diferente. Pero esto es un poco complejo para un viejo y sencillo como yo.

¡Siéntete libre de ‘mejorarlo’!

(Por cierto, el maravilloso @moin ha hecho exactamente eso, añadiendo la funcionalidad y haciéndolo funcionar correctamente!)

[nathank (Nathan Kershaw)]

@Moin

Creo que la posición actual es la misma que la sección de mensajes que estaba en el núcleo.
Ya existe un gran componente sobre cómo cambiar el orden de las secciones en la barra lateral: Control de visualización del menú de la barra lateral de navegación
Para evitar conflictos porque ambos componentes intentan anular el orden, tendría sentido que los administradores que deseen un orden diferente utilicen el componente existente (el autor confirmó que funciona usando “inbox-section” como nombre de la sección).

Esto funciona muy bien, de hecho. Algo vergonzosamente, soy uno de los autores (muy secundario a @lilly) de ese TC !

Sería genial tener esto en el OP.

[Moin]

@nathank solicitó una opción para cambiar el orden de las bandejas de entrada de grupo en la barra lateral. Anteriormente, solicité ideas sobre la mejor manera de abordar esto en Configuring the order of groups in theme component settings, y creo que ahora he llegado a una solución.
Combiné esto con la solicitud de mostrar el nombre completo de un grupo en lugar de su nombre corto. Dado que el nombre completo no está fácilmente disponible en este contexto, la solución es permitir a los administradores definir un nombre de visualización personalizado en su lugar. El campo que anteriormente solo se usaría para mostrar el nombre del grupo en la configuración ahora también se utiliza para controlar el nombre que se muestra en la barra lateral.

Ambas características se manejan a través de la nueva configuración advanced_group_inbox_configuration.

En esta configuración puedes:

• seleccionar un grupo de un menú desplegable
• definir opcionalmente un nombre personalizado que se mostrará en la barra lateral
• reordenar los grupos configurados usando los botones en la parte inferior

El nombre personalizado también es útil dentro de la propia configuración.
Si no se proporciona un nombre, la entrada se etiquetará como grupo 1, grupo 2, etc. (según su posición). Agregar un nombre temporal puede facilitar el reordenamiento, y puedes eliminarlo antes de guardar si lo deseas.

Los grupos con mensajes que no se agregan a la configuración avanzada seguirán apareciendo en la barra lateral, enumerados después de los configurados y ordenados por su ID de grupo.
Los grupos enumerados en la configuración hide_group_inboxes siempre estarán ocultos, independientemente de si también están presentes en la configuración avanzada o tienen mensajes.

En este ejemplo, no se introdujo un nombre personalizado para el grupo de moderadores, por lo que aparece como grupo 1 en la configuración. Los otros grupos tienen nombres personalizados.

Esta configuración da como resultado:

Aquí puedes ver que las bandejas de entrada ‘doggo-daily’ y ‘cat_pics’ han cambiado de posición y se muestran sin guiones ni guiones bajos. La bandeja de entrada ‘Team’ aparece debajo de las configuradas en la configuración avanzada.
También puedes ver una advertencia exclusiva para administradores, que aparece porque el grupo ‘admin’ se agregó a la configuración avanzada y a la configuración hide_group_inboxes al mismo tiempo.

[nathank (Nathan Kershaw)]

Esto es simplemente brillante para aquellos que utilizan grupos para las comunicaciones. ¡Gran trabajo, @Moin!

Gracias por escuchar y participar activamente en los comentarios de otros (y míos), y por producir un componente de tema tan bien diseñado y pragmático que resuelve un problema de larga data con tanta elegancia.

[agit (Bren Typo)]

Hola @Moin, gran trabajo y muchas gracias.

Preguntaba si una característica, especialmente cuando se trabaja con muchos grupos, podría formar parte de este complemento: La vista combinada de todos los mensajes de grupo. En la vista de PN ya hay una forma de visualizar con una pequeña insignia que este mensaje también va al grupo, ¿por qué no mostrar todos los mensajes con insignias a qué grupo pertenece?:

[Moin]

@agit

Preguntaba si una función, especialmente cuando se trabaja con muchos grupos, podría formar parte de este componente temático.

No creo que esto encaje bien en este componente temático. El objetivo de este componente es muy específico: añade una sección de mensajes a la barra lateral. No estoy a favor de un componente que soporte funcionalidades completamente diferentes, ya que eso lo hace más difícil de entender y mantener. Ese tipo de funcionalidad se manejaría mejor como una personalización separada.

Lo que es más importante, esto no es algo para lo que un componente temático esté bien adaptado. Los componentes temáticos solo pueden trabajar con datos que ya existen en el frontend, o que se pueden obtener razonablemente de los endpoints del backend existentes. Por eso este componente puede mostrar las bandejas de entrada de grupos en la barra lateral: muchas partes de Discourse ya necesitan saber a qué grupos pertenece un usuario, por lo que esa información está fácilmente disponible.

Sin embargo, lo que describes requeriría acceso a los datos de mensajes de todas las bandejas de entrada de grupos. Actualmente, Discourse no expone esto en un solo lugar. Teóricamente, un componente temático podría obtener cada bandeja de entrada de grupo una por una, pero eso se vuelve rápidamente ineficiente. Cada solicitud solo devuelve los primeros 30 mensajes, por lo que necesitarías cargar varias páginas por bandeja de entrada. Para luego ordenar los mensajes por actividad, necesitarías efectivamente todos los mensajes de todas las bandejas de entrada al mismo tiempo.

Debido a estas limitaciones, un componente temático sería una mala opción aquí. Un plugin que añada un endpoint de backend adecuado para devolver estos datos sería un enfoque mucho más sensato y escalable.