Personalizaciones y configuración

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, utilizamos algo que llamamos "URL ID". Es un identificador, ya sea una cadena o un número, o una URL.

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

En el caso de integraciones de terceros, como WordPress, nuestro plugin suele 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.

Definir un ID de URL personalizado

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 a menudo haremos referencia en este documento es la Interfaz de Personalización del Widget.

Esta interfaz se puede usar para realizar muchos cambios en el widget de comentarios sin usar 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 concreta, ya sea para aplicar estilos personalizados o quizá hacer que los comentarios de esa página 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 mediante el campo de entrada URL ID en esta página, que se muestra de la siguiente manera:

Entrada de ID de URL en la página de personalización del widget

El valor en este campo debe coincidir con el parámetro urlId que se pasa al widget de comentarios. Si deseas que tu regla de personalización sea independiente del urlId, deja este campo vacío o ingresa *.

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

Cosas a tener en cuenta

1. Si tu página tiene parámetros de hash (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 necesites migrar los valores de comentarios del URL ID después de la migración inicial. Para ello, 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 uno de dos enfoques.

El primero, el enfoque más fácil y el que preferimos, es usar la página de personalización del widget.

En la página de personalización del widget, ve la sección "Mostrar opciones avanzadas", bajo la cual hay un área etiquetada como "CSS personalizado":

Área de entrada de CSS personalizado

Este enfoque tiene algunos beneficios:

1. El CSS ingresado 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 realicemos cambios en el widget de comentarios, tu estilo personalizado será probado como parte de nuestro proceso de lanzamiento.

El segundo enfoque es especificar el parámetro customCSS en la configuración del widget, de la siguiente manera:

Pasando CSS personalizado

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. Existe un límite a la cantidad de CSS personalizado que 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 más que una desventaja.
3. Hay una sobrecarga adicional al enviar el CSS personalizado a través de la red dos veces en este caso, ya que debe enviarse a nuestros servidores y luego devolverse en el contenido del iframe. Sin embargo, para la mayoría de los tamaños de carga, esto no es perceptible.
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 manejarlo tú mismo.
5. Tu CSS personalizado no será probado cuando realicemos cambios.

Archivos CSS externos

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

Se recomienda colocar el @import en una regla de personalización. De esta manera, 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 Avanzado y escribirías en CSS personalizado:

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

En código - No recomendado

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

Archivo CSS externo

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.

Estilizado del modal de perfil de usuario

Los modales de perfil de usuario también pueden estilizarse con CSS personalizado. Sin embargo, para garantizar 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 para los modales de perfil de usuario.

Por ejemplo:

CSS de perfil de usuario

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

Compatibilidad hacia atrás

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

Dado que esto es una parte importante de nuestro producto, contamos con una canalización de compilación que nos permite revisar los cambios al widget de comentarios, por cliente, en cada lanzamiento.

Si encontramos problemas menores, actualizaremos tu cuenta para garantizar que nuestro lanzamiento se realice sin problemas. Si vemos cambios importantes 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 el widget de comentarios completo.

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 regional/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 aquí bajo la pestaña "opciones avanzadas".

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

Texto personalizado

Todas las sobrescrituras de traducciones actualmente afectan a todas las configuraciones regionales.

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

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

Para especificar tu propia imagen de avatar estática, puedes 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 "Default Avatar".

Personalizando el Avatar Predeterminado

Ten en cuenta que definir el avatar para un usuario en particular, como con SSO, se cubre 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:

Ocultar avatares

Para proyectos de estilo personalizados más grandes, puede ser deseable comenzar con una hoja en blanco y no usar el estilo predeterminado en absoluto.

Todo el estilo predeterminado se puede eliminar estableciendo el parámetro noStyles a true, de la siguiente manera:

Desactivando todos los estilos predeterminados

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, bajo Opciones Avanzadas:

Desactivando todos los estilos predeterminados

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 los hijos.

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:

Colapsar respuestas

Esta configuración no afectará la cantidad de comentarios de nivel superior cargados inicialmente. Si tienes un comentario de nivel superior y 29 respuestas, con esta configuración activada, tú:

• Ver el comentario de nivel superior.
• Ver "Mostrar respuestas (29)" bajo este comentario.

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

Por defecto, las funcionalidades de formato en FastComments se realizan añadiendo etiquetas de anclaje visibles como <b></b> alrededor de su texto. Hacer clic en la barra de herramientas or using shortcuts does this for you. Sin embargo, algunas comunidades pueden querer optar por usar formato sin etiquetas de anclaje. Esto se llama habilitar el editor WYSIWYG (what you see is what you get). Este editor se ve exactamente igual que el predeterminado, excepto que carga código adicional que permite a los usuarios poner en negrita, subrayar, etc. su texto sin etiquetas de anclaje visibles.

Habilitando la edición WYSIWYG

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, vea la opción "Habilitar formato avanzado".

Habilitar WYSIWYG

Por defecto, FastComments mostrará una barra de herramientas al escribir un comentario para proporcionar accesos rápidos para decorar texto y subir imágenes.

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

Desactivando la barra de herramientas

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 puede hacerse sin código. En la página de personalización del widget, vea la opción "Desactivar la barra de herramientas de respuesta".

Desactivando la barra de herramientas

Por defecto, FastComments permite a los usuarios bloquear a otros usuarios. Bloquear a un usuario hará que sus comentarios se oculten, evita 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 también permite una validación adecuada del lado del servidor, a través de la interfaz de personalización del widget:

Desactivar bloqueo

Por defecto, se usan fechas relativas localizadas. Por ejemplo, junto a un comentario recién dejado puedes ver "hace 11 minutos".

Puede ser necesario o deseado usar fechas absolutas, en cuyo caso debes establecer este parámetro a true.

Usar fechas absolutas

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, bajo Opciones avanzadas:

Usar fechas absolutas

Por defecto, se utilizan fechas relativas localizadas. Por ejemplo, junto a un comentario recién publicado puedes ver "hace 11 minutos".

Puede ser necesario o deseado mantener este formato de fecha relativa, pero también mostrar la fecha completa junto a ella, en cuyo caso debes 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, bajo Opciones avanzadas. Primero deberás habilitar Fechas absolutas para ver esta opción en la interfaz.

Usar tanto fechas absolutas como relativas

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

Llamamos a esto 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, bajo Opciones Avanzadas:

Especificar HTML de encabezado

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

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

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

Renderizar enlaces como texto

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

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

Haga clic para mostrar comentarios

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

Haga clic para mostrar u ocultar comentarios

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 recuento se actualiza en tiempo real con el hilo de comentarios. El botón no se muestra si no hay comentarios.

Esto puede habilitarse sin código creando una regla de personalización y activando "Mostrar comentarios al hacer clic":

Activar Mostrar comentarios al hacer clic

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

Esto puede reemplazarse con cualquier cadena, y el valor [count] será sustituido por el valor del recuento, localizado para el usuario.

Personalizando el texto del recuento de comentarios

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 se puede personalizar sin código, en la página de personalización del widget:

Personalizando el texto del recuento de comentarios

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

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

Para hacerlo, simplemente habilite 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 volverá roja y mostrará un recuento del número de notificaciones que tiene el usuario. Algunas notificaciones de ejemplo son:

• El usuario te respondió.
• El usuario respondió en un hilo en el que comentaste.
• El usuario votó positivamente tu comentario.
• El usuario respondió a una página a la que te has suscrito.

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

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

Desactivar la campana de notificaciones

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 se puede hacer sin código. En la página de personalización del widget, vea la sección "Desactivar la campana de notificaciones".

Desactivar la campana de notificaciones

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

Sin embargo, podemos desactivar esta funcionalidad:

Desactivar perfiles

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, vea la sección "Desactivar perfiles".

Desactivar perfiles

Por defecto, FastComments mostrará una pestaña de "Comentarios de perfil" en los perfiles de usuario, permitiendo a los visitantes dejar comentarios en el perfil de alguien.

Sin embargo, podemos desactivar esta pestaña:

Desactivar Comentarios de Perfil

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 "disableProfileComments": 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 sección "Desactivar Comentarios de Perfil".

Desactivar Comentarios de Perfil

Por defecto, FastComments mostrará una pestaña de "Mensajes Directos" en los perfiles de usuario, permitiendo a los visitantes enviar mensajes directos a un usuario.

Sin embargo, podemos desactivar esta pestaña:

Disable Profile Direct Messages

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 "disableProfileDirectMessages": 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 sección "Disable Direct Messages".

Desactivar mensajes directos del perfil

Por defecto, FastComments mostrará un mensaje de éxito después de comentar. Esto se puede desactivar 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:

Desactivar mensaje de éxito

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

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

Esto se puede establecer en el código o a través de la UI. En el código podemos hacerlo de la siguiente manera:

Establecer clasificación de Gif

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 UI, encontrarás esto bajo Gif Picker Rating siempre que Disable Image Uploads? no esté marcado.

Configurando la clasificación de Gif

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, encontrarás esto bajo Image Content Moderation Level siempre que Disable Image Uploads? no esté marcado.

Configurando el Nivel de Moderación de Contenido de Imagen

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

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

Usamos la bandera voteStyle de la siguiente manera:

Activar botón de corazón

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 que lo hagas sin código, ya que también habilita validaciones del lado del servidor. En la página de personalización del widget, consulta la sección "Estilo de voto".

Cambiar estilo de votación

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

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

Sin embargo, es posible evitarlo.

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

Desactivar eliminación de comentarios

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

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

Sin embargo, es posible evitarlo.

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

Desactivar edición de comentarios

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

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

El tamaño de página se puede personalizar en la Widget Configuration UI en tamaños variables que van 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 se puede configurar 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:

Tamaños de página personalizados

Los tamaños de página pueden personalizarse globalmente, o 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 ingresó, o como se le pasó a través de SSO.

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

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

Cambiar Formato de Nombre

Los formatos disponibles son:

• Capitalizar (mostrar al usuario de ejemplo como Example User)
• Inicial del Apellido (mostrar Example User como Example U.)
• Todas las Iniciales (mostrar Example User como E. U.)
• Mostrar "Anonymous"

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

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

Por defecto, FastComments permite subir imágenes. Esto se puede desactivar configurando la bandera noImageUploads a 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:

Desactivar carga de imágenes

Por defecto FastComments no permite iframes en los comentarios. Cuando habilitas incrustaciones de medios, los comentaristas pueden pegar el código de incrustación (el fragmento <iframe>) de proveedores de confianza como YouTube, Vimeo, SoundCloud y Spotify, y se mostrará en línea dentro del comentario.

Por razones de seguridad, esto no es una bandera de configuración del widget del lado del cliente. Es una configuración del lado del servidor, validada cuando se guarda cada comentario, por lo que no se puede activar desde la página. Sólo se permiten iframes que apunten a una lista incorporada de proveedores de confianza. Cualquier otro iframe se elimina.

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

Permitir incrustaciones de medios

Añadiendo tus propios proveedores

Si deseas permitir incrustaciones de un proveedor que no está en la lista de confianza incorporada, agrega su nombre de host en el campo "Dominios de incrustación adicionales" en la misma página. Estos nombres de host se permiten además de los proveedores incorporados. La coincidencia es exacta, así que incluye el nombre de host completo (por ejemplo, player.example.com). Cualquier cosa que no listes permanecerá bloqueada.

Tanto el cuadro de comentario simple como el editor WYSIWYG admiten pegar una incrustación. En el editor WYSIWYG la incrustación se inserta como un bloque removible.

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

Sin embargo, podemos activarlo estableciendo la bandera enableSearch a true:

Habilitando la búsqueda

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, vea la opción "Enable Search Box".

Casilla de búsqueda habilitada

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

Habilitando 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 "Enable Spoilers".

Habilitar Spoilers

Cuando el texto está resaltado y se hace clic en el botón SPOILER ahora visible, el texto se enmascarará hasta que el usuario pase el cursor sobre él. Para el modo oscuro hacemos lo mismo, con colores diferentes que se adaptan 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 el sistema comenzará a rastrear a medida que cada usuario se desplace a un comentario.

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

Podemos habilitarlo estableciendo la bandera enableViewCounts a true:

Habilitando el recuento de vistas de comentarios

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:

Habilitando el recuento de vistas de comentarios

Rastreamos el id de usuario* que vio el comentario, de modo que si vuelves a ver el comentario no se incrementa. Si vuelves a ver el comentario después de dos años, el recuento se incrementará más.

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

Por defecto, los comentarios en vivo están habilitados. Esto significa que si se añaden, eliminan, editan o fijan comentarios, los cambios deberían aparecer para 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á bajo 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 pujas en vivo o eventos en línea, este no es el comportamiento deseado; puede que quieras que el widget de comentarios sea más como una caja de "chat" donde los nuevos comentarios "se muestren de inmediato".

De ahí el nombre de la bandera que habilita esa función: showLiveRightAway.

Podemos activarla de la siguiente manera:

Mostrar comentarios en vivo de inmediato

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:

Mostrar comentarios en vivo de inmediato

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

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

Por ejemplo, si se agrega un comentario, ese comentario debería mostrarse. Si un comentario se edita o elimina, entonces esos comentarios se editarán o eliminarán para todos los espectadores del hilo. Lo mismo ocurre 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, vea la sección "Disable Live Commenting".

Desactivar Comentarios en Vivo

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

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

El usuario puede entonces cambiar la dirección de ordenación a "Oldest" o "Newest First" en la interfaz del widget de comentarios.

Sin embargo, podemos cambiar el valor predeterminado a cualquiera de los tres. Por ejemplo, si deseas mostrar primero los comentarios más antiguos:

Cambiar la Ordenación Predeterminada a Más Antiguos Primero

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

Establecemos el valor de defaultSortDirection a "OF" para fijar la dirección a "OF".

Para la dirección de ordenación newest-first, haríamos lo siguiente:

Cambiar la Ordenación Predeterminada a Más Recientes Primero

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: "Most Recent"
• NF: "Newest First"
• OF: "Oldest First"

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".

Cambiar la Dirección de Ordenación Predeterminada

Tenga en cuenta que los comentarios en cada página para cada dirección de ordenación se pre‑calculan, 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 moverlo a después.

Moviendo el cuadro de respuesta al final

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:

Moviendo el cuadro de respuesta al final

El número máximo de caracteres permitidos para ingresar en el campo de entrada de comentarios puede ser limitado por el parámetro maxCommentCharacterLength.

El valor predeterminado es 2000.

Elementos como 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:

Limitar longitud del comentario

Por defecto, FastComments permitirá al usuario ingresar un comentario con tantas líneas como desee, hasta el límite de caracteres predeterminado.

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

Activamos la bandera useSingleLineCommentInput de la siguiente manera:

Habilitar entrada de comentario de una sola línea

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, vea la sección "Habilitar entrada de comentario de una sola línea".

Habilitar entrada de comentario de una sola línea

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

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

Esto se rastrea por ID de usuario, ID de usuario anónimo y dirección IP (hasheada).

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

Limitando el volumen de comentarios por usuario

Ten en cuenta que si estás usando la API de creación de comentarios, puede que quieras pasar la dirección ip original del usuario en la solicitud a nuestro backend para que la limitación de velocidad se aplique por usuario y no globalmente a tu cuenta.

FastComments le permite exigir que los comentaristas que comentan por primera vez acepten sus Términos de Servicio antes de enviar un comentario.

Cuando está habilitado:

• Usuarios anónimos verán una casilla de verificación de TOS cada vez que comenten
• Usuarios autenticados verán la casilla solo en su primer comentario, o cuando actualice sus TOS

Configuración

Navegue a la página de personalización del widget y habilite la casilla "Require Terms of Service acceptance". Una vez habilitada, verá las siguientes opciones:

Opciones de Términos de Servicio

• Modo de texto del TOS: Por defecto, la casilla muestra "Acepto los Términos de Servicio y la Política de Privacidad" con enlaces a ambos documentos. Seleccione "Personalizar texto por idioma" para proporcionar su propio texto para cada idioma.
• Fecha de última actualización del TOS: Cuando actualice sus Términos de Servicio, establezca esta fecha. Los usuarios que aceptaron antes de esta fecha deberán volver a aceptar.

Cómo funciona

• La marca de tiempo de aceptación del TOS se almacena por usuario y por comentario
• Cuando un usuario acepta el TOS, la fecha se registra en su perfil de usuario (por inquilino)
• Si establece una fecha de "Última actualización" que sea posterior a la fecha de aceptación del usuario, necesitarán volver a aceptar
• Para usuarios anónimos que no pueden ser rastreados, la casilla aparece en cada envío de comentario

FastComments Secure SSO utiliza encriptación HMAC-SHA256 como el mecanismo para implementar SSO. Primero revisaremos la arquitectura general, proporcionaremos ejemplos y pasos detallados.

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

El flujo se ve así:

Flujo SSO Seguro

Dado que Secure SSO implica desarrollo full-stack, ejemplos de código completos y funcionales en Java/Spring, NodeJS/Express y PHP vanilla 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 esos entornos de ejecución para implementar FastComments SSO: los paquetes criptográficos nativos funcionan.

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

Get Your 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".

Comment Widget Parameters

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

Vamos a detallar qué significan estos parámetros.

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

Para habilitar SSO, pasa un nuevo objeto "sso", que debe tener los siguientes parámetros. Los valores deben generarse en el 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 más de dos días en el pasado.
• loginURL: Una URL que el widget de comentarios puede mostrar para que el usuario inicie sesión.
• logoutURL: Una URL que el widget de comentarios puede mostrar para que el usuario cierre sesión.
• loginCallback: Cuando se proporciona en lugar de la URL de inicio de sesión, 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 URL de cierre de sesión, 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": 1787115343254.0,

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

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

13 "loginCallback": null,

14 "logoutCallback": null

15 }

