| |
|:-|:-|
| 
| Resumen | Resumen Anual de Discourse crea un tema el 1 de enero que resume la actividad del foro del año anterior. (Consulta nuestros ejemplos aquí en Meta - year-in-review)
| 
| Enlace al Repositorio | https://github.com/discourse/discourse-yearly-review
| 
| Guía de Instalación | Cómo instalar plugins en Discourse
Configuración Inicial
Dirígete a tu página /admin/plugins y haz clic en el botón de configuración 
Configuración de discourse-yearly-review:
-
Ingresa las categorías de las que extraer datos en la configuración
yearly review categories. Si se deja en blanco, por defecto se usarán las 5 categorías públicas principales. -
Utiliza la configuración
yearly review publish categorypara elegir una categoría de destino donde se publicará el resumen.
Se recomienda encarecidamente establecer la configuración yearly review publish categoryen una categoría de personal u otra privada, para que puedas ver el tema antes de hacerlo público. También podrías querer editarlo primero. -
Luego, habilita el plugin usando la configuración
yearly review enabled.
Funcionalidades
Como puedes 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 de lectura
- Más temas creados
- Más respuestas creadas
- Más respondidos
- 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ídos
- Más «me gusta»
- Más respondidos
- Más populares
- Más marcados
Generar el 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 sea 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 categoría.
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 recuento 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 deseas que las subcategorías se incluyan en el informe del resumen anual, deberás 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 insignias. Si más de 15 usuarios han recibido esta insignia, se mostrará un enlace a la página de la insignia. Si la configuración yearly review featured badge no está configurada, esta sección no se mostrará.
Ejecutar el resumen anual manualmente
Si no deseas esperar al trabajo en segundo plano, puedes publicar el tema desde la consola de rails con:
Jobs::YearlyReview.new.execute(force: true)
Si deseas generar un informe para un año específico, simplemente añade review_year: 'year', por ejemplo:
Jobs::YearlyReview.new.execute(force: true, review_year: '2021')
¿Te alojamos nosotros? Si deseas ejecutar el resumen anual manualmente, puedes contactarnos en team@discourse.org y con gusto lo organizaremos para ti.
Configuración
| 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 mejores categorías de este grupo. Si se deja en blanco, por defecto serán 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 | Añadir estadísticas de identificación de usuarios al primer mensaje del tema del 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 | Ingresa el nombre completo de la insignia. Puede dejarse en blanco. |
Problemas Conocidos
-
Los datos se muestran en tablas HTML. Las tablas están envueltas en etiquetas
divque tienen los atributosdata-review-topic-users="true"ydata-review-featured-topics="true". Esto permite que las tablas se estilen cuando se muestran en Discourse. Los estilos no se copian cuando se crean los correos electrónicos para los temas. Los correos electrónicos enviados para el tema no se ven muy bien. -
El primer mensaje del tema generado tiene ≈ 40.000 caracteres debido al uso de HTML. Como resultado, no se puede editar a menos que primero aumentes el límite de caracteres del cuerpo por encima de este (consulta Body is limited to 32000 characters; you entered 43659).
-
Los emojis en los títulos no se renderizan en los enlaces de los temas destacados.