Instalar el plugin de Magento

Con la extensión de Magento, su configurador de configento.app funciona directamente en la página de producto de su tienda Magento. Sus clientes configuran, ven el precio al instante y añaden el producto al carrito como siempre. Magento se encarga del pedido, los impuestos y el envío. La configuración aparece en el carrito, el pedido, el correo del pedido y la vista del pedido en el admin.

Requisitos

• Magento Open Source o Adobe Commerce 2.4, hasta 2.4.9 inclusive
• PHP 7.4 a 8.4, con las extensiones json y curl
• Composer y acceso a la línea de comandos de su servidor Magento
• Un acceso al portal de servicio (service.configento.app) con una orden de servicio activa en la tarifa Professional o Ultimate. En la tarifa Basic no se puede conectar ningún plugin de tienda.
• Al menos un componente publicado. Su tienda siempre muestra el último estado publicado.

Magento 1 ya no se sigue desarrollando. Esta guía solo es válida para Magento 2.

Cómo funciona

1. Instala la extensión con Composer.
2. Un administrador de Magento inicia sesión una vez en Configento con su acceso al portal de servicio. A partir de ahí, la tienda y la orden de servicio quedan conectadas – el ID de cliente, la clave y el token los introduce la propia extensión.
3. Añade a cada producto configurable una opción personalizada del tipo configento.app y elige allí el componente.
4. En la página de producto se carga el configurador. Al hacer clic en Añadir al carrito, Magento adopta el precio configurado.

Paso 1: Instalar la extensión

La extensión procede del repositorio Composer de justSelling. El comando correspondiente también lo encontrará en el admin de Configento, en Ajustes → Integraciones, en la tarjeta Magento 2.

Vaya al directorio principal de su instalación de Magento y ejecute:

composer config repositories.configento composer https://www.justselling.de/repo/mage2/
composer require justselling/configento:^5.1

Después, active el módulo y reconstruya Magento:

bin/magento maintenance:enable
bin/magento module:enable Justselling_Configento
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy de_DE en_US
bin/magento cache:flush
bin/magento maintenance:disable

• setup:di:compile y setup:static-content:deploy solo los necesita en modo producción. En static-content:deploy, indique los idiomas de sus tiendas.
• En modo desarrollador bastan setup:upgrade y cache:flush.

Sin Composer

Si no puede usar Composer, descargue el archivo ZIP de la versión deseada en www.justselling.de/repo/mage2/ y descomprímalo en app/code/Justselling/Configento/. Después siguen los mismos comandos bin/magento de arriba. Las actualizaciones tendrá que instalarlas a mano cada vez – por eso Composer es la vía recomendada.

Paso 2: Conectar con Configento

1. En el admin de Magento, abra el menú justSelling → configento.app → configento.app.
2. La primera vez aparece Connect to Configento. Haga clic en Sign in to Configento.
3. Llegará al portal de servicio. Inicie sesión con su acceso al portal.
4. En ¿Qué cliente / qué orden de servicio?, elija la orden de servicio con la que debe trabajar la tienda. Solo se ofrecen órdenes de servicio activas en la tarifa Professional o Ultimate.
5. Confirme la autorización. Los botones se llaman por ahora en inglés Approve (confirmar) y Deny (rechazar).
6. De vuelta en Magento verá Connected to Configento as … y, debajo, el admin de Configento. Aquí crea y edita componentes sin salir de Magento.

Al conectar por primera vez, la extensión introduce automáticamente los datos de acceso de la tienda y notifica la activación a configento.app. No tiene que teclear ni un ID de cliente ni un token de seguridad.

Varios usuarios administradores

El inicio de sesión es válido por usuario administrador de Magento. Cada persona que quiera abrir el admin de Configento en Magento inicia sesión una vez por sí misma. Así verá después quién está conectado y podrá retirar accesos concretos (véase Gestionar conexiones).

Inicio de sesión clásico

Las instalaciones que ya funcionaban antes de la versión 5 pueden seguir con el inicio de sesión anterior con ID de cliente, Secure Key y token de seguridad. Para ello, en la configuración ajuste Use legacy authentication a Yes. En instalaciones nuevas, deje este ajuste desactivado.

Paso 3: Vincular un producto con un componente

1. Abra el producto en el admin de Magento.
2. Abra la sección de opciones personalizadas (Customizable Options) y añada una opción.
3. Dé un título a la opción, p. ej. «Configuración». Aparece en el carrito delante del resumen.
4. Como Option Type, elija configento.app.
5. En el campo Template, elija el componente. La lista muestra por nombre los componentes de su orden de servicio conectada.
6. Guarde el producto.

En la página de producto aparece ahora el configurador. Un componente se puede asignar a tantos productos como quiera.

¿Lista vacía? La lista de componentes viene de configento.app. Si está vacía, la tienda aún no está conectada (paso 2) o la orden de servicio todavía no tiene ningún componente.

Qué ocurre en la tienda

