Colecciones

Personalización Plugin
1
:information_source: Resumen Los usuarios crean colecciones de temas vinculados
:hammer_and_wrench: Enlace del repositorio https://github.com/Alteras1/discourse-collections
:open_book: Guía de instalación Cómo instalar plugins en Discourse

Vista previa

Móvil

Colecciones

Esto permite a los usuarios crear colecciones de temas que son visibles al ver dichos temas. Las colecciones pueden incluir cualquier URL y serán visibles en cualquier tema vinculado. Las colecciones se pueden organizar en secciones, y cualquier cambio en una colección se refleja en todos los temas vinculados. No hay restricción sobre el tema que se va a vincular, por lo que los usuarios pueden crear una colección entre categorías/etiquetas.

Título y descripción

Campo opcional disponible para la entrada. Si se proporciona, se mostrarán en la parte superior de la lista.

Secciones

Característica de organización opcional. Al agregar un encabezado de sección, la colección se puede dividir en secciones, lo que permite que se muestren secciones colapsables.

Subcolecciones

Los usuarios también pueden crear una subcolección, que solo se muestra para un solo tema, lo que permite a los usuarios vincular URLs relevantes (es decir, publicaciones específicas/recursos externos) solo para el tema individual. Las URLs de tema agregadas no se vincularán.

Permisos

El plugin permite que cualquier usuario cree una colección para sus propios temas. De forma predeterminada, los usuarios solo pueden vincular a sus propios temas y deben agregar a otros usuarios como mantenedores, que pueden agregar sus propios temas a la colección. Esta configuración se puede deshabilitar, permitiendo que solo grupos específicos tengan control total sobre cualquier colección (de forma predeterminada Personal y TL4).

Demostración de permisos

Configuración

Nombre Descripción
colecciones habilitadas Habilitar/deshabilitar el plugin. Predeterminado: true
colección por propietario del tema Permitir que el OP del tema cree colecciones. Predeterminado: true
colección por propietario del tema permitir grupos Restringir el OP del tema que puede crear colecciones. Limita colección por propietario del tema. Predeterminado: TL1
subcolección por propietario del tema permitir grupos Restringir el OP del tema que puede crear subcolecciones. Limita colección por propietario del tema. Predeterminado: TL1
modificación de colección por grupos permitidos Grupos autorizados para crear/modificar cualquier colección. Predeterminado: Admin Moderators TL4.
secciones en subcolección Permitir encabezados de sección en subcolecciones. Predeterminado: true

Alternativas

Este plugin está fuertemente inspirado por (y en algún momento se basó en) el plugin Discourse Doc Categories. Si bien el plugin Doc Categories tiene un buen mecanismo de indexación y la visualización es excelente, el diseño estaba pensado para páginas de estilo wiki, donde todo se recopila en una sola categoría. De manera similar, la indexación depende de la entrada de texto formateada en un tema separado, lo que tiene sus propias ventajas y desventajas.

El componente de tema DiscoTOC - automatic table of contents también permite organizar enlaces fuera del cuerpo de la publicación, pero está limitado a un solo tema.

Si su propósito es solo una organización de estilo wiki, Discourse Doc Categories sería una mejor opción. Si solo necesita que algunas páginas tengan temas vinculados, DiscoTOC - automatic table of contents sería mejor.

Notas

Esto se diseñó originalmente para apoyar la migración del foro al que pertenezco a Discourse. Como foro centrado en la escritura, los usuarios mantienen temas separados para diferentes propósitos, lo que resulta en una situación donde los enlaces entre temas entre categorías son prácticamente necesarios. Para ayudar a facilitar esto, he creado este plugin para apoyar la autoorganización de los usuarios.

Existe una línea temporal alternativa donde esto es solo un componente de tema, donde la indexación ocurriría con divs ingresados por el usuario con URLs a otras publicaciones. Pero después de desarrollar el 90% de las herramientas, asistentes y código para hacerlo, me di cuenta de que simplemente no valía la pena y que el usuario probablemente omitiría cada tutorial escrito y aún se quejaría de por qué las cosas no funcionaban. Así que ese camino fue descartado. Honestamente, no es una mala solución, ya que sería mucho más liviana que un plugin, pero habría puesto una carga innecesaria sobre los usuarios para asegurarse de que tuvieran el formato correcto no solo en una publicación, sino en varias.

Actualmente he marcado esto como experimental, ya que aún no estoy 100% decidido sobre las características de la interfaz de usuario (es decir, iconos) y el sistema de permisos. También necesito agregar pruebas de unidad automatizadas.

21 Me gusta
Post Collections, Topic-to-Topic Navigation Buttons, Menus, Anchor Links, and Topic TOC
2

Para tu información: todos los vídeos estaban rotos :thinking: (iPad)

1 me gusta
3

Vaya, pensaba que Safari de iOS soportaba WebM…

He cambiado los vídeos por MP4. ¡Gracias!

5 Me gusta
4

