jeffsenso/prestashop-skills / skills/prestashop-module-development/ps9-core-ai/Component/Controller/skills/create-admin-routing
create-admin-routing
VerifiedCreate the Symfony routing YAML file declaring all admin routes for the domain. Trigger: "create routing for {Domain}".
create-admin-routing
Instructions
- Create
src/PrestaShopBundle/Resources/config/routing/admin/{domain}.yml. - For each action in the controller (listing + form actions), declare a route. Always include
_legacy_controller(permanent — see below). While the page is under migration, also include_legacy_feature_flagso requests are dispatched to the new or legacy controller depending on the flag state:admin_{domain}s_index: path: /{domain}s methods: [GET] defaults: _controller: 'PrestaShopBundle:Admin/{Section}/{Domain}:index' _legacy_controller: Admin{Domain}s _legacy_feature_flag: {domain} - Include routes: index (GET), create (GET+POST), edit (GET+POST with
{id}parameter), delete (POST with{id}), toggle status (POST+JSON), bulk delete/enable/disable (POST). - Import this file from the main admin routing file.
- CRITICAL:
_legacy_feature_flagvalue must exactly match thenameof the feature flag in feature_flag.xml. - Verify with
php bin/console debug:router | grep {domain}.
_legacy_controller is permanent
Keep _legacy_controller on every route — it stays for the lifetime of the page, even after full migration. Two consumers depend on it:
- Permission checks: admin permission rules are keyed by the legacy controller name. Action security expressions like
is_granted('read', request.get('_legacy_controller'))rely on this attribute being present - Automatic legacy link conversion: third-party modules and old code paths still call
Link::getAdminLink('Admin{Domain}s'); the routing layer uses_legacy_controllerto resolve those calls to the Symfony route
Removing _legacy_controller after release would silently break permissions and any legacy Link::getAdminLink() callers — never strip it.
_legacy_feature_flag is migration-only
_legacy_feature_flag, in contrast, only exists while the new page coexists with the legacy one. Once the feature flag has been promoted to stable (GA) and the legacy controller is no longer used as a fallback, remove _legacy_feature_flag from the route — but keep _legacy_controller. Routes for fully-released pages have _legacy_controller and no _legacy_feature_flag.
This skill scaffolds routes for pages currently under migration. For routes added or refactored on already-released pages, omit _legacy_feature_flag and keep _legacy_controller.
Rules
Conventions (atomic commit, case-sensitive flag matching, toggle returning JSON, _legacy_controller permanence, post-release flag removal) are in Controller/CONTEXT.md. Skill-specific reminders:
- Edit and delete routes must include
{id}path parameter - Toggle status route must allow POST method
- Never strip
_legacy_controller— it remains required for permissions and legacy link conversion long after migration is over
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |