Blog en directo

Live Blog le permite presentar actualizaciones en tiempo real e imágenes de los propios editores del sitio al cubrir un evento en directo.

Blog en directo

Live Blog le permite presentar actualizaciones en tiempo real e imágenes de los propios editores del sitio al cubrir un evento en directo.

de CRM

Live Blog le permite presentar actualizaciones en tiempo real e imágenes de los propios editores del sitio al cubrir un evento en directo.

Para incrustar una aplicación de blog en directo, siga el procedimiento para incrustar una aplicación. Consulte Incrustar una aplicación. A continuación se muestra un ejemplo del aspecto que tiene una aplicación de blog en directo integrada.

Ejemplo

<html> 
  <head> 
    <script src="//cdn.livefyre.com/Livefyre.js"> 
    </script> 
  </head> 
<body> 
    <script type="text/javascript"> 
    var networkConfig = { 
      network: "client-solutions.fyre.co" 
    }; 
    var convConfig = { 
      siteId: '347674', 
      articleId: '1', 
      el: 'livefyre', 
      collectionMeta: 'eyJ0eXAiOiJqd3QiLCJhbGciOiJIUzI1NiJ9.eyJ0aXRsZSI6IlRpdGxlIDEiLCJ1cmwiOiJodHRwOlwvXC9kZXYubGl2ZWZ5cmUuY29tIiwidGFncyI6InRhZzEsdGFnMiIsImNoZWNrc3VtIjoiY2Q0YTJjYWJkMTIxOTkyM2FjZGJhMjExOWY2NmYwNTUiLCJhcnRpY2xlSWQiOiIxIn0.Dq-ghi9KYmEPmagvCS1NPyYDRMGBujm735QaTRb7E7k', 
      checksum: '6e2e4faf7b95f896260fe695eafb34ba' 
    }; 
    
    Livefyre.require(['fyre.conv#3'], function(Conv) { 
        new Conv(networkConfig, [convConfig], function(blogWidget) {}); 
        auth.delegate({ 
          login: function (callback) { 
            callback(null,{livefyre:'<userauthtoken>'}); 
          }, 
        }); 
    }); 
  
    </script> 
    <div id="livefyre"> 
    </div> 
   </body> 
</html>

CollectionMeta es un objeto JSON codificado. En el ejemplo anterior, el objeto JSON toma el siguiente formato antes de su codificación JWT:

{ 
"url": "https://dev.livefyre.com/articles/test.html",  
"articleId": "1",  
"type": "liveblog",  
"title": "Title 1" 
}

Objeto NetworkConfig

El objeto NetworkConfig es un objeto JSON que personaliza el sistema de autenticación para usuarios de red.

El objeto NetworkConfig es un objeto JSON que contiene los siguientes parámetros:

Parámetro Tipo Descripción
authDelegate ** requiredobject Se utiliza para personalizar el sistema de autenticación para usuarios de red personalizados.
network ** cadena requerida Un nombre de red proporcionado por Livefyre. Por ejemplo: yourname.fyre.co.
attachmentDelegate ** optionalobject Se utiliza para especificar los tipos de archivos adjuntos de contenidos visibles en el flujo de aplicaciones. Para obtener más información, consulte Restricting Media.
cadenas ** optionalobject Se utiliza para personalizar cadenas de texto de los elementos HTML en cualquiera de las aplicaciones principales de Livefyre. Para obtener más información, consulte Personalizaciones de cadenas.

Objeto ConvConfig

El objeto convConfig es un objeto JSON utilizado para especificar el contenido que la aplicación Livefyre procesa en la página.

NOTA

Los parámetros de objeto convConfig enumerados aquí no se aplican a la aplicación de revisiones. Para obtener información sobre la integración de la aplicación de revisiones con el objeto convConfig , consulte Integración de revisiones.

El objeto ConvConfig contiene los siguientes parámetros obligatorios:

Parámetro Tipo Descripción
articleId ** required string Identifica de forma exclusiva una colección dentro del sitio. Normalmente, esto corresponde a una clave principal de base de datos o a un ID de anuncio dentro de su CMS. Por ejemplo: "post-42". Límite de 255 caracteres. Nota: Si utiliza la URL del artículo como articleId, asegúrese de que la cadena tenga codificación MD5 o SHA-1.
collectionMeta ** required string Metadatos con codificación JWT sobre la colección. Consulte CollectionMeta Object para obtener más información.
el ** required string El ID de un elemento DOM al que se procesará el flujo de contenido.
siteId ** required string El ID proporcionado por Livefyre para el sitio web o la aplicación a la que pertenece la colección. Por ejemplo: "303617".
NOTA

