Skip to content

jeffsenso/prestashop-skills / skills/prestashop-module-development/ps9-core-ai/Component/Controller/skills/create-controller-listing

create-controller-listing

Unverified

Create 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}Filters class as action argument — automatically resolved by the argument resolver
  • Build grid via the grid factory service, present it, render the index template
  • No manual SearchCriteria construction needed

Reference: TaxController::indexAction(), ManufacturerController::indexAction()

2. Search and reset

  • Search/filter: CommonController::searchGridAction saves 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 (see create-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 the GridDefinition

3. Delete action

#[AdminSecurity("is_granted('delete', request.get('_legacy_controller'))")]
public function deleteAction(int ${domain}Id): RedirectResponse
  • Dispatch Delete{Domain}Command via command bus
  • Catch {Domain}NotFoundException and CannotDelete{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}StatusCommand via 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
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: 196kUpdated Claude CodeCodexVerifiedInstall
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: 193kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 193kUpdated Claude CodeCodexVerifiedInstall
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: 193kUpdated Claude CodeCodexVerifiedInstall