16}];

17</script>

18

The User Object

El objeto de usuario

Copy

1

2interface SSOUser {

3 /** Requerido. Máx. 1k caracteres. **/

4 id: string;

5 /** Requerido. Máx. 1k caracteres. Nota: Debe ser único. **/

6 email: string;

7 /** Requerido. Máx. 1k caracteres. Nota: El nombre de usuario no puede ser un correo electrónico. No tiene que ser único. **/

8 username: string;

9 /** Opcional. Máx. 3k caracteres para URLs. Por defecto se obtiene de gravatar basado en el correo electrónico. Soporta imágenes codificadas en base64, en cuyo caso el límite es 50k caracteres. **/

10 avatar?: string;

11 /** Opcional. Por defecto false. **/

12 optedInNotifications?: boolean;

13 /** Opcional. Por defecto false. **/

14 optedInSubscriptionNotifications?: boolean;

15 /** Opcional. Máx. 100 caracteres. Esta etiqueta se mostrará junto a su nombre. Por defecto es Administrador/Moderador cuando corresponda. **/

16 displayLabel?: string;

17 /** Opcional. Máx. 500 caracteres. Esto se mostrará en lugar del nombre de usuario. **/

18 displayName?: string;

19 /** Opcional. Máx. 2k caracteres. El nombre del usuario enlazará a esto. **/

20 websiteUrl?: string;

21 /** Opcional. Hasta 100 grupos por usuario. Un id de grupo no puede exceder los 50 caracteres. **/

22 groupIds?: string[];

23 /** Opcional. Indica que el usuario es administrador. **/

24 isAdmin?: boolean;

25 /** Opcional. Indica que el usuario es moderador. **/

26 isModerator?: boolean;

27 /** Opcional, por defecto true. Establecer a false para habilitar la pestaña "activity" en el perfil del usuario. **/

28 isProfileActivityPrivate?: boolean;

29 /** Opcional, por defecto false. Establecer a true para desactivar los comentarios de perfil. **/

30 isProfileCommentsPrivate?: boolean;

31 /** Opcional, por defecto false. Establecer a true para desactivar el envío de mensajes directos a este usuario. **/

32 isProfileDMDisabled?: boolean;

33 /** Configuración opcional para insignias de usuario. **/

34 badgeConfig?: {

35 /** Array de IDs de insignias globales para asignar. Limitado a 30 insignias. Se respeta el orden. **/

36 badgeIds: string[];

37 /** Array de IDs de insignias con alcance en la página actual (urlId). Solo se muestran en la página asignada. **/

38 pageBadgeIds?: string[];

39 /** Si es true, reemplaza las insignias mostradas existentes. Las globales y las específicas de página se sobrescriben de forma independiente. **/

40 override?: boolean;

41 /** Si es true, actualiza las propiedades de visualización de la insignia desde la configuración del tenant. **/

42 update?: boolean;

43 };

44}

