Revisión anual de Discourse

:discourse2: Resumen Resumen Anual de Discourse crea un tema el 1 de enero que resume la actividad del foro del año anterior. (Vea nuestros ejemplos aquí en Meta - year-in-review)
:hammer_and_wrench: Enlace al Repositorio https://github.com/discourse/discourse-yearly-review
:open_book: Guía de Instalación Cómo instalar plugins en Discourse

Configuración Inicial

Diríjase a su página /admin/plugins para hacer clic en el botón de configuración :gear: del plugin discourse-yearly-review :gear: Configuración:

Configuración del resumen anual

  1. Ingrese las categorías de las que extraer datos en la configuración yearly review categories. Si se deja en blanco, se utilizarán por defecto las 5 categorías públicas principales.

  2. Utilizando la configuración yearly review publish category, elija una categoría de destino donde se publicará el resumen.

    :bulb: Se recomienda encarecidamente establecer la yearly review publish category en una categoría de personal u otra privada para que pueda ver el tema antes de hacerlo público. También podría gustarle editarlo primero.

  3. Luego, habilite el plugin utilizando la configuración yearly review enabled.

Funcionalidades

Como puede ver en 2022: The Year in Review, los datos se muestran en dos secciones: usuarios y temas.

La sección de usuarios incluye:

  • Más tiempo leyendo
  • Más temas creados
  • Más respuestas creadas
  • Más respondido
  • Más “me gusta” dados
  • Más “me gusta” recibidos
  • Más visitas
  • Usuarios que han recibido una insignia destacada (la insignia se establece mediante la Configuración del Sitio yearly review featured badge)

La sección de temas incluye:

  • Más leído
  • Más “me gusta”
  • Más respondido
  • Más popular
  • Más marcado como favorito

Generación del Resumen Anual

El plugin establece umbrales para decidir qué temas mostrar. Debe haber un mínimo de 10 “me gusta” o respuestas, 5 marcadores, una puntuación de 10, o una hora de tiempo de lectura antes de que un tema se muestre. El tema se publica automáticamente mediante un trabajo en segundo plano. El trabajo verifica que el plugin esté habilitado y que esté dentro de los primeros 31 días del primer mes del año. Luego verifica si ya se ha publicado un tema con el título yearly_review.topic_title por el usuario del sistema. Si todos los controles pasan, el tema se publica en la categoría establecida en la configuración yearly review publish category. Si esto no está configurado, el tema se publicará en la categoría Sin clasificar.

Opciones Adicionales

Categorías del resumen anual

Las categorías utilizadas en esta sección son las establecidas en la Configuración del Sitio yearly review categories. Si esta configuración no está configurada, se elegirán las 5 mejores categorías públicas del foro. “Mejor” se determina por el conteo de la categoría topics_year.

Las subcategorías de cualquier categoría especificada en la Configuración del Sitio yearly review categories no se incluirán en el informe del resumen anual. Si desea que las subcategorías se incluyan en el informe del resumen anual, deberá especificarlas explícitamente en la Configuración del Sitio yearly review categories.

Excluir personal del resumen anual

El plugin tiene una configuración yearly review exclude staff. Está habilitada por defecto para que los miembros del personal se excluyan de la sección de usuarios y los temas creados por el personal se excluyan de la sección de temas.

Insignia destacada del resumen anual

Se puede establecer una insignia destacada mediante la configuración yearly review featured badge. Se muestran un máximo de 15 usuarios con la insignia. Si más de 15 usuarios han recibido esta insignia, se muestra un enlace a la página de la insignia. Si la yearly review featured badge no está configurada, esta sección no se mostrará.

Ejecutar el Resumen Anual manualmente

Si no desea esperar al trabajo en segundo plano, puede publicar el tema desde la consola de rails con:

Jobs::YearlyReview.new.execute(force: true)

Si desea generar un informe para un año específico, simplemente agregue review_year: 'year', por ejemplo:

Jobs::YearlyReview.new.execute(force: true, review_year: '2021')

:discourse2: ¿Alojado por nosotros? Si desea ejecutar el Resumen Anual manualmente, puede contactarnos en team@discourse.org y estaremos encantados de organizarlo para usted.

Configuraciones

