# Shopware6 > This skill should be used when the user asks to "create a Shopware plugin", "add a subscriber in Shopware", "create a custom entity in Shopware", "build an admin module for Shopware", "override a Storefront template", "write a DAL migration", "add custom fields in Shopware", "decorate a Shopware service", "extend the Shopware admin", "create a Shopware theme", "write Shopware API endpoint", "impl… - **Type:** Skill - **Install:** `agentstack add skill-dpaguba-shopware-skill-shopware6` - **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior - **Seller:** [dpaguba](https://agentstack.voostack.com/s/dpaguba) - **Installs:** 0 - **Category:** [Databases](https://agentstack.voostack.com/c/databases) - **Latest version:** 0.1.0 - **License:** MIT - **Upstream author:** [dpaguba](https://github.com/dpaguba) - **Source:** https://github.com/dpaguba/shopware-skill/tree/main/skills/shopware6 ## Install ```sh agentstack add skill-dpaguba-shopware-skill-shopware6 ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About # Shopware 6 Development ## Core Architecture Shopware 6 is a PHP/Symfony platform. Clarify which layer is being targeted before generating code: | Layer | Tech | Where | |---|---|---| | **Core / PHP** | PHP 8.2+, Symfony 6.4 (SW 6.5) / Symfony 7 (SW 6.6+) | `src/` — Services, DAL, Events | | **Storefront** | Twig 3, SCSS, Vanilla JS | `src/Resources/views/storefront/` | | **Admin** | Vue 3, Shopware Admin API | `src/Resources/app/administration/` | | **App System** | manifest.xml, App Scripts | External server or Twig scripts (no PHP needed) | **Plugin vs App System:** Use Plugin for self-hosted installs needing direct PHP/DB access. Use App System for SaaS/multi-tenant or when targeting the Shopware Store. --- ## Plugin Structure ``` PluginName/ ├── composer.json ├── src/ │ ├── PluginName.php # Bootstrap class │ ├── Resources/ │ │ ├── config/ │ │ │ └── services.xml # Symfony DI container │ │ ├── views/ │ │ │ └── storefront/ # Twig template overrides │ │ └── app/ │ │ └── administration/ # Vue.js admin extensions │ └── Migration/ # Database migrations └── tests/ ``` ### Plugin Bootstrap ```php ``` Common tags: `kernel.event_subscriber`, `twig.extension`, `console.command`, `messenger.message_handler`, `shopware.entity.definition`, `shopware.entity.extension`, `shopware.rule.definition`, `shopware.payment.method.sync`, `shopware.payment.method.async`, `shopware.cms.element`. ### 2. Listen to Events (Subscriber) ```php class ProductSubscriber implements EventSubscriberInterface { public static function getSubscribedEvents(): array { return ['product.written' => 'onProductWritten']; } public function onProductWritten(EntityWrittenEvent $event): void { foreach ($event->getWriteResults() as $result) { $id = $result->getPrimaryKey(); } } } ``` ### 3. DAL Read & Write ```php // Read $criteria = new Criteria(); $criteria->addFilter(new EqualsFilter('active', true)); $criteria->addAssociation('manufacturer'); $result = $this->productRepository->search($criteria, $context); // Write $this->productRepository->upsert([ ['id' => $id, 'name' => 'New Name'], ], $context); ``` ### 4. Override a Storefront Template ```twig {# Mirrors original path under views/storefront/ #} {% sw_extends '@Storefront/storefront/page/product-detail/index.html.twig' %} {% block page_product_detail_content %} Custom content {{ parent() }} {% endblock %} ``` ### 5. Decorate a Service ```xml ``` --- ## Karpathy Principles — Clarify Before Coding Surface these assumptions before generating code: - **Version?** SW 6.5 vs 6.6 (API and Vue component differences exist) - **Plugin or App System?** Plugin = PHP server; App = manifest.xml + external/no server - **Layer?** PHP/Core, Storefront, Admin, or headless/Store API - **Read or write?** Repository `search()` vs `upsert()`/`create()`/`update()` - **Entity or extension?** New table vs extending existing entity Write only the minimum code that solves the problem. Shopware's DI and event system handle most complexity. --- ## DAL Quick Reference ```php // Criteria $criteria->addFilter(new EqualsFilter('active', true)); $criteria->addFilter(new ContainsFilter('name', 'shirt')); $criteria->addFilter(new RangeFilter('price', [RangeFilter::GTE => 10])); $criteria->addAssociation('manufacturer'); $criteria->addSorting(new FieldSorting('name', FieldSorting::ASCENDING)); $criteria->setLimit(25)->setOffset(0); // Context $context = Context::createDefaultContext(); // system // OR inject SalesChannelContext from route / event // IDs only (faster, no hydration) $ids = $this->repo->searchIds($criteria, $context)->getIds(); ``` --- ## Admin Vue.js Quick Reference ```js // Register module Shopware.Module.register('my-module', { type: 'plugin', routes: { index: { component: 'my-module-index', path: 'index' } }, navigation: [{ label: 'my-module.title', path: 'my.module.index', icon: 'default-shopping-paper-bag' }], }); // Override existing component Shopware.Component.override('sw-product-detail', { methods: { async saveProduct() { await this.$super('saveProduct'); // call original }, }, }); ``` --- ## CLI Commands ```bash bin/console plugin:install --activate PluginName bin/console database:migrate --all PluginName bin/console cache:clear bin/console plugin:refresh bin/build-administration.sh bin/build-storefront.sh bin/console theme:compile php vendor/bin/phpunit --testsuite=unit vendor/bin/phpstan analyse src --level=8 ``` --- ## Additional Resources ### Reference Files Load these when working on specific areas: - **[references/dal.md](references/dal.md)** — DAL: EntityDefinition, Criteria, Aggregations, custom fields, **Entity Extensions** (extend core entities) - **[references/admin.md](references/admin.md)** — Admin: Vue modules, components, overrides, **naming conventions**, **ACL privileges**, **filter/inline edit**, search config - **[references/storefront.md](references/storefront.md)** — Storefront: Twig inheritance, SCSS/theme variables, JavaScript plugins, controllers - **[references/themes.md](references/themes.md)** — Themes: **theme.json** (config fields, colors, fonts, media), SCSS Bootstrap overrides, **theme inheritance**, ThemeInterface, CLI commands - **[references/cart.md](references/cart.md)** — Cart: **CartDataCollector**, **CartProcessor**, **CartValidator** + custom errors, **discount line items**, price manipulation, Tax Provider - **[references/seo-mail.md](references/seo-mail.md)** — SEO: **SeoUrlRoute**, sitemap URL provider; Mail: **custom mail templates** (migration + send); **Documents** (custom PDF types); **Order State Machine** (transitions, events) - **[references/plugin-structure.md](references/plugin-structure.md)** — Full plugin anatomy: services.xml, lifecycle hooks, composer.json, console commands, scheduled tasks - **[references/api.md](references/api.md)** — Admin API & Store API: CRUD, bulk, filters; **context token lifecycle**, **Cart/Checkout/Account Store API**, TypeScript client pattern - **[references/testing.md](references/testing.md)** — PHPUnit unit/integration, **StaticEntityRepository**, **ProductBuilder**, Jest, Cypress, assertSame vs assertEquals - **[references/app-system.md](references/app-system.md)** — App System: **manifest.xml**, **webhook HMAC verification**, **registration handshake**, **App Scripts** (Twig-based, no server) - **[references/security.md](references/security.md)** — Security: route scopes, **CSRF protection**, input validation, authorization by customer, SQL injection prevention - **[references/integrations.md](references/integrations.md)** — Integrations: **Payment Handler** (sync/async), Shipping Method, **CMS Elements**, **Rule Builder** conditions, Flow Builder events - **[references/performance.md](references/performance.md)** — Performance: **HTTP Cache** (tags, invalidation), **Message Queue** (async processing), **Elasticsearch/OpenSearch**, object cache - **[references/devops.md](references/devops.md)** — DevOps: **structured logging**, PHPStan, php-cs-fixer, CI/CD, deployment, debugging, **media handling**, upgrade safety - **[references/advanced.md](references/advanced.md)** — Advanced: **PHP Attributes entities** (SW 6.6.3+), **Flysystem** (public/private file storage), **Redis** (cache/queue), **Rate Limiter** (compiler pass + RateLimiter service), **Data Indexer**, **Field Inheritance** (variants), **In-App Purchases** ### Examples Working code examples in `examples/`: - **[examples/custom-entity/](examples/custom-entity/)** — Complete custom entity plugin (Definition, Entity, Repository, Migration) - **[examples/storefront-subscriber/](examples/storefront-subscriber/)** — Storefront page loaded subscriber with template variable injection ## Source & license This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code. - **Author:** [dpaguba](https://github.com/dpaguba) - **Source:** [dpaguba/shopware-skill](https://github.com/dpaguba/shopware-skill) - **License:** MIT Install and usage instructions live in the source repository linked above. ## Pricing - **Free** — Free ## Security capabilities Automated source analysis of v0.1.0 — what this tool can access: - **Network access:** no - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** no - **Dynamic code execution:** no *"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** — security scan: passed — Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/skill-dpaguba-shopware-skill-shopware6 - Seller: https://agentstack.voostack.com/s/dpaguba - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.