fullmetrixDocs

Troubleshooting

Fix Sylius plugin problems, from a failed installation to an import that does not finish.

Always start with checks that change nothing. Do not click Disconnect in Sylius, or in Fullmetrix, to "start over". In Sylius, disconnecting cuts the link and the code cannot be reused. In Fullmetrix, it deletes the imported data.

Several checks on this page concern the project code. Pass them on to your developer, with the time and the exact message of the problem.

Composer refuses to install the plugin

Your developer runs this command to find out what blocks it.

composer why-not fullmetrix/sylius-plugin '*'

The usual causes are a PHP version below 8.1, a missing cURL or JSON extension, or a Sylius, Symfony or Doctrine version outside the list in Compatibility. They resolve dependencies on their machine, then deploy the resulting composer.lock file. Copying the vendor/ folder from one machine to another is a bad idea if the PHP versions differ.

Symfony does not load the plugin

If bin/console cache:clear fails or no Fullmetrix route exists, check that config/bundles.php contains this line.

Fullmetrix\SyliusPlugin\FullmetrixPlugin::class => ['all' => true],

Your developer then runs composer dump-autoload and clears the cache with the same environment as the live site. On several servers, they check each one.

The Fullmetrix page does not appear in the admin

  1. Open your store's /admin/fullmetrix address directly with an admin account. If the page shows up, only the menu is missing, often because of a custom admin menu or theme.
  2. If the address returns a 404 error, the routes are not imported. Your developer checks the config/routes/fullmetrix.yaml file, then runs bin/console debug:router fullmetrix_admin_connection, which must show the route.
  3. They clear the cache, then you reload the page.

The migration fails

  • Back up the database before trying again.
  • Your developer checks bin/console doctrine:migrations:status and the first error shown.
  • They check that the database user is allowed to create tables.
  • They do not create the tables by hand and do not mark the migration as run without understanding the error.

Connection error messages

When the connection fails, the page shows Connection failed followed by a reason. Some reasons come back in French. They are quoted below as they appear.

Reason shownWhat it meansWhat to do
invalid_code_formatThe code does not have the form FMTX-XXXX-XXXX-XXXXCopy it again from Fullmetrix. It never contains the letters O and I or the digits 0 and 1.
storage_failedThe plugin could not save its settingsThe migration was probably not run. Your developer runs bin/console doctrine:migrations:migrate.
Code de connexion introuvableThis code does not exist in FullmetrixCopy the code shown in your organization again, with no extra characters
Plateforme incorrecte pour ce codeThe code was created for another platformIn Fullmetrix, go back to the platform choice, choose Sylius, then copy the code shown and try again
Ce code est déjà associé à un autre siteA store has already accepted this codeSee the next section
Trop de tentatives, réessayez dans quelques minutes.Too many attempts in a short timeWait ten minutes before trying again
Cette boutique est déjà connectée à une autre Organization.The store already belongs to another Fullmetrix organizationUse that organization, or remove the store from it first
Cette boutique a déjà bénéficié d'un essai Fullmetrix...The free trial was already used for this storeA subscription is required, see Billing
invalid_response, register_failed or a network messageThe server could not reach Fullmetrix properlyYour developer checks that PHP can open outgoing HTTPS connections to fullmetrix.com (firewall, proxy, DNS, certificates)

Do not share an active code

The code is a secret. If you send a screenshot of the Fullmetrix page in Sylius, fully hide the Connection code field.

The code is "already associated with another site"

A code works only once. This message, Ce code est déjà associé à un autre site, appears when you retry with a code that was already accepted, for example after clicking Disconnect in Sylius, or if another installation (a staging site, for example) used it first.

If the store card in Fullmetrix still works, there is nothing to do. If you disconnected the store in Sylius and want to reconnect it, you need a new code. Open Settings, then Integrations, click Disconnect on the Sylius card, confirm, then add the store again to get a fresh code. This erases the data imported into Fullmetrix, which is then imported again from your store.

Connected, but the import does not finish

  1. In Sylius, open Marketing, then Fullmetrix, and look at the Sync activity box. Note whether it shows Waiting for sync, Sync in progress or Sync complete.
  2. Read the Recent activity box. A sync_error line contains the cause of the error. Note it before clicking Clear logs.
  3. In Fullmetrix, read the Sylius card in Settings, then Integrations. The message The last sync could not reach your store means Fullmetrix could not call your site.
  4. Your developer checks that the /fullmetrix/api/ addresses get through the proxy, the cache and the firewall. If you use Cloudflare, follow Cloudflare and firewalls.
  5. They check the PHP and web server logs at the time of the problem, and that every server runs the same plugin version.

After an error, the Sync button gives way to Resume and Reset. Once the cause is fixed, click Resume to continue from where the import stopped. If Resume isn't offered, click Reset, which sets the progress back to zero and restarts the sync without deleting orders already imported. The card's other states are described in Sync status.

The store address is wrong in Fullmetrix

The card shows the address the plugin sent when you connected. If it is an internal address, an HTTP address or another domain, the admin was opened with that address, or Symfony does not trust the proxy in front of the site. Your developer fixes the proxy configuration. To record the right address, the store then has to be reconnected with a new code, as explained above.

Visitor tracking receives nothing

  • Check that the Fullmetrix page in Sylius still shows Connected.
  • Test on a public page of the store, not on the admin.
  • Clear any page cache in front of the site.
  • Run your test after accepting cookies if a consent banner is in place.
  • Check delivery in Tracking script.

Contact support

If the problem persists, contact us with the following.

  • The store's public address and the name of your Fullmetrix organization.
  • The Sylius, plugin, PHP, Symfony and Doctrine versions.
  • The exact message, the time it appeared and the timezone.
  • The output of bin/console debug:router fullmetrix_admin_connection.
  • A screenshot of the Sync activity and Recent activity boxes, with the code hidden.

Never send a password, a connection code or an extract of your production database.

On this page