Skip to content

jeffsenso/prestashop-skills / skills/prestashop-module-development

prestashop-module-development

Verified

Complete PrestaShop module development workflow using modern architecture and best practices. Use when: creating new PrestaShop modules, updating legacy modules to modern code, implementing hooks and actions, setting up module configuration pages, adding front office features, handling database operations, implementing security measures, managing translations, creating cart rules and vouchers, building Symfony console commands, or modernizing existing PrestaShop modules from legacy patterns to current standards.

FileKindSize
CHANGELOG.mdmarkdown12.9 KB
README.mdmarkdown3.5 KB
SKILL.mdskill md21.7 KB
ps9-core-ai/CONTEXT.mdmarkdown6.4 KB
ps9-core-ai/Component/BackOfficeHelp/CONTEXT.mdmarkdown1.0 KB
ps9-core-ai/Component/Behat/CONTEXT.mdmarkdown7.7 KB
ps9-core-ai/Component/CQRS/CONTEXT.mdmarkdown6.8 KB
ps9-core-ai/Component/Configuration/CONTEXT.mdmarkdown1.5 KB
ps9-core-ai/Component/Console/CONTEXT.mdmarkdown1.1 KB
ps9-core-ai/Component/Context/CONTEXT.mdmarkdown1.8 KB
ps9-core-ai/Component/ContextStateManager/CONTEXT.mdmarkdown2.0 KB
ps9-core-ai/Component/Controller/CONTEXT.mdmarkdown4.7 KB
ps9-core-ai/Component/Cookie/CONTEXT.mdmarkdown1.3 KB
ps9-core-ai/Component/Database/CONTEXT.mdmarkdown1.4 KB
ps9-core-ai/Component/Export/CONTEXT.mdmarkdown964 B
ps9-core-ai/Component/FacetedSearch/CONTEXT.mdmarkdown1.3 KB
ps9-core-ai/Component/Forms/CONTEXT.mdmarkdown6.1 KB
ps9-core-ai/Component/Grid/CONTEXT.mdmarkdown5.2 KB
ps9-core-ai/Component/Hook/CONTEXT.mdmarkdown1.1 KB
ps9-core-ai/Component/Import/CONTEXT.mdmarkdown1.5 KB
ps9-core-ai/Component/Javascript/CONTEXT.mdmarkdown3.9 KB
ps9-core-ai/Component/Link/CONTEXT.mdmarkdown1.4 KB
ps9-core-ai/Component/Locale/CONTEXT.mdmarkdown1.7 KB
ps9-core-ai/Component/MailTemplate/CONTEXT.mdmarkdown1.5 KB
ps9-core-ai/Component/Migration/CONTEXT.mdmarkdown10.6 KB
ps9-core-ai/Component/Playwright/CONTEXT.mdmarkdown6.4 KB
ps9-core-ai/Component/PositionUpdater/CONTEXT.mdmarkdown1.4 KB
ps9-core-ai/Component/Router/CONTEXT.mdmarkdown1.7 KB
ps9-core-ai/Component/Smarty/CONTEXT.mdmarkdown1.7 KB
ps9-core-ai/Component/TinyMCE/CONTEXT.mdmarkdown1.4 KB
ps9-core-ai/Component/Twig/CONTEXT.mdmarkdown3.9 KB
ps9-core-ai/Domain/Address/CONTEXT.mdmarkdown1.6 KB
ps9-core-ai/Domain/Alias/CONTEXT.mdmarkdown1.3 KB
ps9-core-ai/Domain/ApiClient/CONTEXT.mdmarkdown1.9 KB
ps9-core-ai/Domain/Attachment/CONTEXT.mdmarkdown1.2 KB
ps9-core-ai/Domain/AttributeGroup/CONTEXT.mdmarkdown1.9 KB
ps9-core-ai/Domain/Carrier/CONTEXT.mdmarkdown1.8 KB
ps9-core-ai/Domain/Cart/CONTEXT.mdmarkdown2.1 KB
ps9-core-ai/Domain/CartRule/CONTEXT.mdmarkdown1.6 KB
ps9-core-ai/Domain/CatalogPriceRule/CONTEXT.mdmarkdown1.5 KB
ps9-core-ai/Domain/Category/CONTEXT.mdmarkdown1.8 KB
ps9-core-ai/Domain/CmsPage/CONTEXT.mdmarkdown1.5 KB
ps9-core-ai/Domain/CmsPageCategory/CONTEXT.mdmarkdown1.5 KB
ps9-core-ai/Domain/Combination/CONTEXT.mdmarkdown2.4 KB
ps9-core-ai/Domain/Configuration/CONTEXT.mdmarkdown1.5 KB
ps9-core-ai/Domain/Contact/CONTEXT.mdmarkdown1.2 KB
ps9-core-ai/Domain/Country/CONTEXT.mdmarkdown1.8 KB
ps9-core-ai/Domain/CreditSlip/CONTEXT.mdmarkdown1.4 KB
ps9-core-ai/Domain/Currency/CONTEXT.mdmarkdown1.9 KB
ps9-core-ai/Domain/Customer/CONTEXT.mdmarkdown2.0 KB
ps9-core-ai/Domain/CustomerMessage/CONTEXT.mdmarkdown1.5 KB
ps9-core-ai/Domain/CustomerService/CONTEXT.mdmarkdown2.3 KB
ps9-core-ai/Domain/Discount/CONTEXT.mdmarkdown2.4 KB
ps9-core-ai/Domain/Employee/CONTEXT.mdmarkdown2.3 KB
ps9-core-ai/Domain/Feature/CONTEXT.mdmarkdown1.6 KB
ps9-core-ai/Domain/Hook/CONTEXT.mdmarkdown1.1 KB
ps9-core-ai/Domain/ImageSettings/CONTEXT.mdmarkdown1.7 KB
ps9-core-ai/Domain/Language/CONTEXT.mdmarkdown1.7 KB
ps9-core-ai/Domain/MailTemplate/CONTEXT.mdmarkdown1.7 KB
ps9-core-ai/Domain/Manufacturer/CONTEXT.mdmarkdown1.5 KB
ps9-core-ai/Domain/Meta/CONTEXT.mdmarkdown1.9 KB
ps9-core-ai/Domain/Module/CONTEXT.mdmarkdown1.6 KB
ps9-core-ai/Domain/Notification/CONTEXT.mdmarkdown1.3 KB
ps9-core-ai/Domain/Order/CONTEXT.mdmarkdown2.6 KB
ps9-core-ai/Domain/OrderMessage/CONTEXT.mdmarkdown1.5 KB
ps9-core-ai/Domain/OrderReturn/CONTEXT.mdmarkdown1.5 KB
ps9-core-ai/Domain/OrderReturnState/CONTEXT.mdmarkdown1.6 KB
ps9-core-ai/Domain/OrderState/CONTEXT.mdmarkdown1.9 KB
ps9-core-ai/Domain/Position/CONTEXT.mdmarkdown996 B
ps9-core-ai/Domain/Product/CONTEXT.mdmarkdown2.7 KB
ps9-core-ai/Domain/Profile/CONTEXT.mdmarkdown1.7 KB
ps9-core-ai/Domain/Search/CONTEXT.mdmarkdown1.6 KB
ps9-core-ai/Domain/SearchEngine/CONTEXT.mdmarkdown1.5 KB
ps9-core-ai/Domain/Security/CONTEXT.mdmarkdown1.7 KB
ps9-core-ai/Domain/Shipment/CONTEXT.mdmarkdown1.8 KB
ps9-core-ai/Domain/Shop/CONTEXT.mdmarkdown2.0 KB
ps9-core-ai/Domain/ShowcaseCard/CONTEXT.mdmarkdown1.4 KB
ps9-core-ai/Domain/SqlManagement/CONTEXT.mdmarkdown1.6 KB
ps9-core-ai/Domain/State/CONTEXT.mdmarkdown1.7 KB
ps9-core-ai/Domain/Store/CONTEXT.mdmarkdown1.5 KB
ps9-core-ai/Domain/Supplier/CONTEXT.mdmarkdown2.1 KB
ps9-core-ai/Domain/Tab/CONTEXT.mdmarkdown1.5 KB
ps9-core-ai/Domain/Tag/CONTEXT.mdmarkdown1.4 KB
ps9-core-ai/Domain/Tax/CONTEXT.mdmarkdown1.6 KB
ps9-core-ai/Domain/TaxRulesGroup/CONTEXT.mdmarkdown1.7 KB
ps9-core-ai/Domain/Theme/CONTEXT.mdmarkdown1.7 KB
ps9-core-ai/Domain/Title/CONTEXT.mdmarkdown1.6 KB
ps9-core-ai/Domain/Webservice/CONTEXT.mdmarkdown1.9 KB
ps9-core-ai/Domain/Zone/CONTEXT.mdmarkdown1.3 KB
ps9-core-ai/GOTCHAS.mdmarkdown3.9 KB
ps9-core-ai/MULTISTORE.mdmarkdown3.1 KB
ps9-core-ai/STRUCTURE.mdmarkdown11.1 KB
ps9-core-ai/bin/generate-ai-index.shscript17.9 KB
ps9-core-ai/generated/cqrs.mdmarkdown16.1 KB
ps9-core-ai/generated/entities.mdmarkdown2.7 KB
ps9-core-ai/generated/hooks.mdmarkdown3.7 KB
ps9-core-ai/generated/routes.mdmarkdown88.8 KB
references/cart-rules.mdmarkdown8.9 KB
references/configuration-management.mdmarkdown11.9 KB
references/configuration-page.mdmarkdown11.0 KB
references/database-and-entities.mdmarkdown5.7 KB
references/debugging.mdmarkdown5.9 KB
references/entity-doctrine.mdmarkdown12.5 KB
references/forms.mdmarkdown8.5 KB
references/grid-system.mdmarkdown41.0 KB
references/hooks-and-front-office.mdmarkdown8.2 KB
references/legacy-conversion.mdmarkdown3.5 KB
references/module-class-and-installer.mdmarkdown13.7 KB
references/module-structure.mdmarkdown3.4 KB
references/security.mdmarkdown2.4 KB
references/services-and-di.mdmarkdown20.8 KB
references/services-split.mdmarkdown6.0 KB
references/theme-template-injection.mdmarkdown7.4 KB
references/translations.mdmarkdown8.6 KB
references/validation.mdmarkdown2.5 KB
scripts/grid.bundle.jsscript4.4 KB
scripts/translatable-form.bundle.jsscript9.8 KB

