Es posible que observe que el widget de comentarios puede usarse con un Tenant ID de "demo", por ejemplo:

Demo Tenant ID

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo"

7}];

8</script>

9

Esto está destinado únicamente a probar y jugar con el widget de comentarios. En producción, usted pasaría su Tenant ID, de la siguiente manera:

Defining Your Tenant ID

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "aKa2Z4Q="

7}];

8</script>

9

Puede encontrar su Tenant ID ya aplicado en el fragmento de código del widget de comentarios en su cuenta.

También puede encontrar su Tenant ID y gestionar sus claves de API en la página de credenciales de API.

A partir de este punto, si ha iniciado sesión en FastComments, los ejemplos de código usarán su Tenant ID real (si ha iniciado sesión en https://fastcomments.com).

Al renderizar un hilo de comentarios, o al dejar un comentario, FastComments necesita saber a qué página, artículo o producto pertenecen esos comentarios.

Para ello, usamos algo que llamamos el "URL ID". Es ya sea un identificador, como una cadena o un número, o una URL.

Por defecto, si no especificas el urlId, este será la URL de la página. Tomaremos la URL actual de la página y la limpiaremos para eliminar cualquier parámetro común de marketing o identificadores de seguimiento.

En el caso de integraciones de terceros, como WordPress, nuestro plugin normalmente usará el identificador que representa la información actual que se está viendo como el URL ID, por ejemplo el id del artículo/página.

Defining a Custom URL ID

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "urlId": "https://example.com/page"

8}];

9</script>

10

Una cosa a la que nos referiremos a menudo en este documento es la Interfaz de personalización del widget.

Esta interfaz puede usarse para realizar muchos cambios en el widget de comentarios sin utilizar código.

Al crear una regla de personalización, a menudo querremos que se aplique a todas las páginas de nuestro sitio. Sin embargo, en algunos casos queremos personalizar el widget de comentarios en una página en particular, ya sea para aplicar estilos personalizados, o quizá para que los comentarios de esa página en particular sean anónimos. También podrías, por ejemplo, hacer que los comentarios en vivo aparezcan de inmediato en algunas páginas, mientras que en otras se oculten bajo botones de notificación.

Todo esto es posible a través del campo de entrada URL ID en esta página, que se muestra de la siguiente manera:

URL ID Input in The Widget Customization Page

El valor en este campo debe coincidir con el parámetro urlId pasado al widget de comentarios. Si quieres que tu regla de personalización sea agnóstica al urlId, deja este campo vacío o introduce *.

