Vistas previas de enlaces

Resumen

Esta página explica, para quienes administran el servidor, las vistas previas de enlaces: sus tres tipos, los lugares donde aparecen, cómo el frontend las obtiene del servidor y qué apps conocidas las proporcionan.

Las vistas previas de enlaces están disponibles en algunos lugares de APS Conecta Gestión. Hay 3 tipos de vista previa de enlace:

  • Las de los enlaces compatibles con un proveedor de referencias

    • Sin widget de referencia personalizado (usan un estilo genérico predeterminado: imagen + título + descripción)

    • Con widget de referencia personalizado (implementado por la app que admite el enlace)

  • Las predeterminadas, a partir de la información de OpenGraph. Es la alternativa para todo enlace no compatible

¿Dónde aparecen?

Las vistas previas de enlaces que proporciona el sistema de referencias de APS Conecta Gestión aparecen en los siguientes lugares:

  • Text (y páginas de Collectives, Notas, comentarios de tarjetas de Deck, comentarios de Archivos, etc.)

    • Directamente en el contenido del documento, junto a los enlaces

    • Solo se muestra una vista previa de enlace por párrafo

    • Pueden mostrarse widgets personalizados

  • Talk

    • En los mensajes

    • Solo se muestra una vista previa de enlace por mensaje

    • Pueden mostrarse widgets personalizados

  • Nextcloud Office

    • En el contenido del documento, al pasar el cursor sobre los enlaces

    • No se muestran los widgets personalizados

¿Cómo funciona?

El frontend de APS Conecta Gestión pide al servidor que resuelva los enlaces mediante una solicitud a la API. Como respuesta se devuelve un objeto enriquecido, que el frontend usa para mostrar la vista previa.

Las apps pueden registrar, de forma opcional, un widget de referencia personalizado para mostrar un tipo específico de objeto enriquecido (en los enlaces que admiten). Por lo tanto, las apps tienen total libertad sobre el aspecto de algunas vistas previas.

Proveedores conocidos de vistas previas de enlaces