Cada componente funciona en su tienda con uno de dos motores de frontend: Legacy, el configurador probado, o V3, el nuevo motor en fase beta. Ambos leen los mismos datos – características, valores, precios y reglas. Pero los muestran de forma distinta, y algunas funciones solo existen en uno de los dos. Este artículo muestra dónde funciona cada motor, en qué se diferencian y cómo cambiar de forma segura.
Dónde se configura el motor
El motor se configura para cada componente:
- Abra el componente y cambie a la pestaña Ajustes de la izquierda.
- En la pestaña General, al final, encontrará Motor de frontend con el campo Motor.
- Elija Legacy (predeterminado) o V3 (Beta).
- Guarde y publique el componente. Solo entonces se aplica el nuevo motor en la tienda.
El ajuste no cambia:
- sus datos – características, valores, precios, reglas y tablas se mantienen igual,
- el editor del admin – edita el componente exactamente igual que antes,
- la publicación – la comprobación y el proceso son los mismos para ambos motores.
Por tanto, puede volver atrás en cualquier momento.
Qué motor funciona dónde
No todas las integraciones siguen este ajuste:
| Dónde funciona el componente | Motor |
|---|---|
| Vista previa en el admin | El motor configurado. Así prueba un cambio antes de que lo vean sus clientes. |
| Magento 2 | El motor configurado. Componentes con Legacy y con V3 funcionan en paralelo en la misma tienda. |
| Shopify | Siempre V3, independientemente del ajuste. |
| PrestaShop 9 | Siempre V3, independientemente del ajuste. |
| Shopware 6 | Siempre Legacy. Por ahora, el plugin de Shopware no puede cargar el motor V3. |
| Fragmento HTML | Decide el fragmento, no el ajuste: el fragmento clásico de la tarjeta HTML5 carga Legacy, el fragmento de la tarjeta HTML5 (V3 Beta) carga V3. |
Las cuentas sin la nube clásica funcionan con V3 en todos los lugares donde el motor depende de la cuenta – el ajuste Legacy (predeterminado) no tiene efecto allí. Reconocerá estas cuentas por este aviso en Ajustes → Integraciones: «Los plugins de tienda se conectan a través del portal de servicio; aquí no se necesita ningún token de seguridad.»
Más sobre cada integración: Instalar plugin Magento, Instalar plugin Shopware, Instalar el plugin de Shopify, Instalar el plugin de PrestaShop, Integración fragmento HTML.
Qué es diferente
Solo en V3
| Función | Qué hace Legacy en su lugar |
|---|---|
| Captcha (tipo de datos Captcha (solo V3), protege el botón de acción contra el spam) | No puede mostrarlo – vea La etiqueta "V3" |
Imagen de producto combinada en PDF y correo electrónico (marcador {{combined_image}} en el botón de acción) |
El marcador queda vacío |
| Ponderación de reglas (el campo Ponderación de la configuración de la regla determina el orden) | No evalúa la ponderación; las reglas se ejecutan en el orden guardado |
Condiciones en el precio escalonado (>=, >, =, <=, <, !=) |
Ignora la condición y toma siempre el tramo más alto cuyo valor sea menor o igual que la entrada; si la entrada está por debajo de todos los tramos, se aplica el más pequeño |
Fórmulas con nombres de características sin $ (ancho * alto) y round(x, 2) con decimales |
Necesita $ancho; que round esté disponible depende de la página de la tienda |
Solo en Legacy
| Función | Qué hace V3 en su lugar |
|---|---|
| Visualización Acordeón | Muestra las características sin navegación por grupos (como Sin grupos) |
| Vista 360° de la imagen de producto combinada | Muestra la imagen combinada solo como capas estáticas |
| Autocompletar (selección como campo de búsqueda) | Muestra una lista de selección normal con todos los valores |
| Campo de fecha con calendario y restricciones (p. ej. Permitir días pasados) | Muestra un campo de texto normal sin calendario |
| Cantidad predefinida y Mín/máx predefinidos (tipos de regla) | Omite estas reglas |
Fórmulas de varias líneas con var, if o for |
Evalúa solo una expresión; las fórmulas de varias líneas no devuelven resultado. Escriba las condiciones como condición ? a : b. |
Más sobre fórmulas: Fórmulas y cálculos. Más sobre precios escalonados: Configurar precios.
La etiqueta "V3"
Algunas características necesitan V3 – actualmente es el Captcha. Si un componente contiene una característica así,
- lleva la etiqueta V3 en la vista general de componentes,
- la configuración del componente muestra el aviso Requiere Frontend V3,
- Magento 2 lo carga automáticamente con V3 – aunque en Motor siga figurando Legacy (predeterminado).
Esto no bloquea la publicación. Pero las integraciones que solo cargan Legacy – Shopware 6 y el fragmento HTML5 clásico – no pueden mostrar correctamente un componente así. No utilice Captcha allí.
Por tanto, la etiqueta no indica qué motor ha configurado, sino que el componente no funciona por completo sin V3.
¿Qué motor debe elegir?
Quédese con Legacy (predeterminado) si
- su componente ya está en línea y funciona como debe,
- utiliza Acordeón, la vista 360°, Autocompletar, campos de fecha, cantidad o mín/máx predefinidos, o fórmulas de varias líneas,
- su tienda funciona con Shopware 6.
Elija V3 (Beta) si
- crea un componente nuevo y no necesita ninguna de las funciones de Legacy anteriores,
- quiere usar Captcha, la imagen de producto combinada en el PDF o la ponderación de reglas,
- su tienda funciona con Shopify o PrestaShop – allí se usa V3 de todos modos.
Cambiar un componente existente
- Ponga Motor en V3 (Beta) y guarde – todavía sin publicar.
- Compruebe en la vista previa: ¿aparecen todas las características? ¿Es correcto el precio para algunas configuraciones típicas?
- Preste especial atención a los precios escalonados: si un tramo tiene una condición distinta de
>=, V3 calcula de forma diferente a antes. Un tramo «>10» se aplica en V3 a partir de 11, en Legacy ya a partir de 10. - Compruebe las fórmulas: reescriba antes las fórmulas de varias líneas como una sola expresión.
- Si todo está bien, publique. Si el resultado no le convence, vuelva simplemente a Legacy (predeterminado) y publique de nuevo.
Solución de problemas
- El cambio no tiene efecto en la tienda – el motor solo se aplica después de publicar. Compruebe también la tabla anterior: Shopify y PrestaShop funcionan siempre con V3, Shopware 6 siempre con Legacy y, en el fragmento HTML, decide el fragmento.
- Falta una característica o se ve distinta – el componente usa una función que el motor elegido no conoce. Para las características que no conoce en absoluto, V3 muestra el aviso «Tipo de característica desconocido». Compare con las tablas anteriores.
- El precio difiere tras el cambio – normalmente se debe a un precio escalonado con una condición distinta de
>=o a una fórmula que no devuelve resultado en uno de los motores. Pruebe la configuración afectada en la vista previa con ambos motores. - Una fórmula no devuelve resultado en V3 – consta de varias instrucciones (
var,if,;). Escríbala como una sola expresión, p. ej.$ancho > 200 ? $ancho * 1.2 : $ancho. - El componente tiene la etiqueta V3 aunque está configurado Legacy – contiene un Captcha. Por eso funciona con V3 en Magento 2; en Shopware 6 y en el fragmento HTML5 clásico no funciona por completo.