A partir de 2023 el campo URL ID en la personalización del widget ahora también acepta patrones. Por ejemplo, puedes tener */blog/* para añadir estilos específicos a tu blog y */store/* para tener estilos específicos en tu tienda, todo mientras usas el mismo dominio.

Advertencias

1. Si tu página tiene parámetros de fragmento (como example.com#page-1) - esto se convertirá en parte del URL ID, por defecto.
2. Durante migraciones, por ejemplo de WordPress a Gatsby, puede que tengas que migrar los valores de comentarios del URL ID después de la migración inicial. Para eso, contáctanos.

FastComments está diseñado para ser personalizado. El widget de comentarios en sí se ejecuta dentro de un iframe por razones de seguridad, por lo que para aplicar estilos personalizados debes seguir una de dos aproximaciones.

La primera, la más sencilla y la que preferimos, es usar la página de personalización del widget.

En la página de personalización del widget, consulta la sección "Show Advanced Options" (Mostrar opciones avanzadas), bajo la cual hay un área etiquetada "Custom CSS" (CSS personalizado):

Custom CSS Input Area

Este enfoque tiene algunas ventajas:

1. El CSS introducido se minifica antes de enviarse al usuario, y el formato se mantiene consistente en la interfaz de edición.
2. Obtienes todos los beneficios de la interfaz de personalización del widget, por ejemplo personalizar fácilmente el widget de comentarios de forma diferente para distintos sitios.
3. Cuando hacemos cambios en el widget de comentarios, tus estilos personalizados se probarán como parte de nuestro proceso de lanzamiento.

La segunda aproximación es especificar el parámetro customCSS en la configuración del widget, como sigue:

Passing Custom CSS

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "customCSS": "button { background: red; }"

8}];

9</script>

10

Sin embargo, esto tiene limitaciones:

1. Hay un límite de cuánto CSS personalizado se puede pasar antes de que nuestros servidores rechacen la solicitud, debido al tamaño de los encabezados.
2. Debes gestionar el CSS personalizado en tu infraestructura y sistema de compilación. Esto también puede ser una ventaja en lugar de un inconveniente.
3. Hay una sobrecarga adicional de enviar el CSS personalizado por la red dos veces en este caso de uso, ya que tiene que enviarse a nuestros servidores y luego devolverse en el contenido del iframe. Sin embargo, para la mayoría de tamaños de carga útil, esto no se percibe.
4. Una optimización común es minificar el CSS para reducir su tamaño en la red; sin embargo, con este enfoque tendrás que encargarte de eso.
5. Tu CSS personalizado no será probado cuando hagamos cambios.

External CSS Files

Puedes indicar al widget que obtenga un archivo externo usando @import!

Se recomienda poner el @import en una regla de personalización. De este modo, si alguna vez necesitamos hacer un cambio en el widget de comentarios, podemos usar nuestras herramientas de automatización para verificar tu configuración. Por ejemplo, crearías una regla de personalización en la interfaz de personalización del widget, harías clic en Advanced y escribirías en Custom CSS:

@import url(https://example.com/styles.css);

In Code - Not Recommended

También puedes cargar un archivo CSS externo mediante la propiedad customCSS:

External CSS File

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "customCSS": "@import url(https://example.com/styles.css);"

8}];

9</script>

10

Sin embargo, recuerda que tu CSS no podrá ser probado por nosotros si haces esto.

User Profile Modal Styling

Los modales de perfil de usuario también pueden estilizarse con CSS personalizado. Sin embargo, para asegurarte de que el estilo personalizado se aplique a los perfiles de usuario, todos los selectores CSS deben llevar el prefijo .user-profile. Sin este prefijo, el estilo personalizado será ignorado en los modales de perfil de usuario.

Por ejemplo:

User Profile CSS

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "customCSS": ".user-profile .profile-name { color: blue; }"

8}];

9</script>

10

Backwards Compatibility

En FastComments, sabemos que nuestros clientes personalizan el widget de comentarios. Eso es por diseño: lo último que queremos es que nuestro producto provoque inconsistencias de diseño en tu producto.

Dado que esto es una parte importante de nuestro producto, tenemos una canalización de compilación que nos permite revisar los cambios del widget de comentarios por cliente en cada versión.

Si encontramos problemas menores, actualizaremos tu cuenta para asegurar que nuestro lanzamiento se realice sin contratiempos. Si vemos cambios mayores que rompan la funcionalidad, esto nos permite detener el lanzamiento.

Para clientes con cuentas Pro o Enterprise, se permite la personalización de marca (white labeling). Simplemente contáctanos y estaremos encantados de ayudar.

Si solo desea eliminar nuestro logotipo del widget de comentarios, esto se habilita automáticamente en los planes Flex y Pro.

Estos planes también proporcionan la misma funcionalidad para los correos electrónicos enviados desde nuestra plataforma.

Para los sitios que permiten alternar el modo oscuro después de la carga inicial de la página, esto es un poco más complejo.

Primero, todas las versiones actuales de la biblioteca del widget de comentarios (React, Vue) tienen ejemplos de alternancia del modo oscuro en sus respectivos repositorios.

Para el widget VanillaJS, necesitaremos hacer un poco más de trabajo. Primero, FastCommentsUI devuelve un objeto con las funciones "destroy" y "update".

Podemos simplemente llamar a la función update cada vez que queramos actualizar la configuración del widget de comentarios, como sigue. Aquí hay un ejemplo completamente funcional de alternancia del modo oscuro con el widget VanillaJS.

Ejemplo completo de alternancia del modo oscuro

Copy Run

1

2<script src="https://fastcomments.com/js/embed-v2.min.js"></script>

3<button id="toggle-dark-mode">Toggle Dark Mode</button>

4<div id="fastcomments-widget"></div>

5<script>

6 (function() {

7 const button = document.getElementById('toggle-dark-mode');

8 const config = {

9 tenantId: 'demo',

10 hasDarkBackground: false

11 };

12 const instance = window.FastCommentsUI(document.getElementById('fastcomments-widget'), config);

13 button.addEventListener('click', function() {

14 config.hasDarkBackground = !config.hasDarkBackground;

15 if (config.hasDarkBackground) {

16 document.body.classList.add('dark');

17 } else {

18 document.body.classList.remove('dark');

19 }

20 instance.update(config);

21 });

22 })();

23</script>

24<style>

25 body.dark {

26 background: #000;

27 color: #fff;

28 }

29</style>

30

Con FastComments, todo el texto en el widget de comentarios es personalizable.

Puedes sobrescribir una sola pieza de texto, como el botón de enviar, o todo el texto en todo el widget de comentarios.

Por defecto, el texto en el widget de comentarios se traduce según la configuración regional del usuario. Sin embargo, podemos sobrescribir el texto, si estamos seguros de que nuestra base de usuarios está usando la misma configuración local/idioma, por ejemplo:

Custom Text

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "translations": {

8 "SUBMIT_REPLY": "Reply"

9 }

10}];

11</script>

12

Todas las traducciones personalizables se pueden encontrar here bajo la "advanced options" tab.

Sin embargo, hay una forma más sencilla, a través de la interfaz de personalización del widget. Allí, podemos simplemente encontrar el texto que se muestra en el widget de comentarios en la localidad EN_US, y especificar un reemplazo.

Custom Text

Todas las sobrescrituras de traducciones actualmente afectan a todos los locales.

Cuando un usuario comenta con FastComments por primera vez intentaremos obtener su avatar de http://gravatar.com/.

Sin embargo, si no encontramos un avatar, o el usuario nunca configura uno en su cuenta, mostramos una imagen de avatar predeterminada estática.

Para especificar tu propia imagen de avatar estática, podemos usar la configuración defaultAvatarSrc.

Override The Default Avatar

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "defaultAvatarSrc": "https://example.com/some-image.png"

8}];

9</script>

10

Esto también se puede hacer sin código. En la página de personalización del widget, consulta la sección "Avatar predeterminado".

Customizing The Default Avatar

Ten en cuenta que definir el avatar para un usuario en particular, como con SSO, se trata en su propia sección.

Los avatares pueden eliminarse por completo del widget de comentarios, incluso si los usuarios han definido su propio avatar.

Hiding Avatars

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "hideAvatars": true

8}];

9</script>

10

Esto se puede personalizar sin código, en la página de personalización del widget:

Hiding Avatars

Para proyectos de personalización de estilos más grandes, puede ser deseable empezar de cero y no usar el estilo predeterminado en absoluto.

Todo el estilo predeterminado puede eliminarse estableciendo el parámetro noStyles en true, como sigue:

Disabling All Default Styles

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "noStyles": true

8}];

9</script>

10

Esto se puede personalizar sin código, en la página de personalización del widget, en Opciones avanzadas:

Disabling All Default Styles

Por defecto, las respuestas a los comentarios de nivel superior se muestran.

Esto se puede configurar para que el usuario tenga que hacer clic en "Mostrar respuestas" en los comentarios de nivel superior para ver las respuestas hijas.

Collapse Replies to Top Level Comments

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "collapseReplies": true

8}];

9</script>

10

Esto se puede personalizar sin código, en la página de personalización del widget:

Collapse Replies

Esta configuración no afectará el número de comentarios de nivel superior cargados inicialmente. Si tienes un comentario de nivel superior, y 29 hijos, con esta opción activada verás:

• Verás el comentario de nivel superior.
• Verás "Mostrar respuestas (29)" debajo de este comentario.

Si deseas mostrar todos los comentarios de nivel superior en combinación con esta opción, establece la página inicial en -1.

Por defecto, las funcionalidades de formato en FastComments se realizan añadiendo etiquetas ancla visibles como <b></b> alrededor de tu texto. Al hacer clic en la barra de herramientas o usar atajos, esto se hace por ti. Sin embargo, algunas comunidades pueden querer optar por usar formato sin etiquetas ancla visibles. Esto se llama habilitar el WYSIWYG (lo que ves es lo que obtienes) editor. Este editor se ve exactamente igual que el predeterminado, excepto que carga algo de código adicional que permite a los usuarios poner texto en negrita, subrayar, etc., sin etiquetas ancla visibles.

Enabling WYSIWYG Editing

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableWYSIWYG": true

8}];

9</script>

10

Esto también se puede hacer sin código. En la página de personalización del widget, consulte la opción "Habilitar formato avanzado".

Enable WYSIWYG

Por defecto, FastComments mostrará una barra de herramientas al redactar un comentario para proporcionar accesos directos para dar formato al texto y subir imágenes.

Esta barra de herramientas puede desactivarse en el código o mediante la interfaz de personalización.

Disabling The Toolbar

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableToolbar": true

8}];

9</script>

10

Esto también se puede hacer sin código. En la página de personalización del widget, consulte la opción "Disable The Reply Toolbar".

Disabling The Toolbar

Por defecto, FastComments permite a los usuarios bloquear a otros usuarios. Bloquear a un usuario hará que sus comentarios se enmascaren, evitará las notificaciones entre los usuarios, y así sucesivamente.

Puede ser deseable desactivar esta funcionalidad. Se puede hacer de la siguiente manera:

Disable Blocking

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableBlocking": true

8}];

9</script>

10

Esto también se puede hacer sin código, lo que además habilita la validación adecuada del lado del servidor, a través de la interfaz de personalización del widget:

Disable Blocking

Por defecto se usan fechas relativas localizadas. Por ejemplo, junto a un comentario publicado recientemente puede ver "hace 11 minutos".

Puede ser necesario o deseable usar fechas absolutas, en cuyo caso debe establecer este parámetro en true.

Use Absolute Dates

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "absoluteDates": true

8}];

9</script>

10

Esto se puede personalizar sin código, en la página de personalización del widget, en Opciones avanzadas:

Use Absolute Dates

Por defecto, se usan fechas relativas localizadas. Por ejemplo, junto a un comentario dejado recientemente puede ver "11 minutes ago".

Puede ser necesario o deseable mantener este formato de fecha relativa, pero también mostrar la fecha completa junto a él; en ese caso debe establecer este parámetro en true.

Use Both Absolute and Relative Dates

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "absoluteAndRelativeDates": true

8}];

9</script>

10

Esto se puede personalizar sin código, en la página de personalización del widget, en Opciones avanzadas. Primero tendrá que habilitar Fechas absolutas para ver esta opción en la interfaz de usuario.

Use Both Absolute and Relative Dates

Algo de texto, como un encabezado o mensaje, puede mostrarse debajo del recuento de comentarios pero por encima del texto de estado de inicio de sesión.

A esto lo llamamos el encabezado, y por defecto está oculto.

Specifying Header HTML

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "headerHTML": "<h1>Leave a Comment!</h1>"

8}];

9</script>

10

Esto se puede personalizar sin código, en la página de personalización del widget, en Opciones avanzadas:

Specifying Header HTML

De forma predeterminada, FastComments renderizará enlaces como este: https://exmaple.com - donde la URL del enlace se convierte en una etiqueta de enlace HTML clicable.

Algunos sitios pueden querer desactivar esto, por ejemplo para desalentar a los estafadores. Proporcionamos esto configurando la Comment HTML Rendering Option en Links as Text.

Esto puede personalizarse sin código, en la página de personalización del widget, para un dominio completo, o página:

Render Links as Text

Por defecto, FastComments renderizará el cuadro de entrada de comentarios y el hilo de comentarios al mismo tiempo. Para ahorrar espacio vertical, también ocultará cualquier otro campo requerido hasta que se interactúe con el widget.

Sin embargo, el widget de comentarios puede ocultarse detrás de un botón, por ejemplo:

Click to Show Comments

El botón utiliza texto traducido distinto según si los comentarios están visibles o no. Si los comentarios están ocultos, usa translations.SHOW_COMMENTS_BUTTON_TEXT. Si los comentarios están visibles, usa translations.HIDE_COMMENTS_BUTTON_TEXT. Las traducciones pueden contener el texto [count] que será reemplazado por el conteo localizado.

Click to Show or Hide Comments

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "useShowCommentsToggle": true

8}];

9</script>

10

Esto está diseñado para reemplazar la configuración hideCommentsUnderCountTextFormat.

El conteo se actualiza en vivo con el hilo de comentarios. El botón no se muestra si no hay comentarios.

Esto se puede habilitar sin código creando una regla de personalización y activando "Hacer clic para mostrar comentarios":

Enable Click to Show Comments

El recuento de comentarios que se muestra en la parte superior del widget de comentarios se puede personalizar.

Puede reemplazarse por cualquier cadena, y el valor [count] será reemplazado por el número de comentarios, localizado para el usuario.

Customizing The Comment Count Text

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "commentCountFormat": "There are [count] comments."

8}];

9</script>

10

Esto puede personalizarse sin código, en la página de personalización del widget:

Customizing The Comment Count Text

Cuando los usuarios ingresan hashtags, en la forma de #someexampletag, FastComments creará automáticamente ese HashTag y resaltarlo en su comentario.

En algunos casos es deseable desactivar esta función o controlar qué hashtags se pueden usar a través de la API.

Para hacerlo, simplemente active Disable Automatic #hashtag Creation a través de la interfaz de personalización del widget.

Disabling Automatic HashTag Creation

Por defecto, FastComments mostrará una campana de notificaciones en la esquina superior derecha del área de comentarios.

Esta campana se pondrá roja y mostrará un recuento del número de notificaciones que tiene el usuario. Algunos ejemplos de notificaciones son:

• Un usuario te respondió.
• Un usuario respondió en un hilo en el que comentaste.
• Un usuario votó a favor de tu comentario.
• Un usuario respondió en una página a la que estás suscrito.

La campana de notificaciones también ofrece un mecanismo para suscribirse a una página completa.

Sin embargo, podemos desactivar la campana de notificaciones por completo:

Disable Notification Bell

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableNotificationBell": true

8}];

9</script>

10

Esto también puede hacerse sin código. En la página de personalización del widget, consulta la sección "Disable Notification Bell".

Disable Notification Bell

Por defecto, FastComments mostrará el perfil del usuario cuando haga clic en su avatar.

Sin embargo, podemos desactivar esta funcionalidad:

Disable Profiles

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableProfiles": true

8}];

9</script>

10

Esto también se puede hacer sin código. En la página de personalización del widget, consulte la sección "Disable Profiles".

Disable Profiles

Por defecto, FastComments mostrará un mensaje de éxito después de comentar. Esto puede desactivarse de la siguiente manera:

Disable Success Message

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableSuccessMessage": true

8}];

9</script>

10

Esto también se puede hacer sin código. En la página de personalización del widget:

Disable Success Message

Por defecto, el widget de comentarios de FastComments establecerá un gif rating de pg.

Las opciones disponibles son g, pg, pg-13 y r.

Esto se puede configurar en el código o mediante la interfaz de usuario. En el código, podemos hacerlo de la siguiente manera:

Set Gif Rating

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "gifRating": "pg-13"

8}];

9</script>

10

En la interfaz, encontrarás esto bajo Gif Picker Rating siempre que Disable Image Uploads? no esté marcado.

Setting The Gif Rating

Por defecto, el widget de comentarios de FastComments tiene la moderación de contenido de imágenes desactivada (off).

Las opciones disponibles son off, low, medium y high.

En la interfaz de personalización del widget, lo encontrarás bajo Image Content Moderation Level siempre que Disable Image Uploads? no esté marcado.

Setting The Image Content Moderation Level

Por defecto, FastComments mostrará las opciones de votación como flechas hacia arriba y hacia abajo, permitiendo a los usuarios votar a favor o en contra de un comentario.

Sin embargo, es posible cambiar el estilo de la barra de herramientas de votación. Las opciones actuales son los botones predeterminados Arriba/Abajo, o usar un mecanismo de votación con estilo Corazón.

Usamos la opción voteStyle de la siguiente manera:

Enable Heart Button

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "voteStyle": 1

8}];

9</script>

10

Recomendamos encarecidamente hacerlo sin código, ya que también habilita las validaciones del lado del servidor. En la página de personalización del widget, consulte la sección "Estilo de Votación".

Change Voting Style

La votación también puede desactivarse, vea Disable Voting arriba de las opciones de estilo.

Por defecto, FastComments permitirá a los usuarios eliminar sus comentarios.

Sin embargo, es posible evitar esto.

En la página de personalización del widget, consulte la opción "Desactivar eliminación".

Desactivar eliminación de comentarios

• Esto solo afecta a los comentaristas regulares y no a moderadores o administradores, quienes aún podrán eliminar.
• Esto también afectará a las integraciones de la API cuando se pase contextUserId.

Por defecto, FastComments permitirá a los usuarios editar sus comentarios.

Sin embargo, es posible evitar esto.

En la página de personalización del widget, consulte la opción "Desactivar edición".

Disable Comment Editing

• Esto solo afecta a los comentaristas regulares y no a los moderadores o administradores, que aún podrán editar.
• Esto también afectará a las integraciones de la API cuando se pase contextUserId.

Por defecto, el tamaño de página de FastComments es 30. Esto incluye las respuestas en los hilos.

El tamaño de página se puede personalizar en la Interfaz de configuración del widget en tamaños que varían desde 10 hasta 200.

Tenga en cuenta que cambiar el tamaño de página requiere recalcular todos los hilos de comentarios en su cuenta. Esto puede tardar un par de minutos.

Esto no puede configurarse en el widget del lado del cliente ya que las páginas se calculan del lado del servidor.

A continuación se muestra un ejemplo de configuración:

Custom Page Sizes

Los tamaños de página se pueden personalizar de forma global, por dominio o por página, creando diferentes reglas de personalización.

Esto afectará a todos los clientes, integraciones y frameworks que pueda estar utilizando para mostrar comentarios a través de nuestra plataforma.

Por defecto, FastComments mostrará el nombre del usuario tal como lo introdujo, o tal como se nos pasó a través de SSO.

Sin embargo, puede ser deseable enmascarar o mostrar el nombre del usuario de una manera distinta. Por ejemplo, si el nombre del usuario es Allen Rex, quizá quieras mostrar solo "Allen R.".

Esto se puede hacer sin código en la interfaz de personalización del widget, en la opción llamada Commenter Name Format:

Change Name Format

Los formatos disponibles son:

• Capitalizar (display example user as Example User)
• Inicial del apellido (display Example User as Example U.)
• Todas las iniciales (display Example User as E. U.)
• Mostrar "Anonymous"

El efecto de cambiar esto es inmediato. Los usuarios seguirán viendo su nombre completo en la parte superior del área de comentarios, para ellos mismos, pero sus comentarios mostrarán el nombre modificado.

Los nombres de usuario se enmascaran del lado del servidor para proteger a los usuarios.

Por defecto, FastComments permite la subida de imágenes. Esto se puede desactivar estableciendo la bandera noImageUploads en true.

Disabling Image Uploads

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "noImageUploads": true

8}];

9</script>

10

Esto se puede personalizar sin código, en la página de personalización del widget:

Disabling Image Uploads

Por defecto, no se muestra un cuadro de búsqueda en el widget de comentarios.

Sin embargo, podemos activar esto estableciendo la bandera enableSearch en true:

Enabling Search

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableSearch": true

8}];

9</script>

10

Esto también se puede hacer sin código. En la página de personalización del widget, consulte la opción "Enable Search Box".

Enable Search Box

Podemos habilitar el soporte de spoilers estableciendo la bandera enableSpoilers en true:

Enabling Spoilers

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableSpoilers": true

8}];

9</script>

10

Esto también se puede hacer sin código. En la página de personalización del widget, vea la opción "Activar spoilers".

Enable Spoilers

Cuando se resalta texto, y se hace clic en el botón SPOILER que ahora es visible, el texto quedará enmascarado hasta que el usuario sitúe el cursor sobre él. Para el modo oscuro hacemos lo mismo, con diferentes colores que se ajustan mejor al modo oscuro.

Esto también es compatible con el editor WYSIWYG.

Por defecto, FastComments no rastrea quién vio cada comentario ni proporciona estadísticas al respecto.

Sin embargo, podemos habilitar esta función, y entonces el sistema empezará a registrar cuando cada usuario se desplace hasta un comentario.

Cuando esto ocurre, se incrementará un contador junto a un icono de ojo que se muestra en cada comentario. El contador se actualiza en tiempo real y se abrevia según la configuración regional del usuario.

Podemos habilitar esto estableciendo la bandera enableViewCounts en true:

Enabling Comment View Counts

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableViewCounts": true

8}];

9</script>

10

Esto se puede personalizar sin código, en la página de personalización del widget:

Enabling Comment View Counts

Registramos el id de usuario* que vio el comentario, de modo que si vuelves a ver el comentario no se incrementará. Si vuelves a ver el comentario después de dos años, el contador se incrementará de nuevo.

• *Nota: o el id de sesión anónima, o la IP del usuario como un valor hash.

Por defecto, la función de comentarios en vivo está habilitada. Esto significa que si se añaden, eliminan, editan o fijan comentarios, los cambios deberían aparecer a todos los usuarios que estén viendo el hilo de comentarios al mismo tiempo.

Sin embargo, por defecto esos nuevos comentarios aparecerán bajo un botón mostrado dinámicamente con un texto similar a "Mostrar 2 comentarios nuevos".

Si los nuevos comentarios son respuestas directamente a la página, el botón se mostrará en la parte superior del hilo de comentarios. Si son respuestas a un comentario en particular, el botón se mostrará debajo de ese comentario.

Esto es para evitar que el tamaño de la página cambie constantemente para el usuario, lo que podría causar frustración al intentar agarrar la barra de desplazamiento.

Para algunos casos de uso, como subastas en vivo o eventos en línea, este no es el comportamiento deseado: es posible que quiera que el widget de comentarios sea más como una caja de "chat" donde los nuevos comentarios se "muestren de inmediato".

Por ello, el nombre de la bandera que habilita esa función: showLiveRightAway.

Podemos activarlo de la siguiente manera:

Show Live Comments Right Away

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "showLiveRightAway": true

8}];

9</script>

10

Esto se puede personalizar sin código, en la página de personalización del widget:

Show Live Comments Right Away

Por defecto, FastComments tendrá habilitados los comentarios en vivo.

Esto significa que cada visualizador del hilo de comentarios debería ver el mismo contenido.

Por ejemplo, si se añade un comentario, ese comentario se mostrará. Si se edita o elimina un comentario, entonces esos comentarios se editarán o eliminarán para todos los visualizadores del hilo. Lo mismo con los votos y todas las acciones de moderación.

Sin embargo, podemos desactivar esto:

Disable Live Commenting

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableLiveCommenting": true

8}];

9</script>

10

Esto también se puede hacer sin código. En la página de personalización del widget, consulte la sección "Desactivar comentarios en vivo".

Disable Live Commenting

Por defecto, FastComments ordenará los comentarios por la dirección de ordenación "Most Relevant".

La ordenación "Most Relevant" tiene en cuenta la hora en que se dejó el comentario y el número de votos para el ordenamiento.

El usuario puede cambiar la dirección de ordenación a "Más antiguos primero" o "Más recientes primero" en la interfaz del widget de comentarios.

However, we can change the default to be any of the three. For example if you wanted to show the oldest comments first:

Changing The Default Sort To Oldest First

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "defaultSortDirection": "OF"

8}];

9</script>

10

Asignamos el valor de defaultSortDirection a "OF" para establecer la dirección a "OF".

For the newest-first sort direction, we would do the following:

Changing The Default Sort To Newest First

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "defaultSortDirection": "NF"

8}];

9</script>

10

Los valores válidos para defaultSortDirection son:

• MR: "Más reciente"
• NF: "Más recientes primero"
• OF: "Más antiguos primero"

Esto también se puede hacer sin código. En la página de personalización del widget, consulta la sección "Default Sort Direction".

Changing The Default Sort Direction

Ten en cuenta que los comentarios en cada página para cada dirección de ordenación se precomputan, por lo que todas las direcciones de ordenación tienen el mismo rendimiento.

Por defecto el área de entrada de comentarios está antes del hilo de comentarios. Sin embargo, al establecer este parámetro de configuración a true podemos moverla a después.

Moving The Reply Box to The Bottom

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "inputAfterComments": true

8}];

9</script>

10

Esto se puede personalizar sin código, en la página de personalización del widget:

Moving The Reply Box to The Bottom

El número máximo de caracteres permitidos en el campo de entrada de comentarios se puede limitar mediante el parámetro maxCommentCharacterLength.

El valor predeterminado es 2000.

Elementos como las URLs de imágenes no se incluyen en la determinación de la longitud.

Limit Comment Length

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "maxCommentCharacterLength": 500

8}];

9</script>

10

Esto se puede personalizar sin código, en la página de personalización del widget:

Limit Comment Length

Por defecto, FastComments permitirá a los usuarios ingresar un comentario con tantas líneas como deseen, hasta el límite de caracteres predeterminado.

Sin embargo, puede ser deseable limitar al usuario a ingresar solo una línea de texto. Algunos ejemplos de casos de uso incluyen subastas en línea, o chat en vivo, para los cuales FastComments puede utilizarse.

Activamos la bandera useSingleLineCommentInput de la siguiente manera:

Enable Single-Line Comment Input

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "useSingleLineCommentInput": true

8}];

9</script>

10

Esto también se puede hacer sin código. En la página de personalización del widget, consulte la sección "Habilitar entrada de comentario de una sola línea".

Enable Single-Line Comment Input

Tenga en cuenta que, los comentarios en cada página para cada dirección de ordenamiento se precomputan, por lo que todas las direcciones de ordenamiento tienen el mismo rendimiento.

Por defecto, cada usuario puede enviar hasta 5 comments en el mismo minuto.

Esto se rastrea por user id, anon user id y ip address (hashed).

Esto puede personalizarse sin código, en la página de personalización del widget:

Limiting Comment Volume Per User

Ten en cuenta que si estás usando la comment creation API puede que quieras pasar la dirección ip original del usuario en la solicitud a nuestro backend para que la limitación de tasa se aplique por usuario y no de forma global a tu cuenta.

FastComments Secure SSO utiliza cifrado HMAC-SHA256 como el mecanismo para implementar SSO. Primero repasaremos la arquitectura general, proporcionaremos ejemplos y pasos detallados.

También hay documentación relativa a la migración desde otros proveedores con mecanismos SSO similares, y las diferencias.

El flujo se ve así:

Flujo SSO seguro

Dado que Secure SSO implica desarrollo full-stack, ejemplos completos y funcionales en Java/Spring, NodeJS/Express y PHP puro están actualmente en GitHub.

Aunque usamos ExpressJS en el ejemplo de NodeJS y Spring en el ejemplo de Java, no se requieren frameworks/bibliotecas en estos entornos para implementar FastComments SSO: los paquetes de criptografía nativos funcionan.

No tienes que escribir nuevos endpoints de API con FastComments SSO. Simplemente encripta la información del usuario usando tu clave secreta y pasa la carga útil (payload) al widget de comentarios.

Obtener tu API Secret Key

Tu API Secret puede recuperarse desde esta página. También puedes encontrar esta página yendo a My Account, haciendo clic en el mosaico API/SSO y luego en "Get API Secret Key".

Parámetros del widget de comentarios

La documentación de alto nivel de la API para el widget de comentarios se puede encontrar aquí.

Entremos en más detalle sobre lo que significan estos parámetros.

El widget de comentarios toma un objeto de configuración: ya pasas esto si estás usando FastComments para pasar tu customer id (llamado tenantId).

Para habilitar SSO, pasa un nuevo objeto "sso", que debe tener los siguientes parámetros. Los valores deben generarse en el lado del servidor.

• userDataJSONBase64: Los datos del usuario en formato JSON, que luego se codifican en Base64.
• verificationHash: El hash HMAC-SHA256 creado a partir de UNIX_TIME_MILLIS + userDataJSONBase64.
• timestamp: Marca de tiempo Epoch, en milisegundos. No debe estar en el futuro, ni tener más de dos días de antigüedad.
• loginURL: Una URL que el widget de comentarios puede mostrar para iniciar sesión el usuario.
• logoutURL: Una URL que el widget de comentarios puede mostrar para cerrar sesión el usuario.
• loginCallback: Cuando se proporciona en lugar de la login URL, una función que el widget de comentarios invocará al hacer clic en el botón de inicio de sesión.
• logoutCallback: Cuando se proporciona en lugar de la logout URL, una función que el widget de comentarios invocará al hacer clic en el botón de cierre de sesión.

Secure SSO Client Code

Copy

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "sso": {

8 "userDataJSONBase64": "...",

9 "verificationHash": "...",

10 "timestamp": 1768890094768,

11 "loginURL": "https://example.com/login",

12 "logoutURL": "https://example.com/logout"

13 }

14}];

15</script>

16

The User Object

The User object contains the following schema:

El objeto de usuario

Copy

1

2interface SSOUser {

3 /** Required. 1k Characters Max. **/

