Download the PHP package cybercog/laravel-likeable without Composer

Laravel Likeable

Attention

This package is abandoned and no longer maintained. Development moved to Laravel Love package!

If you already have installed version of Laravel Likeable you can use Laravel Love Migration Guide.

Introduction

Laravel Likeable simplify management of Eloquent model's likes & dislikes. Make any model likeable & dislikeable in a minutes!

Contents

• Features
• Installation
• Usage
  • Prepare likeable model
  • Available methods
  • Scopes
  • Events
  • Console commands
• Extending
• Change log
• Contributing
• Testing
• Security
• Contributors
• Alternatives
• License
• About CyberCog

Features

• Designed to work with Laravel Eloquent models.
• Using contracts to keep high customization capabilities.
• Using traits to get functionality out of the box.
• Most part of the the logic is handled by the LikeableService.
• Has Artisan command likeable:recount {model?} {type?} to re-fetch likes counters.
• Likeable model can has Likes and Dislikes.
• Likes and Dislikes for one model are mutually exclusive.
• Get Likeable models ordered by likes count.
• Events for like, unlike, dislike, undislike methods.
• Following PHP Standard Recommendations:
  • PSR-1 (Basic Coding Standard).
  • PSR-2 (Coding Style Guide).
  • PSR-4 (Autoloading Standard).
• Covered with unit tests.

Installation

First, pull in the package through Composer.

If you are using Laravel 5.5 you can skip register package part.

Register package on Laravel 5.4 and lower

Include the service provider within app/config/app.php.

Perform Database Migration

At last you need to publish and run database migrations.

Usage

Prepare likeable model

Use Likeable contract in model which will get likes behavior and implement it or just use Likeable trait.

Available methods

Likes

Like model

Remove like mark from model

Toggle like mark of model

Get model likes count

Get model likes counter

Get likes relation

Get iterable Illuminate\Database\Eloquent\Collection of existing model likes

Boolean check if user liked model

Checks in eager loaded relations likes & likesAndDislikes first.

Get collection of users who liked model

Delete all likes for model

Dislikes

Dislike model

Remove dislike mark from model

Toggle dislike mark of model

Get model dislikes count

Get model dislikes counter

Get dislikes relation

Get iterable Illuminate\Database\Eloquent\Collection of existing model dislikes

Boolean check if user disliked model

Checks in eager loaded relations dislikes & likesAndDislikes first.

Get collection of users who disliked model

Delete all dislikes for model

Likes and Dislikes

Get difference between likes and dislikes

Get likes and dislikes relation

Get iterable Illuminate\Database\Eloquent\Collection of existing model likes and dislikes

Scopes

Find all articles liked by user

Find all articles disliked by user

Fetch Likeable models by likes count

Uses desc as default order direction.

Fetch Likeable models by dislikes count

Uses desc as default order direction.

Events

On each like added \Cog\Likeable\Events\ModelWasLiked event is fired.

On each like removed \Cog\Likeable\Events\ModelWasUnliked event is fired.

On each dislike added \Cog\Likeable\Events\ModelWasDisliked event is fired.

On each dislike removed \Cog\Likeable\Events\ModelWasUndisliked event is fired.

Console commands

Recount likes and dislikes of all model types

Recount likes and dislikes of concrete model type (using morph map alias)

Recount likes and dislikes of concrete model type (using fully qualified class name)

Recount only likes of all model types

Recount only likes of concrete model type (using morph map alias)

Recount only likes of concrete model type (using fully qualified class name)

Recount only dislikes of all model types

Recount only dislikes of concrete model type (using morph map alias)

Recount only dislikes of concrete model type (using fully qualified class name)

Extending

You can override core classes of package with your own implementations:

• Models\Like
• Models\LikeCounter
• Services\LikeableService

Note: Don't forget that all custom models must implement original models interfaces.

To make it you should use container binding interfaces to implementations in your application service providers.

Use model class own implementation

Use service class own implementation

After that your CustomLike and CustomService classes will be instantiable with helper method app().

Change log

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Testing

You can run the tests with:

Security

If you discover any security related issues, please email [email protected] instead of using the issue tracker.

Contributors

Anton Komarev	Kevin Olson

Laravel Likeable contributors list

Alternatives

• cybercog/laravel-love
• rtconner/laravel-likeable
• faustbrian/laravel-likeable
• sukohi/evaluation
• zvermafia/lavoter

Feel free to add more alternatives as Pull Request.

License

• Laravel Likeable package is open-sourced software licensed under the Anton Komarev.

About CyberCog

CyberCog is a Social Unity of enthusiasts. Research best solutions in product & software development is our passion.

• Follow us on Twitter
• Read our articles on Medium