init-grid-extensions

Read @.ai/Component/Javascript/CONTEXT.md for the grid component and extension system.

Basic pattern

In the listing entry point (index.ts):

const grid = new window.prestashop.component.Grid('{domain}');

grid.addExtension(new window.prestashop.component.GridExtensions.SortingExtension());
grid.addExtension(new window.prestashop.component.GridExtensions.FiltersResetExtension());
grid.addExtension(new window.prestashop.component.GridExtensions.SubmitRowActionExtension());
grid.addExtension(new window.prestashop.component.GridExtensions.SubmitBulkActionExtension());
grid.addExtension(new window.prestashop.component.GridExtensions.BulkActionCheckboxExtension());
grid.addExtension(new window.prestashop.component.GridExtensions.ColumnTogglingExtension());

The grid ID must match the GRID_ID const from the PHP grid definition factory.

Available extensions

Core extensions (most grids need these)

Specialized extensions (add only when needed)

Domain-specific extensions

Some domains have custom extensions in subdirectories:

• column/catalog/ — catalog-specific column extensions
• action/row/ — domain-specific row action extensions (e.g. customer delete with order check)

Check admin-dev/themes/new-theme/js/components/grid/extension/ for the full list.

Multiple grids on one page

For pages with multiple grids (e.g. Manufacturer with manufacturers + addresses):

const manufacturerGrid = new window.prestashop.component.Grid('manufacturer');
manufacturerGrid.addExtension(new SortingExtension());
// ...

const addressGrid = new window.prestashop.component.Grid('manufacturer_address');
addressGrid.addExtension(new SortingExtension());
// ...

Each grid instance gets its own set of extensions.

Rules

Conventions (multiple Grid instances pattern) are in Javascript/CONTEXT.md. Skill-specific reminders:

• Grid ID must match the PHP GRID_ID constant — mismatch means extensions don't bind
• Only add extensions that match the grid definition — don't add PositionExtension without a PositionColumn
• AsyncToggleColumnExtension requires a matching AJAX toggle route in the controller