¿Es posible habilitar colecciones ‘públicas’ como en Discourse Docs?

1 me gusta
5

Disculpe si no quedó claro, todas las colecciones son “públicas”. Todos los usuarios verán la misma colección sobre el mismo tema. Este plugin está diseñado para organizar temas, no para ser una especie de “carpeta de marcadores” privada para los usuarios.

Tema de Discourse con Colección visto por un usuario anónimo
Tema de Discourse con Colección visto por un usuario anónimo1920×1243 155 KB

5 Me gusta
6

¡Plugin actualizado con soporte para Emojis y Cuadrados de Color en la barra lateral!

5 Me gusta
7

Esto parece realmente increíble. Y la documentación es absolutamente brillante: ¡tiene mi voto como el Customization > Plugin mejor documentado en meta.discourse.org!!

¿Has considerado ampliarlo para que también cubra las listas de temas?

A menudo encuentro que sería muy útil tener una colección de enlaces por categoría o por etiqueta. Un ejemplo sería una categoría privada dedicada a un grupo específico, que también utiliza otras herramientas (como algunas carpetas en Google Docs, un portal del gobierno local, un canal de chat asociado y una bandeja de entrada del grupo). Sería ideal que los moderadores de la categoría tuvieran control sobre ello.

3 Me gusta
8

¡Muchas gracias!

Es algo que definitivamente he considerado antes, pero no creo que encaje bien con el diseño actual de ser una forma impulsada por el usuario para organizar temas. No es ideal para el nivel de categoría/etiqueta, ya que tendría que limitarse al control del moderador. El caso de uso original era cubrir la vinculación de temas relacionados que son demasiado grandes para 1-2 temas, pero demasiado pequeños para una etiqueta/categoría.

Hacer que las listas de temas muestren la indexación en la barra lateral de las categorías se puede hacer a través del plugin Discourse Doc Categories, aunque con un método de configuración diferente. Definitivamente es una molestia tener que tener dos plugins haciendo dos cosas muy similares, pero creo que la filosofía original para cada uno es lo suficientemente diferente como para justificar los enfoques separados.

Agregar una extensión de compatibilidad para el Private Topics Plugin es una idea muy interesante desde el punto de vista del usuario. Tendré que considerarlo…

Eso solo deja el nivel por etiqueta. Hacer una PR para Discourse Doc Categories (o hacer un nuevo plugin/TC) para etiquetas es una opción, pero no está activamente en mi mente. Quizás en el futuro.

9

En realidad, esto probablemente funcionaría bien para mi caso de uso. No estoy seguro de si es lo suficientemente adaptable para ello, sin embargo (jugaré con él más tarde esta semana).

Suena muy interesante. ¿Qué caso de uso tienes en mente?

10

Para los usuarios habituales, la categoría con Temas privados habilitada solo mostraría sus propios temas. Por lo tanto, podría ver que este es uno de los pocos lugares donde permitir que el plugin Colecciones eleve una colección del nivel de temas al nivel de categoría por usuario tiene sentido.
El foro en el que participo tiene una categoría privada para que los usuarios la utilicen como campo de pruebas/redacción personal. Y crean muchos temas, por lo que la organización de temas impulsada por el usuario a veces ocurre aquí.

11

Realmente esperaba que fuera un sistema de colección donde los usuarios pudieran crear categorías y poner allí temas de su elección, como una galería. Bueno, qué le vamos a hacer.

12

¿Cómo es que esto no es eso?

1 me gusta
13

Mi suposición es que no puedes crear categorías.

14

Aprecio mucho la interfaz de usuario de arrastrar y soltar de este complemento para crear secuencias arbitrarias de Temas como capítulos de un libro, que se pueden reorganizar fácilmente.

He iniciado un Componente de Tema para agregar navegación secuencial para Colecciones, como \text{<kbd>Previous <</kbd>} y \text{<kbd>Next ></kbd>} y Paginación en un Modal…

Aquí está mi repositorio de trabajo

4 Me gusta
15

Muy necesario, lo estoy revisando hoy y este parecía ser el último componente que necesitaba.

@Alteras Tengo un error con la X de cerrar del modal en el modal “Crear Colecciones”. Se puede pasar el ratón por encima y hacer clic, pero no cierra el modal hasta que se actualiza la página.

1 me gusta
16

Oooo, este es un concepto interesante. Me encanta el modal para ver rápidamente las diferentes publicaciones de temas enlazados. También ayuda a informar a los usuarios de que hay una colección para aquellos que no tienen/mantienen la barra lateral abierta 24/7.

Tengo curiosidad por la decisión de intercambiar el contenido de la publicación en lugar de simplemente redirigir al usuario al tema.

Realmente me gusta la idea de usar <kbd>< Prev</kbd> y <kbd>Next ></kbd> encima de la línea de tiempo para navegar por los temas sin necesidad de la barra lateral. Tal vez podría estar con la línea de tiempo como la tabla de contenido (TOC), para que se pueda acceder fácilmente en temas con una primera publicación larga sin tener que desplazarse hacia arriba… O tal vez simplemente decorar la publicación superior/inferior…

