App Script: logica personalizzata per le app Shopware senza server proprio

Gli App Script sono piccoli programmi in sintassi Twig che un’app Shopware esegue direttamente nel negozio, senza un server proprio. Reagiscono a hook come il calcolo del carrello o il caricamento di una pagina e consentono una logica che prima era possibile solo con i plugin.

Il sistema di app di Shopware 6 separa le estensioni dal negozio: le app girano all’esterno e comunicano tramite API e webhook. Questo ha uno svantaggio: la logica che deve essere eseguita durante una richiesta, ad esempio un supplemento nel carrello, non si poteva realizzare. Gli App Script colmano questa lacuna da Shopware 6.4.8. Un’app include file di script che Shopware esegue in un ambiente Twig protetto, in modo sincrono e all’interno del negozio. Per questo gli App Script funzionano anche in Shopware Cloud, dove non è consentito eseguire codice PHP proprio.

Ogni script è collegato a un hook, che stabilisce quando viene eseguito e quali dati vede. I più importanti:

• cart: a ogni calcolo del carrello. Accesso a righe, prezzi, cliente e contesto; hook tipico per supplementi, sconti o articoli omaggio.
• product-page-loaded, product-listing-loaded, checkout-confirm-page-loaded e altri hook dello storefront: arricchiscono i dati della pagina, ad esempio con informazioni aggiuntive da un altro sistema.
• api e custom-endpoint: endpoint propri in Admin API e Store API a cui risponde uno script.
• storefront-custom-page: rendering di pagine proprie nello storefront.
• order-placed e altri hook di evento: reagire dopo un evento, ad esempio inviando dati all’app.

Gli script si trovano nell’app in Resources/scripts//; il nome della cartella determina l’hook.

Uno script è un file Twig che lavora con i dati dell’hook e accede a Shopware tramite servizi. Un esempio di supplemento per ordini di piccolo importo nel carrello:

{# Resources/scripts/cart/supplemento-piccoli-ordini.twig #}
{% if hook.cart.price.totalPrice < 30 %}
{% do services.cart.products.add("ID_ARTICOLO_SUPPLEMENTO") %}
{% endif %}

Tra i servizi disponibili ci sono services.repository per leggere le entità, services.cart per le azioni sul carrello, services.config per la configurazione dell’app, services.response per endpoint propri e services.writer per le scritture tramite il Data Abstraction Layer. Quali servizi mette a disposizione ciascun hook è documentato da Shopware nel riferimento degli script.

• Logica dei prezzi nel carrello: supplementi, scaglioni, omaggi, valori minimi d’ordine per gruppo di clienti.
• Arricchire i dati: completare le pagine prodotto con informazioni da sistemi terzi o valori calcolati.
• Endpoint propri: piccole interrogazioni per JavaScript dello storefront o servizi esterni senza passare dall’app.
• Validazione: bloccare gli ordini se non sono soddisfatte determinate condizioni.
• Compatibilità cloud: logica che deve girare in Shopware Cloud, dove i plugin non sono consentiti.

• Nessun codice PHP arbitrario: gli script girano in una sandbox con servizi definiti; file system, database e librerie esterne non sono accessibili.
• Servizi esterni: gli script raggiungono i sistemi terzi solo tramite i canali previsti; interrogazioni pesanti durante il calcolo del carrello rallentano il checkout.
• Performance: gli script del carrello vengono eseguiti a ogni calcolo. Logiche complesse o molte interrogazioni al repository rallentano il negozio.
• Debugging: gli errori compaiono nei log; un ambiente di sviluppo dedicato con il debug degli script attivo semplifica molto il lavoro.

I plugin girano come PHP nel negozio, hanno pieno accesso a servizi Symfony, eventi e database e sono la scelta migliore per logiche complesse o critiche per le performance. Gli App Script sono preferibili quando l’estensione deve essere distribuita come app, girare nel cloud o quando la logica è contenuta. Molte agenzie combinano entrambi: app per i clienti cloud, plugin per i progetti self hosted. Se gestisce un negozio Shopware in Italia e vuole sapere come realizziamo le estensioni, legga la nostra pagina sullo sviluppo di plugin Shopware; la differenza tra i formati è spiegata nella voce App: formato di plugin cloud native.

Twig, Evento (hook), Webhook, Extension SDK e Estensioni dello Store. Tutti i termini nel glossario Shopware.