El parámetro app no es necesario para una implementación de la aplicación Comentarios.

El objeto ConvConfig también puede contener los siguientes parámetros opcionales:

Parámetro Tipo Descripción
actionButton ** matriz opcional Matriz de botones de acción personalizados para agregar a un fragmento de contenido junto a los botones Compartir y Marcar. Para obtener más información, consulte Adición de botones personalizados.
animaciones ** opcional booleano Define si las animaciones se ejecutarán dentro de la aplicación Livefyre. Establézcalo en false para deshabilitar las animaciones. El valor predeterminado es true.
anonymousFlaggingEnabled Booleano Define si los usuarios invitados tienen la opción de marcar el contenido. El valor predeterminado es true.
browserType ** optionalString Define el dispositivo para el que se debe generar el contenido de visualización. Esto hará que el CSS, y algunas funciones, cambien para ajustarse al tipo de dispositivo de entrada. Las opciones son escritorio, móvil o tableta. (Si se deja en blanco, pasará de forma predeterminada a la determinación del agente de Google para el formato de visualización).
checksum ** cadena opcional (recomendado) Identifica el estado actual de CollectionMeta. Si se cambia este valor, Livefyre actualizará los datos del servidor con los nuevos valores de CollectionMeta.
datetimeFormat ** función de objeto de cadena opcional Especifica el formato de fecha y hora del contenido transmitido. Para obtener más información, consulte Personalización de marcas de fecha y hora.
disableAvatars ** opcional booleano Evita que los avatares se representen en el flujo de la aplicación y, por lo tanto, reduce el número de elementos cargados en el explorador. El valor predeterminado es false.
disableIE8Shim ** opcional booleano Desactiva el shiv predeterminado utilizado por Livefyre para rellenar Internet Explorer 8 de modo que se admitan los elementos HTML5. Livefyre utiliza el siguiente proyecto: https://github.com/aFarkas/html5shiv . El valor predeterminado es false. Nota: Si este valor es false, se debe usar un tipo de polyfill antes de que se invoque Livefyre Chat para el soporte de Internet Explorer 8.
disableThirdPartyAnalytics ** opcional booleano Desactiva los sistemas de análisis de terceros (Quantserve y Google Analytics) que Livefyre puede utilizar para las mediciones internas. El valor predeterminado es false.
editorCss ** optionalobject Se utiliza para personalizar el estilo del editor de comentarios. Puede aplicar estilo al color de fondo del campo del editor, así como al color de fuente, el tamaño y la familia del texto que aparece dentro del editor. Por ejemplo: {fondo: ‘#ccc’, color: "rojo", fuente: "Helvetica Neue", Helvetica, Arial, Ginebra, sans-serif"
initialNumVisible ** optionalinteger Permite establecer el número predeterminado de comentarios visibles en la aplicación al cargarlos. Puede ser un número entero entre 1 y 50.
initialNumVisibleLegacy ** optionalinteger Permite establecer el número predeterminado de elementos de contenido heredados visibles en la aplicación al cargarlos. Puede ser un número entero entre 1 y 50. Si no se especifica este parámetro, el valor predeterminado es initialNumVisible. Por ejemplo: Si la colección incluye 100 comentarios activos y 100 comentarios heredados, establezca initalNumVisible:10 e initialNumVisibleLegacy:5 para mostrar 10 comentarios activos (con el botón Mostrar más ) + 5 comentarios de archivo (con el botón Mostrar más ).
maxVisible ** optionalinteger Establece el número máximo de fragmentos visibles de contenido de nivel superior en la aplicación de chat. Si hay nuevos fragmentos de flujo de contenido en , el contenido de la parte inferior del flujo se eliminará de la página. Si se hace clic en el botón Mostrar más… , se ignora el parámetro y el usuario puede mostrar todo el contenido que desee. (Utilice este parámetro para controlar el número de elementos que aparecen en la página en flujos de alta velocidad).
postToButton ** matriz opcional Se utiliza para configurar los proveedores que aparecen al incrustar la aplicación de blog en directo. Las opciones disponibles son dos (Twitter), fb (Facebook) y li (LinkedIn). El valor predeterminado es [ tw , fb ].
readOnly ** opcional booleano Desactiva toda la interactividad de la colección. Cuando se establece en true, los usuarios no pueden iniciar sesión en el flujo y no pueden anunciar, editar, responder o "Me gusta" del contenido. Cuando sea verdadero, los usuarios podrán marcar y compartir contenido. El valor predeterminado es false.
flujo ** optionalobject Contiene opciones para configurar la transmisión de la aplicación.
stream.catchup ** optionalinteger Especifica el número de segundos anteriores al momento actual en el que se debe cargar el flujo. De forma predeterminada, Livefyre carga 50 fragmentos de contenido y, a continuación, carga todo el contenido enviado entre ellos y la hora actual. En casos de uso muy rápido, el contenido se puede publicar demasiado rápido para permitir que la aplicación se "ponga al día" en el presente. Utilice esta configuración para definir el número de segundos transcurridos desde antes de que se publique el contenido (después de la carga inicial del contenido).
stream.delay ** optionalinteger Especifica el número de segundos entre solicitudes de flujo continuo. Utilice este parámetro para ayudar a controlar el flujo de contenido y retrasar la frecuencia con la que se actualiza el DOM. Nota: Si se configura demasiado grande, el flujo puede quedar rezagado.
NOTA

Puede pasar uno o varios objetos convConfig durante la inicialización de la aplicación para mostrar varias aplicaciones en la misma página. Tenga en cuenta que las aplicaciones adicionales utilizan recursos del explorador y el rendimiento puede degradarse a medida que aumenta el número.

CollectionMetaObject

El objeto CollectionMeta es un objeto JSON que especifica los metadatos que se guardarán en la colección.

CollectionMeta siempre se codifica antes de pasarse a Livefyre para su seguridad. El valor codificado se pasa al objeto ConvConfig que se muestra arriba.

NOTA

Debe añadir código del lado del servidor para codificar el objeto JSON CollectionMeta. Consulte Creación de tokens del lado del servidor para obtener más información.

Parámetro Tipo Descripción
articleId ** required string Un ID único para la colección.
title ** required string El título que desea aplicar a la colección. Esto suele corresponder al título de la página que muestra la aplicación. Por ejemplo: "¡La integración es tan divertida!" Nota: La longitud máxima de caracteres del título es de 255 caracteres. El campo de título no admite entidades HTML. Codifique caracteres especiales utilizando UTF-8.
url ** required string La URL absoluta canónica que desea adjuntar a esta colección. Esta URL se utilizará para generar vínculos a la aplicación a partir de contenido compartido en Facebook y Twitter, notificaciones por correo electrónico y Livefyre Studio. Nota: Livefyre requiere el uso de un nombre de dominio completo; no es necesario el número de puerto o una llamada de retorno para resolver la configuración local. Si realiza pruebas localmente, asegúrese de utilizar un dominio de URL base válido. (Por ejemplo: https://customer.com es válido, mientras que https://localhost:5995 no lo es.) Una vez configurado el servidor web local para aceptar un nombre de dominio completo, no se necesitan llamadas de retorno ni resoluciones y el desarrollo local puede continuar según lo esperado.
type ** requiredString El tipo Collection . Debe ser livechat .

El objeto CollectionMeta también puede contener el siguiente parámetro opcional:

Parámetro Tipo Descripción
etiquetas **cadena opcional Una lista separada por comas de palabras clave o expresiones únicas. Buscar colecciones por etiquetas en Studio o con la API de búsqueda.** Nota:** Aunque las etiquetas añadidas a través de Studio pueden contener espacios, las etiquetas introducidas a través de la API no pueden. Utilice guiones bajos para definir las etiquetas que mostrarán los espacios en la interfaz de usuario. (Por ejemplo: utilice lunes_trimestre para mostrar lunes al trimestre en Studio.)

Adición de un controlador de eventos

Para registrar los controladores de eventos, utilice la llamada a widget.on dentro de la función de llamada de retorno de la aplicación.

Por ejemplo:

Livefyre.require(['fyre.conv#3'], function(Conv) { 
   new Conv(networkConfig, [convConfig], function(widget) { 
      widget.on('<strong><eventName></strong>', function (data) { 
         // Do something, perhaps using data 
      }); 
   }); 
});

En esta página