
Idioma 🇪🇸 Español
Instalación
APIs de recuento de comentarios
FastComments proporciona widgets ligeros e independientes de recuento de comentarios que pueden mostrar el número de comentarios de páginas o publicaciones específicas. Estos widgets son independientes del widget principal de comentarios y están diseñados para usarse en cualquier lugar donde quieras mostrar los recuentos de comentarios sin la interfaz completa de comentarios.
Hay dos tipos de widgets de recuento de comentarios disponibles:
- Widget de recuento de comentarios - Para mostrar el recuento de comentarios de una sola página
- Widget de recuento de comentarios por lotes - Para mostrar de forma eficiente los recuentos de comentarios de varias páginas en una misma página
Este artículo cubre los widgets de VanillaJS. Nuestras librerías de React/Angular/etc. también tienen sus propios widgets.
Instalación del widget de recuento de comentarios 
El Widget de Conteo de Comentarios esta disenado para mostrar el conteo de comentarios de una sola pagina. Es liviano y proporciona actualizaciones en tiempo real si se configura.
Instalacion Basica
Run 
Opciones de Configuracion
La funcion FastCommentsCommentCount acepta las siguientes opciones de configuracion:
- tenantId (requerido): Tu ID de tenant de FastComments
- urlId (opcional): El identificador de la pagina. Por defecto es
window.location.hrefsi no se especifica - numberOnly (opcional): Si es
true, solo muestra el numero sin texto. Por defecto esfalse - isLive (opcional): Si es
true, el conteo se actualizara automaticamente. Por defecto esfalse
Ejemplos Avanzados
URL ID Personalizado
Run 
Mostrar Solo Numero
Run 
Actualizaciones en Vivo
Run 
Metodos del Widget
El widget devuelve un objeto con los siguientes metodos:
- destroy(): Elimina el widget y limpia todos los temporizadores
- update(config): Actualiza el widget con una nueva configuracion
Ejemplo de Uso
Run 
Estilos
El widget renderiza HTML simple con el conteo de comentarios y viene con estilos minimos. Puedes personalizar la apariencia con CSS:
Run 
Instalación masiva del widget de recuento de comentarios 
El Widget de Conteo Masivo de Comentarios esta disenado para mostrar eficientemente los conteos de comentarios de multiples paginas en la misma pagina. En lugar de realizar llamadas API individuales para cada conteo de comentarios, este widget agrupa las solicitudes para un rendimiento optimo.
Instalacion Basica
Run 
Como Funciona
El widget masivo funciona mediante:
- Escanear la pagina en busca de elementos con la clase
fast-comments-count - Leer el atributo
data-fast-comments-url-idde cada elemento - Agrupar solicitudes API para obtener multiples conteos de comentarios eficientemente
- Actualizar cada elemento con el conteo de comentarios apropiado
Opciones de Configuracion
La funcion FastCommentsCommentCountBulk acepta las siguientes opciones de configuracion:
- tenantId (requerido): Tu ID de tenant de FastComments
- apiHost (opcional): Host API personalizado si estas usando una instancia auto-alojada
Ejemplo del Mundo Real
Aqui hay un ejemplo practico que muestra como podrias usar el widget masivo en un listado de publicaciones de blog:
Run 
Consideraciones de Rendimiento
El widget masivo optimiza automaticamente el rendimiento mediante:
- Agrupacion de solicitudes: Multiples conteos de comentarios se obtienen en una sola llamada API
- Limites de tamano de solicitud: Las solicitudes se dividen automaticamente si la lista de URLs se vuelve demasiado grande (mas de 1,000 caracteres)
- Deduplicacion: Multiples elementos con el mismo
data-fast-comments-url-idcomparten el mismo conteo
Multiples Elementos con el Mismo URL ID
Puedes tener multiples elementos en la pagina con el mismo data-fast-comments-url-id. Todos seran actualizados con el mismo conteo:
Run 
Localizacion
El widget masivo formatea automaticamente los conteos de comentarios segun tu configuracion de idioma de FastComments. Proporciona texto apropiado para:
- Cero comentarios
- Un comentario
- Multiples comentarios
Cuando Usar el Widget Masivo vs Individual
Usa el Widget Masivo cuando:
- Tienes multiples conteos de comentarios en la misma pagina
- Estas mostrando una lista de publicaciones/articulos con conteos de comentarios
- El rendimiento es importante (reduce las llamadas API)
Usa el Widget Individual cuando:
- Solo necesitas un conteo de comentarios en la pagina
- Necesitas actualizaciones en vivo (el widget individual soporta actualizaciones en tiempo real)
- Quieres mas control sobre el comportamiento individual del widget
APIs de recuento de comentarios 
Hay varios endpoints para obtener los conteos, dependiendo de lo que quieras y si quieres obtenerlos desde un navegador, servidor o usando el SDK de la API.
Conteos Publicos de Comentarios
Puedes obtener los conteos publicos de comentarios usando los widgets anteriores o usando las APIs que ellos usan. Estas APIs han permanecido sin cambios desde 2019 y nunca cambiaran.

Esto devolvera una estructura como:

La propiedad postfix siempre esta incluida.

Esto devolvera una estructura como:

El objeto counts solo se completa para paginas que tienen conteos. El mapa translations siempre esta presente ya que se usa para el widget.
Comportamiento de Endpoints Publicos / Cache
Los endpoints publicos tienen un mecanismo de cache de 60 segundos para manejar picos de trafico. Internamente, esto es un cache LRU por hilo en memoria en el servidor, por lo que puedes ver que los conteos cambian ligeramente (suben y luego bajan temporalmente) cuando las personas dejan muchos comentarios.
Los endpoints publicos siempre devuelven el conteo total de comentarios, no el conteo de comentarios raiz.
APIs del Lado del Servidor / SDK
La forma de obtener comentarios desde tu servidor es llamar a la API de Paginas y obtener el objeto de pagina, que contiene el conteo total de comentarios y el conteo de comentarios raiz. Proporcionamos SDKs que te permiten llamar a esta API sin construir la solicitud de API manualmente y proporcionan valores de retorno tipados.
Los widgets de recuento de comentarios de FastComments proporcionan una forma sencilla y eficiente de mostrar la cantidad de comentarios en todo su sitio.
Esperamos que esta documentación le haya resultado útil.