 |
Resumen | Discourse Templates permite la creación de plantillas de contenido para su uso repetido. Las plantillas se almacenan como temas en una categoría especial, donde se pueden editar y discutir según sea necesario. |
 |
Guía de instalación | Este plugin está incluido en el núcleo de Discourse. No es necesario instalar el plugin por separado. |
Este plugin es básicamente una nueva versión de Discourse Canned Replies, pero es más flexible y almacena las plantillas de manera diferente.
Funcionalidades
Este plugin utiliza una o más categorías para almacenar las plantillas y usarlas más tarde. El primer mensaje de cada tema en estas categorías se utilizará como plantilla para las respuestas.
Este enfoque ofrece mucha más funcionalidad que la disponible anteriormente con discourse-canned-replies, ya que cada plantilla tendrá un historial de ediciones, puede tener etiquetas asociadas y los mensajes subsiguientes se pueden utilizar para discutir el contenido de la plantilla si es necesario.
Solo se utilizarán los temas visibles como plantillas, por lo que los temas no listados y archivados no aparecerán.
El plugin también aprovecha la configuración de seguridad de las categorías para verificar qué usuarios pueden usar las plantillas. Si el usuario puede leer los temas de la categoría, estará disponible la opción de “insertar plantillas” en el editor de texto. El usuario solo podrá ver las plantillas/temas de las categorías a las que tenga acceso.
Se pueden utilizar múltiples categorías principales y/o subcategorías para proporcionar diferentes conjuntos de plantillas a distintos grupos de usuarios y organizar las plantillas.
Plantillas privadas
El plugin también admite plantillas privadas. Las plantillas privadas son mensajes privados etiquetados como plantillas. Estos mensajes estarán disponibles como plantillas únicamente para el autor del mensaje.
Los mensajes archivados no se listarán como plantillas.
Puedes encontrar todas tus plantillas privadas en:
/u/{NOMBRE-DE-USUARIO}/messages/tags/{ETIQUETA-DE-PLANTILLA-PRIVADA}
Configuración:
discourse templates enabled: Activa el plugindiscourse templates categories: Categorías que se utilizan para almacenar las plantillas. Cada tema en estas categorías y sus subcategorías se utilizará como plantilla y estará disponible para los usuarios que puedan verlos en sus categorías originales.discourse templates enable private templates: Habilita el uso de plantillas privadas.discourse templates groups allowed private templates: Grupos de usuarios autorizados a usar plantillas privadas.
Los miembros del personal siempre están autorizados.
discourse templates private templates tags: Etiquetas que se utilizarán para marcar los mensajes privados como plantillas.
Cómo usarlo
Después de instalar el plugin, necesitarás crear al menos una categoría para almacenar las plantillas.
Ten en cuenta que cualquier usuario que tenga acceso para leer los temas en esta categoría podrá usar la funcionalidad del plugin en el editor de texto.
Hacer que los nuevos temas sean wikis por defectoen la configuración de la categoría.
Después de eso, especifica la categoría en la configuración del plugin.
Eso es todo. Ahora solo tienes que crear algunos temas en la categoría especificada y estarán disponibles para usar como plantillas.
Si lo deseas, puedes crear subcategorías para organizar mejor las plantillas o para proporcionar diferentes conjuntos de respuestas a múltiples grupos de usuarios.
Para insertar plantillas, primero debes abrir el editor de respuestas y hacer clic en el botón de extras, luego seleccionar la opción “Insertar plantilla”.
Selecciona la plantilla deseada, puedes buscar por texto o etiquetas y hacer clic en el icono de “pegar”.
Atajo de teclado
Puedes usar Ctrl+Shift+I en PCs o ⌘+Shift+I en Macs para insertar plantillas.
Plantillas privadas
Necesitas configurar las siguientes opciones de Discourse para que funcione:
tagging enabled: debe estar habilitado.enable personal messages: debería estar habilitado si deseas que la función esté disponible para usuarios que no son del personal.pm tags allowed for groups: necesitarás permitir que los grupos que usarán plantillas privadas etiqueten los mensajes privados.
Para usar plantillas privadas, primero debes habilitarlas en la configuración, asignar los grupos de usuarios que pueden usarlas y asignar al menos una etiqueta para marcar los MP (mensajes privados) como plantilla.
Para crear una plantilla personal, los usuarios deben:
- enviar un mensaje personal no encriptado a sí mismos etiquetado con una de las etiquetas configuradas en la configuración del plugin. Solo el autor del mensaje lo verá como una plantilla privada.
Variables predefinidas
El plugin admite las siguientes variables en las plantillas:
my_usernamemy_nametopic_titletopic_urloriginal_poster_usernameoriginal_poster_namereply_to_usernamereply_to_namelast_poster_usernamereply_to_or_last_poster_username.
Todas las variables anteriores admiten texto de respaldo y eliminarán la variable si no se especifica un respaldo y la variable no se puede reemplazar.
Tanto el título como el cuerpo admiten el reemplazo de variables.
Ejemplo:
Hola %{reply_to_username,fallback:allá},
...
Saludos,
%{my_name}
Si reply_to_username no está disponible, la plantilla será:
Hola allá,
...
Saludos,
Arpit Jalan
Migración desde discourse-canned-replies
Existe una tarea rake para migrar las respuestas predefinidas existentes a plantillas:
rake "discourse-templates:migrate-from-canned-replies"
Esto tomó solo unos segundos para ejecutarse en Meta para migrar 47 respuestas predefinidas, por lo que debería ser seguro de usar a menos que tengas una cantidad descomunal de respuestas predefinidas.
PENDIENTE
ampliar la funcionalidad a otros lugares más allá del editor
permitir usar más de una categoría principal como fuente de plantillas
Registro de cambios
- 2022-07-14T03:00:00Z: Añadida la capacidad de usar múltiples categorías principales como fuente para plantillas
- 2022-07-18T03:00:00Z: Plantillas privadas
- 2022-08-10T03:00:00Z: Atajo de teclado global