4 id: string;

5 /** Required. 1k Characters Max. Note: Must be unique. **/

6 email: string;

7 /** Required. 1k Characters Max. Note: The username cannot be an email. Does not have to be unique. **/

8 username: string;

9 /** Optional. 3k Characters Max for URLs. Default is from gravatar based on email. Supports 64 encoded images, in which case the limit is 50k characters. **/

10 avatar?: string;

11 /** Optional. Default false. **/

12 optedInNotifications?: boolean;

13 /** Optional. Default false. **/

14 optedInSubscriptionNotifications?: boolean;

15 /** Optional. 100 Characters Max. This label will be shown next to their name. Default is Administrator/Moderator when applicable. **/

16 displayLabel?: string;

17 /** Optional. 500 Characters Max. This will be shown instead of the username. **/

18 displayName?: string;

19 /** Optional. 2k Characters Max. The user's name will link to this. **/

20 websiteUrl?: string;

21 /** Optional. Up to 100 groups per user. A group id may not be longer than 50 characters. **/

22 groupIds?: string[];

23 /** Optional. Denotes the user as an administrator. **/

24 isAdmin?: boolean;

25 /** Optional. Denotes the user as a moderator. **/

26 isModerator?: boolean;

27 /** Optional, default true. Set to false to enable the "activity" tab in the user's profile. **/

