Intégration Instagram Feed : installation et aide

1. Importez le ZIP d'Instagram Feed Integration via "Modules > Module Manager".
2. Ouvrez "Configure".
3. Renseignez Jeton d'accès, ID utilisateur Instagram et Nom d'utilisateur Instagram.
4. Choisissez un Hook d'affichage réellement pris en charge par votre thème, puis enregistrez.
5. Visitez cette zone de la boutique pour déclencher la première requête du flux. Vérifiez que les publications renvoient vers le compte souhaité.

Nécessite PrestaShop 1.6 ou une version ultérieure et PHP 7.1 ou une version ultérieure.

Lorsque ID utilisateur Instagram est renseigné, le module interroge https://graph.facebook.com/v18.0/USER_ID/media. Si le champ est vide, il interroge https://graph.instagram.com/me/media. Configurez le compte Graph souhaité et vérifiez la réponse du flux.

Après chaque récupération sans cache valide, le module tente de renouveler le jeton via graph.instagram.com/refresh_access_token, même si ID utilisateur Instagram est renseigné. Il enregistre le jeton renvoyé en cas de succès. Le renouvellement n’est pas garanti ; remplacez les identifiants en cas d’échec d’authentification.

Emplacement

Seul le hook standard sélectionné affiche le flux. Votre thème doit appeler ce hook. Vous pouvez utiliser la page d'accueil pour le premier test, puis déplacer le flux vers un hook de pied de page ou de colonne pris en charge par votre thème.

Mise en page

Pour une grille en page d'accueil, commencez avec 12 publications, quatre colonnes sur ordinateur, deux sur mobile et trois lignes. Cela affiche jusqu’à 12 publications sur ordinateur et six sur mobile ; les tablettes utilisent trois colonnes. Lignes limite les éléments visibles de la grille, tandis que Nombre de publications reste la limite globale. Pour un slider en pied de page, choisissez displayFooterBefore et slider, réduisez Nombre de publications si nécessaire et masquez les légendes ou les dates pour une mise en page compacte.

Le slider fourni lit les variables de colonnes et d’espacement sur la section, alors que le template les définit sur la grille. Sans ces variables sur la section dans votre thème, le déplacement utilise quatre éléments sur ordinateur, trois sur tablette, deux sur mobile et un espacement de 10px. Testez le slider après toute modification de mise en page.

Contenu visible

Les vidéos sont représentées par des miniatures avec un indicateur de lecture. Les albums carrousel apparaissent sous forme d'aperçu lié avec un indicateur de galerie ; le récupérateur ne demande et n'affiche pas tous les éléments du carrousel. Le flux présente les médias du compte, pas des résultats par hashtag. Les éléments sans image ou miniature vidéo exploitable sont ignorés.

Cache et slider

Le flux utilise un fichier de cache JSON local dans le répertoire du module. Une requête en boutique récupère les médias si le fichier est absent ou plus ancien que Durée du cache. Les boutiques utilisant le même répertoire partagent ce cache. Il n’existe aucune tâche planifiée d’actualisation.

Rafraîchir le cache du flux maintenant et l’enregistrement des réglages du flux vident le cache. La prochaine requête en boutique récupère les médias et enregistre uniquement les résultats non vides. Une erreur API ou un résultat vide n’affiche aucun flux pour cette requête ; le contenu expiré n’est pas servi. Le chargement différé utilise IntersectionObserver, avec chargement immédiat si celui-ci est indisponible.

La configuration comprend une section de publication et un panneau d’articles de blog. Ce panneau nécessite des données MPR Blog Revolution pour répertorier les articles. La lecture du flux et la publication sont des opérations distinctes. Laissez Activer la publication automatique désactivé, sa valeur par défaut à l’installation, tant que vous ne souhaitez pas que les contenus de blog publiés créent des publications distantes. L’enregistrement du formulaire principal du flux réinitialise l’interrupteur de publication automatique et le modèle de légende séparés. Enregistrez de nouveau le formulaire de publication après avoir modifié les réglages du flux.

La valeur par défaut de Modèle de légende est :

{title}

{excerpt}

{url}

Vous pouvez aussi utiliser {shop_name}. Par exemple, remplacez la dernière partie par Read the article: {url} et ajoutez {shop_name} sur une autre ligne.

La publication automatique réagit aux hooks d'ajout/mise à jour d'objets ayant le statut publié 1 et des identifiants configurés. Le système de publication Instagram nécessite Jeton d'accès, ID utilisateur Instagram et une image à la une. Il crée un conteneur de média et le soumet à la publication. Il ne publie pas de carrousel à plusieurs images.

Les boutons manuels du panneau des articles de blog récents publient aussi de vrais contenus sur Instagram. Vérifiez l'article sélectionné, le compte et la légende avant de les utiliser, et assurez-vous que le jeton a le droit de publier.

Les tentatives de publication utilisent des données partagées et persistantes de file d'attente/historique avec des contrôles de doublons et de résultats inconnus. La publication est tentée pendant la requête ; examinez les tentatives échouées avant de les relancer. Si le résultat est inconnu ou nécessite un rapprochement, vérifiez le compte distant et le résultat dans la file avant de réessayer.

La politique d'écriture partagée peut bloquer la publication sur un hôte de développement/préproduction ou lorsque l'hôte de boutique configuré est incertain. Utilisez le résultat affiché et les journaux PrestaShop pour diagnostiquer ce blocage. Il n'est pas nécessaire de modifier la politique de publication pour tester la lecture du flux.

Lorsque le paramètre enregistré d'activation de la plateforme dans mprsocialrevolution est activé, ce module supprime son propre flux et sa publication automatique pour cette plateforme. Ce contrôle de prise en charge lit le paramètre de la plateforme ; il ne vérifie pas simplement si l'autre module est installé.

• Vérifiez que les identifiants requis sont enregistrés, que le flux est activé et que le hook sélectionné s'exécute dans votre thème.
• Videz le cache, visitez la zone choisie et examinez le flux obtenu. Si rien n'apparaît, vérifiez l'horodatage du fichier de cache et les erreurs PHP/API.
• Testez les commandes de grille ou de slider, la visibilité sur mobile, les liens de suivi et les permaliens des publications. Les compteurs de mentions J'aime/commentaires nécessitent la requête avec ID utilisateur et des valeurs positives renvoyées.
• Si l'authentification échoue, vérifiez le jeton, l'ID du compte, la version de l'API distante et les permissions. L’enregistrement exige un jeton non vide, sans vérifier l’identité du compte distant. Modifier seulement le nom d'utilisateur ne change pas l'ID de compte utilisé par l'API.
• Si la publication est refusée, vérifiez l'accès de l'employé au module, les identifiants du compte, le résultat de la politique d'hôte, la compatibilité des paquets partagés et l'état de la tentative précédente. Ne relancez pas plusieurs publications après une réponse incertaine.

Conservez les surcharges de templates dans votre thème :

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

Le CSS du thème peut cibler .mprinstagram-section, .mprinstagram-title, .mprinstagram-grid, .mprinstagram-slider, .mprinstagram-item et .mprinstagram-follow-btn. Utilisez .mprinstagram-caption pour le style des légendes. Les variables de mise en page comprennent --mprinstagram-gap et --mprinstagram-radius.

Pour suspendre l'affichage, désactivez Activer le module. Désactivez séparément Activer la publication automatique pour arrêter la publication automatique. Avant la désinstallation, conservez les identifiants et sauvegardez l'historique de publication nécessaire. La désinstallation supprime le menu et les paramètres du module, vide son cache et exécute le nettoyage de son schéma. Elle ne supprime pas les publications déjà créées sur Instagram.