¿Campos de producto personalizados sin overrides?

miriam_store

Hola a todos,

Estoy intentando añadir un par de campos personalizados a mis productos en PrestaShop 1.7.6.6 para uso interno (cosas como un número de serie interno y una fecha de caducidad). La idea es que estos campos sean solo para gestión nuestra y no visibles para el cliente.

He intentado extender la clase Product.php y añadir estos campos como propiedades, pensando que sería suficiente para que se guardaran en la base de datos, pero no consigo que funcionen correctamente en el Back Office. Los campos aparecen en la base de datos después de la modificación y vaciado de caché, pero no se muestran en el formulario de edición de producto en el BO, y por supuesto, no puedo guardar los datos desde ahí.

Este es mi intento actual en override/classes/Product.php:

class Product extends ProductCore
{
    public $internal_serial;
    public $expiry_date;
    public function __construct($id = null, $id_lang = null, $id_shop = null, Context $context = null)
    {
        self::$definition['fields']['internal_serial'] = [
            'type' => self::TYPE_STRING,
            'validate' => 'isGenericName',
            'size' => 64,

¿Alguien tiene alguna idea de cómo puedo hacer esto de una manera más limpia y que no me rompa el sitio con cada pequeña actualización?

felix_tech

Hola @miriam_store, ese es un problema clásico cuando se intenta extender el Product.php directamente. Tu override está bien para la parte del ObjectModel y la base de datos, pero el Back Office de PrestaShop 1.7 no es tan 'mágico'. No hay un mecanismo automático para que los campos que añades en self::$definition['fields'] aparezcan en el formulario de edición de productos.

Para que esos campos sean editables y visibles en el panel de administración, necesitas modificar el controlador AdminProductsController o, mejor dicho, engancharte a los hooks que ese controlador expone para añadir campos a su formulario. El BO de PS 1.7, especialmente la página de producto, usa componentes de Symfony para construir sus formularios, y tu override de Product.php no interactúa con eso.

¿Confirmas que estás en PrestaShop 1.7.6.6? Esto es importante porque las versiones posteriores de PS 1.7 y sobre todo PS 8/9 han ido cambiando la forma de construir esos formularios.

sara_madrid

Exacto, @felix_tech lo ha explicado muy bien. La definición del ObjectModel es solo una parte. Para que el Back Office se entere de esos campos y te permita interactuar con ellos, tendrías que engancharte al hookActionProductFormBuilderModifier para inyectar los campos en el formulario Symfony que se usa en la página del producto, y luego a hookActionProductUpdate y hookActionProductAdd para asegurarte de que los datos se guarden correctamente cuando el producto se actualiza o se crea.

Intentar hacer todo eso con overrides es un infierno. Siempre digo que para cualquier cosa que implique el Back Office, si no es una solución de un módulo bien diseñado, terminarás peleando con los overrides y los hooks cada vez que actualices PrestaShop o instales un módulo que también toque el controlador de productos. Me pasó a mí con unos campos de SEO extra y acabé desistiendo de la vía manual.

Milo

Hola @miriam_store, los compañeros @felix_tech y @sara_madrid han dado en el clavo. Tu override de Product.php es correcto para extender el ObjectModel y la definición de la base de datos, pero como bien indican, el Back Office no lo reconoce automáticamente. Para que PrestaShop muestre los campos y los guarde, necesitarías un módulo que se enganche a los hooks adecuados en el AdminProductsController.

En PrestaShop 1.7.6.6 (y versiones similares de PS 1.7), necesitarías un módulo que implemente:

hookActionProductFormBuilderModifier para añadir los campos al formulario del producto, utilizando los tipos de formulario de Symfony.
hookActionProductUpdate y hookActionProductAdd para guardar y cargar los datos de esos campos desde la base de datos cuando se edita o crea un producto.

Intentar hacer esto manualmente con overrides directos de controladores es propenso a errores y muy difícil de mantener con las actualizaciones. Si realmente quieres hacerlo a mano, aquí tienes un ejemplo muy simplificado de cómo se vería la adición de un campo en un FormBuilder dentro de un módulo:

use Symfony\Component\Form\Extension\Core\Type\TextType;
use Symfony\Component\Form\Extension\Core\Type\DateType;
// Este código iría dentro de un método hookActionProductFormBuilderModifier de tu módulo
public function hookActionProductFormBuilderModifier(array $params)
{
    /** @var \Symfony\Component\Form\FormBuilder $formBuilder */
    $formBuilder = $params['form_builder'];
    $data = $params['data']; // Datos actuales del formulario
    $formBuilder->add('internal_serial', TextType::class, [
        'label' => $this->trans('Número de serie interno', [], 'Modules.MyModule.Admin'),

Luego, necesitarías el hookActionProductUpdate y hookActionProductAdd para manejar el guardado de internal_serial y expiry_date en tu tabla _product extendida. Sin embargo, para una solución más robusta y que no tengas que mantener manualmente, te recomiendo usar esta solución probada. Este tipo de módulos se encargan de toda la lógica de los hooks, la integración en el formulario y la persistencia de datos de forma segura.

miriam_store

Muchas gracias a todos, especialmente a @Milo por la explicación detallada y el ejemplo de código. Tenía la intuición de que necesitaba más que solo el override del Product.php, pero no sabía exactamente dónde engancharme en el Back Office con la complejidad de Symfony en PrestaShop 1.7.

Después de revisar el módulo que mencionaste, decidí implementarlo y funciona perfectamente. Ahora tengo mis campos personalizados en el Back Office y se guardan sin problemas, ¡y sin miedo a futuras actualizaciones del core o conflictos con otros módulos! Un alivio no tener que mantener todo esto a mano. Problema resuelto.