Si estás de acuerdo, me gustaría explorar la adición de algunas de esas ideas directamente en el complemento, tal vez con configuraciones de sitio adicionales para los administradores. Por supuesto, no tengo ninguna objeción a tener un Componente de Tema (TC) basado en el complemento, más personalización para los usuarios. Avísame si necesitas ayuda con tu TC. Deberías poder obtener la información de la colección que se muestra actualmente del servicio ember service:collection-sidebar sin tener que analizar el DOM.

Hmm… eso es realmente extraño. No logro replicarlo. Recientemente hice algunos cambios actualizando el complemento para abordar algunos problemas de obsolescencia, ¿así que eso podría haberlo afectado? Por favor, comprueba si el complemento está actualizado. Por favor, comparte también los detalles de tu configuración (navegador, móvil/escritorio, versión de Discourse).

3 Me gusta
17

Estoy desactualizado, quizás por eso. Todavía estaba en el commit del 6 de noviembre.
ETA: Olvídalo, la actualización lo resolvió.

1 me gusta
18

Me gusta la rapidez. No es un diseño razonado.

Dado que la ordenación arbitraria de los elementos es la oportunidad aquí, donde la secuenciación no está decididamente ligada a ninguna línea de tiempo, mi objetivo inicial es reutilizar los comportamientos de menú anidados con desplazamiento horizontal del núcleo, como tenemos en la visualización de los Perfiles de Usuario, por ejemplo, donde, debajo del Título de la Colección (fijo) y la Descripción (si/cuando está presente), hay dos filas con desplazamiento/deslizamiento horizontal: Encabezados de Sección y sus Títulos de Tema asociados debajo de estos.

multilevel-horizontal-swiping
multilevel-horizontal-swiping648×169 16.3 KB

También dentro del modal hay una visualización vertical colapsable (deslizamiento rápido hacia adentro/afuera desde la izquierda) que replica el comportamiento de la barra lateral izquierda fuera del modal.
…

¡Por favor, hazlo!

2 Me gusta
19

Ahora que lo tengo funcionando (gracias por el aviso sobre la actualización anterior), un par de cosas que encontré:

  1. El botón de Colecciones es visible incluso cuando el usuario no forma parte de los grupos permitidos. Esto resulta en un Error Interno del Servidor (mostrado elegantemente en una barra roja en el modal) al intentar crear una colección.
  2. En la barra lateral de colecciones, el botón en la parte inferior ofrece la opción original de Crear Colección. Hay que usar el botón en la publicación original para gestionarla; sería muy útil tener una opción de Gestionar inmediatamente desde el botón en la barra lateral de la colección.
  3. ¿Sería posible separar los permisos de Colección y Subcolección? Las subcolecciones podrían ser inmensamente útiles para personas que deseen recopilar temas por su cuenta, sin el impacto generalizado que tiene una Colección en todos los temas vinculados.

Por último, ¿cómo maneja este complemento dos colecciones que enlazan el mismo tema? ¿Dos subcolecciones? Esto me inclina más hacia la sugerencia n.º 3 para una gestión más fácil de objetivos superpuestos para los usuarios a los que les gusta la función de colecciones.

EDITAR: Me di cuenta de que el n.º 1 es un error relacionado con la modificación de Colecciones por grupos permitidos que permite temas no propios. Aun así, ¡un mejor mensaje de error podría ser útil!

1 me gusta
20

Así que la configuración modificación de colección por grupos permitidos está destinada al personal y a los usuarios con privilegios muy altos, es decir, a los ayudantes que mantienen las wikis. Aunque parece que tendré que solucionar los errores.

Siempre que modificación de colección por grupos permitidos esté configurado lo suficientemente alto, las colecciones y subcolecciones solo deberían ser creadas/modificadas por el propietario del tema (y el personal). Los propietarios de temas deberían poder añadir usuarios normales como mantenedores a colecciones o subcolecciones, quienes luego pueden añadir sus propios temas. No estoy muy seguro de cuáles son vuestras configuraciones para justificar la separación.

Dos colecciones no pueden enlazar al mismo tema. Se debería mostrar un error al intentar enlazar un tema que ya está en una colección. Del mismo modo, solo se permite una subcolección por tema. Esto se debe a que las colecciones son públicas y solo deben ser creadas por los propietarios de los temas.

Mmm… Tengo la sensación de que sería mejor crear un plugin separado que sean solo carpetas de marcadores que se puedan ver pública o privadamente… ¿“Colecciones Personales”? ¿“Biblioteca de Marcadores”? ¿“Listas de Reproducción de Temas”? O tal vez simplemente extienda este. Pero el código subyacente y la filosofía serían bastante diferentes entre las dos características… Es una pena que el nombre “Colecciones” sea bastante amplio y pueda interpretarse de muchas maneras.

3 Me gusta