fullmetrixDocs

Instalación

Conecta tu tienda Magento a Fullmetrix paso a paso, desde la obtención del código hasta la confirmación de la conexión, con lo que hace cada comando.

Esta página sigue el orden real de la conexión. Las partes marcadas para tu desarrollador se las puedes reenviar tal cual. Calcula unos minutos para la instalación en el servidor y después un tiempo de importación que depende del volumen de tu tienda.

Ten dos cosas a mano

El nombre de la persona que puede instalar un módulo en tu servidor Magento (desarrollador, agencia o proveedor de alojamiento) y el acceso al panel de administración de Magento con el menú Marketing. Comprueba también la compatibilidad de tu tienda.

Obtén tu código de conexión

El código de conexión vincula tu tienda con tu organización de Fullmetrix. Se parece a FMTX-7K4M-Q2HD-9WXR. Solo funciona una vez. En cuanto una tienda lo ha aceptado, no se puede usar en ningún otro sitio.

Durante el asistente de configuración

Crea la organización y define lo básico

En la pantalla Bienvenido a Fullmetrix, escribe un nombre en Nombre de tu tienda y haz clic en Crear y continuar. En la pantalla Ajustes básicos, elige tu Zona horaria y tu Moneda, y luego haz clic en Guardar y continuar, o en Omitir este paso para hacerlo más tarde en General.

Elige Magento

En la pantalla Conectar tu tienda, haz clic en la fila Magento, titulada Magento 2.4.4+ / Adobe Commerce. Fullmetrix muestra Generando el código de conexión... durante un segundo.

Copia el comando y el código

La pantalla muestra dos cuadros numerados.

  • Instala la extensión contiene el comando de instalación. El botón de la derecha lo copia y muestra Orden copiada.
  • Conecta tu tienda contiene tu código de conexión. Un clic lo copia y muestra Copiado.

Debajo de estos cuadros, el panel Esperando que el complemento se conecte te pide que dejes la página abierta. Se actualiza solo en cuanto tu tienda acepta el código.

Puedes cerrar la página y volver más tarde. Cuando vuelvas a iniciar sesión en Fullmetrix, el asistente se retoma en el mismo punto y con el mismo código. El enlace Cambiar plataforma te devuelve a la lista si elegiste la plataforma equivocada.

Desde Ajustes

Si ya terminaste el asistente, o si vas a añadir una tienda, abre Ajustes y luego la pestaña Integraciones. En la categoría Comercio electrónico, haz clic en Conectar en la tarjeta Tienda e-commerce, o en el recuadro Agregar una tienda si ya hay una tienda conectada. En la ventana Conectar una plataforma, elige Magento.

La ventana muestra el Código de conexión con un botón para copiarlo, el comando de instalación, un enlace Descargar el plugin y un enlace Enviar las instrucciones a mi desarrollador.

Pasa la instalación a tu desarrollador

Envía las instrucciones por correo

En la ventana Conectar una plataforma, haz clic en Enviar las instrucciones a mi desarrollador. Escribe su dirección en Email del desarrollador y haz clic en Enviar instrucciones. El mensaje Instrucciones enviadas a seguido de la dirección confirma que se envió.

Tu desarrollador recibe un correo con los comandos que debe ejecutar, tu código de conexión y la ruta al menú de Fullmetrix en Magento. Este enlace no se ofrece en el asistente de configuración. Durante el asistente, copia el comando y el código y envíaselos tú mismo.

El código es confidencial

Quien tenga tu código puede conectar una tienda con él. Envíalo solo a la persona que instala el módulo y no lo publiques en un ticket público ni en una captura de pantalla compartida.

Qué le puedes decir

El módulo es un paquete público de Composer llamado fullmetrix/magento-connector. Se instala como cualquier módulo de Magento 2, con el proceso de despliegue habitual de la tienda. Añade al panel de administración el menú Marketing y luego Fullmetrix, y necesita el cron de Magento.

Instala el módulo (para tu desarrollador)

Ejecuta cada comando desde la carpeta raíz del proyecto Magento, con el usuario del sistema que suele ejecutar Composer y bin/magento. Ten una copia de seguridad reciente y respeta tu ventana de publicación habitual.

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

Esto es lo que hace cada línea.

ComandoQué hace
composer require fullmetrix/magento-connector:^1.1Descarga la última versión 1.x del módulo en el proyecto y la añade a composer.json y composer.lock
bin/magento module:enable Fullmetrix_ConnectorActiva el módulo en Magento
bin/magento setup:upgradeRegistra el módulo y crea su tabla de cola en la base de datos
bin/magento setup:di:compileRegenera el código compilado de Magento. Es obligatorio cuando la tienda funciona en modo producción.
bin/magento cache:flushVacía la caché para que el menú de Fullmetrix aparezca en el panel de administración

