akaunting/akaunting

// Usually in the Laravel project there's just EventServiceProvider to register all events
// But in this case, they created a separate Event class that extends the default provider

use Illuminate\Foundation\Support\Providers\EventServiceProvider as Provider;

class Event extends Provider
{
    protected $listen = [
        // ...
        
        'App\Events\Document\DocumentViewed' => [
            'App\Listeners\Document\MarkDocumentViewed',
        ],
    ];
}

// All that class actually does is taking care of the $document parameter passed to the Event

class DocumentViewed extends Event
{
    public $document;

    public function __construct($document)
    {
        $this->document = $document;
    }
}

// Then, that parameter is accessible as $event->document inside of this Listener class

class MarkDocumentViewed
{
    public function handle(Event $event)
    {
        $document = $event->document;

        if ($document->status != 'sent') {
            return;
        }

        unset($document->paid);

        $document->status = 'viewed';
        $document->save();
        
        // ... the rest of the listener actions
    }
}

// Finally, this is how we call this Event from the Controller, passing $invoice as the document

class Invoices extends Controller
{
    public function show(Document $invoice, Request $request)
    {
        event(new \App\Events\Document\DocumentViewed($invoice));

        return view('portal.invoices.show', compact('invoice', 'payment_methods'));
    }
}