Plantillas de Discours

Plugin
, ,
1

|||
|—|—|—|
|:discourse2: | 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. |
|:open_book: | Guía de instalación | Este plugin está incluido en el núcleo de Discourse. No es necesario instalar el plugin por separado.

:information_source: Este plugin es prácticamente una nueva versión de Discourse Canned Replies pero es más flexible y almacena las plantillas de una manera diferente.

Características

Este plugin utiliza una o más categorías para almacenar las plantillas para su uso posterior. La primera publicación de cada tema en estas categorías se utilizará como plantilla para las respuestas.

Este enfoque proporciona mucha más funcionalidad que la disponible anteriormente con discourse-canned-replies, ya que cada plantilla tendrá un historial de edición, puede tener etiquetas asociadas y las publicaciones posteriores 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, la opción “insertar plantillas” en el compositor estará disponible para su uso. El usuario solo podrá ver las plantillas/temas en las categorías a las que tenga acceso.

Se pueden usar múltiples categorías principales y/o subcategorías para proporcionar diferentes conjuntos de plantillas para diferentes 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 solo para el autor del mensaje.

Los mensajes archivados no aparecerán como plantillas.

:bulb: Puedes encontrar todas tus plantillas privadas en:
/u/{NOMBRE-DE-USUARIO}/messages/tags/{ETIQUETA-PLANTILLA-PRIVADA}

Configuración:

  • discourse templates enabled: Activa el plugin
  • discourse 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 permitidos para usar plantillas privadas.

:warning: Los miembros del personal siempre están permitidos.

  • 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, deberás crear al menos una categoría para almacenar las plantillas.

Ten en cuenta que cada usuario que tenga acceso para leer los temas de esta categoría podrá usar la funcionalidad del plugin en el compositor.

:bulb: Consejo profesional: La misma configuración para editar temas se aplicará a los temas “plantilla”. Si deseas que cualquier persona con acceso de escritura en la categoría pueda editar las plantillas existentes, deberías activar Hacer que los nuevos temas sean wikis por defecto en la configuración de la categoría.

image
image736×402 27.6 KB

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 usarlos 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 compositor de respuestas y hacer clic en el botón de extras, luego seleccionar la opción “Insertar plantilla”.

image
image724×346 41.2 KB

Selecciona la plantilla deseada, puedes buscar por texto o etiquetas y hacer clic en el icono de “pegar”.

image
image1062×403 22.2 KB

Atajo de teclado
Puedes usar Ctrl+Shift+I en PC o ⌘+Shift+I en Mac para insertar plantillas.

:bulb: El atajo de teclado funcionará dentro de cualquier área de texto en Discourse.

Plantillas privadas

:warning: Las plantillas privadas solo funcionarán en instancias con mensajes privados y etiquetas habilitados.

Necesitas configurar los siguientes ajustes de Discourse para que funcione:

  • tagging enabled: debe estar habilitado.
  • enable personal messages: debe estar habilitado si deseas que la función esté disponible para usuarios que no sean del personal.
  • pm tags allowed for groups: deberás permitir que los grupos que usarán plantillas privadas etiqueten 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 mensajes privados como plantilla.

Para crear una plantilla personal, los usuarios deben:

  • enviarse un mensaje privado no cifrado 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.

:bulb: Los mensajes privados enviados a otros usuarios también pueden ser etiquetados, pero solo el autor del mensaje podrá usarlo como plantilla.

Variables prellenadas

El plugin admite las siguientes variables en las plantillas:

  • my_username
  • my_name
  • topic_title
  • topic_url
  • original_poster_username
  • original_poster_name
  • reply_to_username
  • reply_to_name
  • last_poster_username
  • reply_to_or_last_poster_username.

Todas las variables anteriores admiten texto de respaldo y eliminarán la variable si no se especifica el 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:ahí},

...

Saludos,
%{my_name}

Si reply_to_username no está disponible, la plantilla será:

Hola ahí,

...

Saludos,
Arpit Jalan

Migración desde discourse-canned-replies

Hay una tarea de rake para migrar las respuestas predefinidas existentes a plantillas:

rake "discourse-templates:migrate-from-canned-replies"

Esto solo tardó unos segundos en ejecutarse en Meta para migrar 47 respuestas predefinidas, por lo que debería ser seguro de usar a menos que tengas una cantidad abrumadora de respuestas predefinidas.

TODO

  • extender la funcionalidad a otros lugares más allá del compositor :white_check_mark:
  • permitir el uso de más de una categoría principal como fuentes de plantillas :white_check_mark:

Changelog

  • 2022-07-14T03:00:00Z: Se agregó la capacidad de usar múltiples categorías principales como fuente de plantillas
  • 2022-07-18T03:00:00Z: Plantillas privadas
  • 2022-08-10T03:00:00Z: Atajo de teclado global
44 Me gusta