Laravel Love is a package by Anton Komarev that lets people express how they feel about content by liking and disliking Eloquent models. The package works by defining a “liker” model defined with a contract. Most likely this will be your application’s User
model:
1<?php 2 3use Cog\Contracts\Love\Liker\Models\Liker as LikerContract; 4use Cog\Laravel\Love\Liker\Models\Traits\Liker; 5use Illuminate\Foundation\Auth\User as Authenticatable; 6 7class User extends Authenticatable implements LikerContract 8{ 9 use Liker;10}
On the other end, you define Eloquent models that can be “liked” by your “liker” model:
1use Cog\Contracts\Love\Likeable\Models\Likeable as LikeableContract;2use Cog\Laravel\Love\Likeable\Models\Traits\Likeable;3use Illuminate\Database\Eloquent\Model;45class Article extends Model implements LikeableContract6{7 use Likeable;8}
Here are some available methods this package affords your models:
1$user->like($article);2$user->likedBy(); // true/false3$user->unlike($article);4$user->toggleLike($article);56// Dislike7$user->dislike($article);
On likable models you here are some of the methods available:
1<?php23$article->likesCount;4$article->dislikesCount;
This package also provides model scopes that you can learn about in the GitHub readme, along with installation instructions and API documentation:
1<?php 2 3# Find all articles liked by a user 4Article::whereLikedBy($user->id) 5 ->with('likesCounter') // Allow eager load (optional) 6 ->get(); 7 8# Get Articles sorted by likes count asc 9$sortedArticles = Article::orderByLikesCount('asc')->get();1011# The default sort order is desc12$sortedArticles = Article::orderByLikesCount()->get();
The obvious use-case for this package is showing the number of likes/dislikes on content and even sorting content based on that (i.e., Reddit or Hacker News upvotes).
Another use-case that intrigues me more is trying to recommend content to users, and allowing a user to provide feedback on whether they like or dislike specific recommendations. You could use that data to keep improving the recommended content based on user feedback.
Learn More
You can get installation instructions and documentation on the GitHub repository cybercog/laravel-love. What other use-cases come to mind? Respond to @laravelnews on Twitter and let us know!
Filed in:
Full stack web developer. Author of Lumen Programming Guide and Docker for PHP Developers.