jeffsenso/prestashop-skills / skills/prestashop-module-development/ps9-core-ai/Component/Controller/skills/create-controller-listing
create-controller-listing
UnverifiedCreate the listing page actions in the admin controller: index (grid with filters), delete, toggle status, and any bulk actions the entity requires. Trigger: "create listing for {Domain}", "create index action for {Domain}".
create-controller-listing
Read @.ai/Component/Controller/CONTEXT.md for controller conventions (base class, DI, security attributes, error mapping).
Read @.ai/Component/Grid/CONTEXT.md for grid patterns (definition factory, query builder, filters).
1. Index action
#[AdminSecurity("is_granted('read', request.get('_legacy_controller'))")]
public function indexAction({Domain}Filters $filters): Response
- Use the
{Domain}Filtersclass as action argument — automatically resolved by the argument resolver - Build grid via the grid factory service, present it, render the index template
- No manual
SearchCriteriaconstruction needed
Reference: TaxController::indexAction(), ManufacturerController::indexAction()
2. Search and reset
- Search/filter:
CommonController::searchGridActionsaves and applies grid filters, then redirects back to the domain's index action. A domain-specific route must be defined pointing to this generic controller action (seecreate-admin-routing) - Filter reset: uses the generic route
admin_common_reset_search_by_filter_id— no domain-specific route or controller code needed. Referenced from theGridDefinition
3. Delete action
#[AdminSecurity("is_granted('delete', request.get('_legacy_controller'))")]
public function deleteAction(int ${domain}Id): RedirectResponse
- Dispatch
Delete{Domain}Commandvia command bus - Catch
{Domain}NotFoundExceptionandCannotDelete{Domain}Exception - Flash appropriate message, redirect to index
4. Toggle status action
#[AdminSecurity("is_granted('update', request.get('_legacy_controller'))")]
public function toggleStatusAction(int ${domain}Id): JsonResponse
- Dispatch
Toggle{Domain}StatusCommandvia command bus - Return
JsonResponse(AJAX grid toggle switch)
5. Bulk actions
Create one method per bulk action the grid defines — not all entities have the same set:
#[AdminSecurity("is_granted('delete', request.get('_legacy_controller'))")]
public function bulkDeleteAction(Request $request): RedirectResponse
Common pattern for all bulk actions:
- Extract selected IDs from request
- If empty selection, return early with info flash
- Dispatch the appropriate bulk command
- Catch bulk exceptions, flash with failed IDs (see Controller/CONTEXT.md)
- Redirect to index
Rules
See Controller/CONTEXT.md for all conventions (Filters argument, bulk exception handling, toggle JSON). Skill-specific reminder:
- Bulk actions match the grid definition — don't assume delete/enable/disable are always present
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: 196k | 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: 193k | 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: 193k | 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: 193k | Updated | Claude CodeCodex | Verified | Install |