references/services-split.md

View on GitHub
# Services split & components architecture

## Services split: common.yml vs admin services.yml

PrestaShop is **not fully migrated** — front office runs a legacy light container, admin runs the full Symfony bundle kernel.

### How PrestaShop loads module service files

| File | Loaded by |
|------|----------|
| `config/services.yml` | **Admin** kernel only (via `PrestaShopBundle::build()`) |
| `config/admin/services.yml` | **Admin** kernel only, in addition to `config/services.yml` |
| `config/front/services.yml` | **Front-office** kernel only (via `Adapter\ContainerBuilder`) |

**`config/services.yml`** is an admin-kernel-only entry point loaded by `PrestaShopBundle::build()` via `LoadServicesFromModulesPass()` (no container name = empty = `config/services.yml`). It is **NOT** loaded by the front kernel.

**`config/front/services.yml`** is the front-kernel entry point, loaded by `Adapter\ContainerBuilder` via `LoadServicesFromModulesPass('front')`. It must import `../common.yml`. This is what makes repository services available in front-office hooks.

> ⚠️ **Front services must be in `config/front/services.yml`**, not `config/services.yml`. Putting repository services only in `config/services.yml` means the front kernel never sees them and `$this->get()` calls in `getWidgetVariables()` will silently return null.

**`config/common.yml`** — imported by both `config/front/services.yml` and `config/admin/services.yml`:
- Imports `components/repository/*.yml` only
- No inline service definitions
- No dependency on any `PrestaShop\` class

**`config/admin/services.yml`** — admin only, loaded in addition to `config/services.yml`:
- Imports `../common.yml` (self-contained; safe to re-import — Symfony deduplicates)
- Then imports all admin-only component globs
- Manager, grid factories, form types, controllers, any `PrestaShopBundle\` dep

> ⚠️ **Path trap**: in `config/admin/services.yml`, the path to common is `../common.yml` (not `common.yml`). Using `common.yml` resolves relative to `config/admin/` and fails with a FileLocator error.

**Rule**: A service goes in `common.yml` only if ALL its dependencies are Doctrine-level (not `PrestaShopBundle`). If any dependency is `@prestashop.*` or a `PrestaShopBundle\` class, it belongs in admin-only services.

## Components split (mandatory for all modules)

Always split admin services into component files under `config/components/`. Never put more than one concern in a single flat `services.yml`. Use this structure:

```
config/
  common.yml                              # imports: components/repository/*.yml only
  admin/
    services.yml                          # imports: common.yml + all components/* globs
  front/
    services.yml                          # imports: common.yml only
  components/
    index.php                             # PS security redirect
    repository/
      index.php
      repository.yml                      # Doctrine factory services only
    manager/
      index.php
      manager.yml                         # Manager class (PrestaShopBundle deps)
    form/
      index.php
      <feature>_form.yml                  # DataConfiguration, DataProvider, FormType, Handler
    grid/
      index.php
      <entity>_grid.yml                   # GridDefinitionFactory, QueryBuilder, DataFactory, GridFactory, PositionDefinition, twig.loader.filesystem
    controller/
      index.php
      controllers.yml                     # All FrameworkBundleAdminController services
```

**`config/services.yml`** pattern (admin kernel only, optional):
```yaml
# Admin kernel only — loaded by PrestaShopBundle in addition to config/admin/services.yml.
imports:
    - { resource: "common.yml" }
```

**`config/front/services.yml`** pattern (front kernel only, **required for front-office hooks**):
```yaml
# Front-office only — loaded by Adapter\ContainerBuilder (config/front/services.yml).
imports:
    - { resource: "../common.yml" }
```

**`config/common.yml`** pattern:
```yaml
# Loaded by both kernels (via config/front/services.yml and config/admin/services.yml) — Doctrine-only services.
imports:
    - { resource: "components/repository/*.yml" }
```

**`config/admin/services.yml`** pattern:
```yaml
# Admin-only — loaded by admin kernel IN ADDITION to config/services.yml.
# ../common.yml is re-imported for self-containment; Symfony deduplicates safely.
imports:
    - { resource: ../common.yml }        # ← must be ../common.yml, NOT common.yml
    - { resource: "../components/manager/*.yml" }
    - { resource: "../components/form/*.yml" }
    - { resource: "../components/grid/*.yml" }
    - { resource: "../components/controller/*.yml" }
```

**`config/components/repository/repository.yml`** pattern:
```yaml
# Front+Admin — repository services (no PrestaShopBundle dependencies).
# Only mark public: true on services accessed via $this->get() from the module class.
# All other services remain private (omit public:).
services:
    mymodule.repository.my_repository:
        class: Vendor\MyModule\Repository\MyRepository
        public: true                             # ← accessed via $this->get() in module class
```

> ⚠️ **`public: true` is required only for services accessed via `$this->get()`** from the module class or a controller. Declare it explicitly on each such service definition — avoid `_defaults: public: true` as a blanket default: it is against Symfony best practices (services should be private unless explicitly needed) and causes a fatal error in PrestaShop's Symfony version when combined with `parent:` services.

Rules:
- Each component `.yml` starts with a comment header naming the concern and kernel scope
- Every component folder must contain an `index.php` PS security redirect file
- Add a new sub-folder (never a new inline block) when a new concern is introduced
- `config/front/services.yml` imports only `common.yml` — never add admin-only services there
- **Never point `config/services.yml` at `admin/services.yml`** — doing so loads admin-only services (e.g. `PrestaShopBundle` controller decorators) into the front kernel and breaks container compilation silently
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall