pmochine/laravel-report

Reportable Polymorphic Eloquent Models for Laravel 5

3.2.0 2020-11-08 17:24 UTC

This package is auto-updated.

Last update: 2024-12-09 02:32:48 UTC


README

PHP from Packagist Latest Version

Installation

Require this package, with Composer, in the root directory of your project.

$ composer require pmochine/laravel-report

To get started, you'll need to publish the vendor assets and migrate:

php artisan vendor:publish --provider="Pmochine\Report\ReportServiceProvider" && php artisan migrate

Usage

Setup a Model

<?php

namespace App;

use Pmochine\Report\Traits\HasReports;
use Illuminate\Database\Eloquent\Model;

class Post extends Model
{
    use HasReports;
}

Examples

The User Model reports the Post Model

$post->report([
    'reason' => \Str::random(10),
    'meta' => ['some more optional data, can be notes or something'],
], $user);

Create a conclusion for a Report and add the User Model as "judge" (useful to later see who or what came to this conclusion)

$report->conclude([
    'conclusion' => 'Your report was valid. Thanks! We\'ve taken action and removed the entry.',
    'action_taken' => 'Record has been deleted.' // This is optional but can be useful to see what happend to the record
    'meta' => ['some more optional data, can be notes or something'],
], $user);

Get the conclusion for the Report Model

$report->conclusion;

Get the judge for the Report Model (only available if there is a conclusion)

$report->judge(); // Just a shortcut for $report->conclusion->judge

Get an array with all Judges that have ever "judged" something

Report::allJudges();

Testing

$ phpunit

Security

If you discover any security related issues, please don't email me. I'm afraid 😱. avidofood@protonmail.com

Credits

Now comes the best part! 😍 This package is based on

License

MIT © Brian Faust