Saltar al contenido principal

Gaia_Kustomer

Descripción General​

El módulo Gaia_Kustomer proporciona integración con Kustomer para gestión de clientes en Magento 2. Incluye funcionalidades para carritos abandonados, tracking de órdenes exitosas, logging personalizado con NewRelic, y plugins para el proceso de checkout.

Features​

Gestión de Carritos Abandonados​

  • Descripción: Implementa funcionalidades para tracking y gestión de carritos abandonados a través de Kustomer.
  • Tipo de modificación: Helper personalizado.
  • Archivos del core afectados: No modifica archivos core de Magento.
  • Archivos del módulo:
    • Helper/AbandonedCarts.php
  • Notas importantes:
    • Proporciona logging personalizado para operaciones de carritos abandonados.

Tracking de Órdenes Exitosas​

  • Descripción: Implementa tracking de órdenes exitosas para integración con Kustomer.
  • Tipo de modificación: Observer.
  • Archivos del core afectados: No modifica archivos core de Magento.
  • Archivos del módulo:
    • Observer/Success.php
  • Notas importantes:
    • Se ejecuta cuando se completa una orden exitosamente.

Plugin de Checkout​

  • Descripción: Personaliza el proceso de checkout para integración con Kustomer.
  • Tipo de modificación: Plugin en gestión de información de envío.
  • Archivos del core afectados: No modifica archivos core de Magento.
  • Archivos del módulo:
    • Plugin/CheckoutPlugin.php
  • Notas importantes:
    • Se ejecuta durante el proceso de checkout para tracking de Kustomer.

Sistema de Logging Integrado​

  • Descripción: Implementa logging personalizado con integración NewRelic para operaciones de Kustomer.
  • Tipo de modificación: Configuración de logging.
  • Archivos del core afectados: No modifica archivos core de Magento.
  • Archivos del módulo:
    • Model/DebugHandler.php
    • Configuración en di.xml
  • Notas importantes:
    • Proporciona logging detallado para debugging y monitoreo de operaciones Kustomer.

Widgets Personalizados​

  • Descripción: Proporciona widgets personalizados para integración con Kustomer.
  • Tipo de modificación: Widgets personalizados.
  • Archivos del core afectados: No modifica archivos core de Magento.
  • Archivos del módulo:
    • etc/widget.xml
    • Block/
  • Notas importantes:
    • Permite integración visual con Kustomer en el frontend.

APIs Personalizadas​

  • Descripción: Implementa APIs específicas para integración con Kustomer.
  • Tipo de modificación: APIs personalizadas.
  • Archivos del core afectados: No modifica archivos core de Magento.
  • Archivos del módulo:
    • Api/
  • Notas importantes:
    • Proporciona endpoints para comunicación con Kustomer.

Configuración de Permisos​

  • Descripción: Define permisos específicos para funcionalidades de Kustomer.
  • Tipo de modificación: Configuración de ACL.
  • Archivos del core afectados: No modifica archivos core de Magento.
  • Archivos del módulo:
    • etc/acl.xml
  • Notas importantes:
    • Controla acceso a funcionalidades de Kustomer en el admin.

Overrides, Observers y Plugins Importantes​

Observers​

  • checkout_onepage_controller_success_action → Gaia\Kustomer\Observer\Success
    • Descripción: Maneja eventos cuando se completa una orden exitosamente.

Plugins​

  • Magento\Checkout\Api\ShippingInformationManagementInterface
    • kustomer_abandoned_carts: Plugin para tracking de carritos abandonados

Configuraciones de Inyección de Dependencias​

  • Gaia\Kustomer\Helper\AbandonedCarts
    • Descripción: Configura helper con logger personalizado
  • KustomerLogger (Virtual Type)
    • Descripción: Configura logger principal con NewRelic y debug handler
  • NewRelicHandler (Virtual Type)
    • Descripción: Configura handler de NewRelic para logging

Virtual Types​

  • KustomerLogger
    • Descripción: Logger personalizado con integración NewRelic y debug handler
  • NewRelicHandler
    • Descripción: Handler de NewRelic configurado para nivel 400

CLI Commands​

Este módulo no define comandos CLI personalizados.

APIs​

Expone APIs personalizadas para integración con Kustomer a través de la configuración en Api/.

Consideraciones para Mantenimiento​

  • El módulo es importante para la integración con Kustomer y no debe desactivarse sin revisar dependencias.
  • Depende del módulo core de Widget de Magento.
  • La integración con NewRelic requiere configuración correcta del servicio.
  • El logging personalizado puede generar volúmenes importantes de datos.
  • Los plugins se ejecutan en operaciones críticas de checkout y deben ser eficientes.
  • Revisar compatibilidad con actualizaciones de Kustomer.
  • Las operaciones de carritos abandonados pueden requerir configuración específica.
  • Los widgets pueden afectar el rendimiento del frontend.
  • Los permisos ACL deben estar correctamente configurados para acceso administrativo.