Cada vez más comercios online en España trabajan con Shopware en la nube o quieren ampliar su tienda sin mantener un servidor adicional. Los App Scripts permiten que una app ejecute lógica propia directamente dentro de Shopware, por ejemplo en el carrito, sin código PHP y sin infraestructura extra.
Primera consulta gratuita de 15 minutos directamente con nuestros expertos.
Los App Scripts son pequeños programas con sintaxis Twig que una app de Shopware ejecuta directamente en la tienda, sin servidor propio. Reaccionan a hooks como el cálculo del carrito o la carga de una página y permiten lógica que antes solo era posible con plugins.
El sistema de apps de Shopware 6 separa las extensiones de la tienda: las apps se ejecutan fuera y se comunican a través de la API y de webhooks. Esto tiene una desventaja: la lógica que debe ejecutarse durante una petición, como un recargo en el carrito, no se podía implementar así. Los App Scripts cubren este hueco desde Shopware 6.4.8. Una app incluye archivos de script y Shopware los ejecuta en un entorno Twig protegido (sandbox), de forma síncrona y dentro de la tienda. Por eso los App Scripts funcionan también en Shopware SaaS (antes Shopware Cloud), donde no se puede ejecutar código PHP propio.
Cada script está vinculado a un hook que determina cuándo se ejecuta y qué datos y servicios tiene disponibles. Los más importantes:
Los scripts se guardan en la app en Resources/scripts//; el nombre de la carpeta determina el hook. No existe un hook para eventos de negocio como «pedido realizado»: para reaccionar a ellos, las apps utilizan webhooks.
Un script es un archivo Twig que trabaja con los datos del hook y accede a Shopware a través de servicios. Un ejemplo de recargo por pedido mínimo en el carrito:
{# Resources/scripts/cart/recargo-pedido-minimo.twig #}
{% if hook.cart.price.totalPrice < 30 %}
{% do services.cart.products.add("ID_DEL_ARTICULO_DE_RECARGO") %}
{% endif %}
Entre los servicios disponibles están services.repository para leer entidades, services.cart para acciones en el carrito, services.config para la configuración de la app, services.response para endpoints propios y services.writer para escrituras a través de la Data Abstraction Layer. Qué servicios ofrece cada hook lo documenta Shopware en la referencia de scripts: el hook cart, por ejemplo, ofrece cart, price y config, pero no repository.
Los plugins se ejecutan como PHP dentro de la tienda, tienen acceso completo a los servicios de Symfony, a los eventos y a la base de datos, y son la mejor opción para lógica compleja o crítica en rendimiento. Los App Scripts ganan cuando la extensión se va a distribuir como app, debe funcionar en SaaS o la lógica es sencilla. Muchas agencias combinan ambos: app para clientes en SaaS y plugin para proyectos autoalojados. Si necesita una extensión para su tienda Shopware en España, solution25 le asesora en remoto (+49 421 438 1919-0). Cómo desarrollamos extensiones lo explicamos en nuestra página de desarrollo de plugins para Shopware; la diferencia entre formatos se explica en la entrada App: formato de extensión nativo para la nube.
Twig, Event (hook), Webhooks, Extension SDK y extensiones de la Store. Todos los términos en el diccionario Shopware.