Installation
Connecter votre boutique Magento à Fullmetrix pas à pas, de la récupération du code jusqu'à la confirmation de connexion, avec ce que fait chaque commande.
Cette page suit l'ordre réel de la connexion. Les parties marquées pour votre développeur peuvent lui être transmises telles quelles. Comptez quelques minutes pour l'installation sur le serveur, puis un temps d'import qui dépend du volume de votre boutique.
Préparez deux choses
Le nom de la personne qui peut installer un module sur votre serveur Magento (développeur, agence ou hébergeur), et un accès à l'administration Magento avec le menu Marketing. Vérifiez aussi la compatibilité de votre boutique.
Récupérer votre code de connexion
Le code de connexion relie votre boutique à votre organisation Fullmetrix. Il ressemble à FMTX-7K4M-Q2HD-9WXR. Il ne sert qu'une seule fois. Dès qu'une boutique l'a accepté, il ne peut plus être utilisé ailleurs.
Pendant l'assistant de démarrage
Créer l'organisation et régler les paramètres
Sur l'écran Bienvenue sur Fullmetrix, saisissez un nom dans Nom de votre boutique, puis cliquez sur Créer et continuer. Sur l'écran Paramètres de base, choisissez votre Fuseau horaire et votre Devise, puis cliquez sur Enregistrer et continuer, ou sur Passer cette étape pour le faire plus tard dans Général.
Choisir Magento
Sur l'écran Connecter votre boutique, cliquez sur la ligne Magento, marquée Magento 2.4.4+ / Adobe Commerce. Fullmetrix affiche Génération du code de connexion... pendant une seconde.
Copier la commande et le code
L'écran affiche deux cadres numérotés.
- Installez l'extension contient la commande d'installation. Le bouton à droite la copie et affiche Commande copiée.
- Connectez votre boutique contient votre code de connexion. Un clic dessus le copie et affiche copié.
Sous ces cadres, l'encadré En attente de connexion du plugin vous demande de garder la page ouverte. Elle se met à jour toute seule dès que votre boutique accepte le code.
Vous pouvez fermer la page et revenir plus tard. En vous reconnectant à Fullmetrix, l'assistant reprend au même endroit avec le même code. Le lien Changer de plateforme vous ramène à la liste si vous vous êtes trompé de plateforme.
Depuis les réglages
Si vous avez déjà terminé l'assistant, ou si vous ajoutez une boutique, ouvrez Paramètres, puis l'onglet Intégrations. Dans la catégorie E-commerce, cliquez sur Connecter sur la carte Boutique e-commerce, ou sur la case Ajouter une boutique si une boutique est déjà connectée. Dans la fenêtre Connecter une plateforme, choisissez Magento.
La fenêtre affiche le Code de connexion avec un bouton de copie, la commande d'installation, un lien Télécharger le plugin et un lien Envoyer les instructions à mon développeur.
Confier l'installation à votre développeur
Envoyer les instructions par e-mail
Dans la fenêtre Connecter une plateforme, cliquez sur Envoyer les instructions à mon développeur. Saisissez son adresse dans Email du développeur, puis cliquez sur Envoyer les instructions. Le message Instructions envoyées à suivi de l'adresse confirme l'envoi.
Votre développeur reçoit un e-mail avec les commandes à exécuter, votre code de connexion et le chemin du menu Fullmetrix dans Magento. Ce lien n'est pas proposé dans l'assistant de démarrage. Pendant l'assistant, copiez la commande et le code, puis envoyez-les vous-même.
Le code est confidentiel
Toute personne qui possède votre code peut y connecter une boutique. Envoyez-le seulement à la personne qui installe le module, et ne le publiez pas dans un ticket public ou une capture partagée.
Ce que vous pouvez lui dire
Le module est un paquet Composer public nommé fullmetrix/magento-connector. Il s'installe comme n'importe quel module Magento 2, avec la procédure de déploiement habituelle de la boutique. Il ajoute le menu Marketing, puis Fullmetrix dans l'administration, et a besoin du cron de Magento.
Installer le module (pour votre développeur)
Toutes les commandes s'exécutent dans le dossier racine du projet Magento, avec l'utilisateur système qui exécute habituellement Composer et bin/magento. Prévoyez une sauvegarde récente et votre fenêtre de mise en production habituelle.
composer require fullmetrix/magento-connector:^1.1
bin/magento module:enable Fullmetrix_Connector
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flushVoici ce que fait chaque ligne.
| Commande | Ce qu'elle fait |
|---|---|
composer require fullmetrix/magento-connector:^1.1 | Télécharge la dernière version 1.x du module dans le projet et l'ajoute à composer.json et composer.lock |
bin/magento module:enable Fullmetrix_Connector | Active le module dans Magento |
bin/magento setup:upgrade | Enregistre le module et crée sa table de file d'attente dans la base de données |
bin/magento setup:di:compile | Régénère le code compilé de Magento. Obligatoire quand la boutique tourne en mode production. |
bin/magento cache:flush | Vide le cache pour que le menu Fullmetrix apparaisse dans l'administration |
Ne sautez pas la compilation en mode production
Sur une boutique en mode production, oublier setup:di:compile après l'installation ou une mise à jour du module provoque des erreurs, y compris au moment du paiement. Si votre procédure de déploiement déploie aussi les fichiers statiques, suivez-la normalement.
Pour vérifier que le module est actif, votre développeur exécute cette commande.
bin/magento module:status Fullmetrix_ConnectorLa réponse doit indiquer que le module est activé.
Vérifier le cron
Le module envoie les changements à Fullmetrix toutes les minutes grâce au cron de Magento, dans un groupe de tâches à part nommé fullmetrix. Le cron de Magento doit donc être installé et actif. Si votre crontab ne lance que certains groupes de tâches de façon explicite, ajoutez celui-ci à la liste.
bin/magento cron:run --group=fullmetrixInstaller à partir du fichier zip
Si Composer n'est pas utilisable sur le serveur, le lien Télécharger le plugin de la fenêtre Connecter une plateforme fournit le module en archive zip. Décompressez son contenu dans app/code/Fullmetrix/Connector, puis exécutez les mêmes commandes à partir de module:enable. Les mises à jour se feront alors à la main, en remplaçant ce dossier.
Coller le code dans Magento
Cette partie se fait dans l'administration Magento. Vous pouvez la faire vous-même une fois le module installé.
Ouvrir la page Fullmetrix
Dans le menu de gauche de l'administration, cliquez sur Marketing, puis sur Fullmetrix. Si l'entrée n'apparaît pas, déconnectez-vous de l'administration et reconnectez-vous. Si elle manque toujours, voyez Dépannage.

