Create Position Column
Developmentcreate-position-columnCreate 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.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
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
- Add
PositionColumnas the second column (after BulkActionColumn) in the Grid Definition. - Configure the position update route:
->setOption('update_method', 'POST')->setOption('update_route', 'admin_{domain}s_update_position'). - Add a
ReorderPositionsButtonTypefilter associated with the position column (see Rules below) — mandatory, not optional. - Create the
admin_{domain}s_update_positionPOST route in the routing YAML (seecreate-admin-routingskill). - In the controller, handle the AJAX position update: receive
positions[]array, dispatchUpdatePosition{Domain}Command(or use QueryBuilder directly). - In the repository, update the
positioncolumn 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
ReorderPositionsButtonTypefilter. 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