28 isProfileActivityPrivate?: boolean;

29 /** Optional, default false. Set to true to disable profile comments. **/

30 isProfileCommentsPrivate?: boolean;

31 /** Optional, default false. Set to true to disable direct messaging this user. **/

32 isProfileDMDisabled?: boolean;

33}

34

Moderators and Administrators

Para administradores y moderadores, pasa las banderas respectivas isAdmin o isModerator en el objeto SSOUser.

Notifications

Para habilitar o deshabilitar las notificaciones, establece el valor de optedInNotifications en true o false respectivamente. La primera vez que el usuario cargue la página con este valor en la carga SSO, sus ajustes de notificación se actualizarán.

Además, si quieres que los usuarios reciban correos electrónicos de notificación por actividad en páginas a las que están suscritos (en lugar de solo notificaciones dentro de la aplicación), establece optedInSubscriptionNotifications en true.

VIP Users & Special Labels

Puedes mostrar una etiqueta especial junto al nombre del usuario usando el campo opcional "displayLabel".

Unauthenticated users

Para representar a un usuario no autenticado, simplemente no rellenes userDataJSONBase64, verificationHash ni timestamp. Proporciona una loginURL.

Estos usuarios no podrán comentar y en su lugar se les mostrará un mensaje de inicio de sesión (mensaje, enlace o botón, dependiendo de la configuración).

