Event System Overview

Introduction

WNCMS event docs are grouped by domain. Add new hooks to the matching group page when introducing them in core.

Event Groups

• Users Events
• Posts Events
• Settings Events
• Themes Events

Event Registration

In a Service Provider

namespace App\Providers;

use Illuminate\Support\Facades\Event;
use Illuminate\Support\ServiceProvider;

class EventServiceProvider extends ServiceProvider
{
    public function boot()
    {
        Event::listen('wncms.frontend.users.register.after', function ($user) {
            // Your logic here
        });
    }
}

Using Event Listeners

namespace App\Listeners;

class SendWelcomeEmail
{
    public function handle($user)
    {
        // Send welcome email
    }
}

Register in EventServiceProvider:

protected $listen = [
    'wncms.frontend.users.register.after' => [
        SendWelcomeEmail::class,
    ],
];

Best Practices

1. Use references when runtime mutation is required (&$param).
2. Keep hook names aligned with the naming standard.
3. Wrap listener logic in error handling when side effects are non-critical.
4. Keep hook docs updated in this folder in the same task.
5. Sync zh-CN and zh-TW docs when structure changes.

See Also

• Laravel Events Documentation
• Service Providers
• Frontend Controller