Saltar al contenido principal

Gaia_SalesRule

Descripción General​

El módulo Gaia_SalesRule extiende y personaliza la funcionalidad de reglas de venta y cupones en Magento 2. Proporciona validación personalizada de cupones, gestión avanzada de reglas de promoción y personalización de la interfaz de administración para reglas de carrito.

Features​

Validación Personalizada de Cupones​

  • Descripción: Implementa lógica personalizada para validar cupones y reglas de venta.
  • Tipo de modificación: API y modelo personalizado.
  • Archivos del core afectados: No modifica archivos core de Magento.
  • Archivos del módulo:
    • Api/CouponValidatorInterface.php
    • Model/CouponValidator.php
  • Notas importantes:
    • Permite reglas de validación específicas para cupones.

Personalización de Interfaz de Administración​

  • Descripción: Personaliza la interfaz de administración para reglas de promoción y cupones.
  • Tipo de modificación: Bloques de administración personalizados.
  • Archivos del core afectados: Reemplaza bloques de administración estándar.
  • Archivos del módulo:
    • Block/Adminhtml/Promo/Quote.php
    • Block/Adminhtml/Promo/Quote/Edit/SaveButton.php, SaveAndContinueButton.php, DeleteButton.php
    • Block/Adminhtml/Promo/Quote/Edit/Tab/Coupons/Form.php
  • Notas importantes:
    • Modifica la experiencia de administración de reglas de promoción.

Gestión de Reglas de Carrito​

  • Descripción: Extiende la funcionalidad de reglas de carrito con lógica personalizada.
  • Tipo de modificación: Modelo de colección personalizado.
  • Archivos del core afectados: Reemplaza la colección estándar de reglas.
  • Archivos del módulo:
    • Model/ResourceModel/Rule/Quote/Collection.php
  • Notas importantes:
    • Permite filtros y lógica personalizada para reglas de carrito.

APIs para Integración​

  • Descripción: Expone APIs para validación y gestión de cupones.
  • Tipo de modificación: APIs personalizadas.
  • Archivos del core afectados: No modifica archivos core.
  • Archivos del módulo:
    • etc/webapi.xml
  • Notas importantes:
    • Permite integración con sistemas externos y headless.

Overrides, Observers y Plugins Importantes​

Preferences (Overrides)​

  • Gaia\SalesRule\Api\CouponValidatorInterface → Gaia\SalesRule\Model\CouponValidator
    • Descripción: Implementa lógica personalizada de validación de cupones.
  • Magento\SalesRule\Block\Adminhtml\Promo\Quote\Edit\SaveButton → Gaia\SalesRule\Block\Adminhtml\Promo\Quote\Edit\SaveButton
    • Descripción: Personaliza el botón de guardar en la edición de reglas.
  • Magento\SalesRule\Block\Adminhtml\Promo\Quote\Edit\SaveAndContinueButton → Gaia\SalesRule\Block\Adminhtml\Promo\Quote\Edit\SaveAndContinueButton
    • Descripción: Personaliza el botón de guardar y continuar.
  • Magento\SalesRule\Block\Adminhtml\Promo\Quote\Edit\DeleteButton → Gaia\SalesRule\Block\Adminhtml\Promo\Quote\Edit\DeleteButton
    • Descripción: Personaliza el botón de eliminar reglas.
  • Magento\SalesRule\Block\Adminhtml\Promo\Quote\Edit\Tab\Coupons\Form → Gaia\SalesRule\Block\Adminhtml\Promo\Quote\Edit\Tab\Coupons\Form
    • Descripción: Personaliza el formulario de cupones en la edición de reglas.
  • Magento\SalesRule\Block\Adminhtml\Promo\Quote → Gaia\SalesRule\Block\Adminhtml\Promo\Quote
    • Descripción: Personaliza el bloque principal de promociones.
  • Magento\SalesRule\Model\ResourceModel\Rule\Quote\Collection → Gaia\SalesRule\Model\ResourceModel\Rule\Quote\Collection
    • Descripción: Extiende la colección de reglas de carrito con lógica personalizada.

Observers​

  • ConvertChannelInputMultiSelect (evento: salesrule_rule_save_before)
    • Descripción: Convierte campos de entrada múltiple antes de guardar reglas de venta.

CLI Commands​

Este módulo no define comandos CLI personalizados.

APIs​

Expone endpoints REST para validación de cupones, definidos en etc/webapi.xml.

Consideraciones para Mantenimiento​

  • El módulo modifica múltiples bloques de administración de reglas de venta.
  • Los overrides pueden requerir ajustes si cambian los bloques core en versiones futuras de Magento.
  • La validación personalizada de cupones puede afectar el comportamiento de promociones existentes.
  • No modifica archivos core directamente, pero reemplaza funcionalidades estándar de reglas de venta.
  • Revisar compatibilidad con otros módulos de promociones o cupones.