Integración Instagram Feed: configuración y ayuda

1. Sube el ZIP de Instagram Feed Integration desde "Modules > Module Manager".
2. Abre "Configure".
3. Introduce Token de acceso, ID de usuario de Instagram y Nombre de usuario de Instagram.
4. Elige un Hook de visualización que tu tema admita realmente y guarda.
5. Visita esa zona de la tienda para ejecutar la primera solicitud del feed. Confirma que las publicaciones enlazan con la cuenta deseada.

Requiere PrestaShop 1.6 o posterior y PHP 7.1 o posterior.

Con ID de usuario de Instagram rellenado, el módulo consulta https://graph.facebook.com/v18.0/USER_ID/media. Si el campo está vacío, consulta https://graph.instagram.com/me/media. Configura la cuenta Graph deseada y comprueba la respuesta del feed.

Después de cada obtención sin caché válida, el módulo intenta renovar el token mediante graph.instagram.com/refresh_access_token, incluso con ID de usuario de Instagram configurado. Guarda el token recibido si tiene éxito. La renovación no está garantizada; sustituye las credenciales si falla la autenticación.

Ubicación

Solo el hook estándar seleccionado muestra el feed. Tu tema debe llamar a ese hook. Puedes usar la página de inicio para la primera prueba y después moverlo a un hook del pie o de una columna que admita tu tema.

Diseño

Para una cuadrícula en la página de inicio, empieza con 12 publicaciones, cuatro columnas de escritorio, dos en móvil y tres filas. Esto muestra hasta 12 publicaciones en escritorio y seis en móvil; las tabletas usan tres columnas. Filas limita los elementos visibles de la cuadrícula, mientras que Número de publicaciones sigue siendo el máximo total. Para un slider en el pie, elige displayFooterBefore y slider, reduce Número de publicaciones si hace falta y oculta los textos o las fechas para un diseño compacto.

El slider incluido lee las variables de columnas y espacio de la sección, mientras que la plantilla las define en la cuadrícula. Si el tema no las define en la sección, el desplazamiento usa cuatro elementos en escritorio, tres en tabletas, dos en móvil y un espacio de 10px. Prueba el slider después de cambiar el diseño.

Contenido visible

Los vídeos se representan mediante miniaturas con un indicador de reproducción. Los álbumes de carrusel aparecen como una vista previa enlazada con un indicador de galería; el proceso de obtención no solicita ni muestra todos los elementos del carrusel. El feed muestra los medios de la cuenta, no resultados de hashtags. Se omiten los elementos sin una imagen o miniatura de vídeo utilizable.

Caché y slider

El feed usa un archivo de caché JSON local en el directorio del módulo. Una solicitud a la tienda obtiene los medios si el archivo no existe o supera Duración de caché. Las tiendas que usan el mismo directorio comparten la caché. No existe una tarea programada de actualización.

Actualizar caché del feed ahora y guardar los ajustes del feed vacían la caché. La siguiente solicitud obtiene los medios y solo guarda resultados con contenido. Un error de API o un resultado vacío deja esa solicitud sin feed; el contenido caducado no se muestra. La carga diferida usa IntersectionObserver, con carga inmediata si no está disponible.

La configuración incluye una sección de publicación y un panel de artículos del blog. El panel necesita datos de MPR Blog Revolution para listar los artículos. Leer el feed y publicar son operaciones independientes. Mantén Activar la publicación automática desactivado, su valor predeterminado al instalar, hasta que quieras que el contenido publicado del blog cree publicaciones remotas. Guardar el formulario principal del feed restablece el interruptor independiente de publicación automática y la plantilla de leyenda. Guarda de nuevo el formulario de publicación después de cambiar los ajustes del feed.

El valor predeterminado de Plantilla del pie de foto es:

{title}

{excerpt}

{url}

También puedes usar {shop_name}. Por ejemplo, cambia la última parte a Read the article: {url} y añade {shop_name} en otra línea.

La publicación automática reacciona a los hooks de creación/actualización de objetos con estado publicado 1 y credenciales configuradas. El sistema de publicación de Instagram requiere Token de acceso, ID de usuario de Instagram y una imagen destacada. Crea un contenedor de medios y lo envía para su publicación. No publica carruseles de varias imágenes.

Los botones manuales del panel de artículos recientes del blog también publican contenido real en Instagram. Comprueba el artículo seleccionado, la cuenta y el texto antes de usarlos, y asegúrate de que el token tenga permiso para publicar.

Los intentos de publicación usan datos persistentes compartidos de cola/historial con comprobaciones de duplicados y resultados desconocidos. La publicación se intenta durante la solicitud; revisa los intentos fallidos antes de repetirlos. Si el resultado es desconocido o requiere conciliación, revisa la cuenta remota y el resultado en la cola antes de volver a intentarlo.

La política de escritura compartida puede bloquear la publicación en un host de desarrollo/pruebas o cuando el host de tienda configurado no está claro. Usa el resultado mostrado y los registros de PrestaShop para diagnosticar el bloqueo. No necesitas cambiar la política de publicación para probar la lectura del feed.

Cuando el ajuste guardado de activación de la plataforma en mprsocialrevolution está activado, este módulo suprime su propio feed y la publicación automática para esa plataforma. La comprobación de toma de control lee el ajuste de la plataforma; no se limita a comprobar que el otro módulo esté instalado.

• Confirma que las credenciales necesarias están guardadas, el feed está activado y el hook seleccionado se ejecuta en tu tema.
• Vacía la caché, visita la zona elegida e inspecciona el feed resultante. Si no aparece nada, comprueba la fecha y hora del archivo de caché y los errores de PHP/API.
• Prueba los controles de cuadrícula o slider, la visibilidad en móvil, los enlaces para seguir y los enlaces permanentes de las publicaciones. Los contadores de Me gusta/comentarios requieren la solicitud con ID de usuario y valores positivos devueltos.
• Si falla la autenticación, comprueba el token, el ID de cuenta, la versión de la API remota y los permisos. Guardar exige un token no vacío, pero no comprueba la identidad de la cuenta remota. Cambiar únicamente el nombre de usuario no cambia el ID de cuenta de la API.
• Si se deniega la publicación, revisa el acceso del empleado al módulo, las credenciales de la cuenta, el resultado de la política del host, la compatibilidad de los paquetes compartidos y el estado del intento anterior. No publiques repetidamente tras una respuesta incierta.

Guarda las sobrescrituras de plantillas en tu tema:

themes/your-theme/modules/mprinstagramintegration/views/templates/hook/feed.tpl
themes/your-theme/modules/mprinstagramintegration/views/templates/hook/post_item.tpl

El CSS del tema puede dirigirse a .mprinstagram-section, .mprinstagram-title, .mprinstagram-grid, .mprinstagram-slider, .mprinstagram-item y .mprinstagram-follow-btn. Usa .mprinstagram-caption para el estilo de los textos. Las variables de diseño incluyen --mprinstagram-gap y --mprinstagram-radius.

Para pausar la visualización, desactiva Activar módulo. Desactiva Activar la publicación automática por separado para detener la publicación automática. Antes de desinstalar, conserva las credenciales y guarda una copia del historial de publicación que necesites. La desinstalación elimina el menú y los ajustes del módulo, vacía su caché y ejecuta la limpieza de su esquema. No elimina las publicaciones ya creadas en Instagram.