Nombre Descripción
yearly review enabled Habilitar el resumen anual.
yearly review categories Categorías públicas de las que extraer temas. Se seleccionarán las 5 categorías principales de este grupo. Si se deja en blanco, se utilizarán por defecto las 5 categorías públicas principales.
yearly review exclude staff Excluir al personal de las estadísticas de usuarios.
yearly review include user stats Agregar estadísticas de identificación de usuarios a la primera publicación del tema de resumen.
yearly review include private categories Incluir la actividad de usuarios de categorías privadas o restringidas por lectura en el resumen.
yearly review publish category La categoría en la que se publicará el resumen.
yearly review featured badge Ingrese el nombre completo de la insignia. Puede dejarse en blanco.

:discourse2: ¿Alojado por nosotros? Este plugin está disponible en todos nuestros niveles de alojamiento Yearly Review | Discourse - Civilized Discussion


Problemas Conocidos

  • Los datos se muestran en tablas HTML. Las tablas están envueltas en etiquetas div que tienen los atributos data-review-topic-users="true" y data-review-featured-topics="true". Esto permite que las tablas se estilicen cuando se muestran en Discourse. Los estilos no se copian cuando se crean correos electrónicos para los temas. Los correos electrónicos enviados para el tema no se ven bien.

  • La primera publicación en el tema generado tiene ≈ 40,000 caracteres debido al uso de HTML. Como resultado, no se puede editar a menos que primero aumente el límite de caracteres del cuerpo por encima de este (ver Body is limited to 32000 characters; you entered 43659)

  • Los emojis en los títulos no se muestran en los enlaces de los temas destacados

90 Me gusta

Algunas mejoras interesantes que se podrían hacer en este plugin. ¿Espero estar compartiendo esto en el lugar correcto? Avísenme si no es así.

  • Capacidad para excluir al personal de la lista de usuarios, pero aún así incluir los temas que crean.
  • Capacidad para excluir a TL4 de la lista de usuarios (y, como se mencionó anteriormente, aún incluir los temas que crean).
  • Capacidad para crear múltiples publicaciones de revisión para que podamos tener una para miembros TL4 (los usamos para empleados) y personal, y luego una publicación solo para miembros de la comunidad.
5 Me gusta

¡Hola!
Instalé el plugin este año, pero aunque está habilitado, no sé cuándo se publica la reseña, o si debo hacer algo más para publicarla.

¿Alguien puede informarme?
¡¡Muchas gracias!!

2 Me gusta

Saludos @Ayelen_Rives,

Al inspeccionar la consola administrativa, se le presentará la siguiente ayuda visual:

Un examen más detallado dentro del plugin titulado ‘plugin:discourse-yearly-review’ revela otro ejemplo ilustrativo:

Es imperativo que, al configurar los ajustes, designe la categoría de publicación de la revisión anual al personal u otra categoría restringida. Esto garantiza una revisión preliminar antes de permitir una visibilidad más amplia.

6 Me gusta

¡Muchas gracias, Aaron!

Inesperadamente, no veo esos mensajes en la consola administrativa, ni en la configuración:

La categoría de publicación es Staff, así que descubriré el 1 de enero si se ha creado.

¡Gracias de nuevo y felices fiestas!

2 Me gusta

¡Feliz año nuevo! :partying_face:

El plugin no se ejecutó aquí en dos foros. Y ahora muestra el mensaje para el 1 de enero de 2025. Extraño.

Lo ejecuté manualmente en la consola de rails en un foro y volvió en inglés, no en alemán, el idioma del foro.

Algo está/estaba mal aquí.

2 Me gusta

Aún no ha llegado aquí en meta. Seguí el consejo y lo configuré para publicarlo primero en #staff, que creo que es la única diferencia con el año pasado.

Esperaba que apareciera mágicamente con un poco de paciencia, pero quizás sea optimista.

2 Me gusta

No cambié nada en la configuración, ni siquiera el foro para revisarlo primero como miembro del personal y luego moverlo,

En mi segundo foro todavía no hay nada. Y aquí son las 11:24 a.m.

Parece que algo está roto.

¿Es necesaria una bandera de idioma al ejecutarlo manualmente? Tampoco quiero traducir todo en el segundo foro. :wink:

1 me gusta

Me tentaría a dejarlo un poco más para ver si hay un retraso en el trabajo en segundo plano, pero tampoco estoy seguro de por qué activarlo manualmente daría un resultado diferente a que el trabajo en segundo plano se ejecute por sí solo.

