GMC Facebook Feed Gallery — Documentación (WordPress)
GMC Facebook Feed Gallery integra las publicaciones, fotos y vídeos de una página de Facebook directamente en tu sitio WordPress como una galería rápida y responsive, con un lightbox local, caché de medios opcional y shortcodes sencillos. Funciona con dos modos de conexión: el Page Plugin oficial de Facebook (sin token) o la Meta Graph API para una galería totalmente nativa. Está pensado para operadores turísticos, hoteles, restaurantes y cualquier marca activa en Facebook que quiera ese contenido en su propio sitio en lugar de un embed fijo de terceros.
Instalación
- En tu escritorio de WordPress ve a Plugins → Añadir nuevo → Subir plugin.
- Selecciona el archivo
.zipdel plugin que descargaste (déjalo comprimido) y haz clic en Instalar ahora. - Haz clic en Activar. Tras la activación, la pantalla de ajustes del plugin aparece en el menú de administración.
Requisitos: WordPress 6.0 o superior y PHP 8.1 o superior.
Configuración
Abre la pantalla de ajustes del plugin desde el menú de administración y decide qué modo de conexión quieres:
- Page Plugin (modo alternativo) — no requiere token. El plugin muestra el Page Plugin oficial de Facebook de tu página. Puedes definir el idioma del Page Plugin y guardar sus valores por defecto en los ajustes globales.
- Meta Graph API — introduce un token de acceso de página de la Meta Graph API en los ajustes. Este modo obtiene publicaciones, fotos y vídeos y los muestra como una galería nativa y responsive. También puedes fijar una versión concreta de la Graph API si lo necesitas.
Otros ajustes que conviene revisar:
- Caché local de medios — actívala para servir fotos y vídeos desde tu propio sitio, lo que hace la configuración más compatible con el RGPD y mantiene el feed renderizado incluso cuando la Graph API va lenta. Un mecanismo de caché obsoleta ante errores sigue mostrando el último contenido válido si la API no está disponible temporalmente, de modo que el bloque nunca se queda en blanco durante una caída.
- Valores de diseño por defecto — diseño en tarjetas o en lista, número de columnas, un botón Cargar más, cabecera y texto de la página opcionales, estadísticas de me gusta / comentarios / compartidos y un enlace opcional de vuelta a Facebook.
- Colores — hay selectores de color de acento y de superposición tanto en el editor del widget como en los ajustes globales del plugin.
La vía más rápida hacia un feed funcional es un feed guardado: usa los preajustes de configuración rápida, mantén el modo de conexión global, deja para más tarde las opciones avanzadas plegadas, comprueba la vista previa del diseño en vivo y copia el shortcode ya preparado.
Uso del plugin
Insertar un feed con shortcodes
Hay cuatro shortcodes disponibles que pueden colocarse en cualquier entrada, página o área de widgets: [gmcfacebookpagefeed], [gmcfacebookfeed], [gmcfacebookgallery] y [gmcsocialpage]. Ejemplos:
- Embed del Page Plugin:
[gmcfacebookpagefeed page="https://www.facebook.com/PAGE_NAME" tabs="timeline"] - Galería con la Graph API:
[gmcfacebookgallery page_id="PAGE_ID" access_token="TOKEN" type="photos" columns="3"]
Con un feed guardado normalmente no escribes los atributos a mano: la pantalla de ajustes te da un shortcode listo para copiar del feed que configuraste.
Diseños de galería y lightbox
Los feeds de la Graph API se muestran con diseños responsive en tarjetas o en lista, con columnas configurables y un botón Cargar más opcional. Las fotos y los vídeos se abren en un lightbox local, así que los visitantes permanecen en tu sitio. El diseño Showcase añade una superposición que aparece al pasar el ratón y muestra el texto de la publicación junto con los me gusta / comentarios y la fecha, con 3 columnas fijas por defecto.
Comportamiento de la caché
Cuando la caché local de medios está activada, los medios que el plugin ya ha descargado se sirven desde tu sitio. Si la Graph API va lenta o está temporalmente caída, el plugin sirve el contenido en caché que ya tiene, de modo que la página se sigue renderizando en lugar de romperse.
Idiomas
El plugin incluye de serie inglés, italiano y español y respeta la configuración multilingüe de tu sitio.
Actualizaciones y licencia
Tras la compra recibes una Download Key con tu correo de licencia. Introdúcela en la pantalla de ajustes del plugin: esta clave desbloquea las actualizaciones con un clic desde el servidor de actualizaciones de GMC / FuerteventuraTV. El plugin consulta el servidor de actualizaciones por sí solo (aproximadamente cada 12 horas) y muestra las nuevas versiones en Plugins / Escritorio → Actualizaciones como cualquier otro plugin, siempre que tu licencia esté activa. El actualizador valida la URL de descarga del gateway licenciado antes de usarla para una actualización con un clic, y también puedes volver a descargar la última versión desde tu cuenta en cualquier momento.
El software se publica bajo la GNU GPL. Tu compra cubre la build oficial, las actualizaciones licenciadas y el soporte para un sitio; la licencia se aplica al plugin wp-gmc-facebook-page-feed — la edición para Joomla es un producto aparte. Para más sitios o proyectos de clientes, contáctanos para un acuerdo de volumen o de agencia.
Soporte
Para recibir ayuda, responde a tu correo de compra o escríbenos por WhatsApp al +34 633 168 995 (la misma línea aparece en tu correo de licencia). Incluye el nombre y la versión del producto, tu versión de WordPress y de PHP, y una URL pública o una captura de pantalla con los tokens o claves ocultos. Respondemos en inglés, italiano y español. Si el producto no funciona como se describe y no podemos solucionarlo, puedes solicitar un reembolso dentro de los 14 días posteriores a la compra.
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é.
