pmochine / laravel-report
Reportable Polymorphic Eloquent Models for Laravel 5
3.2.0
2020-11-08 17:24 UTC
Requires
- php: >=7.2
- illuminate/database: ~5.4||~5.5||~5.6||~5.7||~5.8||~6.0||~7.0||~8.0
- illuminate/support: ~5.4||~5.5||~5.6||~5.7||~5.8||~6.0||~7.0||~8.0
Requires (Dev)
- graham-campbell/testbench: ^5.0
- mockery/mockery: ^1.0
- phpunit/phpunit: ^9.4.2
README
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