45

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 a true o false respectivamente. La primera vez que el usuario carga la página con este valor en la carga útil SSO, su configuración de notificaciones se actualizará.

Adicionalmente, si quieres que los usuarios reciban correos electrónicos de notificación por actividad en páginas a las que se suscribieron (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 un usuario no autenticado, simplemente no completes userDataJSONBase64, verificationHash ni timestamp. Proporciona un loginURL.

Estos usuarios no podrán comentar y, en su lugar, se les presentará 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 aquí (js), aquí (java) y aquí (php).

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

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

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

Al cambiar una configuración, podemos restringir que los comentarios se obtengan a menos que lo haga un administrador o un usuario SSO válido.

No-Code Setup

Podemos evitar la visualización e interacción con nuestros hilos de comentarios, cuando SSO está configurado, creando una regla de personalización.

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

Requerir SSO para ver comentarios

Actívela y guarde la regla de personalización.

Only Protect a Certain Domain or Page

Para proteger solo un dominio o página específicos, simplemente configuraremos la regla de personalización para hacerlo.

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

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

Para proteger una página en particular, introduzca la URL de la página en el campo "URL ID". Si tiene una integración personalizada con FastComments, puede introducir aquí un tipo de ID en lugar de una URL.

Security Levels

Al requerir SSO, querrá decidir si requiere SSO Simple o SSO Seguro. Si requiere SSO Simple, entonces ambos están permitidos, pero si requiere SSO Seguro, el contenido debe obtenerse con una carga útil de SSO Seguro hashada con su clave API para poder ser visualizado.

La opción de nivel de seguridad aparecerá cuando seleccione "Require SSO To View Comments".

Protection Beyond Reading

Activar esta opción protegerá la página o dominio de ser comentado a menos que el usuario haya iniciado sesión mediante SSO.

Gotchas

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

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

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

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

Enabling Anonymous Comments

FastComments puede configurarse para eliminar los 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 desactivarse, a través de la página Configuración de Moderación.

Configuración de Moderación

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 mediante correo electrónico.

Para algunos sitios o aplicaciones, es deseable no solicitar al usuario su correo electrónico al comentar o votar.

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

Desactivar campos de correo electrónico

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

Ten en cuenta que, con esta configuración, todos los comentarios serán no verificados a menos que el usuario cree una cuenta e inicie sesión en https://fastcomments.com.

Puede que desees considerar desactivar la etiqueta no verificada.

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

Desactivar la etiqueta de comentario no verificado

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:

Desactivar la etiqueta de comentario no verificado

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

Podemos eliminar este requisito, permitiendo que cualquier persona vote en un comentario sin dejar ninguna información.

Permitir Votos Anónimos

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

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

Estableciendo el nombre de usuario predeterminado

Por defecto, FastComments renderizará el widget de comentarios en la configuración regional determinada por el sistema y el navegador del usuario.

Cuando un usuario comenta o inicia sesión, actualizamos su última configuración regional utilizada y la usamos también para enviar correos electrónicos.

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

Via The UI

Esto se puede definir usando la interfaz de personalización del widget. Consulte la opción "Locale / Language":

Cambiar la configuración regional / idioma

Via Code

Esto se puede sobrescribir con una configuración regional deseada.

Definiendo manualmente la configuración regional del usuario

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

Supported Languages and Locale Codes

¡Puedes encontrar la lista completa de idiomas compatibles y los códigos de configuración regional correspondientes aquí!

SSO Note

Si estás usando SSO, quizás quieras pasar la configuración regional del usuario en el objeto de usuario, de modo que los correos electrónicos y otras cosas se localicen correctamente para él.

By default, FastComments does not limit languages used to comment.

It may be desirable to limit the languages a community uses.

This can be configured without code, on the widget customization page:

Idiomas permitidos

The system will parse their comment and determine its language, and then match it with the allowed list.

If the comment is written in a language that is not allowed, then a localized error message is shown.

Se puede bloquear la capacidad de comentar para que no se puedan dejar nuevos comentarios o votos estableciendo la bandera readonly en true.

Los comentarios tampoco podrán ser editados o eliminados.

Haciendo el hilo de comentarios de solo lectura

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 un dominio completo o una página:

Haciendo el hilo de comentarios de solo lectura

¡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 encima del área de respuesta.

Esto evitará nuevos comentarios, mientras sigue permitiendo votar y permite a los usuarios eliminar sus comentarios si lo desean, mientras que readonly no permite estas cosas.

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 provocará que se muestre 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:

Restringir dominios de enlaces externos

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

Sin embargo, en algunas situaciones puede que desees 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 que el usuario ingrese la URL de su sitio web estableciendo la bandera enableCommenterLinks a 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 todos sus nombres de usuario en comentarios pasados y futuros enlazarán a esa URL.

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

Habilitar enlaces de comentarista

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 correo electrónico para comentar (a menos que el campo de entrada de correo esté oculto), y sus comentarios siempre se mostrarán como no verificados (por defecto).

Para evitar esto, puede habilitar la derivación de cookies de terceros.

Cuando esta configuración está habilitada, se mostrará una pequeña ventana emergente que indica que el usuario está iniciando sesión. Esta ventana emergente aparece siempre que el usuario interactúa con el widget de comentarios; por ejemplo, si deja un comentario.

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

Activar la omisión de cookies de terceros

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 UI de Personalización del Widget, bajo Enable Third-Party Cookie Popup:

Activar la omisión de cookies de terceros

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

Puede restringir esto de las siguientes maneras:

• En su lugar, anonimice el comentario eliminado (establezca el nombre y el texto a [deleted] o a un valor personalizado).
• No permita eliminar comentarios cuando hay respuestas. Se muestra un mensaje de error personalizable.
• Restrinja la eliminación de comentarios que tienen respuestas solo a administradores y moderadores.

Esto se puede configurar a través de la sección Comment Thread Deletion en la UI de Personalización del Widget.

Personalizar el comportamiento de eliminación para respuestas

Por defecto, FastComments mostrará los distintivos de usuario solo en sus comentarios dentro del hilo de comentarios.

Sin embargo, podemos mostrar los distintivos de usuario junto a su nombre encima del formulario de comentarios habilitando esta función en la página de personalización del widget:

Opción de Mostrar Distintivos en la Barra Superior

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

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

Desactivar Mostrar Distintivos en la Barra Superior

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

Por defecto, FastComments no muestra una lista de usuarios en la página.

Puedes renderizar una lista de personas que están viendo la página en ese momento, junto al widget de comentarios. La lista se actualiza en tiempo real a medida que los usuarios se unen y salen, y muestra su nombre, avatar y un indicador de conexión.

Hay tres opciones de diseño:

• 1 - Superior: una fila horizontal de avatares superpuestos renderizada encima de los comentarios.
• 2 - Izquierda: una barra lateral con nombres y puntos en línea renderizada a la izquierda del widget.
• 3 - Derecha: la misma barra lateral renderizada a la derecha del widget.

Establece la bandera usersListLocation para habilitar la función:

Mostrar lista de usuarios a la derecha

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 "usersListLocation": 3

8}];

9</script>

10

Por defecto, la lista muestra solo a los usuarios que están en línea. Para incluir también a personas que han comentado en la página en el pasado (pero que no la están viendo actualmente), establece usersListIncludeOffline a true:

Incluir comentaristas anteriores

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 "usersListLocation": 3,

8 "usersListIncludeOffline": true

9}];

10</script>

11

Los comentaristas anteriores se renderizan sin el punto verde de en línea, de modo que quede claro quién está presente ahora.

Los usuarios con perfiles privados se muestran con un avatar genérico y una etiqueta "Perfil privado" para que el recuento siga siendo preciso sin revelar identidades.

Esto también se puede configurar sin código. En la página de personalización del widget, consulta la opción "Ubicación de la lista de usuarios". Cuando la ubicación se establece en cualquier valor distinto de Off, aparece una casilla de verificación "Incluir comentaristas anteriores" debajo.

Configuración de la lista de usuarios

Con más de 500 usuarios en vivo, la lista puede estar desactualizada hasta 30 segundos.