Con el plugin de Shopware, su configurador aparece directamente en la página de producto de su tienda Shopware. Sus clientes configuran el producto, ven el precio al instante y añaden la configuración terminada al carrito normal de Shopware. Después, el pedido se tramita en Shopware con total normalidad.
Requisitos
- Shopware 6.7 (el plugin actual está hecho para 6.7)
- PHP 8.2 a 8.5
- Un acceso al admin de Shopware con permiso para instalar extensiones
- Un acceso al portal de servicio para el servicio con el que quiere conectar la tienda
- Al menos un componente publicado – los borradores sin publicar no se pueden elegir en la tienda
¿Usa una versión anterior de Shopware 6? Entonces contacte con el soporte antes de instalar.
Descargar el plugin
El plugin lo obtiene en configento.app, en Ajustes → Integraciones.
Si la pestaña está bloqueada, acepte primero el contrato de encargo de tratamiento en Ajustes → Tratamiento de datos.
La tarjeta que verá allí depende de su cuenta:
| Si ve … | Significa | Inicio de sesión en el plugin |
|---|---|---|
| una tarjeta Shopware 6.7 con el botón Descargar plugin | Su tienda se conecta con su acceso al portal de servicio. No necesita token de seguridad. | Connect to Configento (recomendado) |
| una tarjeta Shopware 6 con interruptor, token de seguridad y el enlace Descargar plugin | Su cuenta usa todavía el inicio de sesión clásico. | Introducir a mano Customer ID, Secure Key y Security Token – véase Inicio de sesión clásico |
Descargue el archivo ZIP y no lo descomprima.
Instalar el plugin
En el admin de Shopware
- Abra Extensiones → Mis extensiones (Extensions → My extensions).
- Suba el archivo ZIP con Subir extensión (Upload extension).
- Instale y active el plugin configento.app Plugin.
- Vacíe la caché de Shopware.
Por consola
Si tiene acceso a la consola de Shopware, copie la carpeta descomprimida JustsellingProductConfigurator en custom/plugins/ y ejecute en el directorio de Shopware:
bin/console plugin:refresh
bin/console plugin:install --activate JustsellingProductConfigurator
bin/console cache:clearEl nombre técnico del plugin es JustsellingProductConfigurator. Guías anteriores indican aquí otro nombre que no funciona.
Conectar con Configento
La conexión se establece una vez desde el admin de Shopware. No tiene que copiar ningún token.
- Abra la configuración del configento.app Plugin en la gestión de extensiones.
- En la tarjeta General, bajo Configento connection, está el botón Connect to Configento. Haga clic en él.
- Se le redirige al portal de servicio. Inicie sesión y confirme la conexión.
- Después vuelve al admin de Shopware. Bajo Configento connection aparece ahora Connected as con su acceso al portal.
Deje desactivado el interruptor Use legacy authentication.
Al conectar, el plugin introduce por sí mismo los datos de acceso para la página de producto. Los encontrará en la tarjeta General como Customer ID, Secure Key y Security Token. No tiene que cambiar nada allí.
Cada usuario administrador se conecta por separado. La conexión es válida para el usuario de Shopware que la estableció. Si un compañero trabaja con su propio acceso a Shopware, al abrir el configurador por primera vez verá el aviso Connect to Configento y hará clic en Connect now.
Puede comprobar la conexión existente en cualquier momento con Test connection.
Editar componentes en el admin de Shopware
Tras conectar, en el área de catálogo del menú principal de Shopware aparece la entrada configento.app. Allí se abre configento.app directamente en el admin de Shopware, de modo que edita sus componentes sin salir de la tienda.
Vincular un producto con un componente
- Abra el producto en el admin de Shopware.
- Cambie a la pestaña configento.app.
- Haga clic en Add component.
- En Component name, elija el componente. La lista muestra por nombre los componentes de su servicio conectado.
- Opcional: introduzca un Headline. Aparece sobre el resumen de la configuración en la página de producto (véase Ajustes del plugin).
- Guarde el producto.
Un producto tiene exactamente un componente. Si ya hay uno vinculado, desaparece el botón Add component. Para vincular otro componente, quite el anterior con Remove component y añada después el nuevo.
Si un componente no aparece en la lista, normalmente aún no está publicado. Publíquelo en configento.app y vuelva a abrir el producto.
Qué motor frontend se ejecuta
A partir de la versión 5.2.0, el plugin carga para cada componente el motor frontend adecuado. V3 se ejecuta si lo ha configurado en el componente, si el componente contiene una característica que necesita V3 o si su cuenta funciona sin la nube clásica. En caso contrario, sigue con Legacy. Con el ajuste Configurator version lo fija para toda la tienda, consulte Configurador en la tienda. En qué se diferencian los dos motores: Motor frontend: Legacy o V3.
Con V3, además:
- El precio en la parte superior de la página de producto incluye la configuración y cambia con cada elección.
- Si el componente genera una imagen de producto combinada, sustituye a las fotos del producto en la página de producto. En el carrito, en el pago y en el pedido aparece como imagen de la línea.
- El carrito cobra siempre el precio que calcula configento.app para la configuración, independientemente de la verificación de precios.
- El enlace del producto en el carrito abre el configurador con la selección guardada. El cliente la modifica y vuelve a añadir el producto al carrito.
Autorizar el dominio de la tienda
V3 solo se carga en dominios autorizados para su servicio. A partir de la versión 5.2.3, el plugin comunica a configento.app los dominios de sus canales de venta al conectarse, pero no los autoriza por sí mismo. Adóptelos en el admin de configento.app en Ajustes → Dominios, en la sección Notificados por las tiendas conectadas, antes de pasar un componente a V3. Si más adelante se añade un dominio, introdúzcalo usted mismo o vuelva a conectar el plugin. Más información: Configuración global.
Qué ocurre en la tienda
- El cliente abre la página de producto. El configurador aparece en la zona de compra y sustituye allí al botón normal del carrito.
- El cliente configura el producto. El precio se recalcula con cada selección.
- Con Añadir al carrito, el producto llega con su configuración al carrito de Shopware. Las características elegidas aparecen debajo del producto.
- Shopware tramita el pedido con normalidad. En el pedido, en el admin de Shopware, verá la configuración en la posición del pedido.
El precio del carrito es el precio del producto de Shopware más los recargos de la configuración. Si introduce un precio base en Shopware, este se suma al precio de la configuración. Si el configurador debe determinar el precio completo, ponga el precio de Shopware a 0.
La tienda siempre muestra el último estado publicado del componente. Los cambios que solo ha guardado no los verán sus clientes hasta que publique.
Datos del producto en fórmulas
Con V3, las características del tipo de datos Atributo de producto leen valores del producto de Shopware, a partir de la versión 5.2.1 del plugin. Así una fórmula puede calcular con el ancho, el peso o una propiedad. Como código introduzca en la característica:
| Origen | Código | Ejemplo |
|---|---|---|
| Campo del producto | Nombre del campo en Shopware | productNumber, name, ean, manufacturerNumber, manufacturer, width, height, length, weight, purchaseUnit, referenceUnit, packUnit, minPurchase, purchaseSteps |
| Campo personalizado del producto | Nombre técnico del campo personalizado | custom_banner_material |
| Propiedad del producto | Nombre del grupo de propiedades | Material devuelve p. ej. Lana; varias opciones llegan separadas por comas |
| Variante | Nombre del grupo de propiedades de la variante | Talla devuelve p. ej. XL |
Si un código aparece varias veces, gana el origen que está más arriba en la tabla. Los nombres de los grupos de propiedades valen en el idioma del canal de venta. En una tienda multilingüe, llámelos igual en todos los idiomas; si no, la característica queda vacía en los demás idiomas.
La verificación de precios del carrito usa los mismos valores. El plugin nunca entrega precios de compra, existencias ni descripciones, porque los valores están en el código fuente de la página de producto. Más sobre este tipo de datos: Características de cálculo.
Configuración en la confirmación del pedido
La confirmación de pedido de Shopware no muestra por sí misma las características elegidas. Para ello, en la plantilla de correo Confirmación de pedido, añada este bloque dentro del bucle sobre las posiciones del pedido.
En la versión HTML:
{% if nestedItem.payload.justselling_options is defined and nestedItem.payload.justselling_options|length >= 1 %}
<div>
{% for option in nestedItem.payload.justselling_options %}
{{ option.group }}: {{ option.option }}
{% if nestedItem.payload.justselling_options|last != option %}<br>{% endif %}
{% endfor %}
</div>
{% endif %}En la versión de texto:
{% if lineItem.payload.justselling_options is defined and lineItem.payload.justselling_options|length >= 1 %}, {% for option in lineItem.payload.justselling_options %}{{ option.group }}: {{ option.option }}{% if lineItem.payload.justselling_options|last != option %}{{ " | " }}{% endif %}{% endfor %}{% endif %}Los nombres de variable nestedItem y lineItem deben coincidir con su plantilla. Si su bucle usa otro nombre, sustitúyalos.
Ajustes del plugin
Todos los ajustes están en la configuración del configento.app Plugin. El plugin no tiene traducción al español; aquí nombramos los ajustes tal como aparecen en inglés.
Configurador en la tienda
| Configurator version | Efecto |
|---|---|
| Automatic (as set for the component) (por defecto) | El plugin pregunta a configento.app para cada componente si se ejecuta con V3; consulte Qué motor frontend se ejecuta. |
| Always V3 | Todos los componentes se ejecutan con V3. |
| Always the previous version | Todos los componentes se ejecutan con Legacy. |
Settings
| Ajuste | Efecto | Por defecto |
|---|---|---|
| Load Chart plugin | Actívelo si sus componentes contienen características con diagramas. Solo para Legacy. | desactivado |
| Load Dropzone plugin | Actívelo si sus componentes contienen subidas de archivos. Sin esta opción, la subida no funciona en la tienda. Solo para Legacy. | desactivado |
| Load jQuery | Carga jQuery para el configurador. Desactívelo solo si su tema ya carga jQuery y hay conflictos. Solo para Legacy. | activado |
| Create parts list when ordering | En lugar de un producto configurado, en el pedido se piden los productos individuales de Shopware que corresponden a los valores elegidos. Para ello, el Número de artículo (SKU) de un valor en configento.app debe coincidir con el número de producto de un producto de Shopware. Consulte Listas de piezas por números de artículo. | desactivado |
| CSS Path of combined Image Container | Selector CSS de la zona de la página de producto donde debe aparecer la imagen de producto combinada. Con V3, la imagen sustituye allí a las fotos del producto. Si lo deja vacío, se usa la zona de imágenes de la página de producto. | vacío |
Price verification
A partir de la versión 5.0.1 del plugin, configento.app recalcula en su propio servidor el recargo de cada configuración. Así, un precio manipulado en el navegador no llega al carrito.
| Modo | Efecto |
|---|---|
| Off | Sin verificación. El carrito adopta el precio del configurador. |
| Observe (log differences only) (por defecto) | El carrito sigue adoptando el precio del configurador. Cada diferencia aparece como configento.price.divergence en el log de Shopware. |
| Enforce (cart uses the verified price) | El carrito calcula el precio verificado. Si no lo hay, por ejemplo porque configento.app no está disponible, Shopware bloquea el pedido con un aviso para el cliente. |
Tras la actualización, deje el plugin unos días en Observe. Si en el log no aparecen diferencias, cambie a Enforce.
Este ajuste no se aplica a los componentes con V3: el carrito cobra siempre allí el precio verificado.
Product view
| Ajuste | Efecto | Por defecto |
|---|---|---|
| Show summary in tab on product page | Muestra la configuración elegida en la pestaña de descripción de la página de producto | desactivado |
| Show summary below price on product page | Muestra la configuración elegida debajo del precio, con el Headline de la vinculación del producto | desactivado |
Developer-Settings
Debug mode, Development mode y los campos de URL inferiores están pensados para diagnosticar errores con el soporte. En la tienda en vivo, déjelos desactivados y vacíos.
Estado de la suscripción en la administración
A partir de la versión 5.2.1, el plugin muestra una vez por sesión en la administración de Shopware un aviso configento.app subscription cuando su suscripción requiere atención. La administración de Shopware muestra estos avisos solo en alemán o en inglés:
| Aviso | Significado |
|---|---|
| Your trial ends on … | El periodo de prueba termina en los próximos 7 días. |
| Your subscription is no longer active. Configurators keep working in your shop until … | La suscripción ha terminado. El configurador sigue funcionando hasta la fecha indicada. |
| Your subscription is no longer active. Renew it to keep the configurators running in your shop. (o Your trial has ended. Take out a subscription …) | La suscripción o el periodo de prueba han terminado, pero el configurador sigue funcionando. Renueve antes de que se desactive. |
| … Configurators are no longer available in your shop. | El periodo de prueba o la suscripción han terminado. |
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. El plugin consulta el estado como máximo una vez por hora; tras una renovación, el aviso puede tardar hasta una hora en desaparecer. Su suscripción la gestiona en el portal de servicio.
Inicio de sesión clásico
Las cuentas que en Ajustes → Integraciones ven la tarjeta Shopware 6 con token de seguridad conectan el plugin con tres datos de acceso:
| Campo en el plugin | Dónde encuentra el valor |
|---|---|
| Customer ID | Portal de servicio, página Servicios: el valor detrás de Cliente en el servicio correspondiente |
| Secure Key | Portal de servicio, página Servicios: la Clave de seguridad del servicio correspondiente |
| Security Token | configento.app, Ajustes → Integraciones, tarjeta Shopware 6. Active la tarjeta para que se genere un token. |
En la configuración del plugin, active Use legacy authentication, introduzca los tres valores y guarde. Con Test connection comprueba los datos de acceso. Si son correctos, aparece Legacy cloud connection OK. Si genera un token nuevo en configento.app, tendrá que cambiarlo también en el plugin.
Actualizar el plugin
Suba el nuevo archivo ZIP como en la instalación, en Extensiones → Mis extensiones, y ejecute la actualización. Por consola, copie la carpeta nueva sobre la anterior y ejecute:
bin/console plugin:refresh
bin/console plugin:update JustsellingProductConfigurator
bin/console cache:clearLa conexión, los ajustes y las vinculaciones de productos se conservan en la actualización.
Desconectar
Disconnect está bajo Configento connection en la configuración del plugin.
Atención: desconectar afecta a toda la tienda, no solo a su usuario administrador. Se eliminan todas las vinculaciones entre productos y componentes de la tienda y se restablecen los datos de acceso guardados. Los componentes en configento.app se conservan. Pero tras una nueva conexión tendrá que volver a vincularlos con los productos.
Por tanto, desconecte solo si la tienda ya no va a usar configento.app o debe trabajar con otro servicio. Para cambiar de usuario administrador no es necesario.
En el portal de servicio, en Conexiones, verá todas las tiendas conectadas: host de la tienda, plugin, servicio, Conectado por y Último uso. Allí también puede Revocar una conexión, por ejemplo si ya no tiene acceso a la tienda.
Solución de problemas
La lista de componentes en la pestaña del producto está vacía
- ¿Está conectado su usuario administrador? Abra la configuración del plugin y compruebe si aparece Connected as.
- ¿Está publicado el componente? Los borradores no aparecen.
En configento.app (menú de catálogo) aparece un mensaje de error
- «Stored Configento connection is corrupted — please reconnect.»: haga clic en Disconnect y vuelva a conectar. Tenga en cuenta que así se eliminan las vinculaciones de productos.
- «Configento service portal could not issue a token right now — please try again.»: inténtelo de nuevo pasados unos minutos con Retry.
- «Plugin is not yet connected to Configento.»: haga clic en Connect now.
El configurador no aparece en la página de producto
- ¿Hay un componente elegido en la pestaña configento.app del producto y se ha guardado el producto?
- Vacíe la caché de Shopware y recargue la página en el navegador.
- Con el inicio de sesión clásico: ¿son correctos Customer ID, Secure Key y Security Token? ¿Está activada la tarjeta Shopware 6 en Ajustes → Integraciones?
La subida de archivos o el diagrama no funciona en la tienda Active Load Dropzone plugin o Load Chart plugin y vacíe la caché.
Con V3 el configurador queda vacío o no se carga ¿Está introducido el dominio de su tienda en Ajustes → Dominios? Consulte Autorizar el dominio de la tienda.
Una característica Atributo de producto queda vacía El código no coincide, o el grupo de propiedades tiene otro nombre en el idioma del canal de venta. Con Legacy la característica queda siempre vacía en Shopware. Consulte Datos del producto en fórmulas.
La página de producto muestra «This product cannot be configured at the moment.» Su suscripción o su periodo de prueba ha terminado. Consulte Estado de la suscripción en la administración.
El precio en el carrito es demasiado alto El precio del producto de Shopware se suma al precio de la configuración. Póngalo a 0 si el configurador da el precio completo.
La tienda muestra un estado antiguo Publique el componente en configento.app. La tienda solo muestra estados publicados.
Si nada de esto ayuda, contacte con el soporte a través del chat del portal de servicio. Indique la versión de Shopware, la versión del plugin y el enlace a la página de producto afectada.
Shopware 5
Shopware ya no desarrolla Shopware 5. El plugin de configento.app para Shopware 5 tampoco recibe funciones nuevas. Para tiendas nuevas, use Shopware 6.7.