GMC Instagram Feed Gallery — Documentación (WordPress)
GMC Instagram Feed Gallery muestra tus publicaciones y reels de Instagram en una galería responsive en tu propio sitio WordPress. Funciona en dos modos de conexión: pega URLs de publicaciones o reels individuales sin necesidad de token de acceso, o conecta una cuenta Instagram Business / Creator a través de la Meta Graph API para un feed que se actualiza automáticamente. Está dirigido a marcas, hoteles, restaurantes, operadores turísticos y sitios de contenido que quieren su contenido de Instagram en páginas propias, con control total sobre el diseño, la carga y la privacidad.
Requisitos: WordPress 6.0 o superior, PHP 8.1 o superior.
Instalación
- Descarga el
.zipdel plugin desde tu email de compra o desde tu cuenta. Mantenlo comprimido. - En tu escritorio de WordPress ve a Plugins → Añadir nuevo → Subir plugin.
- Elige el archivo
.zip, haz clic en Instalar ahora y luego en Activar. - Tras la activación, la pantalla de ajustes del plugin aparece en el menú de administración.
Configuración
Abre la pantalla de administración del plugin y decide qué modo de conexión necesitas:
- Modo manual (sin token): no hay nada que conectar. Proporcionas directamente las URLs de publicaciones o reels de Instagram, ya sea en una galería guardada o en el propio shortcode. Es la forma más rápida de poner una galería en marcha.
- Feed de cuenta (Graph API): conecta una cuenta de Instagram Business o Creator a través de la Meta Graph API. Una vez conectada, la galería obtiene tus últimas publicaciones automáticamente. Un modo de conexión global permite que las galerías guardadas reutilicen la misma conexión de cuenta en lugar de configurarla galería por galería.
Al crear una galería guardada, el editor ofrece presets de configuración rápida, opciones avanzadas plegadas, una vista previa del diseño en vivo y un shortcode listo para copiar, así que una galería básica lleva un par de minutos. Las opciones principales que conviene revisar:
- Diseño: cuadrícula o masonry, con varios estilos visuales. El estilo showcase usa un valor por defecto fijo de tres columnas y revela el pie de foto, los me gusta/comentarios y la fecha al pasar el ratón.
- Colores: los selectores de color de acento y de superposición están disponibles tanto en el editor de galerías como en los ajustes globales del plugin.
- Filtros: filtros de medios foto/vídeo y reglas de texto de inclusión / exclusión para seleccionar qué elementos aparecen.
- Carga: cuántos elementos se cargan inicialmente, más botón de cargar más o scroll infinito.
- Extras: pies de foto, el lightbox local integrado y una llamada a la acción opcional.
- Caché local de medios: opcionalmente cachea los medios en local para una configuración más orientada al RGPD.
Uso del plugin
Insertar una galería con shortcodes
Inserta un shortcode en cualquier entrada, página o bloque que admita shortcodes. Para una galería manual a partir de URLs de publicaciones/reels:
[gmcinstagramgallery urls="https://www.instagram.com/p/POST_ID/" columns="3"]
Para un feed de cuenta conectada:
[gmcinstagram limit="24" columns="3" infinite="1"]
Los atributos habituales incluyen columns (columnas de la cuadrícula), limit (número de elementos) e infinite (scroll infinito). Las galerías guardadas muestran un shortcode listo para copiar en el editor, así puedes pegarlo sin recordar los atributos.
Seleccionar qué aparece
Usa el filtro de medios para mostrar solo fotos o solo vídeos, y las opciones de texto de inclusión / exclusión para mantener o descartar elementos según sus pies de foto. Por ejemplo, excluye publicaciones que contengan un hashtag que uses para contenido interno, o incluye solo publicaciones que mencionen una etiqueta de campaña. Los contadores de me gusta y comentarios de los medios propios se muestran cuando están disponibles, y las miniaturas de vídeo se gestionan automáticamente.
Comportamiento en el frontend
Los visitantes ven una galería responsive en cuadrícula o masonry acorde a tu tema. Al hacer clic en un elemento se abre el lightbox local integrado — sin redirección a Instagram salvo que la quieras. Según tus ajustes, se cargan más elementos mediante un botón de cargar más o scroll infinito, y la CTA opcional da a la galería un objetivo de conversión (por ejemplo, un enlace a tu página de reservas o de contacto).
Idiomas
El plugin incluye inglés, italiano y español y respeta la configuración multilingüe de tu sitio.
Actualizaciones y licencia
Es un producto de pago (compra única). Tras la compra recibes una Download Key junto con tu email de licencia. Introdúcela en la pantalla de ajustes del plugin — el campo de la clave se muestra tras la activación, dentro del propio menú de administración del plugin. La clave desbloquea las actualizaciones con licencia en un clic desde el servidor de actualizaciones de GMC / FuerteventuraTV.
Las actualizaciones son automáticas: el plugin consulta el servidor de actualizaciones por sí solo (aproximadamente cada 12 horas) y ofrece las nuevas versiones en Plugins o Escritorio → Actualizaciones, como cualquier otro plugin, mientras tu licencia esté activa. 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 versión oficial, las actualizaciones en un clic y el soporte para un sitio; la licencia se aplica al plugin wp-gmc-instagram-gallery, mientras que la edición para Joomla se vende por separado. Para varios sitios o proyectos de clientes, contáctanos para un acuerdo por volumen o de agencia.
Soporte
Para obtener ayuda, responde a tu email de compra o escríbenos por WhatsApp al +34 633 168 995 (la misma línea aparece en tu email de licencia). Incluye por favor:
- el nombre del producto y la versión,
- tus versiones de WordPress y PHP,
- una URL pública o una captura de pantalla (con las claves ocultas).
Respondemos en inglés, italiano y español. Si el plugin 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
76 funciones reales, agrupadas por área — toda la profundidad de la Instagram Feed Gallery, sin relleno.
Fuentes de contenido y modos de conexión
- Embeds manuales sin token — pega las URL de posts, reels o TV y obtén una galería curada sin ningún token de acceso y sin conectar ninguna cuenta.
- Feed de cuenta vía Graph API — recupera automáticamente todo el contenido de una cuenta Business o Creator mediante la API oficial Meta Graph, de modo que la galería se actualiza sola a medida que publicas.
- Validación de URL integrada — solo se aceptan enlaces reales de post/reel/tv de
instagram.com; cualquier otra cosa se descarta en silencio, así un pegado erróneo no puede romper la página. - Versión de Graph API, user ID y token configurables — los defines desde la pantalla de ajustes; el token viaja como cabecera
Authorization: Bearer, nunca expuesto en URL ni en registros.
Fuentes de feed y descubrimiento
- Múltiples modos de fuente de feed — elige
own,username(otro perfil de empresa público mediante business discovery),taggedohashtagpor cada galería. - Combinación multicuenta (hasta 10) — combina varios ID de cuenta de Instagram en un único feed, unido de lo más reciente a lo más antiguo, deduplicado por ID de contenido y limitado a tu número máximo de elementos.
- Tokens por fuente — cada cuenta adicional puede llevar su propio token de acceso; las cuentas sin token recurren al token principal.
- Resistente a una fuente caída — si una cuenta falla se omite (sirviendo su última caché válida cuando está disponible) mientras el resto del feed se sigue mostrando.
- Feeds de hashtag opt-in y fail-closed — el modo hashtag permanece desactivado hasta que lo habilitas explícitamente tras la Meta App Review, evitando configuraciones erróneas accidentales.
Diseños y estilos visuales
- Cuadrícula responsive o masonry — elige una cuadrícula uniforme y limpia o un diseño masonry al estilo Pinterest que se adapta a cualquier tamaño de pantalla.
- De 1 a 8 columnas + espaciado ajustable — ajusta con precisión la densidad de la galería, con número de columnas por galería y espaciado de 0 a 48 px.
- Recorte cuadrado o natural — fuerza mosaicos cuadrados uniformes o conserva la relación de aspecto nativa de cada post.
- Set completo de estilos —
clean,tiles,rounded,polaroid,caption, más theme-match, showcase y otros presets integrados para looks concretos. - Preset YOOtheme / theme-match — hereda las tarjetas, colores, fuentes y transiciones al pasar el cursor de tu tema activo; en Joomla genera marcado UIkit nativo (
uk-card/uk-grid/uk-overlay/uk-lightbox) y degrada con elegancia en sitios sin UIkit. - Modo carrusel / slider — muestra el preset theme-match como slider (
uk-sliderUIkit nativo con flechas, puntos y deslizamiento en Joomla; un slider autónomo con scroll-snap en WordPress) en lugar de una cuadrícula.
Preset showcase e interacción
- Estilo showcase rico en información — cada mosaico recibe una superposición de degradado oscuro que revela el pie de foto, la fecha del post y el recuento de me gusta/comentarios, además de un icono de permalink de Instagram en la esquina, replicando las galerías premium de la competencia.
- Superposición al pasar el cursor — la superposición aparece al pasar el cursor en vez de estar siempre visible, manteniendo la cuadrícula limpia hasta que el visitante interactúa.
- Selectores de color de acento y superposición — define los colores de acento y superposición del showcase por cada galería y como valores globales predeterminados, con valores validados de forma segura antes de llegar al CSS.
- Recuento de me gusta/comentarios del titular — para tu propio contenido Business/Creator la galería muestra las cifras de interacción, obtenidas de forma segura y omitidas automáticamente cuando Instagram no las devuelve.
- Distintivos de vídeo y álbum de carrusel — los mosaicos de vídeo llevan un distintivo de reproducción y los posts de varias imágenes muestran un distintivo con el número de elementos, así los visitantes saben que hay más dentro.
Visualización de la galería e interacción
- Pies de foto on/off — muestra u oculta el pie de cada post por cada galería.
- Lightbox local integrado — visor a pantalla completa con un panel lateral de información (pie de foto, fecha, me gusta/comentarios, permalink), servido desde tu propio sitio sin ningún script de embed externo.
- Alternativa sin lightbox — con el lightbox desactivado, los mosaicos enlazan directamente al permalink de Instagram, así un toque siempre llega al post original.
- Cargar más y scroll infinito — empieza con un tamaño de página configurable y deja que los visitantes carguen más con un clic, o que aparezcan automáticamente a medida que se desplazan.
- Pestañas por tipo de contenido — una barra de pestañas opcional
photos, videos, reelssobre la cuadrícula filtra los elementos del lado del cliente por tipo de contenido. - Chips de filtro de álbum — define álbumes
Label | keywordspara generar chips "Todos + por álbum" que filtran la cuadrícula por palabra clave del pie de foto. - Filtro de contenido foto/vídeo — muestra todo el contenido, solo fotos o solo vídeos.
- Incluir / excluir por texto — conserva o descarta posts por una subcadena del pie de foto sin distinguir mayúsculas de minúsculas, así curas exactamente qué contenido aparece.
- Ocultar posts concretos por ID — excluye elementos individuales que no quieras mostrar, con independencia del feed.
- Llamada a la acción configurable — añade un botón "Síguenos" (o cualquier otro) con tu propia etiqueta y un enlace https debajo de la galería.
- Título/encabezado de la galería — etiqueta de encabezado opcional sobre la cuadrícula.
- Recuento de elementos en vivo — el encabezado refleja cuántos elementos se muestran.
Administración y gestión de galerías
- Gestor de galerías guardadas — un auténtico componente de back-office (Joomla) / custom post type (WordPress) que almacena muchas galerías reutilizables, cada una con su configuración de visualización completa.
- CRUD + duplicar + copiar-shortcode — crea, edita, elimina, clona una galería guardada y copia su shortcode ya listo con un solo clic.
- Inserción mediante ID — coloca una galería guardada en cualquier sitio por su id (
{gmcinstagramgallery id="N"}/[gmcinstagramgallery id="N"]) en vez de repetir cada atributo. - Presets de configuración rápida — inicia una nueva galería desde un preset (simple, showcase, carousel, manual) en lugar de un formulario en blanco.
- Conexión global o por galería — reutiliza por defecto la conexión de Instagram válida para todo el sitio, o sobrescribe las credenciales en una galería concreta.
- Opciones avanzadas plegadas — los campos del primer día permanecen visibles; las opciones para expertos se recogen en una sección "Avanzadas" para mantener el editor accesible.
- Vista previa del diseño en vivo — un panel dentro de la administración muestra columnas/estilo/recorte/carrusel/álbumes con mosaicos de marcador de posición a medida que cambias las opciones, así puedes comprobarlo antes de guardar.
- Valores de visualización predeterminados para todo el sitio — define límite, columnas, diseño, estilo, espaciado, recorte, pies de foto, lightbox, tamaño de página, scroll infinito, CTA y más como valores predeterminados, así las nuevas galerías y los shortcodes mínimos heredan valores sensatos.
- Permisos ACL de Joomla — las reglas de acceso estándar de Joomla controlan quién puede gestionar las galerías.
Experiencia de conexión y configuración
- Asistente de configuración guiada — un flujo de incorporación paso a paso acompaña al nuevo propietario del sitio en la conexión de una cuenta.
- Botón "Probar conexión" — valida la conexión en vivo contra la Graph API con mensajes de error claros y específicos (token caducado/no válido, ID de cuenta incorrecto, permiso ausente, límite de peticiones).
- Conectar con Instagram (Instagram Login) — inicia sesión directamente con credenciales de Instagram, sin necesidad de vincular una Página de Facebook, para cualquier cuenta profesional.
- Conectar con Facebook (flujo de Página) — la ruta clásica de Facebook Login con un selector de Página para cuentas vinculadas a una Página de Facebook.
- Easy Connect (vía GMC) OAuth con un clic — conecta Instagram con un solo clic sin tu propia app de desarrollador de Meta; inicias sesión en la propia página de Instagram y el token vuelve cifrado, almacenado solo en tu sitio (el relay de GMC nunca lo conserva).
- Asistente de intercambio manual de token — pega un App ID + App Secret de Meta y un token de corta duración para obtener automáticamente un Page access token permanente, sin extensión manual del token.
- Renovación automática del token — el token de Instagram de 60 días se renueva automáticamente antes de caducar, así los feeds conectados siguen funcionando sin volver a autenticarse.
- Aviso de admin por token no válido — si Instagram devuelve el error 190 el plugin marca el token como no válido y muestra un aviso al administrador que explica exactamente cómo solucionarlo.
Privacidad, RGPD y seguridad
- Caché local de contenido opcional — almacena el contenido de Instagram en tu propio dominio para una configuración más orientada al RGPD, así las imágenes y las miniaturas de vídeo se sirven desde tu servidor y no desde la CDN de Instagram.
- Gestión robusta de miniaturas de vídeo — los mosaicos permanecen visibles incluso cuando las miniaturas de vídeo antiguas de Instagram faltan o han caducado.
- Descargas de caché endurecidas contra SSRF — la caché local de contenido solo descarga desde una lista autorizada de hosts CDN de Meta auténticos (
fbcdn.net,cdninstagram.com,fbsbx.com,akamaihd.net) con validación del content-type. - Tokens en cabecera Bearer — los tokens de acceso viajan en una cabecera
Authorization, fuera de las URL, las cadenas de consulta y los registros. - Tokens de estilo/diseño en lista blanca y escapado completo de la salida — los valores de estilo/diseño/recorte aportados por el usuario se validan antes de llegar a los nombres de clases CSS, y la salida se escapa por completo — endurecido para las versiones modernas de Joomla y las versiones actuales de WordPress.
- Desinstalación limpia — la eliminación en WordPress limpia los ajustes, los datos de licencia y los metadatos del actualizador en caché.
Rendimiento y caché
- Caché del feed "último válido" — durante una caída de la Graph API la galería sirve desde el disco el último contenido recuperado con éxito en lugar de dejar en blanco una página que funciona.
- Caché de contenido consciente del disco — las imágenes en caché se comprueban en el disco antes de volver a descargarlas, evitando descargar de nuevo cada imagen en cada visita a la página.
- Purga automática diaria de la caché — una tarea programada (WP cron / purga de Joomla con limitación) elimina el contenido en caché obsoleto más antiguo que la vida útil de la caché (mínimo 7 días), así la carpeta de caché no crece sin límite.
- Vida útil de la caché y timeout de petición configurables — ajusta cuánto tiempo se guardan los feeds en caché y cuánto puede durar una petición Graph.
Internacionalización y compatibilidad
- Inglés, italiano y español listos para usar — las cadenas completas de la interfaz y del front-end (admin, asistente, cuadros OAuth/Easy-Connect, lightbox, "Cargar más", chip de álbum "Todos") se entregan traducidas y compiladas.
- Consciente de los sitios multiidioma — respeta la configuración multiidioma del sitio.
- Probado en los CMS actuales — Joomla 5.x/6.x y WordPress 6.0–6.8, PHP 8.1+.
Desarrolladores e integración
- Cuatro alias de shortcode —
gmcinstagramgallery,gmcinstagram,gmcinstagramfeed,gmcphotostreamresuelven todos al mismo handler (llaves en Joomla, corchetes en WordPress). - Amplio conjunto de atributos de shortcode — controla todo en línea (urls, limit, columns, layout, style, gutter, crop, filtros, caption, lightbox, carousel, álbumes, tabs, colores, source, CTA, title, id…); los valores en línea tienen prioridad sobre los predeterminados guardados.
- Bloque Gutenberg para WordPress — un bloque nativo registra la galería para el editor de bloques junto a los shortcodes.
- Plugin de contenido de Joomla — inserta una galería directamente en cualquier artículo mediante el plugin de contenido incluido; un plugin de sistema incluido gestiona el callback OAuth en una URL de administración limpia.
- Endpoints AJAX — el "Cargar más" y los flujos OAuth/connect se ejecutan a través de la propia capa AJAX del CMS.
Confianza y licencia
- Licencia GPLv2 — publicado bajo la GNU General Public License v2 o posterior; obtienes la build oficial.
- Autoalojado, tus datos — la galería y cualquier contenido en caché residen en tu propio sitio; el modo manual no implica ningún servicio de terceros, y con Easy Connect el token se almacena solo en tu sitio.
- Actualizaciones con un clic bajo licencia — la extensión consulta automáticamente el servidor de actualizaciones de GMC / FuerteventuraTV (~24 h en Joomla, ~12 h en WordPress) y ofrece las nuevas versiones a través del actualizador nativo mientras la licencia está activa.
- Entrega mediante Download Key — una Download Key llega por correo tras la compra y desbloquea las actualizaciones con licencia; la introduces una sola vez en la pantalla de licencia/ajustes.
- Periodo de gracia elegante en la licencia — si la pasarela de licencias está brevemente inaccesible, un sitio previamente licenciado sigue funcionando con su último derecho válido conocido; solo los fallos de transporte no se guardan nunca mucho tiempo en caché, así un corte momentáneo nunca compromete el control.
- Licencia de un sitio + opción para agencias — cada compra cubre un sitio con actualizaciones y soporte; acuerdos por volumen/agencia disponibles a petición.
- Reembolso a 14 días + soporte multiidioma — soporte y reembolsos gestionados en inglés, italiano y español (línea de WhatsApp incluida en el correo de licencia).
Joomla y WordPress
- Joomla — el preset theme-match genera marcado UIkit/YOOtheme Pro nativo (tarjetas, cuadrícula, superposición, slider, lightbox); se entrega como paquete (componente
com_gmc_instagram_feed_gallery+ plugin de contenido + plugin de sistema) con ACL, un campo Download Key y el servidor de actualizaciones de Joomla — instala solo elpkg_…zipexterno. - WordPress — los estilos equivalentes son CSS autónomo (sin dependencia de UIkit); las galerías guardadas son un custom post type con un editor de meta-box y un bloque Gutenberg; expone el interruptor por plugin "Habilitar actualizaciones automáticas" y una purga diaria de la caché mediante WP-cron; se vende como producto independiente de la edición de Joomla.
