Events

Each action dispatches an event carrying the affected review, so you can notify authors, alert support on low ratings or refresh search indexes without modifying the package. All live in RoundlyConsulting\Reviews\Events:

use Illuminate\Support\Facades\Event;
use RoundlyConsulting\Reviews\Events\ReviewCreated;
use RoundlyConsulting\Reviews\Events\ReviewRejected;

Event::listen(function (ReviewCreated $event): void {
    logger()->info('New review', ['id' => $event->review->id]);
});

Event::listen(function (ReviewRejected $event): void {
    // $event->review, $event->reason (?string)
});

Worth knowing

• Events come from the actions, which the facade, an injected manager, the builder, the traits and the Review model helpers all run. A raw Eloquent change — $review->delete() on the model, say — fires no package event.
• A review that lands approved or rejected on create (approved(), auto_approve or the moderator) or after an edit fires ReviewApproved or ReviewRejected too, after ReviewCreated or ReviewUpdated.
• The package listens to ReviewApproved itself to warm photo variants on the queue when photos are enabled — however the review became approved.