Choisir la vue boutique
La page rappelle les trois étapes de la connexion. Dans la liste Vue boutique (Store view si votre administration est en anglais), choisissez la vue à connecter. Chaque ligne affiche le site puis la vue, par exemple Main Website / Default Store View. Seules les vues actives sont proposées.
La vue choisie compte, parce que seules les commandes passées sur cette vue sont importées. Elle fixe aussi l'adresse de la boutique, la devise et la langue envoyées à Fullmetrix. Si vous hésitez, lisez Choisir la vue boutique.
Coller le code et connecter
Collez votre code dans Code de connexion (Connection code), puis cliquez sur Connecter (Connect). Les majuscules et les espaces autour du code n'ont pas d'importance.

Lire la confirmation
Magento affiche un message de succès qui indique que la boutique est connectée et que la première synchronisation démarre automatiquement. La page affiche maintenant une pastille Connecté (Connected), le code en lecture seule, la ligne Vue boutique avec le nom de la vue, et un lien Ouvrir le tableau de bord Fullmetrix.
Si un message rouge Échec de la connexion apparaît à la place, la raison est indiquée juste après. Les raisons possibles sont expliquées dans Dépannage.

Connecter en ligne de commande
Votre développeur peut aussi faire cette étape sur le serveur. L'option --store-id indique le numéro de la vue boutique. Sans elle, la vue par défaut est utilisée.
bin/magento fullmetrix:connect FMTX-XXXX-XXXX-XXXX --store-id=1Suivre l'import
Revenez dans Fullmetrix. Pendant l'assistant, l'encadré passe à Plugin connecté et l'écran avance tout seul vers Préparation de votre espace. Une barre de progression suit l'import de vos commandes, produits, clients et de votre historique de revenus. Le bouton Accéder au tableau de bord vous laisse entrer dans l'application sans attendre, l'import continue en arrière-plan.
Depuis les réglages, la fenêtre se ferme avec le message Import démarré et la carte Magento affiche Importation en cours avec un pourcentage.
Côté Magento, le cadre Activité de synchronisation suit le même import. Il affiche En attente de synchronisation, puis Synchronisation en cours, puis Synchronisation terminée avec le nombre d'éléments importés par type.
Vérifier que tout fonctionne
- Dans Fullmetrix, ouvrez Paramètres, puis Intégrations. La carte Magento affiche l'adresse de la boutique, une pastille verte et la ligne Dernière synchro.
- Passez une commande de test ou modifiez un produit, puis attendez deux ou trois minutes. Le changement apparaît dans Fullmetrix grâce au cron.
- Ouvrez votre boutique, parcourez quelques pages, puis regardez la réception des événements dans Script de suivi.
Si les données n'avancent pas, commencez par le cron, comme expliqué dans Dépannage.
Mettre à jour le module
Quand une nouvelle version sort, votre développeur la récupère avec Composer puis relance les mêmes étapes de déploiement.
composer update fullmetrix/magento-connector
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flushLa connexion est conservée pendant une mise à jour. Il n'y a pas de code à saisir de nouveau.