Download the PHP package manzadey/laravel-favorite without Composer
On this page you can find all versions of the php package manzadey/laravel-favorite. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download manzadey/laravel-favorite
More information about manzadey/laravel-favorite
Files in manzadey/laravel-favorite
Package laravel-favorite
Short Description Allows Laravel Eloquent models to implement a 'favorite' or 'remember' or 'follow' feature.
License MIT
Homepage https://github.com/Manzadey/laravel-favorite
Informations about the package laravel-favorite
Laravel Favorite (Laravel 8 Package)
Allows Laravel Eloquent models to implement a 'favorite' or 'remember' or 'follow' feature.
Index
- Installation
- Models
- Usage
- Testing
- Change log
- Contributions
- Pull Requests
- Security
- Credits
- License
Installation
1) Install the package via Composer
2) You need to publish the migration to create the favorites
table:
3) After that, you need to run migrations:
Publishing the config file
Publishing the config file is optional:
This is the default content of the config file:
Models
Your User model should import the Favoriteability
trait, FavoriteabilityContract
implements interface and use it, that trait allows the user to favorite the models.
(see an example below):
Your models should import the Favoriteable
trait, FavoriteableContract
implements interface and use it, that trait has the methods that you'll use to allow the model be favoriteable.
In all the examples I will use the Post model as the model that is 'Favoriteable', that's for example proposes only.
(see an example below):
That's it ... your model is now "favoriteable"! Now the User can favorite models that have the favoriteable trait.
Usage
The models can be favorite with and without an authenticated user (see examples below):
Add to favorites and remove from favorites:
If a param is passed in the favorite method, then the model will assume the user with that user model.
The user model can also add to favorites and remove from favorites:
Return the favorite objects for the user:
A user can return the objects he marked as favorite.
You just need to pass the class in the getFavorite()
method in the User
model.
Return the users who marked this object as favorite
You can return the users who marked this object, you just need to call the favoriteBy()
method in the object
Check if the user already favorite an object
You can check if the Auth user have already favorite an object, you just need to call the isFavorite()
method in the object
Testing
The package have integrated testing, so everytime you make a pull request your code will be tested.
Change log
Please see CHANGELOG for more information on what has changed recently.
Contributions
Contributions are welcome and will be fully credited. We accept contributions via Pull Requests on Github.
Pull Requests
-
PSR-12 Coding Standard - Check the code style with
$ composer check-style
and fix it with$ composer fix-style
. -
Add tests! - Your patch won't be accepted if it doesn't have tests.
-
Document any change in behaviour - Make sure the
README.md
and any other relevant documentation are kept up-to-date. -
Consider our release cycle - We try to follow SemVer v2.0.0. Randomly breaking public APIs is not an option.
-
Create feature branches - Don't ask us to pull from your master branch.
-
One pull request per feature - If you want to do more than one thing, send multiple pull requests.
- Send coherent history - Make sure each individual commit in your pull request is meaningful. If you had to make multiple intermediate commits while developing, please squash them before submitting.
Security
Please report any issue you find in the issues page. Pull requests are welcome.
Credits
- Christian Kuri
- Manzadey Andrey
- All Contributors
License
The MIT License (MIT). Please see License File for more information.
All versions of laravel-favorite with dependencies
illuminate/database Version ^8.0|^9.0
php Version ^8.0|^8.1