Apps: het cloudgeschikte extensieformaat van Shopware 6

Apps zijn het extensieformaat dat Shopware 6 voor de cloud heeft ontwikkeld: ze draaien buiten de webshop, communiceren via API’s en webhooks met de shop en brengen met App Scripts toch logica in de request. Klassieke plugins draaien daarentegen als PHP-code in de webshop.

Met Shopware 6.4 heeft Shopware naast plugins een tweede extensieformaat geïntroduceerd. Een app bestaat in de kern uit een manifest.xml, die beschrijft wat de app mag doen en waar zij ingrijpt, en optioneel uit templates, scripts, configuratieschema’s en adminmodules. Eigen servercode draait niet in de webshop, maar op een server van de appaanbieder, die via de Admin-API terugbelt.

De reden voor dit ontwerp is de Shopware Cloud: in een gedeelde omgeving mag geen externe PHP-code worden uitgevoerd. Apps maken extensies toch mogelijk, en wel in een formaat dat zowel in de cloud als in zelf gehoste webshops werkt.

• Uitvoering: plugins draaien als PHP binnen Shopware, apps erbuiten (plus App Scripts in de webshop).
• Toegang: plugins bereiken alle Symfony-services, events en de database. Apps gebruiken Admin-API, Store-API, webhooks en gedefinieerde scriptservices.
• Hosting: plugins vereisen een zelf gehoste webshop. Apps draaien ook in de Shopware Cloud.
• Taal: plugins zijn PHP. De server van een app kan in elke taal zijn geschreven.
• Rechten: apps declareren in het manifest tot welke entiteiten zij toegang hebben; de handelaar bevestigt dat bij de installatie.
• Updates: apps actualiseren manifest en scripts via de Store, hun serverlogica onafhankelijk daarvan.

Een minimaal manifest.xml bevat metadata, rechten en de registratie-URL:

    
        MeineApp
        Meine App
        1.0.0
        solution25
    
    
        https://app.example.com/register
    
    
        order
        product
    
    
        
    

Andere bouwstenen zijn adminmodules (eigen pagina’s in het beheer via iframe), action buttons, payment-endpoints voor eigen betaalmethoden, custom fields, rule conditions, Flow Builder-acties, Storefront-templates en App Scripts.

Bij de installatie roept Shopware de registratie-URL van de app aan en wisselt secrets uit; de app ontvangt per webshop een eigen API-toegang. Daarna verloopt de communicatie in beide richtingen: Shopware stuurt webhooks bij gebeurtenissen, de app leest en schrijft via de Admin-API. Elk verzoek is ondertekend, zodat beide partijen de herkomst kunnen controleren. Shopware stelt voor de appzijde een PHP-SDK en een Symfony-bundle beschikbaar, die registratie, controle van handtekeningen en API-client voor hun rekening nemen.

• De extensie moet in de Shopware Store ook voor cloudklanten worden aangeboden.
• De logica leeft sowieso in een extern systeem, bijvoorbeeld een ERP, een betaalprovider of een AI-dienst.
• U wilt onafhankelijk van PHP-versies en Shopware-deployments uitleveren en bijwerken.
• Meerdere webshops moeten dezelfde dienst gebruiken, die centraal wordt beheerd.

Een plugin blijft de betere keuze wanneer logica diep ingrijpt in checkout, prijsberekening of datamodel, hoge performance vereist of er geen externe infrastructuur moet worden beheerd. Meer hierover op onze pagina over Shopware-pluginontwikkeling.

• Rechten minimaal houden: alleen de entiteiten opvragen die de app echt nodig heeft; handelaren zien de lijst bij de installatie.
• Webhooks idempotent verwerken: leveringen kunnen zich herhalen; gebruik eventId voor deduplicatie.
• Payload nalaaden: webhooks leveren alleen ID’s; haal de actuele status op via de Admin-API.
• Versiebeheer: manifestversie zorgvuldig bijhouden, breaking changes vermijden, migratiepaden documenteren.
• Beheer beveiligen: de appserver maakt deel uit van de webshop. Monitoring, back-ups en beschikbaarheid horen bij het aanbod.

App Script, Plugin, Extensie-SDK, Store-extensies en PaaS op Platform.sh. Alle begrippen in het Shopware woordenboek.