Direct Examples for Serializing and Hashing User Data

Más detalles y ejemplos directos aquí (js), aquí (java) y aquí (php).

Entendemos que cualquier integración puede ser un proceso complicado y doloroso. No dudes en ponerte en contacto con tu representante o usar la página de soporte.

FastComments SSO (detalles aquí) proporciona a tus usuarios una forma de comentar sin tener que iniciar sesión en otra plataforma.

Sin embargo, esto por sí solo no protege tus hilos de comentarios, ya que por defecto los datos de los comentarios son información pública: cualquiera que pueda ver la página puede ver los comentarios.

Al cambiar una configuración, podemos restringir la obtención de comentarios a menos que sea por un administrador o un usuario SSO válido.

No-Code Setup

Podemos evitar que se vean e interactúe con nuestros hilos de comentarios, cuando SSO está configurado, creando una regla de personalización.

Al hacerlo, busca SSO y encontrarás esta opción:

Require SSO To View Comments

Actívala y guarda la regla de personalización.

Solo proteger un dominio o una página determinada

Para proteger únicamente un dominio o una página concreta, simplemente configuraremos la regla de personalización para hacerlo.

En la parte superior de la interfaz de personalización, encontraremos dos campos, Domain y URL ID.

Para proteger solo un dominio en particular, introduce el dominio en cuestión en el campo "domain".

