Back to Top

Adding a new column in PrestaShop new Symfony admin controller grid page with module

Updated 11 October 2019

Prestashop 1.7.x.x now have a new admin controller page on Symfony architecture where now listing is displayed with PrestaShop grid component.

So if we need to add any new column in the list using the module we need to follow not new hooks provided, there are two hooks mainly,

‘actionCustomerGridDefinitionModifier’ to add a new column

‘actionCustomerGridQueryBuilderModifier’ to provide data to the column

In my example, I am adding a normal text type display column on the customer controller,

Start your headless eCommerce
Find out More

For this, we need to use these namespaces

use PrestaShop\PrestaShop\Core\Grid\Column\Type\DataColumn;
use PrestaShop\PrestaShop\Core\Grid\Filter\Filter;
use Symfony\Component\Form\Extension\Core\Type\TextType;

And in the hook function, this is the example code,

public function hookActionCustomerGridDefinitionModifier(array $params)
    /** @var GridDefinitionInterface $definition */
    $definition = $params['definition'];

            (new DataColumn('mobile'))
                ->setName($this->l('Mobile number'))
                    'field' => 'mobile',

    // For search filter
        (new Filter('mobile', TextType::class))

the above code looks simple and understandable ­čÖé

     * Hook allows to modify Customers query builder and add custom sql statements.
     * @param array $params
    public function hookActionCustomerGridQueryBuilderModifier(array $params)
        /** @var QueryBuilder $searchQueryBuilder */
        $searchQueryBuilder = $params['search_query_builder'];

        /** @var CustomerFilters $searchCriteria */
        $searchCriteria = $params['search_criteria'];

            'IF(wcm.`mobile` IS NULL,0,wcm.`mobile`) AS `mobile`'

            '`' . pSQL(_DB_PREFIX_) . 'wk_customer_mobile`',
            'wcm.`id_customer` = c.`id_customer`'

        if ('mobile' === $searchCriteria->getOrderBy()) {
            $searchQueryBuilder->orderBy('wcm.`mobile`', $searchCriteria->getOrderWay());

        foreach ($searchCriteria->getFilters() as $filterName => $filterValue) {
            if ('mobile' === $filterName) {
                $searchQueryBuilder->andWhere('wcm.`mobile` = :mobile');
                $searchQueryBuilder->setParameter('mobile', $filterValue);

                if (!$filterValue) {
                    $searchQueryBuilder->orWhere('wcm.`mobile` IS NULL');

This code is providing the actionCustomerGridDefinitionModifier hook a custom data of customer entity.

Now you can see your column here like this,


PrestaShop also provided multiple column types, you can refer to this and use accordingly.

See this blog if you want to create your custom column type.

. . .

Leave a Comment

Your email address will not be published. Required fields are marked*


  • Niko
    • Dheeraj Sharma (Moderator)
  • Gaurav Negi
    • Dheeraj Sharma (Moderator)
  • langziyang
    • Dheeraj Sharma
  • Back to Top

    Message Sent!

    If you have more details or questions, you can reply to the received confirmation email.

    Back to Home