Colecciones

Plugin
1
:information_source: Resumen Los usuarios crearon 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 pueden organizarse en secciones, y cualquier cambio en una colección se refleja en todos los temas vinculados. No hay restricción en el Tema que se vincula, por lo que los usuarios pueden crear una colección entre categorías/etiquetas.

Título y Descripción

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

Secciones

Característica organizativa opcional. Al agregar un encabezado de sección, la colección se puede dividir en secciones, lo que permite mostrar 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 URL relevantes (es decir, publicaciones específicas/recursos externos) solo para ese tema único. Las URL de temas agregadas no se vincularán.

Permisos

El plugin permite a cualquier usuario crear una colección para sus propios Temas. Por defecto, los usuarios solo pueden vincular a sus propios Temas y deben agregar a otros usuarios como mantenedores, quienes 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 (por defecto, Staff y TL4).

Demostración de Permisos

Configuración

Nombre Descripción
colecciones habilitadas Habilita/deshabilita el plugin. Por defecto: true
colección por propietario del tema Permite al OP del tema crear colecciones. Por defecto: true
grupos permitidos para colección por propietario del tema Restringe al OP del tema que puede crear colecciones. Limita colección por propietario del tema. Por defecto: TL1
modificación de colección por grupos permitidos Grupos permitidos para crear/modificar cualquier colección. Por defecto: Admin Moderators TL4.
secciones en subcolección Permite encabezados de sección en subcolecciones. Por defecto: true

Alternativas

Este plugin está fuertemente inspirado (y en un momento se basó) en el plugin https://meta.discourse.org/t/discourse-doc-categories/322376. Si bien el plugin Doc Categories tiene un buen mecanismo de indexación y la visualización es excelente, el diseño estaba destinado a páginas estilo wiki, donde todo se recopila en una sola categoría. De manera similar, la indexación se basa en la entrada de texto formateado en un Tema separado, que tiene sus pros y contras.

El componente de tema https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143 también permite organizar enlaces fuera del cuerpo de la publicación, pero se limita a un solo tema.

Si su propósito es solo una organización estilo wiki, https://meta.discourse.org/t/discourse-doc-categories/322376 sería una mejor opción. Si solo necesita que algunas páginas tengan Temas vinculados, https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143 sería mejor.

Notas

Originalmente, esto fue diseñado para dar soporte a la migración del foro del que formo parte a Discourse. Como foro centrado en la escritura, los usuarios mantienen temas separados para diferentes propósitos, lo que resulta en una situación en la que los enlaces entre temas de diferentes categorías son prácticamente obligatorios. Para facilitar esto, he creado este plugin para ayudar a los usuarios a autoorganizarse.

Existe una línea de tiempo alternativa en la que esto es solo un componente de tema, donde la indexación ocurriría con divs ingresados por el usuario con URL a otras publicaciones. Pero después de desarrollar el 90% de las herramientas, asistentes y código para hacerlo, me di cuenta de que no valía la pena y que el usuario probablemente omitiría todos los tutoriales escritos 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 en 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 todavía no estoy 100% seguro de las características de la interfaz de usuario (es decir, iconos) y el sistema de permisos. Además, necesito agregar pruebas unitarias automatizadas.

20 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 se ve realmente asombroso. Y una documentación absolutamente brillante: ¡esto tiene mi voto como el Plugin mejor documentado en meta.discourse.org!

¿Has considerado extender esto para que también cubra listas de temas?

A menudo encuentro que sería muy útil tener colecciones de enlaces por categoría o por etiqueta. Un ejemplo es una categoría privada dedicada a un grupo específico, que también utiliza otras herramientas (como algunas carpetas en Google Docs, un portal de gobierno local, un canal de chat asociado y una bandeja de entrada grupal). Sería ideal tener control de los moderadores de categoría 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

3 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).

2 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.

2 Me gusta