fullmetrixDocs

Installation

Connect your Magento store to Fullmetrix step by step, from getting the code to the connection confirmation, with what each command does.

This page follows the actual order of the connection. The parts marked for your developer can be forwarded to them as they are. Allow a few minutes for the server installation, then an import time that depends on your store's volume.

Have two things ready

The name of the person who can install a module on your Magento server (developer, agency or hosting provider), and access to the Magento admin with the Marketing menu. Also check your store's compatibility.

Get your connection code

The connection code links your store to your Fullmetrix organization. It looks like FMTX-7K4M-Q2HD-9WXR. It works only once. As soon as a store has accepted it, it cannot be used anywhere else.

During the setup wizard

Create the organization and set the basics

On the Welcome to Fullmetrix screen, enter a name in Store name, then click Create and continue. On the Basic settings screen, choose your Timezone and Currency, then click Save and continue, or Skip this step to do it later in General.

Choose Magento

On the Connect your store screen, click the Magento row, labeled Magento 2.4.4+ / Adobe Commerce. Fullmetrix shows Generating connection code... for a second.

Copy the command and the code

The screen shows two numbered boxes.

  • Install the extension holds the install command. The button on the right copies it and shows Command copied.
  • Connect your store holds your connection code. One click copies it and shows copied.

Below these boxes, the Waiting for plugin connection panel asks you to leave the page open. It updates on its own as soon as your store accepts the code.

You can close the page and come back later. When you sign back in to Fullmetrix, the wizard resumes at the same point with the same code. The Change platform link takes you back to the list if you picked the wrong platform.

From Settings

If you have already finished the wizard, or you are adding a store, open Settings, then the Integrations tab. In the E-commerce category, click Connect on the E-commerce store card, or the Add a store tile if a store is already connected. In the Connect a platform window, choose Magento.

The window shows the Connection code with a copy button, the install command, a Download plugin link and a Send instructions to my developer link.

Hand the installation to your developer

Send the instructions by email

In the Connect a platform window, click Send instructions to my developer. Enter their address in Developer email, then click Send instructions. The message Instructions sent to followed by the address confirms it was sent.

Your developer receives an email with the commands to run, your connection code and the path to the Fullmetrix menu in Magento. This link is not offered in the setup wizard. During the wizard, copy the command and the code, then send them yourself.

The code is confidential

Anyone who has your code can connect a store to it. Send it only to the person installing the module, and do not post it in a public ticket or a shared screenshot.

What you can tell them

The module is a public Composer package named fullmetrix/magento-connector. It installs like any Magento 2 module, with the store's usual deployment process. It adds the Marketing, then Fullmetrix menu to the admin and needs the Magento cron.

Install the module (for your developer)

Run every command from the root folder of the Magento project, with the system user that usually runs Composer and bin/magento. Have a recent backup and your usual release window.

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:flush

Here is what each line does.

CommandWhat it does
composer require fullmetrix/magento-connector:^1.1Downloads the latest 1.x version of the module into the project and adds it to composer.json and composer.lock
bin/magento module:enable Fullmetrix_ConnectorEnables the module in Magento
bin/magento setup:upgradeRegisters the module and creates its queue table in the database
bin/magento setup:di:compileRegenerates Magento's compiled code. Required when the store runs in production mode.
bin/magento cache:flushClears the cache so the Fullmetrix menu shows up in the admin

Do not skip compilation in production mode

On a store in production mode, forgetting setup:di:compile after installing or updating the module causes errors, including at checkout. If your deployment process also deploys static files, follow it as usual.

To check that the module is enabled, your developer runs this command.

bin/magento module:status Fullmetrix_Connector

The answer must say that the module is enabled.

Check the cron

The module sends changes to Fullmetrix every minute through the Magento cron, in a separate job group named fullmetrix. The Magento cron must therefore be installed and running. If your crontab only runs some job groups explicitly, add this one to the list.

bin/magento cron:run --group=fullmetrix

Install from the zip file

If Composer cannot be used on the server, the Download plugin link in the Connect a platform window provides the module as a zip archive. Extract its contents into app/code/Fullmetrix/Connector, then run the same commands starting from module:enable. Updates will then be manual, by replacing that folder.

Paste the code in Magento

This part happens in the Magento admin. You can do it yourself once the module is installed.

Open the Fullmetrix page

In the admin's left menu, click Marketing, then Fullmetrix. If the entry does not appear, sign out of the admin and sign back in. If it is still missing, see Troubleshooting.

Magento Marketing menu with Fullmetrix highlighted

Choose the store view

The page recaps the three connection steps. In the Store view list, choose the view to connect. Each line shows the website then the view, for example Main Website / Default Store View. Only active views are offered.

The view you choose matters, because only orders placed on that view are imported. It also sets the store address, currency and language sent to Fullmetrix. If you are unsure, read the store view section of Compatibility.

Paste the code and connect

Paste your code into Connection code, then click Connect. Upper or lower case and spaces around the code do not matter.

Fullmetrix Magento form with the store-view selector highlighted

Read the confirmation

Magento shows the success message Store connected to Fullmetrix. The first sync starts automatically. The page now shows a Connected badge, the code in read-only mode, the Store view line with the view name, and an Open the Fullmetrix dashboard link.

If a red message starting with Échec de la connexion (connection failed) appears instead, the reason follows right after it. The possible reasons are explained in Troubleshooting.

Fullmetrix Magento module showing the Connected status

Connect from the command line

Your developer can also do this step on the server. The --store-id option gives the store view number. Without it, the default view is used.

bin/magento fullmetrix:connect FMTX-XXXX-XXXX-XXXX --store-id=1

Follow the import

Go back to Fullmetrix. During the wizard, the panel switches to Plugin connected and the screen moves on by itself to Preparing your workspace. A progress bar follows the import of your orders, products, customers and revenue history. The Go to dashboard anyway button lets you into the app without waiting, while the import keeps running in the background.

From Settings, the window closes with the message Import started and the Magento card shows Import in progress with a percentage.

On the Magento side, the Sync activity box follows the same import. It shows Waiting for sync, then Sync in progress, then Sync complete with the number of imported items per type.

Check that everything works

  1. In Fullmetrix, open Settings, then Integrations. The Magento card shows the store address, a green dot and the Last sync line.
  2. Place a test order or edit a product, then wait two or three minutes. The change shows up in Fullmetrix thanks to the cron.
  3. Open your store, browse a few pages, then check event delivery in Tracking script.

If data does not move, start with the cron, as explained in Troubleshooting.

Update the module

When a new version is released, your developer fetches it with Composer and runs the same deployment steps again.

composer update fullmetrix/magento-connector
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush

The connection is kept during an update. There is no code to enter again.

On this page