OpenParable
Skip to content
← Back to skills

Create Position Column

Development
create-position-column

Create Position Column is an Agent Skill for development published in the PrestaShop/PrestaShop repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Documents how to add drag-and-drop row reordering to a PrestaShop grid. Requires a PositionColumn in the definition, a ReorderPositionsButtonType filter, a dedicated update-position route, and position handling in the repository.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/PrestaShop/PrestaShop/blob/HEAD/.ai/Component/Grid/skills/create-position-column/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/create-position-column, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

create-position-column

Canonical reference: FeatureValueGridDefinitionFactory.

Instructions

  1. Add PositionColumn as the second column (after BulkActionColumn) in the Grid Definition.
  2. Configure the position update route: ->setOption('update_method', 'POST')->setOption('update_route', 'admin_{domain}s_update_position').
  3. Add a ReorderPositionsButtonType filter associated with the position column (see Rules below) — mandatory, not optional.
  4. Create the admin_{domain}s_update_position POST route in the routing YAML (see create-admin-routing skill).
  5. In the controller, handle the AJAX position update: receive positions[] array, dispatch UpdatePosition{Domain}Command (or use QueryBuilder directly).
  6. In the repository, update the position column for the moved entities.

Rules

Column ordering conventions (PositionColumn as second column) are in Grid/CONTEXT.md. Skill-specific reminders:

  • Always pair the PositionColumn with a ReorderPositionsButtonType filter. It renders a "Rearrange" button (js-btn-reorder-positions) that toggles inline drag-and-drop mode — dramatically better UX than a numeric position search field. Use:

    use PrestaShopBundle\Form\Admin\Type\ReorderPositionsButtonType;
    
    ->add((new Filter('position', ReorderPositionsButtonType::class))
        ->setAssociatedColumn('position')
    );
    
  • Position updates are always AJAX — return JSON response, not redirect

  • Position values start at 0 or 1 — be consistent with existing PS convention