Génération manuelle du flux
Déclenchez une reconstruction complète du flux à la demande, sans attendre un cron planifié — utile pour vérifier votre configuration, corriger des erreurs ou envoyer immédiatement des données produits mises à jour vers Facebook.
Disponible depuis la v1.0.0
Présentation
L'onglet Génération manuelle du flux vous propose un bouton unique qui lance le processus de génération immédiatement. C'est le moyen le plus rapide de confirmer que votre flux se génère correctement après avoir modifié un paramètre du module, et c'est la première étape recommandée lors de la configuration initiale.
Les grands catalogues pouvant nécessiter plusieurs minutes de traitement, le module lance la génération en tâche de fond. Vous n'avez pas besoin de laisser la page du Back Office ouverte pendant son exécution.
Comment générer manuellement le flux
- Rendez-vous dans Modules > Gestionnaire de modules, trouvez Facebook & Instagram Product Catalogue Feed Pro et cliquez sur Configurer.
- Cliquez sur l'onglet Génération manuelle du flux dans la barre de navigation.
- Cliquez sur le bouton Générer le flux maintenant ! en bas du panneau.
- La page se recharge et affiche un message confirmant que la génération a démarré. Un indicateur de progression apparaît pendant la construction du flux.
- Une fois la génération terminée, le verrou se libère automatiquement et l'onglet Tableau de bord (Vue rapide) reflète les nouvelles données du flux.
Si un avertissement concernant le mode maintenance s'affiche, votre boutique est en maintenance et l'adresse IP du serveur n'a pas été ajoutée à la liste des IP autorisées. Le module affichera l'IP de votre serveur afin que vous puissiez la copier directement dans Préférences > Maintenance avant de réessayer.
Ce qui se passe pendant la génération
Lorsque vous cliquez sur Générer le flux maintenant !, le module :
- Efface les erreurs enregistrées lors de l'exécution précédente.
- Pose le verrou de génération (
FPF_GENERATING = 1) et écrit un fichierprogress.jsoninitial dans le dossierfeeds/. - Appelle l'URL de génération du flux via cURL, en transmettant votre clé secrète pour l'authentification. Si cURL n'est pas disponible sur le serveur, le module bascule sur une requête HTTP directe.
- Le contrôleur front-office (
GenerateFeed) traite vos produits par cycles — le nombre de produits par cycle est contrôlé par le paramètre Éléments par cycle dans l'onglet Options produits. - À chaque cycle terminé,
progress.jsonest mis à jour avec le nombre de flux complétés par rapport au total. - Une fois tous les flux écrits, le verrou est libéré automatiquement (voir ci-dessous).
Les fichiers de flux générés sont enregistrés dans le dossier feeds/ à l'intérieur du répertoire du module. Facebook et Instagram lisent le flux depuis l'URL publique indiquée dans l'onglet Génération du flux.
Le verrou de génération et la réinitialisation automatique
Le module utilise un indicateur global (FPF_GENERATING) pour signaler qu'une génération est en cours. Cela empêche le lancement simultané de plusieurs exécutions — par exemple, si un cron se déclenche pendant une génération manuelle.
Réinitialisation automatique : à chaque chargement de la page de configuration, le module vérifie progress.json. Si le fichier indique que tous les flux ont été complétés (completed_feeds >= total_feeds) et que l'exécution n'est plus dans un état de démarrage, le verrou est automatiquement libéré. Aucune action de votre part n'est nécessaire.
Cette réinitialisation automatique évite qu'un verrou bloqué n'empêche les générations futures dans les cas où le processus de génération s'est terminé sans pouvoir effacer l'indicateur lui-même — par exemple, après un timeout serveur ou un appel cURL interrompu.
Forcer Facebook à se mettre à jour immédiatement
Après avoir généré le flux sur votre boutique, Facebook le récupérera selon son propre intervalle d'actualisation planifié. Si vous avez besoin que Facebook lise le flux mis à jour immédiatement — par exemple lors de la correction d'erreurs dans un catalogue — vous pouvez forcer une récupération manuelle :
- Ouvrez Facebook Ads Manager.
- Naviguez vers Catalogues et sélectionnez votre catalogue.
- Cliquez sur Sources de données produits et sélectionnez votre source de données.
- Cliquez sur le menu Configuration en haut de la page de la source de données.
- Faites défiler vers le bas et cliquez sur Récupérer maintenant (aussi libellé Actualiser selon les régions).
- Après quelques secondes, Facebook commence à récupérer la dernière version de votre flux.
Notes importantes
- Première configuration : après avoir configuré le module pour la première fois, utilisez toujours la génération manuelle avant d'activer le cron. Cela confirme que le flux se génère sans erreur avant le démarrage des exécutions automatiques.
- Modifications des paramètres : lorsque vous enregistrez de nouveaux paramètres, le module peut afficher un avis indiquant que les modifications ne prendront effet qu'après une régénération du flux. Utilisez l'onglet Génération manuelle du flux pour les appliquer immédiatement, ou attendez la prochaine exécution du cron.
- Limite Max Produits : si vous avez défini une valeur dans Options de génération > Génération max produits (à des fins de test), cette limite s'applique également à la génération manuelle. Pensez à la remettre à
0une fois les tests terminés. - Débogage de la génération : de même, si Débogage de la génération du flux produits est défini sur des IDs de produits spécifiques, la génération manuelle ne traitera que ces produits. Le Back Office affiche une bannière d'avertissement lorsque l'une ou l'autre de ces options de débogage est active.
- Multi-boutique : l'indicateur de verrou (
FPF_GENERATING) est stocké comme valeur globale et s'applique à toutes les boutiques. Si une génération est en cours pour un contexte de boutique, le verrou est partagé.
Résolution des problèmes
| Problème | Solution |
|---|---|
| Un clic sur Générer le flux maintenant ! affiche un avertissement de mode maintenance | Ajoutez l'adresse IP de votre serveur (affichée dans l'avertissement) dans Préférences > Maintenance > IP de maintenance. |
| Le bouton de génération est visible mais rien ne se passe / la page se recharge sans confirmation | cURL a peut-être échoué silencieusement. Vérifiez Options de génération > Timeout cURL — essayez de le désactiver si la génération s'arrête avec peu ou pas de produits traités. |
| Le flux a été généré mais le Tableau de bord affiche toujours les anciennes données | Rechargez la page de configuration — le Tableau de bord actualise ses statistiques à chaque chargement de page. |
| La génération du flux semble bloquée (le verrou ne se libère jamais) | Rechargez la page de configuration. La logique de réinitialisation automatique lit progress.json à chaque chargement et libère le verrou si la génération est déjà terminée. |
| L'URL du flux renvoie une erreur 404 après la génération | Le dossier feeds/ n'est peut-être pas accessible en écriture. Vérifiez les permissions du répertoire modules/facebookproductsfeed/feeds/. |
Foire aux questions
Dois-je garder la page du Back Office ouverte pendant la génération du flux ?
Non. Une fois que vous avez cliqué sur Générer le flux maintenant !, le module lance la génération en tâche de fond. Vous pouvez fermer l'onglet et le processus continuera de s'exécuter sur le serveur.
Combien de temps dure la génération ?
Cela dépend de la vitesse de votre hébergement et de la taille de votre catalogue. Un petit catalogue de quelques centaines de produits prend généralement quelques secondes. Un grand catalogue avec des milliers de produits et de déclinaisons peut prendre plusieurs minutes. La génération par cycles est conçue pour gérer de grands catalogues sans dépasser les limites de temps du serveur.
Puis-je lancer une génération manuelle et un cron en même temps ?
Le verrou de génération du module empêche deux exécutions de se dérouler simultanément. Si une génération manuelle est déjà en cours lorsqu'un cron se déclenche, le cron verra le verrou et ignorera ce cycle.
La génération manuelle va-t-elle écraser le flux que Facebook utilise déjà ?
Oui. La génération manuelle produit un nouveau fichier de flux dans le dossier feeds/, remplaçant le précédent. Facebook lit la même URL, donc la prochaine fois qu'il récupèrera votre flux, il verra la nouvelle version — ou immédiatement si vous utilisez l'option Récupérer maintenant dans Facebook Ads Manager.
Mes paramètres ont changé mais le flux semble identique dans Facebook. Que faire ?
Commencez par régénérer le flux manuellement afin que votre boutique produise le fichier mis à jour. Ensuite, rendez-vous dans Facebook Ads Manager et déclenchez manuellement une récupération immédiate sur votre source de données. Facebook met en cache les données du catalogue entre les actualisations planifiées, donc régénérer le flux sur votre boutique seul ne suffit pas.