mobbexco/magento-2

Mobbex Payment Module

4.0.0 2024-12-11 15:33 UTC

Requires

• mobbexco/php-plugins-sdk: 1.11.0

Conflicts

• mobbexco/magento-2-marketplace: <1.2.1

OSL-3.0, AFL-3.0

• Mobbex

README

Requisitos

• PHP >= 7.0
• Magento >= 2.1.0
• Composer >= 1

Instalación

Note

Recuerde que todos los comandos deben ejecutarse en el directorio de instalación de Magento

Warning

Si está utilizando composer 1 para la instalación, primero añada el repositorio a composer mediante el comando composer config repositories.mobbexco-php-plugins-sdk vcs https://github.com/mobbexco/php-plugins-sdk

1. Descargue el paquete:

   composer require mobbexco/magento-2
   

2. Asegurese de que el módulo se encuentra activo:

   php bin/magento module:enable Mobbex_Webpay
   

3. Actualice la base de datos y regenere los archivos:

   php bin/magento setup:upgrade
   php bin/magento setup:static-content:deploy -f
   

4. Añada las credenciales de Mobbex al módulo desde el panel de administración.

Actualización

Para actualizar el módulo ejecute el siguiente comando, y luego repita los pasos 2 y 3 de la instalación:

composer update mobbexco/magento-2

Si al ejecutar el comando se presentan conflictos con dependencias ejecute el comando composer remove mobbexco/magento-2 y vuelva a realizar los pasos de la instalación.

Hooks

Debido a las limitaciones de la plataforma en el manejo de eventos, hemos decidido implementar un método propio para extender las funcionalidades del módulo.

Puntualmente, las diferencias al momento de implementar un observer con estos eventos son las siguientes:

• El observer no necesita implementar la ObserverInterface, debido a que se ejecuta directamente el método que coincida con el nombre del hook.
• El método del observer recibe como parámetros los argumentos enviados, en lugar de obtenerlos mediante un parámetro de tipo observer.
• Los valores retornados modifican el resultado obtenido al momento de ejecutar el hook.

A continuación, un ejemplo utilizando el hook mobbexCheckoutRequest:

<?php

namespace Vendor\Module\Observer;

class Hooks
{
    public function mobbexCheckoutRequest($body, $order)
    {
        $body['reference'] = $order->getId();

        return $body;
    }
}

Y un ejemplo de como se registra el evento en el archivo events.xml. Recuerde que aquí debe escribirse utilizando snake-case:

<config>
    <event name="mobbex_checkout_request">
        <observer name="vendor_module_hooks" instance="Vendor\Module\Observer\Hooks" />
    </event>
</config>

El módulo cuenta con los siguientes hooks actualmente:

Nombre	Utilidad
mobbexCheckoutRequest	Modificar el body que se utiliza para crear el checkout.
mobbexProcessPayment	Remplazar la información que se utiliza para generar las opciones de pago.
mobbexWebhookReceived	Guardar datos adicionales al recibir el webhook de Mobbex.
mobbexProductSettings	Añadir opciones a la configuración por producto del plugin.
mobbexCategorySettings	Añadir opciones a la configuración por categoría del plugin.