fullmetrixDocs

Solución de problemas

Resuelve problemas de instalación, ruta, código, webhook y sincronización de Fullmetrix en Sylius.

Anota el error exacto, hora y zona horaria, versiones del plugin, Sylius y PHP, y el commit desplegado antes de cambiar la instalación.

Composer no puede instalar el plugin

  1. Ejecuta composer why-not fullmetrix/sylius-plugin '*'.
  2. Confirma PHP 8.1 o posterior y las extensiones cURL y JSON.
  3. Comprueba las versiones de Sylius, Symfony y Doctrine.
  4. Verifica la autenticación de Composer al repositorio del paquete.
  5. Resuelve las dependencias en desarrollo y despliega el archivo de bloqueo resultante.

Symfony no carga FullmetrixPlugin

Comprueba esta entrada en config/bundles.php:

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

Ejecuta composer dump-autoload, comprueba vendor/fullmetrix/sylius-plugin y limpia la caché con el mismo APP_ENV que la aplicación web. Revisa cada nodo.

Fullmetrix no aparece en el menú

  1. Comprueba el bundle y la importación de rutas.
  2. Ejecuta bin/console debug:router fullmetrix_admin_connection.
  3. Limpia la caché.
  4. Abre /admin/fullmetrix directamente con una cuenta administradora.
  5. Si la ruta funciona, revisa menús o temas personalizados.

La migración falla

  • Haz una copia de seguridad nueva antes de reintentar.
  • Consulta bin/console doctrine:migrations:status y el primer error SQL.
  • Comprueba permisos para crear y modificar tablas.
  • No crees las tablas manualmente ni marques una migración fallida como ejecutada sin revisión.

El código es rechazado

  • Genéralo desde la organización y plataforma correctas.
  • Copia todo el valor FMTX-… sin espacios ni puntuación.
  • No reutilices un código de otro CMS u organización.
  • Comprueba URL HTTPS, DNS, proxy, certificados y acceso saliente de PHP.
  • Crea otro código solo después de confirmar que el anterior no fue aceptado.

Nunca envíes un código activo en una captura

El código es un secreto. Soporte puede investigar con el ID de organización, URL, hora, versión del plugin y una captura con el código completamente cubierto.

Connected, pero la importación no termina

  1. Mantén abierta la página Fullmetrix hasta que detecte el plugin.
  2. Comprueba Waiting for sync, Sync in progress o Sync complete en Marketing > Fullmetrix.
  3. Revisa Recent activity y conserva el mensaje sync_error antes de borrar el registro.
  4. Comprueba el acceso a /fullmetrix/api/* a través del proxy o WAF.
  5. Revisa los registros PHP y del servidor web en la misma hora.
  6. Comprueba base compartida y versión idéntica en todos los nodos.

Falta el seguimiento de la tienda

  • Comprueba que el plugin siga mostrando Connected.
  • Carga una página pública, no una ruta administrativa o API.
  • Busca el rastreador en el código fuente y la red del navegador.
  • Revisa gestor de consentimiento, CSP, proxy, caché y tema.

Información para soporte

Envía, sin contraseñas, códigos, secretos, datos de clientes ni contenido de producción:

  • URL pública e ID o slug de organización
  • Versiones de Sylius, plugin, PHP, Symfony y Doctrine
  • Error, hora, zona horaria y commit
  • Resultado de debug:router fullmetrix_admin_connection
  • Estado actual y actividad reciente redactada
  • Código de estado pertinente del proxy o servidor

Antes de retirar nada, consulta Desconectar y desinstalar.

On this page