Personalización de preguntas frecuentes y directrices

[Discourse]

Esta es una guía para administradores sobre cómo personalizar las páginas de Preguntas Frecuentes (FAQ) y Directrices en un sitio de Discourse.

Nivel de usuario requerido: Administrador

Personalizar las páginas de Preguntas Frecuentes y Directrices en Discourse te permite adaptar el contenido a las necesidades y reglas específicas de tu comunidad. Estas páginas suelen ser el primer punto de referencia para que los nuevos usuarios entiendan lo que se espera de ellos y también pueden servir como recurso para los miembros existentes.

Páginas de Preguntas Frecuentes y Directrices

Por defecto, Discourse solo incluye una página de Preguntas Frecuentes.

Sin embargo, también puedes crear una página de Directrices. Esto permite un contenido más enfocado en cada página, donde las Preguntas Frecuentes abordan las dudas comunes y las Directrices describen las normas de la comunidad.

Para agregar una página de Directrices a tu sitio, deberás añadir una URL de tema o una URL externa al ajuste de administrador faq url. También puedes usar una URL de página publicada aquí.

Esto creará una página de Directrices (accesible en .../directrices) junto con la pestaña existente de Preguntas Frecuentes.

Cambiar el nombre de Preguntas Frecuentes a Directrices (Cambio próximo)

Discourse está implementando un cambio próximo (rename_faq_to_guidelines) que renombra la página de Preguntas Frecuentes a “Directrices” en la navegación. Cuando se active este cambio:

• La pestaña de navegación mostrará Directrices en lugar de Preguntas Frecuentes.
• /faq, /rules y /conduct se redirigirán a /directrices (cuando faq_url no esté configurado).
• El enlace de la barra lateral cambiará de “Preguntas Frecuentes” a “Directrices”.
• Si faq_url está configurado, las pestañas “Directrices” y “Preguntas Frecuentes” seguirán apareciendo (igual que antes).

El contenido de la página de Preguntas Frecuentes permanece sin cambios; solo cambian la etiqueta y el enrutamiento. Puedes gestionar este cambio próximo desde la página Administración → Cambios próximos.

Contenido de las Preguntas Frecuentes y Directrices

La página de Preguntas Frecuentes en Discourse incluye contenido predeterminado que sirve como plantilla para las directrices del foro y las preguntas frecuentes. Para editar este contenido:

1. Navega al tema Preguntas Frecuentes/Directrices en tu foro, que generalmente se crea por defecto al configurar tu instancia de Discourse. Este tema suele estar fijado en la categoría del personal, pero puede encontrarse en otras categorías si se ha movido.
2. Edita la publicación como lo harías con cualquier otro tema en el foro. Como administrador o moderador, puedes revisar el texto para adaptarlo a las normas y expectativas de tu comunidad.
3. Después de realizar los cambios necesarios, guarda las ediciones para actualizar el contenido de la página de Preguntas Frecuentes.

Si deseas enlazar a una página externa de Preguntas Frecuentes, puedes cambiar el ajuste del sitio faq_url para que apunte a la URL de tu página externa de Preguntas Frecuentes.

Si has agregado una página de Directrices, esta utilizará el tema Preguntas Frecuentes/Directrices para su contenido, y puedes personalizar el contenido de la página de Directrices siguiendo un proceso similar al descrito anteriormente.

Nombres de las etiquetas de navegación

Puedes personalizar las etiquetas de texto utilizadas en los menús de navegación para las Preguntas Frecuentes y las Directrices en la página Administración → Personalizar → Textos (.../admin/customize/site_texts/).

Busca js.guidelines y js.faq para encontrar el contenido de texto que corresponde a las etiquetas de navegación y cámbialas por los términos que prefieras.

También puedes actualizar la etiqueta de navegación utilizada en la barra lateral para las Preguntas Frecuentes editando js.sidebar.sections.community.links.faq.content. Si el cambio próximo rename_faq_to_guidelines está activado, edita js.sidebar.sections.community.links.guidelines.content en su lugar.

Consulta Customize text in Discourse para obtener más detalles sobre este proceso.

Rutas de URL

Si un sitio no incluye una página de Directrices, puedes acceder a la página de Preguntas Frecuentes desde los siguientes identificadores de URL:

• /faq
• /directrices
• /rules
• /conduct

Si un sitio incluye una página de Directrices, las siguientes URLs pueden usarse para acceder a ella:

• /directrices
• /rules
• /conduct

Cuando existe una página de Directrices, la página de Preguntas Frecuentes solo puede accederse desde /faq o a través de SiteSetting.faq_url.

Cuando el cambio próximo rename_faq_to_guidelines está activado y faq_url no está configurado, /faq, /rules y /conduct se redirigen todos a /directrices.

¿Existe alguna forma de cambiar las rutas de URL como /faq y /directrices?

No. Discourse no tiene funciones principales para cambiar esas rutas, aunque es posible hacerlo mediante un complemento.

Ocultar etiquetas de navegación

Dependiendo de cómo quieras estructurar tu sitio, es posible que desees ocultar los enlaces de navegación para las páginas de Preguntas Frecuentes y Directrices. Esto se puede lograr realizando cambios de CSS en tu sitio.

Específicamente, puedes ocultar los nombres de las etiquetas de navegación de Preguntas Frecuentes y Directrices con el siguiente CSS:

Ocultar etiqueta de navegación de Preguntas Frecuentes

.nav-pills .nav-item-faq {
    display: none;
}

Ocultar etiqueta de navegación de Directrices

.nav-pills .nav-item-guidelines {
    display: none;
}

Además, puedes ocultar el botón de Preguntas Frecuentes del menú hamburguesa/barra lateral usando:

li[data-list-item-name="faq"]{
    display: none;
}

Si el cambio próximo rename_faq_to_guidelines está activado, el nombre del elemento de la barra lateral cambia a “directrices”, así que usa:

li[data-list-item-name="guidelines"]{
    display: none;
}

Agregar Directrices a la barra lateral

Puedes usar el componente de tema Enlaces personalizados del menú hamburguesa para agregar un enlace a la página de Directrices en tu menú hamburguesa o barra lateral. Consulta Instalar un tema o componente de tema para obtener detalles sobre cómo instalar este componente.

Una vez instalado el componente del tema, puedes usar la siguiente entrada para agregar un enlace a la página de Directrices:

Directrices,/directrices,g

Consejos para la gestión de la comunidad

Personalizar tus Preguntas Frecuentes y Directrices en Discourse es fundamental para dar forma a la identidad y cultura únicas de tu comunidad, así como a las expectativas de tu espacio. Esto no solo ayuda a fomentar un sentido de comunidad, sino que también proporciona claridad sobre lo que se debe y no se debe hacer, lo cual puede reducir significativamente la carga de moderación y mejorar la experiencia del usuario.

Una sección de Preguntas Frecuentes bien estructurada es invaluable para incorporar eficientemente a nuevos miembros, ya que puede responder anticipadamente a consultas comunes, permitiendo discusiones más profundas y atractivas.

Es beneficioso redactar estos documentos con un tono positivo, destacando los comportamientos alentados con ejemplos claros. Mantener el contenido conciso y bien organizado con viñetas y encabezados también ayuda a que la información sea más fácil de digerir.