actionAddProduct

#Descripcion

Se ejecuta cuando un producto es añadido al carrito de compras. Este hook se dispara cada vez que un cliente agrega un articulo, permitiendo interceptar la accion para registrar analiticas, aplicar reglas de negocio personalizadas o sincronizar el carrito con sistemas externos. Se dispara tanto al añadir un nuevo producto como al incrementar la cantidad de uno existente.

#Parametros

#Ejemplo de codigo

<?php
public function install()
{
    return parent::install()
        && $this->registerHook('actionAddProduct');
}

<?php
/**
 * Hook actionAddProduct — producto añadido al carrito
 */
public function hookActionAddProduct(array $params)
{
    /** @var Cart $cart */
    $cart = $params['cart'];
    /** @var Product $product */
    $product = $params['product'];
    $quantity = (int) $params['quantity'];
    $idAttribute = (int) $params['id_product_attribute'];

    // Ejemplo: Registrar evento para analiticas
    Db::getInstance()->insert('mymodule_cart_events', [
        'id_cart'     => (int) $cart->id,
        'id_product'  => (int) $product->id,
        'id_product_attribute' => $idAttribute,
        'quantity'    => $quantity,
        'operator'    => pSQL($params['operator']),
        'id_customer' => (int) $cart->id_customer,
        'date_add'    => date('Y-m-d H:i:s'),
    ]);

    // Ejemplo: Añadir producto regalo si se cumple condicion
    if ($product->id == Configuration::get('MYMODULE_TRIGGER_PRODUCT')) {
        $giftId = (int) Configuration::get('MYMODULE_GIFT_PRODUCT');
        if ($giftId && !$cart->containsProduct($giftId)) {
            $cart->updateQty(1, $giftId, null, false, 'up');
        }
    }
}

#Notas y gotchas

• ⚠️ El parametro `operator` puede ser 'up' (añadir) o 'down' (reducir). Ten cuidado de verificarlo antes de actuar.
• ⚠️ Este hook se dispara ANTES de que el carrito sea guardado en BD — si necesitas el carrito ya persistido, usa `actionCartSave`.
• ⚠️ No confundir con `actionBeforeCartUpdateQty`, que se ejecuta antes de la actualizacion real de cantidad.
• ⚠️ El objeto Product puede no tener precio especifico cargado — usa `Product::getPriceStatic()` si necesitas el precio real.
• ⚠️ En contexto de API/webservice, este hook puede no dispararse si el carrito se modifica directamente.

#Relacionados

#Historial de versiones