Intégration X (Twitter) Feed : installation et aide

Sur les anciennes versions de PrestaShop, utilisez la page d’installation des modules correspondante. Ouvrez ce module via "Configure" pour revenir à ses réglages.

Le menu Hook d'affichage propose aussi Widget personnalisé (utilisez {widget} dans les modèles), mais cette version ne prend pas en charge ce rendu. Choisissez un hook standard, y compris pour placer le flux dans un template du thème.

Les réglages de colonnes s’appliquent à la grille et au carrousel. De 768px à 991px de largeur, le carrousel et les grilles contenant au moins deux publications utilisent deux colonnes ; une grille contenant une seule publication reste sur une colonne. Sous 768px, ils utilisent Colonnes mobiles. Les grilles contenant seulement une ou deux publications utilisent respectivement une ou deux colonnes sur ordinateur, et une colonne sur mobile. L’espacement et le rayon de bordure s’appliquent à tous les modes de mise en page, y compris au carrousel.

Le serveur résout un ID utilisateur X vide via https://api.x.com/2/users/by/username/{username}. Il récupère le fil via https://api.x.com/2/users/{user_id}/tweets, avec les dates de création, statistiques publiques, médias joints et données d’auteur. Le compte configuré et l’accès API doivent autoriser ces requêtes. Le module ne récupère pas de mur de hashtags et ne combine pas plusieurs comptes.

La logique de récupération limite le nombre d’éléments demandé pour l’affichage à 20. Elle demande jusqu’à trois fois ce nombre avant de conserver le nombre de résultats requis. Gardez un nombre positif. Le texte est raccourci à Longueur max. du texte pendant la récupération ; utilisez 0 pour le texte intégral. Les interrupteurs de métadonnées contrôlent l’affichage des cartes, tandis que ceux d’exclusion modifient la requête API.

Le hook standard sélectionné affiche une grille, un carrousel ou une liste. Le bouton de suivi de l’en-tête ouvre https://x.com/{username}. Chaque carte ouvre https://x.com/{author_handle}/status/{post_id} dans un nouvel onglet. Les vidéos restent des aperçus, sans lecteur intégré.

Si vous changez de compte, modifiez Nom d'utilisateur X et videz manuellement ID utilisateur X avant d’enregistrer. Un ID non vide est réutilisé même après un changement de nom d’utilisateur. Utilisez ensuite Synchroniser maintenant.

Le cache du flux utilise ce fichier JSON local :

modules/mprxintegration/mprx_feed_cache.json

Les paramètres du flux et ce fichier sont partagés par les boutiques utilisant la même installation du module. Les requêtes en boutique le réutilisent tant qu’il est valide et récupèrent les publications depuis X s’il manque ou a expiré. L’enregistrement du formulaire principal l’efface ; cette version n’a pas de tâche planifiée d’actualisation du flux.

Synchroniser maintenant nécessite un Bearer token et un ID utilisateur X résolu, puis efface le cache et récupère immédiatement les publications. Vider le cache supprime seulement le fichier ; la prochaine requête en boutique récupère de nouvelles données. Si la requête API échoue ensuite ou ne renvoie aucune publication, aucune publication ne reste en cache. Vérifiez le fil, les identifiants et l’accès API, puis réessayez.

Seuls les résultats API non vides sont mis en cache. Un fichier expiré n’est pas utilisé en secours si la récupération échoue ; le flux peut donc disparaître jusqu’à la réussite d’une requête ultérieure. Les compteurs API et les dates relatives reflètent la réponse en cache.

Configurez les quatre champs d’identifiants OAuth 1.0a dans Connexion X (Twitter) pour publier depuis le blog. Un Bearer token en lecture seule ne suffit pas à configurer cette publication. Utilisez ensuite le formulaire distinct "Auto-Publish to X" :

Le panneau Articles de blog nécessite MPR Blog Revolution et propose une action de publication manuelle lorsque le système de publication est configuré. Il utilise le titre, l’extrait, l’URL et l’image à la une du blog lorsqu’ils sont disponibles. La publication prend en charge le texte et les images/GIF. Elle passe par une file partagée et un historique empêchant les traitements en double. Si le panneau signale une erreur de file ou de rapprochement, vérifiez le résultat existant avant de réessayer.

L’affichage du flux et la publication ont des interrupteurs distincts, mais l’enregistrement du formulaire principal réinitialise l’interrupteur et la légende de publication, car ces champs y sont absents. Après chaque enregistrement du formulaire principal, enregistrez à nouveau Activer la publication automatique et la légende dans le formulaire de publication séparé.