• Página de producto: los componentes con el motor de frontend V3 se integran directamente en la página. La tienda muestra el precio y el resumen en el lugar habitual y las imágenes de producto van a la galería. Los componentes con el motor Legacy funcionan como hasta ahora. Ambos tipos pueden convivir en la misma tienda.
• Carrito: el precio configurado se aplica al carrito, los impuestos, el envío y el pedido. La configuración se muestra como lista debajo del artículo.
• Lista de deseos y compra inmediata: la configuración se guarda con el artículo. Con Editar en el carrito o en la lista de deseos, el configurador se abre de nuevo con la selección guardada.
• Pedido: la configuración aparece en la confirmación del pedido y en la vista del pedido en el admin.

Ajustes de la extensión

Los ajustes se abren en justSelling → configento.app → Configuration. La extensión no tiene traducción al español; aquí nombramos los ajustes tal como aparecen en el admin en inglés.

Configento Connections

General

Development mode, Backend URL, Frontend URL, Cloud Base URL y CORS: Allow Private Network están pensados para el desarrollo y en la tienda en vivo quedan desactivados o vacíos.

Product View

New configurator (V3)

A partir de la versión 5.0.0-beta21. Se aplica a los productos cuyo componente utiliza el nuevo configurador (V3).

Cart, Checkout and Backend

Asset Synchronisation

Price verification

El configurador calcula el precio en el navegador. Con la verificación de precios, su tienda hace que configento.app recalcule cada precio con el mismo método al añadirlo al carrito. Así nadie puede enviar un precio manipulado al carrito.

Así se cambia de nivel:

1. Empiece con Shadow y deje que la tienda funcione normalmente unos días.
2. Busque en el log de Magento configento.v3.price.divergence. Cada entrada es una configuración en la que el navegador y el servidor calcularon distinto – la causa suele ser un tipo impositivo diferente o un valor que solo conoce la tienda.
3. Solo cuando ya no aparezcan diferencias, cambie a Enforce.

Solo se verifican componentes con el motor de frontend V3. Los componentes con el motor Legacy se omiten y se calculan como hasta ahora.

Estado de la suscripción en el backend

A partir de la versión 5.0.0-beta25, la extensión muestra en la parte superior del backend de Magento un mensaje del sistema con el enlace Manage subscription al portal de servicio cuando su suscripción a configento.app requiere atención. La extensión no tiene traducción al español; los mensajes aparecen en inglés:

Cuando configento.app deja de servir a su tienda, las páginas de producto muestran la frase This product cannot be configured at the moment. en lugar del configurador. La extensión consulta el estado como máximo una vez por hora; tras una renovación, el mensaje puede tardar hasta una hora en desaparecer.

Gestionar conexiones

• En Magento: en Configento Connections, dentro de la configuración, verá todos los usuarios administradores conectados y desconectará conexiones concretas con Disconnect.
• En el portal de servicio: en Conexiones verá todas las tiendas conectadas de su orden de servicio con el host de la tienda, el plugin, el usuario que conectó y el último uso. Revocar desconecta allí una tienda por completo.

Actualización

Con Composer obtiene la versión más reciente así:

composer update justselling/configento
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy de_DE en_US
bin/magento cache:flush

La versión instalada aparece arriba en la configuración de la extensión. Qué ha cambiado en cada versión figura en las notas de versión que se entregan con la extensión.

Solución de problemas

Revise estos puntos en orden:

1. «El plugin de tienda solo puede conectarse a una orden Professional o Ultimate» – su orden de servicio tiene la tarifa Basic o no está activa. Cambie de tarifa en el portal de servicio o elija otra orden de servicio.
2. El admin de Configento en Magento solo muestra «Connect to Configento» – este usuario administrador aún no ha iniciado sesión. El inicio de sesión es válido por usuario.
3. El campo «Template» no muestra ningún componente – la tienda aún no está conectada o la orden de servicio todavía no tiene ningún componente.
4. El configurador no aparece en la página de producto – compruebe que el producto tiene la opción del tipo configento.app y que el componente está publicado. Después, vacíe la caché de Magento y recargue la página sin la caché del navegador.
5. Los cambios en el componente no llegan a la tienda – la tienda muestra el último estado publicado. Publique el componente en el admin de Configento.
6. Errores al compilar o tras la actualización – vuelva a ejecutar setup:upgrade, setup:di:compile y cache:flush. En modo producción, de lo contrario, faltan las clases nuevas tras una actualización.
7. «We could not confirm the price for your configuration» – la verificación de precios está en Enforce y configento.app no estaba disponible o no pudo calcular el componente. Vuelva a Shadow y revise el log.
8. Más pistas – active el Debug mode y mire en la consola del navegador. Además, la extensión escribe en var/log/configento.log, y los mensajes del inicio de sesión en var/log/configento-oauth.log.

Si nada de esto ayuda, puede contactar con el soporte a través del chat del portal de servicio. Envíe directamente la versión de la extensión y las entradas de log correspondientes.

Próximos pasos

• Crear su primer componente
• Instalar plugin Shopware
• Integración fragmento HTML
• Interfaz JavaScript (V3)