Para proteger una página concreta, introduce la URL de la página en el campo "URL ID". Si tienes una integración personalizada con FastComments, puedes introducir aquí un tipo de ID en lugar de una URL.

Niveles de seguridad

Al exigir SSO, querrás decidir si requieres Simple SSO o Secure SSO. Si requieres Simple SSO, entonces se permiten ambos, pero si requieres Secure SSO entonces el contenido debe recuperarse con una carga útil (payload) de Secure SSO hasheada con tu API key para poder ser visualizado.

La opción de nivel de seguridad aparecerá cuando selecciones "Requerir SSO para ver comentarios".

Protección más allá de la lectura

Habilitar esta opción protegerá la página o el dominio para que no se pueda comentar a menos que el usuario haya iniciado sesión vía SSO.

Advertencias

Cualquier usuario que haya creado comentarios antes de tu integración SSO no podrá verlos, a menos que inicie sesión mediante tu integración SSO.

Por defecto, FastComments requerirá un correo electrónico para comentar. No tiene que ser un correo electrónico válido, sin embargo hasta que el usuario haga clic en un enlace que se le envíe, su comentario mostrará una etiqueta "Comentario no verificado".

Sin embargo, podemos eliminar el requisito del correo electrónico. El campo de entrada de correo electrónico seguirá mostrándose, pero ya no será obligatorio.

