This package has an endpoint to receive events from the Mageplaza Webhooks module. It can be configured to dispatch Laravel events when a specific event in Magento has been triggered.

Also check out our other Laravel Magento packages! We also have a Magento Client to easily connect Laravel to Magento!

Install the composer package.

composer require justbetter/laravel-magento-webhooks

Publish the configuration of the package.

php artisan vendor:publish --provider="JustBetter\MagentoWebhooks\ServiceProvider" --tag=config

Run the migration for the event logs.

php artisan migrate

The events array located in your configuration can be used to add events.

By default, no middleware is present on the webhook url. This can be changed by adding your own middleware to the middleware array, like authentication.

In order to keep the database from filling up, schedule the CleanLogsCommand in your Kernel.

use JustBetter\MagentoWebhooks\Commands\CleanLogsCommand;

$schedule->command(CleanLogsCommand::class)->daily();

This command supports usage of a custom date. You can pass a date as a parameter which will clean logs from before this date. This date defaults to one month prior.

php artisan magento:webhooks:clean-logs --date="yesterday"

The following configuration can be used in order to successfully work with webhooks.

You can configure the body any way you like as long as an event key is present. The event can be named anything.

{
    "event": "MyWebhookEvent",
    "some_key": "some_value"
}

Adding an event in Laravel can be easily done in a few steps.

Create a new event in Laravel and be sure to extend our WebhookEvent.

<?php

namespace App\Events;

use JustBetter\MagentoWebhooks\Events\WebhookEvent;

class MyLaravelEvent extends WebhookEvent
{
    //
}

This way, you will have a constructor for $event and $data.

Open your magento-webhooks configuration and add an event.

Note: Be sure that the event MyWebhookEvent matches your json configuration above.

<?php

return [

    // ...

    'events' => [

        // single event
        'MyWebhookEvent' => \App\Events\MyLaravelEvent::class,

        // or multiple events
        'MyWebhookEvent' => [
            \App\Events\MyLaravelEvent1::class,
            \App\Events\MyLaravelEvent2::class,
        ],

    ],

];

Run the following command to generate an event listener.

php artisan make:listener MyLaravelEventListener

Update your EventServiceProvider to add your event and listener.

<?php

protected $listen = [

    // ...

    MyLaravelEvent::class => [
        MyLaravelEventListener::class,
    ],

];

In order to test the package functionalities, run the following command:

composer test

Please see CONTRIBUTING for details.

Please review our security policy on how to report security vulnerabilities.

• Ramon Rietdijk
• All Contributors

The MIT License (MIT). Please see License File for more information.