Puede que necesitemos que alguien con más conocimientos intervenga.

3 Me gusta

El mío no se ejecutó automáticamente, pero lo acabo de ejecutar manualmente y parece que funcionó bien, aunque no quería que estuviera en un idioma diferente.

1 me gusta

Esta mañana, sidekiq me indicó que la revisión anual se programaría en 50 minutos, lo que sería alrededor de las 11 a. m. hora local. Sin embargo, no esperé y la hice manualmente. No hubo problemas y el idioma también fue correcto.

Después de eso, me vi obligado a degradar a mis moderadores y volver a ejecutar sidekiq porque estaban muy molestos: ¡excluía al personal! No podía permitir al personal porque entonces yo, como administrador muy activo, dominaría completamente las listas, así que tomé la ruta más rápida.

Bueno, esa es otra historia, pero ¿podríamos tener un poco más de libertad para incluir o excluir grupos?

2 Me gusta

Santo … En el otro foro, el hilo de 2023 está ahí… 2:31 p.m. hora local. Y en alemán. Así que, todavía misterioso…

1 me gusta

Finalmente activé el nuestro desde Sidekiq. :rocket:

2 Me gusta

En mis sitios, el tema se generó sin que tuviera que ejecutarlo manualmente en sidekiq.

Estas son excelentes sugerencias. ¡Gracias! Es interesante escuchar sobre más casos de uso para este plugin. Lo analizaremos más de cerca pronto basándonos en la experiencia de este año, para ver qué podríamos hacer para mejorarlo antes del próximo año.

Mientras tanto, para esta ronda, puede editar la publicación una vez que se publique como mejor le parezca.

Un comportamiento interesante que noté es que si elimina el tema generado, creará uno nuevo al día siguiente, siempre que el plugin esté habilitado. Por lo tanto, podría jugar con la configuración y generar múltiples versiones del tema de revisión anual, copiar el texto de ellas y luego publicar nuevos temas usted mismo como mejor le parezca. Si tiene acceso a /sidekiq, puede encontrar el trabajo allí y ejecutarlo de inmediato.

2 Me gusta

Y por eso un consejo para publicar la reseña primero en una categoría más privada, es decir, Personal, y luego pasar a pública, no es un buen consejo :wink: A menos que un administrador quiera mantener dos versiones.

No es gran cosa, sin embargo.

1 me gusta

¡Hola! ¡Afortunadamente el plugin se activó solo el 1 de enero sin ningún problema! :raised_hands:

Vengo ahora con algunas preguntas sobre cómo funciona porque algunos informes (como Temas más populares y Me gusta más dados) muestran resultados diferentes a la página de Usuarios para el mismo período.

Por ejemplo, para Temas más populares, la página de Usuarios muestra primero al usuario “S”:

Y la revisión anual muestra primero al usuario “C” y nunca muestra al usuario “S” en la tabla:

(Lo siento, tengo que difuminar las imágenes por confidencialidad de la empresa, pero creo que está más claro si las añado. Además, la tabla está rota, puedes ignorarla :upside_down_face:)

¿Alguien sabe por qué podría estar sucediendo esto? Otros informes muestran exactamente la misma información, pero Temas más populares y Me gusta más dados muestran usuarios diferentes.

¡Muchas gracias por tu ayuda! :100:

1 me gusta

Vaya, no era consciente de que esto es lo que sucede. ¡Lo acabo de probar y tienes razón! Esto es un error. No debería crear un segundo tema de revisión anual si ya existe uno.

Pasos para reproducir:

  1. Una vez que se crea el tema de revisión anual, muévelo a una categoría diferente
  2. Activa la creación del tema de revisión anual a través de /sidekiq
  3. Se crea un segundo tema de revisión anual.

Si te encuentras con este problema, te sugiero que deshabilites el plugin. Estaremos revisando este plugin pronto para corregir errores y mejorarlo antes del próximo año.

1 me gusta

:thinking: ¿qué tan persistente es? Si sigo eliminándolo, ¿seguiremos bailando en junio? :joy:

¿Y esto significa que no necesito contactar al soporte para generar retroactivamente la publicación para mi sitio? ¿Simplemente aparecerá mañana?

1 me gusta

Realmente. Funciona a través de Sidekiq todos los días.

1 me gusta

Esperaría que se detuviera a finales de enero.

2 Me gusta