Esto se puede configurar a través de la interfaz de personalización del widget:

Enabling Anonymous Comments

FastComments se puede configurar para eliminar comentarios no verificados después de un número deseado de días. Esto ayuda a combatir el spam.

Por defecto, no lo hace.

Esto puede configurarse, o deshabilitarse, desde la página Configuración de Moderación.

Moderation Settings

Cuando los usuarios comentan y no han iniciado sesión, se les pedirá que proporcionen su correo electrónico.

Esto creará una "sesión no verificada" para ese usuario, y le pediremos que verifique esa sesión por correo electrónico.

En algunos sitios o aplicaciones, es conveniente no pedir al usuario su correo electrónico al comentar o votar.

Habilitar los comentarios anónimos hace que el campo de correo electrónico sea opcional. Sin embargo, podemos desactivarlo por completo. Primero, habilite los comentarios anónimos, y entonces aparecerá la opción para desactivar los campos de correo electrónico.

Disable Email Inputs

Con esto activado, los campos de correo electrónico no se mostrarán en ninguno de nuestros productos de comentarios.

Tenga en cuenta que, con esta configuración, todos los comentarios estarán sin verificar a menos que el usuario cree una cuenta e inicie sesión en https://fastcomments.com.

Puede considerar desactivar la etiqueta 'no verificado'.

Por defecto, FastComments mostrará una etiqueta "Comentario no verificado" para los comentarios que se hayan dejado a un usuario que tiene una sesión de navegador no verificada. Más información sobre los comentarios no verificados aquí.

Disable The Unverified Label

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableUnverifiedLabel": true

8}];

9</script>

10

Además, esta función se puede usar, sin escribir código, en la interfaz de personalización:

Disable The Unverified Label

Cuando los usuarios intentan votar en un comentario y no han iniciado sesión, se les pedirá que indiquen su nombre de usuario y correo electrónico.

Podemos eliminar este requisito, permitiendo que cualquiera vote en un comentario sin proporcionar ninguna información.

Allow Anonymous Votes

Cuando los usuarios comentan o votan y no han iniciado sesión, se les pedirá que proporcionen su correo electrónico y su nombre de usuario.

En el caso de comentarios anónimos, a veces es conveniente definir un nombre de usuario predeterminado para reducir la fricción al comentar. Esto se puede hacer desde la interfaz de personalización. Primero deben estar habilitados los comentarios anónimos.

Setting The Default Username

De forma predeterminada, FastComments mostrará el widget de comentarios en la locale determinada por el sistema y el navegador del usuario.

Cuando un usuario comenta o inicia sesión, actualizamos su última locale utilizada y la usamos también para el envío de correos electrónicos.

Esto afecta cómo se traduce el widget de comentarios para el usuario. Locale consiste en el idioma y la región del usuario, por lo que configurar la locale normalmente cambiará el idioma que se muestra al usuario.

A través de la interfaz de personalización del widget

