Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sagor110090/laravel-simple-comments
https://github.com/sagor110090/laravel-simple-comments
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/sagor110090/laravel-simple-comments
- Owner: sagor110090
- License: mit
- Created: 2023-08-22T20:39:32.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2023-08-22T20:55:41.000Z (over 1 year ago)
- Last Synced: 2023-08-23T00:55:41.590Z (over 1 year ago)
- Language: PHP
- Size: 15.6 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Add comments to your Laravel application
[](https://packagist.org/packages/Sagor110090/laravel-comments)
[](https://travis-ci.org/Sagor110090/laravel-comments)
[](https://scrutinizer-ci.com/g/Sagor110090/laravel-comments)
[](https://packagist.org/packages/Sagor110090/laravel-comments)
Add the ability to associate comments to your Laravel Eloquent models. The comments can be approved and nested.
```php
$post = Post::find(1);
$post->comment('This is a comment');
$post->commentAsUser($user, 'This is a comment from someone else');
```
## Installation
You can install the package via composer:
```bash
composer require Sagor110090/laravel-comments
```
The package will automatically register itself.
You can publish the migration with:
```bash
php artisan vendor:publish --provider="Sagor110090\Comments\CommentsServiceProvider" --tag="migrations"
```
After the migration has been published you can create the media-table by running the migrations:
```bash
php artisan migrate
```
You can publish the config-file with:
```bash
php artisan vendor:publish --provider="Sagor110090\Comments\CommentsServiceProvider" --tag="config"
```
## Usage
### Registering Models
To let your models be able to receive comments, add the `HasComments` trait to the model classes.
``` php
namespace App\Models;
use Illuminate\Database\Eloquent\Model;
use Sagor110090\Comments\Traits\HasComments;
class Post extends Model
{
use HasComments;
...
}
```
### Creating Comments
To create a comment on your commentable models, you can use the `comment` method. It receives the string of the comment that you want to store.
```php
$post = Post::find(1);
$comment = $post->comment('This is a comment from a user.');
```
The comment method returns the newly created comment class.
Sometimes you also might want to create comments on behalf of other users. You can do this using the `commentAsUser` method and pass in your user model that should get associated
with this comment:
```php
$post = Post::find(1);
$comment = $post->commentAsUser($yourUser, 'This is a comment from someone else.');
```
### Approving Comments
By default, all comments that you create are not approved - this is just a boolean flag called `is_approved` that you can use in your views/controllers to filter out comments that you might not yet want to display.
To approve a single comment, you may use the `approve` method on the Comment model like this:
```php
$post = Post::find(1);
$comment = $post->comments->first();
$comment->approve();
```
### Auto Approve Comments
If you want to automatically approve a comment for a specific user (and optionally model) you can let your User model implement the following interface and method:
```php
namespace App\Models;
use Sagor110090\Comments\Contracts\Commentator;
use Illuminate\Foundation\Auth\User as Authenticatable;
class User extends Authenticatable implements Commentator
{
/**
* Check if a comment for a specific model needs to be approved.
* @param mixed $model
* @return bool
*/
public function needsCommentApproval($model): bool
{
return false;
}
}
```
The `needsCommentApproval` method received the model instance that you want to add a comment to and you can either return `true` to mark the comment as **not** approved, or return `false` to mark the comment as **approved**.
### Retrieving Comments
The models that use the `HasComments` trait have access to it's comments using the `comments` relation:
```php
$post = Post::find(1);
// Retrieve all comments
$comments = $post->comments;
// Retrieve only approved comments
$approved = $post->comments()->approved()->get();
```
### Testing
``` bash
composer test
```
### Changelog
Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.
## Contributing
Please see [CONTRIBUTING](CONTRIBUTING.md) for details.
### Security
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
## Credits
- [Marcel Pociot](https://github.com/mpociot)
- [All Contributors](../../contributors)
## License
The MIT License (MIT). Please see [License File](LICENSE.md) for more information.