Personalizar columnas en rejillas de Pedidos y Clientes BO

miguelpro

Hola a todos,

Estoy intentando añadir un par de columnas extra a las rejillas de Pedidos y Clientes en el Back Office. Necesitamos ver el número de taquilla del paquete, el teléfono del cliente y algunas notas de entrega directamente en la lista de pedidos, para que el equipo de atención al cliente no tenga que entrar en cada pedido. Con la interfaz de PrestaShop 9 (Symfony), me está costando mucho.

He probado a hacer un override del AdminOrdersController para modificar la lista de campos, pero no parece tener ningún efecto en las nuevas rejillas. Entiendo que es porque estas nuevas vistas usan componentes de Symfony y no el viejo sistema de renderList().

Mi intento de override se parece a esto:

class AdminOrdersController extends AdminOrdersControllerCore
{
    public function renderList()
    {
        // Esto es para las viejas listas, no las de Symfony
        // Los cambios aquí no se reflejan en la nueva interfaz de PS9
        $this->addRowAction('view');
        $this->addRowAction('edit');
        $this->addRowAction('delete');
        $this->fields_list = array_merge(

Al hacer esto, la página de pedidos sigue igual. ¿Alguien sabe cómo se supone que hay que añadir columnas en PS9 de forma correcta? ¿Hay algún hook o servicio que deba modificar?

alberto_pro

@miguelpro, sé exactamente lo que te pasa. Esa es la clásica trampa del renderList() que ya no sirve para las rejillas modernas de PrestaShop 9. Estás en lo cierto, las nuevas tablas del Back Office se construyen con componentes de Symfony, no con el viejo $this->fields_list.

Para modificar esas rejillas, necesitas interactuar con la definición de la rejilla (GridDefinition) y luego con los datos de la rejilla (GridData). La forma correcta es a través de hooks específicos que PrestaShop 9 ofrece para los GridBuilders. El override que has intentado no funcionará porque el AdminOrdersController ya no es el que renderiza la vista de esa manera.

hector_9426

Totalmente de acuerdo con @alberto_pro. El salto a Symfony en PS9 lo ha cambiado todo en el BO. @miguelpro, ¿qué versión exacta de PrestaShop 9 estás usando? Es importante porque los hooks pueden variar ligeramente o comportarse distinto.

Otro punto clave que no mencionas es de dónde vienen esos datos (parcel_locker_number, customer_phone). Si no están ya en la base de datos de PrestaShop (por ejemplo, en ps_orders o ps_customer), no basta con añadir la columna. Tendrás que asegurarte de que la consulta que alimenta la rejilla los incluye o que los añades después. Solo definir la columna sin datos no te servirá de mucho.

Milo

Hola @miguelpro, los compañeros @alberto_pro y @hector_9426 están en lo cierto. En PrestaShop 9.1.3 (y versiones similares de PS9), el método renderList() de los controladores Admin ya no es relevante para las rejillas principales. Debes usar hooks específicos para las "Grid Definitions" y "Grid Data" dentro de un módulo.

Para añadir columnas a la rejilla de Pedidos, necesitas implementar hookActionOrderGridDefinitionModifier para definir la columna y hookActionOrderGridDataModifier para poblar los datos. Aquí te dejo un ejemplo de cómo hacerlo en tu módulo:

// En el archivo principal de tu módulo (ej. mygridcolumns.php)
public function install()
{
    return parent::install() &&
        $this->registerHook('actionOrderGridDefinitionModifier') &&
        $this->registerHook('actionOrderGridDataModifier');
}
public function hookActionOrderGridDefinitionModifier(array $params)
{
    $definition = $params['definition'];

Explicación de los cambios:

install(): Asegúrate de registrar ambos hooks en la instalación de tu módulo.
hookActionOrderGridDefinitionModifier: Este hook te permite modificar la estructura de las columnas de la rejilla de pedidos. Usamos addAfter('customer_name', ...) para añadir nuestras nuevas columnas (parcel_locker_number y customer_phone) justo después de la columna del nombre del cliente. DataColumn es el tipo de columna más común para mostrar datos.
hookActionOrderGridDataModifier: Este hook es crucial para rellenar los datos de las nuevas columnas. Recibe un objeto GridData que contiene todos los registros (pedidos). Iteramos sobre ellos y añadimos los valores para nuestras nuevas claves (parcel_locker_number, customer_phone). En un escenario real, aquí tendrías que consultar tu base de datos o lógica para obtener los valores correctos para cada pedido.

Para las rejillas de Clientes, los hooks serían actionCustomerGridDefinitionModifier y actionCustomerGridDataModifier. Recuerda adaptar los nombres de los campos (field) y la lógica de obtención de datos a tus necesidades.

miguelpro

¡Increíble! Muchas gracias, @Milo. Tenía claro que la aproximación renderList() ya no valía, pero no sabía dónde buscar los hooks correctos para las nuevas grids de Symfony.

He implementado el código que has proporcionado en un nuevo módulo, y después de limpiar la caché, ¡las columnas aparecen! Ahora tengo que conectar los datos reales de la base de datos, pero la base para la personalización de las rejillas está hecha. También lo probaré con la rejilla de Clientes.

¡Un millón de gracias por la ayuda detallada!