Instalación y configuración del módulo Kowal Outlet Products
- Paquete Composer:
kowal/module-outletproducts - Módulo Magento:
Kowal_OutletProducts - Tipo de aplicación requerido: Magento 2
- Dependencia del paquete:
kowal/base - Comando CLI del módulo:
bin/magento kowal_outletproducts:generate
Instalación mediante Composer
Añade el repositorio del módulo:
Recibirás por correo electrónico los datos de acceso al repositorio Composer, es decir, el correo electrónico del cliente y el token de licencia, después de la compra. También están disponibles en el panel de cliente tras iniciar sesión en kowal.store. Sustituye TWOJ_EMAIL_KLIENTA por la dirección de correo electrónico de tu cuenta y TWOJ_TOKEN por el token recibido. Ejecuta los comandos en el directorio raíz de Magento.
composer config repositories.kowal composer https://repo.kowal.store
Si el repositorio es privado, configura el token de acceso:
composer config http-basic.repo.kowal.store 'TWOJ_EMAIL_KLIENTA' 'TWOJ_TOKEN'
Instala el módulo:
composer require kowal/module-outletproducts
Activa el módulo:
php bin/magento module:enable Kowal_OutletProducts
Realiza la actualización de la base de datos:
php bin/magento setup:upgrade
En el entorno de producción, ejecuta la compilación DI y el deploy de recursos estáticos de acuerdo con el proceso de despliegue de la tienda:
php bin/magento setup:di:compilephp bin/magento setup:static-content:deploy
Limpia la cache:
php bin/magento cache:flush
Actualización de una instalación existente
Después de actualizar el módulo, ejecuta:
composer update kowal/module-outletproductsphp bin/magento setup:upgradephp bin/magento cache:flush
Si la tienda funciona en production mode, realiza también los pasos estándar de despliegue:
php bin/magento setup:di:compilephp bin/magento setup:static-content:deploy
setup:upgrade es obligatorio porque el módulo añade y actualiza atributos de producto utilizados para gestionar OUTLET y las copias de precios especiales.
Atributos de producto
El módulo añade o utiliza los siguientes atributos:
| Atributo | Significado |
|---|
sale | Marca el producto como OUTLET. |
special_price_copy | Copia del valor special_price anterior a la entrada del producto en OUTLET. |
special_from_date_copy | Copia de la fecha special_from_date. |
special_to_date_copy | Copia de la fecha special_to_date. |
special_price_copy_active | Marcador que informa de que se ha realizado la copia del precio especial. |
Configuración en el panel de administración
Ve a:
Stores > Configuration > kowal > OUTLET Products
Opciones disponibles:
| Opción | Descripción |
|---|
Włącz moduł Outlet | Activa o desactiva el funcionamiento del módulo. |
Usuń ceny specjalne dla produktów po wyprzedaży | Define si, tras finalizar OUTLET, debe eliminarse el precio especial. Si la opción está desactivada, el módulo restaurará el precio desde la copia. |
Kategorie outletowe | Lista de categorías a las que se asignan los productos OUTLET y de las que posteriormente se eliminan automáticamente. |
Wyłącz zarządzanie stanem magazynowym po wyprzedaży | Permite desactivar manage_stock tras finalizar la liquidación. |
Włącz backorder po zakończeniu wyprzedaży outletowej | Permite activar backorder y marcar el producto como disponible tras finalizar la venta outlet. |
La configuración está disponible a nivel default, website y store. Las categorías OUTLET utilizadas por cron se toman de la configuración predeterminada.
Configuración de categorías OUTLET
- Crea en Magento una o varias categorías destinadas al outlet.
- Asegúrate de que las categorías estén activas y sean visibles en el menú o en el listing si deben estar disponibles para los clientes.
- En la configuración del módulo, selecciona todas las categorías outlet en el campo
Kategorie outletowe. - Guarda la configuración.
- Limpia la cache de Magento.
php bin/magento cache:flush
Importación de productos a OUTLET
Ve al panel:
kowal > Upload Outlet Products
En el formulario:
- Pega la lista de SKU, un SKU por línea.
- Selecciona las categorías OUTLET.
- Opcionalmente, selecciona los website a los que debe asignarse el producto.
- Elige si el módulo debe activar la gestión de stock para los productos importados.
- Haz clic en
Importuj.
Ejemplo de lista de SKU:
TSHIRT-BLACK-MTSHIRT-BLACK-LJACKET-NAVY-XLSHOES-WHITE-42
Durante la importación, el módulo:
- asigna los productos a las categorías OUTLET,
- establece el atributo
sale, - actualiza los productos padre configurables,
- crea una copia del precio especial y de las fechas de promoción,
- actualiza el stock de acuerdo con la opción seleccionada,
- actualiza los índices y la cache de productos y categorías.
Gestión de productos configurables
Si el producto importado es una variante de un producto configurable, el módulo busca el producto padre y lo asigna a la categoría OUTLET. Gracias a ello, el producto configurable aparece en el listing de la categoría y el cliente puede elegir la variante outlet.
Durante el recálculo cíclico, el módulo comprueba si el producto padre sigue teniendo variantes OUTLET activas. Si no las tiene, el producto padre se desvincula de la categoría OUTLET.
Gestión de precios especiales
Al importar a OUTLET, el módulo guarda una copia de:
special_price,special_from_date,special_to_date.
La copia se guarda de acuerdo con el scope del atributo del precio especial en Magento:
- para precios globales: a nivel global,
- para precios per website: a nivel del store view predeterminado de cada website,
- para precios per store: a nivel de store view.
El módulo no recalcula divisas. Magento almacena los precios como valores base para el scope correspondiente, y la presentación de divisas en el frontend queda a cargo de los mecanismos estándar de Magento.
El comportamiento tras finalizar OUTLET depende de la opción Usuń ceny specjalne dla produktów po wyprzedaży:
Tak: el módulo limpia el precio especial y elimina la copia técnica,Nie: el módulo restaura el precio especial y las fechas desde la copia y, a continuación, elimina la copia técnica.
Cron
El módulo dispone de una tarea cron:
kowal_outletproducts_outlet
La tarea ejecuta el helper OUTLET y comprueba cíclicamente los productos outlet. Cron elimina productos de las categorías OUTLET cuando ya no deberían estar visibles allí, y actualiza los índices y la cache.
Después de la instalación, asegúrate de que el cron de Magento funcione correctamente:
php bin/magento cron:run
En el entorno de producción, cron debe ejecutarse desde el crontab del sistema del usuario de la aplicación Magento.
Ejecución manual del recálculo
El recálculo puede ejecutarse manualmente desde CLI:
php bin/magento kowal_outletproducts:generate
El comando ejecuta el mismo proceso que se inicia mediante cron.
Índices y cache
Tras los cambios, el módulo actualiza los índices de producto y catálogo más importantes:
catalog_product_price,catalog_product_category,catalogsearch_fulltext,inventory,cataloginventory_stock.
El módulo también limpia la cache de las etiquetas de productos y categorías OUTLET, por lo que el listing de la categoría debería actualizarse después de cambiar el estado o desvincular el producto.
Si es necesario, se puede forzar una reindexación completa:
php bin/magento indexer:reindexphp bin/magento cache:flush
Prueba después del despliegue
Prueba funcional recomendada:
- Selecciona un producto simple con stock disponible.
- Configúrale un precio especial y fechas de promoción.
- Añade el producto a OUTLET mediante el panel de importación.
- Comprueba si el producto ha aparecido en la categoría OUTLET.
- Comprueba si el atributo
sale tiene el valor Tak. - Para un producto configurable, comprueba si el producto padre ha aparecido en OUTLET.
- Cambia el estado del producto para que no sea salable.
- Ejecuta cron o el comando CLI.
- Comprueba si el producto se ha eliminado de la categoría OUTLET.
- Comprueba si el precio especial se ha restaurado o eliminado de acuerdo con la configuración.
Problemas más frecuentes
El producto sigue visible en OUTLET
Comprueba:
- si el cron de Magento funciona,
- si el producto todavía tiene
sale = 1, - si el producto está asignado a una de las categorías configuradas como OUTLET,
- si los índices y la cache se han actualizado.
Comandos de ayuda:
php bin/magento cron:runphp bin/magento indexer:reindexphp bin/magento cache:flush
El parent configurable sigue en OUTLET
Comprueba si alguna variante del producto todavía tiene sale = 1. El producto padre se mantiene en OUTLET mientras tenga una variante outlet activa.
El precio especial no se ha restaurado
Comprueba:
- si el producto se había añadido anteriormente a OUTLET después de la instalación de los atributos de copia,
- si el atributo
special_price_copy_active estaba configurado, - si la configuración
Usuń ceny specjalne dla produktów po wyprzedaży está establecida en Nie, - qué scope de precios está configurado en Magento.
Los precios difieren entre store view
Comprueba la configuración del scope de precios en Magento. El módulo no recalcula divisas ni sincroniza precios entre store view. Restaura los valores guardados para el scope de precios correspondiente.
Desinstalación
Si el módulo debe desactivarse:
php bin/magento module:disable Kowal_OutletProductsphp bin/magento setup:upgradephp bin/magento cache:flush
Eliminación del paquete Composer:
composer remove kowal/module-outletproductsphp bin/magento setup:upgradephp bin/magento cache:flush
Antes de eliminar el módulo, se recomienda comprobar si los productos requieren una limpieza manual del atributo sale o su desvinculación de la categoría OUTLET.
