GMC Facebook Feed Gallery documentacion
GMC Facebook Feed Gallery documentacion
Posts, fotos y videos Facebook renderizados como galerias nativas CMS.
Que hace este componente
GMC Facebook Feed Gallery belongs to the FuerteventuraTV CMS catalogue and is supported through GMC AI Ticketing. Product package key: pkg_gmc_facebook_feed_gallery.
Requisitos
- A supported Joomla 5/6 or WordPress install according to the product platform.
- PHP 8.1 or newer unless the product page says otherwise.
- Administrator access for installation, configuration and update checks.
- A valid FuerteventuraTV purchase/licence for paid downloads and private updates.
Flujo diario
- Usa GMC Facebook Feed Gallery desde el backend CMS, no desde dashboards SaaS externos salvo integracion explicita.
- Anota pagina, shortcode, posicion modulo o item menu donde se publica el output.
- Mantiene un elemento de prueba publicado para reproducir rapidamente problemas de display y update.
Actualizaciones y controles de licencia
- Abre la administracion CMS y confirma la version instalada antes de cambiar archivos.
- Mantiene activa la licencia/download id en la configuracion del producto cuando exista ese campo.
- Para Joomla usa Extensions > Update, pulsa Check For Updates, selecciona el producto y ejecuta Update.
- Si el update no aparece, limpia la cache de updates y verifica que el update site apunta al feed FuerteventuraTV.
Ticket de soporte
Open a support ticket with product name, installed version, domain, order email, licence/download id if available, and the exact error message. The AI assistant must cite this documentation or escalate to a human when the answer is not fully covered.
Paginas relacionadas
Guia de instalacion
Usa la guia de instalacion Joomla o WordPress enlazada desde la documentacion CMS. Instala el ZIP correcto, haz backup, guarda la licencia cuando se pida y prueba en una pagina privada antes de publicar.
Guia de configuracion
Abre la configuracion del producto en el administrador CMS. Revisa licencia, roles, cache, privacidad, avisos y claves de proveedor solo cuando ese producto usa un proveedor externo.
Documentacion de usuario
Estas notas son para propietarios del sitio y editores: primera prueba, uso diario, limites de soporte, privacidad y datos para abrir un ticket. No requieren editar codigo fuente.
Todo incluido
61 funciones reales, agrupadas por área — toda la profundidad de la Facebook Feed Gallery, no un simple escaparate.
Fuentes del feed y fiabilidad
- Modo Page Plugin sin token — incrusta el Facebook Page Plugin oficial sin ninguna configuración de API; solo pega la URL pública de una Página.
- Galerías vía Meta Graph API — extrae las publicaciones, fotos, vídeos o álbumes de fotos de la propia Página y los muestra como una galería real en el sitio, usando un token de acceso oficial de la Página.
- Respaldo automático — si la Graph API no devuelve nada o da error, recurre a la incrustación del Page Plugin, de modo que el bloque nunca se muestra vacío.
- Sigue en línea durante las caídas — cuando la Graph API está lenta o inaccesible, sirve la última copia en caché del contenido ya obtenido, así las páginas siguen cargándose en lugar de romperse.
- Feeds multicuenta unificados — guarda un token por cada Página y muestra varias Páginas de Facebook fusionadas en un único feed de más reciente primero, sin duplicados (hasta 10 fuentes).
- Feeds multi-ID — una lista
page_id="111,222"(separada por coma o barra vertical, hasta 10 ID) se despliega en llamadas Graph por cada ID y fusiona los resultados. - Cuatro tipos de contenido — publicaciones, fotos, vídeos o un navegador interactivo de álbumes de fotos, todos desde el mismo widget.
Diseños y visualización en la página
- Seis estilos de visualización — tarjetas, lista, masonry, adaptación al tema YOOtheme/tema activo, "showcase" con abundante información y un diseño de home-feed estilo revista.
- Preajuste nativo adaptado al tema — hereda automáticamente el aspecto de tu tema activo (marcado UIkit real en Joomla/YOOtheme Pro; CSS autónomo y coherente en WordPress).
- Preajuste showcase con abundante información — cuadrícula de fotos con una superposición de degradado oscuro que muestra el pie de foto, la fecha y el número de me gusta/comentarios, más un glifo de enlace permanente de Facebook y revelación al pasar el ratón.
- Modo carrusel / deslizador — muestra el preajuste adaptado al tema como un deslizador desplazable con flechas anterior/siguiente y puntos.
- Pestañas de contenido en el widget — un solo widget puede ofrecer un selector de pestañas Publicaciones / Fotos / Vídeos alimentado por edges de Graph separados.
- Navegador de álbumes de fotos — una cuadrícula de los álbumes de la Página (portada + nombre + recuento); haz clic en un álbum para ver sus fotos en el lightbox, con un botón para volver — todo obtenido en una sola llamada Graph.
- Chips de filtro por álbum — define álbumes etiquetados mediante palabras clave del pie de foto y deja que los visitantes filtren la cuadrícula del lado del cliente ("Todos" + chips por álbum).
- Cuadrícula configurable — de 1 a 6 columnas, espaciado ajustable y recorte de imagen cuadrado o natural.
- Cargar más + desplazamiento infinito — un botón Cargar más con un umbral inicial configurable, o activación automática al desplazar.
- Botón de llamada a la acción — CTA opcional por tarjeta (etiqueta y URL personalizadas) que enlaza a donde elijas.
- Elige qué se muestra — interruptores independientes para el encabezado, el texto de la publicación y la fila de estadísticas de me gusta/comentarios/compartidos.
- Estadísticas de interacción + enlace de retorno — recuentos opcionales de me gusta, comentarios y compartidos en las publicaciones, con un enlace opcional a la publicación original de Facebook.
- Preajustes de inicio rápido — puntos de partida con un clic (Simple, Showcase, Carrusel, Home de revista, Álbumes) que establecen valores de diseño sensatos.
- Selectores de color de acento y superposición — personaliza la superposición/el acento del showcase con colores hexadecimales validados.
Medios y lightbox
- Lightbox integrado — abre fotos y vídeos en una ventana modal dentro de la página (sin redirección), con un panel informativo que muestra el pie de foto, la fecha, los me gusta, los comentarios y un enlace "Ver en Facebook".
- Caché de medios local (conforme al RGPD) — descarga opcionalmente los medios remotos a tu propio servidor, de modo que nada se transmita en directo desde la CDN de Meta en cada visita; evita volver a descargar los archivos que ya están en disco.
- Extracción inteligente de medios — elige la imagen más grande para mostrar y la más pequeña para las miniaturas, y detecta los adjuntos de vídeo (incluidos los subadjuntos) en las publicaciones.
Curaduría y filtrado de contenido
- Filtros de palabras clave incluir / excluir — muestra u oculta publicaciones según las palabras de su pie de foto.
- Palabras prohibidas — suprime cualquier publicación que contenga los términos que indiques.
- Ocultar publicaciones concretas — excluye publicaciones individuales por ID.
- Eliminación de duplicados — los feeds unificados de varias fuentes descartan automáticamente las repeticiones.
Conecta tu Página (configuración de administración)
- Easy Connect mediante GMC (sin necesidad de app de Meta) — un solo botón: inicia sesión con Facebook, aprueba tu Página, listo; el relay alojado de GMC gestiona el inicio de sesión y el plugin guarda el token de la Página — el relay nunca almacena tu token. (Requiere tu clave de licencia; se desbloquea cuando el relay está activo.)
- Conectar con Facebook (avanzado, con tu propia app de Meta) — OAuth con un clic que obtiene automáticamente el token y el ID de la Página, con un selector de varias Páginas cuando gestionas más de una.
- Intercambio manual de token permanente — pega un token de Usuario de corta duración y obtén a cambio un token de Página sin caducidad, sin necesidad del Access Token Debugger.
- Asistente de configuración guiado — un recorrido de conexión en tres pasos en la pantalla de ajustes.
- Botón de probar conexión — valida el token/ID de la Página contra la Graph API en vivo y devuelve mensajes claros (token caducado/no válido, ID de Página incorrecto, permiso faltante, límite de peticiones).
- Alertas de token no válido — un error Graph 190 marca el token y muestra un aviso en administración para que sepas que debes reconectar.
- Permisos mínimos — solicita únicamente
pages_show_list+pages_read_engagement, evitando los errores "Invalid Scopes". - Versión de Graph e idioma configurables — establece la versión de la Meta Graph API y el idioma del SDK de Facebook.
Gestión y creación desde administración
- Gestor de feeds guardados — una lista en el backend de los widgets guardados con crear/editar, duplicar y copiar shortcode; incrusta cualquier feed guardado por ID (
id="N"). - Panel de vista previa del diseño en vivo — una vista previa con mosaicos de marcador de posición en el editor que se actualiza al cambiar columnas/estilo/recorte/carrusel/álbumes (aproximada; el aspecto exacto del tema es en el front-end).
- Conexión global vs por widget — reutiliza una única conexión global de la Página o sobrescribe las credenciales por cada feed guardado.
- Shortcodes en todas partes — inserta un feed en cualquier artículo/página con cuatro alias de shortcode intercambiables; los atributos en línea siempre prevalecen sobre los valores guardados.
- Bloque Gutenberg para WordPress — un bloque nativo
gmc/facebook-feedpara el editor. - Widget clásico para WordPress — un widget heredado para las zonas de barra lateral/pie de página.
- CPT FB Feeds para WordPress — gestiona los feeds guardados como un tipo de contenido personalizado con una caja meta de opciones de visualización y una columna de shortcode en la lista.
- Opciones de incrustación del Page Plugin — pestañas de cronología/eventos/mensajes, ancho/alto, encabezado reducido, ocultar portada e interruptores de facepile.
Rendimiento y caché
- Caché de respuestas de Graph — TTL configurable (caché en archivo en Joomla, transients en WordPress) con tiempo de espera de petición ajustable.
- Caché negativa del gateway — una comprobación de licencia fallida se almacena en caché durante ~10 minutos, de modo que una caída del gateway no vuelva a disparar una llamada HTTP bloqueante en cada visita.
- Purga diaria de la caché de medios — una tarea programada elimina automáticamente los medios en caché ya obsoletos.
- Escrituras seguras ante concurrencia — los archivos de caché/medios se escriben con bloqueo para evitar la corrupción bajo carga.
Seguridad, privacidad y RGPD
- Escape completo de la salida y refuerzo de la entrada — ID de Página depurados con regex, tokens en lista blanca y salida siempre con escape.
- Lista de hosts permitidos de la CDN de Meta — las descargas de medios locales se restringen a los hosts propios de Meta mediante un remote-get seguro.
- Los secretos permanecen en el servidor — el App Secret de Meta se almacena cifrado y se usa solo del lado del servidor, nunca expuesto en el front-end; la clave de licencia se envía solo de servidor a servidor.
- Autoalojamiento para el RGPD — la caché de medios local opcional mantiene copias en tu propio servidor; ubicaciones de la caché documentadas para retención/eliminación.
Internacionalización
- Inglés, italiano y español listos para usar — tanto las cadenas de administración como las del front-end (asistente, cuadros de conexión, lightbox, Cargar más, filtros de álbum, etiquetas de estadísticas) están completamente traducidas, y respeta la configuración multilingüe de tu sitio.
Confianza y licencia
- GPLv2 o posterior — licencia de código abierto.
- Autoalojado, datos oficiales — lee directamente de la Meta Graph API / Facebook Page Plugin oficiales; sin intermediario SaaS de terceros (a diferencia de los feeds de la competencia enrutados a través de la API de un proveedor).
- Actualizaciones con un clic bajo licencia — la extensión comprueba automáticamente el servidor de actualizaciones de GMC / FuerteventuraTV (~cada 24 h) y ofrece las nuevas versiones a través del actualizador normal del CMS mientras tu licencia esté activa.
- Download Key por correo electrónico — entregada con tu correo de compra; se introduce una sola vez para desbloquear las actualizaciones.
- Periodo de gracia de la licencia — un sitio con licencia previa sigue funcionando durante una caída del gateway (último estado válido conocido); solo se bloquea ante una denegación definitiva.
- Licencia de un sitio — cubre un sitio; acuerdos de volumen/agencia bajo solicitud. Se vende por plataforma (Joomla y WordPress son productos/builds independientes).
Joomla y WordPress
- Joomla — la adaptación al tema/carrusel/pestañas/lightbox emiten marcado UIkit nativo (
uk-card,uk-slider,uk-tab,uk-lightbox) para que las galerías hereden el tema YOOtheme Pro activo, con respaldo elegante en sitios sin UIkit; incluye un componente de administración real con gestor de widgets guardados y un alias de shortcode adicionalgmcsocialpage; normalización de publicaciones más rica (estadísticas de interacción). - WordPress — el mismo conjunto de funciones con CSS/JS autónomos (sin dependencia de UIkit); añade un bloque Gutenberg, un widget clásico y un tipo de contenido personalizado FB Feeds; interruptor de actualización automática y limpieza total al desinstalar de ajustes, licencia y datos en caché.
FAQ - Preguntas frecuentes
Necesito acceso de desarrollador?
No para uso normal. El acceso administrador al CMS basta para instalacion, configuracion, actualizaciones y primeras pruebas.
Puedo usar paquetes Joomla y WordPress indistintamente?
No. Usa el ZIP Joomla en Joomla y el ZIP WordPress en WordPress. Si un producto existe en ambas plataformas, sigue la guia del CMS correcto.
Donde configuro licencia y actualizaciones?
Usa la configuracion del producto o la pantalla de update/licencias del CMS. Descargas paid y updates privados requieren la licencia/download key FuerteventuraTV activa.
Que debo enviar al soporte?
Envia producto, version, CMS, URL del sitio, captura, error exacto y lo que ya probaste. No envies passwords, API keys ni tokens en el ticket.