No te saltes la compilación en modo producción

En una tienda en modo producción, olvidar setup:di:compile tras instalar o actualizar el módulo provoca errores, también en el pago. Si tu proceso de despliegue además despliega los archivos estáticos, síguelo como de costumbre.

Para comprobar que el módulo está activado, tu desarrollador ejecuta este comando.

bin/magento module:status Fullmetrix_Connector

La respuesta debe indicar que el módulo está activado.

Comprueba el cron

El módulo envía los cambios a Fullmetrix cada minuto mediante el cron de Magento, en un grupo de trabajos aparte llamado fullmetrix. Por tanto, el cron de Magento debe estar instalado y en marcha. Si tu crontab solo ejecuta algunos grupos de trabajos de forma explícita, añade este a la lista.

bin/magento cron:run --group=fullmetrix

Instala desde el archivo zip

Si no se puede usar Composer en el servidor, el enlace Descargar el plugin de la ventana Conectar una plataforma ofrece el módulo como archivo zip. Extrae su contenido en app/code/Fullmetrix/Connector y ejecuta los mismos comandos a partir de module:enable. Las actualizaciones serán entonces manuales, sustituyendo esa carpeta.

Pega el código en Magento

Esta parte se hace en el panel de administración de Magento. Puedes hacerla tú mismo una vez instalado el módulo.

Abre la página de Fullmetrix

En el menú de la izquierda del panel de administración, haz clic en Marketing y luego en Fullmetrix. Si la entrada no aparece, cierra sesión en el panel de administración y vuelve a iniciarla. Si sigue faltando, consulta Resolución de problemas.

Menú Marketing del panel de administración de Magento abierto con la entrada Fullmetrix resaltada

Elige la vista de tienda

La página resume los tres pasos de la conexión. En la lista Store view, elige la vista que quieres conectar. Cada línea muestra el sitio web y luego la vista, por ejemplo Main Website / Default Store View. Solo se ofrecen las vistas activas.

La vista que elijas es importante, porque solo se importan los pedidos realizados en esa vista. También determina la dirección, la moneda y el idioma de la tienda que se envían a Fullmetrix. Si tienes dudas, lee la sección sobre la vista de tienda de Compatibilidad.

Pega el código y conecta

Pega tu código en Connection code y haz clic en Connect. Las mayúsculas o minúsculas y los espacios alrededor del código no importan.

Página de Fullmetrix en el panel de administración de Magento con la lista Store view, el campo Connection code rellenado y el botón Connect resaltado

Lee la confirmación

Magento muestra el mensaje de éxito Store connected to Fullmetrix. The first sync starts automatically. Ahora la página muestra una insignia Connected, el código en modo de solo lectura, la línea Store view con el nombre de la vista y un enlace Open the Fullmetrix dashboard.

Si aparece en su lugar un mensaje rojo que empieza por Échec de la connexion (fallo de conexión), el motivo viene justo después. Los motivos posibles se explican en Resolución de problemas.

Página de Fullmetrix en el panel de administración de Magento con la insignia Connected, la vista de tienda conectada y el cuadro Sync activity

Conecta desde la línea de comandos

Tu desarrollador también puede hacer este paso en el servidor. La opción --store-id indica el número de la vista de tienda. Sin ella, se usa la vista por defecto.

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

Sigue la importación

Vuelve a Fullmetrix. Durante el asistente, el panel pasa a Complemento conectado y la pantalla avanza sola a Preparando tu espacio. Una barra de progreso sigue la importación de tus pedidos, productos, clientes e historial de ingresos. El botón Accede al panel de control te deja entrar en la aplicación sin esperar, mientras la importación continúa en segundo plano.

Desde Ajustes, la ventana se cierra con el mensaje Importacion iniciada y la tarjeta de Magento muestra Importación en curso con un porcentaje.

En el lado de Magento, el cuadro Sync activity sigue la misma importación. Muestra Waiting for sync, luego Sync in progress y después Sync complete con el número de elementos importados por tipo.

Comprueba que la conexión funciona

  1. En Fullmetrix, abre Ajustes y luego Integraciones. La tarjeta de Magento muestra la dirección de la tienda, un punto verde y la línea Última sincronización.
  2. Haz un pedido de prueba o edita un producto y espera dos o tres minutos. El cambio aparece en Fullmetrix gracias al cron.
  3. Abre tu tienda, navega por algunas páginas y comprueba después la entrega de eventos en Seguimiento del sitio.

Si los datos no se mueven, empieza por el cron, como se explica en Resolución de problemas.

Actualiza el módulo

Cuando sale una versión nueva, tu desarrollador la obtiene con Composer y vuelve a ejecutar los mismos pasos de despliegue.

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

La conexión se conserva durante una actualización. No hay que volver a introducir ningún código.

En esta página