La publication est bloquée lorsque le drapeau de prise en charge X de Social Revolution est défini. La politique d’écriture sortante peut aussi la bloquer sur un hôte de développement/préproduction ou non résolu. L’interface en indique la raison. Un autre module social installé chargeant une ancienne version du package de publication partagé peut bloquer l’envoi ; mettez les modules sociaux installés à jour ensemble si cette erreur apparaît.

Les exemples ci-dessous décrivent les valeurs à saisir dans les formulaires du back-office. Ce ne sont pas des commandes shell. Remplacez les noms de compte et identifiants d’accès par des valeurs réelles. Le hook du thème doit correspondre à Hook d'affichage.

Affichez une grille d’accueil avec six publications, trois colonnes sur ordinateur, une sur mobile et uniquement les publications originales :

MPRX_DISPLAY_HOOK=displayHome
MPRX_LAYOUT=grid
MPRX_POST_COUNT=6
MPRX_COLUMNS=3
MPRX_MOBILE_COLUMNS=1
MPRX_EXCLUDE_REPLIES=1
MPRX_EXCLUDE_RETWEETS=1

Utilisez une liste compacte dans la colonne de droite, sans médias ni compteurs d’engagement :

MPRX_DISPLAY_HOOK=displayRightColumn
MPRX_LAYOUT=list
MPRX_POST_COUNT=3
MPRX_SHOW_MEDIA=0
MPRX_SHOW_LIKES=0
MPRX_SHOW_RETWEETS=0
MPRX_SHOW_REPLIES=0
MPRX_TEXT_LENGTH=140

Utilisez le slider avec un défilement automatique toutes les huit secondes :

MPRX_LAYOUT=slider
MPRX_COLUMNS=3
MPRX_AUTO_SCROLL=1
MPRX_SCROLL_SPEED=8000

Personnalisez la légende Blog Revolution envoyée à X :

{title}

{excerpt}

Read more: {url}

Les espaces réservés disponibles pour la légende sont :

{title}
{excerpt}
{url}
{shop_name}

Rendez le module via un hook PrestaShop standard dans un template du thème, en configurant le module pour ce même hook :

{hook h='displayHome' mod='mprxintegration'}

Les développeurs de thèmes peuvent surcharger les templates de la boutique ici :

themes/your_theme/modules/mprxintegration/views/templates/hook/feed.tpl
themes/your_theme/modules/mprxintegration/views/templates/hook/post_item.tpl

Sélecteurs CSS utiles pour les styles du thème :

.mprx-section { margin-top: 32px; }
.mprx-title { font-size: 1.25rem; }
.mprx-item { border-radius: 8px; }
[data-theme="dark"] .mprx-item { background: #16181c; }
.mprx-follow-btn { text-transform: none; }

Le cache du flux utilise ce fichier JSON local :

modules/mprxintegration/mprx_feed_cache.json

Pour un carrousel, vérifiez les colonnes et l’espacement configurés aux largeurs d’ordinateur, de tablette et de mobile. Conservez les modifications CSS et de templates dans votre thème.

• Si la section est absente, vérifiez Activer le module, les champs sources, Afficher sur mobile et le hook sélectionné. Le module ne renvoie aucune section si aucun élément n’est disponible.
• Vérifiez que votre thème appelle displayHeader pour charger la feuille de style et JavaScript, et qu’il rend le hook d’affichage sélectionné.
• Si les images restent vides, examinez les erreurs réseau du navigateur. Essayez de désactiver le chargement différé et vérifiez les URL des images.
• Si la mise en page est incorrecte, testez d’abord la grille, puis vérifiez le carrousel aux largeurs d’ordinateur et de mobile.
• Si le réglage X_ACTIVE de MPR Social Revolution est activé, ce flux autonome est masqué. Cette vérification lit le drapeau enregistré ; Social Revolution n’a pas besoin d’être actuellement activé en tant que module.

Ouvrez la page "Integrity" du module pour les contrôles de configuration et de hooks. Licence, Assistance et Mettre à jour sont des pages de maintenance. Testez les destinations réelles après avoir modifié les identifiants de compte ou les sources du flux.

Réglez Activer le module sur Non et enregistrez pour masquer le flux tout en conservant ses paramètres de source et d’affichage. L’enregistrement du formulaire principal réinitialise l’interrupteur et la légende de publication ; vérifiez et enregistrez ensuite le formulaire de publication séparé si la publication doit continuer. Désinstallez via le gestionnaire de modules pour supprimer la configuration, le cache local et les entrées de menu d’administration de ce module. Les tables partagées mpr_social_publish et mpr_social_queue sont marquées comme partagées et conservées à la désinstallation. Les publications déjà envoyées à la plateforme ne sont pas supprimées.