Esto puede definirse usando la interfaz de personalización del widget. Vea la opción "Locale / Language":

Changing The Locale / Language

Mediante código

Esto puede sobrescribirse con la locale deseada.

Manually Defining the User's Locale

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "locale": "ru_ru"

8}];

9</script>

10

Idiomas compatibles y códigos de locale

Puede encontrar la lista completa de idiomas compatibles y los códigos de locale correspondientes aquí.

Nota sobre SSO

Si usa SSO, quizás quiera pasar la locale del usuario en el objeto de usuario, para que los correos electrónicos y otros elementos estén correctamente localizados para ese usuario.

Por defecto, FastComments no limita los idiomas utilizados para comentar.

Puede ser deseable limitar los idiomas que utiliza una comunidad.

Esto se puede configurar sin código, en la página de personalización del widget:

Allowed Languages

El sistema analizará su comentario y determinará su idioma, y luego lo comparará con la lista permitida.

Si el comentario está escrito en un idioma que no está permitido, se mostrará un mensaje de error localizado.

Se puede bloquear la funcionalidad de comentarios para que no se puedan dejar nuevos comentarios ni votos, estableciendo la bandera readonly en true.

Los comentarios tampoco podrán editarse ni eliminarse.

Making The Comment Thread Readonly

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "readonly": true

8}];

9</script>

10

Esto se puede personalizar sin código, en la página de personalización del widget, para todo un dominio o una página:

Making The Comment Thread Readonly

¡Actualización!

A partir de noviembre de 2022, los hilos pueden bloquearse o desbloquearse en vivo por administradores y moderadores mediante el menú de tres puntos sobre el área de respuesta.

Esto impedirá nuevos comentarios, a la vez que permitirá la votación y que los usuarios eliminen sus comentarios si lo desean, mientras que readonly no permite estas acciones.

Esto corresponde al campo isClosed en la API Page.

Por defecto, FastComments permite enlazar a cualquier sitio externo.

Esto puede restringirse a una lista deseada de sitios o dominios. Intentar publicar un enlace a un sitio o dominio, que no esté en la lista definida mostrará un error al usuario.

Esta validación es solo para el Widget de Comentarios y la API. Las importaciones no se ven afectadas.

Esto se hace sin código, en la página de personalización del widget:

Restrict External Link Domains

Por defecto, FastComments solo pedirá al usuario su comentario, su nombre de usuario y su correo electrónico.

Sin embargo, en algunas situaciones es posible que desee que el usuario deje un enlace a su propio blog o sitio web.

Podemos habilitar la visualización de un campo de entrada adicional para dejar la URL del sitio web del usuario estableciendo la bandera enableCommenterLinks en true:

Enabling Commenter Links

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableCommenterLinks": true

8}];

9</script>

10

Cuando se proporciona dicha URL, la cuenta del usuario se actualizará y el nombre de usuario en todos sus comentarios, tanto pasados como futuros, enlazará a esta URL.

Esto se puede personalizar sin código, en la página de personalización del widget:

Enabling Commenter Links

Una lista de identificadores generados desde la página Grupos de Moderación.

Cuando se especifique, los comentarios publicados usando la configuración especificada contendrán el mismo conjunto de moderationGroupIds.

Si un Moderator tiene uno o más Grupos de Moderación definidos, solo verán los comentarios en la página Moderate Comments asociados con su(s) grupo(s).

Specify Moderation Groups

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "moderationGroupIds": [

8 "mxZAhjzdb",

9 "FT19nXbqA"

10 ]

11}];

12</script>

13

Para la autenticación, FastComments depende de que las cookies de terceros estén habilitadas en su navegador. Sin ellas, los usuarios siempre tendrán que dejar su email para comentar (a menos que el campo de entrada de email esté oculto), y sus comentarios siempre aparecerán como no verificados (por defecto).

Para solucionarlo, puede habilitar la omisión de cookies de terceros.

Cuando esta configuración está habilitada, provocará una pequeña ventana emergente que muestra un mensaje indicando que el usuario está iniciando sesión. Esta ventana emergente se muestra cada vez que el usuario interactúa con el widget de comentarios; por ejemplo, si dejan un comentario.

Podemos hacer esto en el código estableciendo la bandera enableThirdPartyCookieBypass a true:

Enabling Third-Party Cookie Bypass

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableThirdPartyCookieBypass": true

8}];

9</script>

10

También podemos configurar esto a través de la interfaz de personalización del widget, en Enable Third-Party Cookie Popup:

Enabling Third-Party Cookie Bypass

Por defecto, los usuarios pueden eliminar sus propios comentarios. Además, al eliminar su comentario automáticamente se eliminan todos los comentarios secundarios y transitorios en el hilo. Este comportamiento también está activo.

Puedes restringir esto de las siguientes maneras:

• En su lugar, anonimizar el comentario eliminado (establecer name y text a [deleted] o un valor personalizado).
• No permitir eliminar comentarios cuando hay respuestas. Se muestra un mensaje de error personalizable.
• Restringir la eliminación de comentarios con respuestas únicamente a administradores y moderadores.

Esto se puede configurar a través de la sección Comment Thread Deletion en la interfaz de personalización del widget.

Customize Delete Behavior for Replies

Por defecto, FastComments mostrará las insignias de los usuarios solo en sus comentarios dentro del hilo de comentarios.

Sin embargo, podemos mostrar las insignias de los usuarios junto a su nombre encima del formulario de comentario activando esta opción en la página de personalización del widget:

Show Badges in Top Bar Option

Esto mostrará las insignias del usuario junto a su nombre en el área de la barra superior, haciendo que sus logros y su estado sean más visibles cuando estén redactando un comentario.

Tenga en cuenta que esta función debe estar activada en la interfaz de personalización del widget para que funcione. Opcionalmente, puede establecer la bandera showBadgesInTopBar en false en su configuración de código para desactivarla selectivamente incluso cuando esté activada a nivel de servidor:

Disable Show Badges in Top Bar

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "showBadgesInTopBar": false

8}];

9</script>

10