overtrue / laravel-follow
User follow unfollow system for Laravel.
Fund package maintenance!
overtrue
Installs: 341 545
Dependents: 10
Suggesters: 0
Security: 0
Stars: 1 190
Watchers: 24
Forks: 133
Open Issues: 0
Requires
- laravel/framework: ^9.0|^10.0|^11.0
Requires (Dev)
- brainmaestro/composer-git-hooks: dev-master
- friendsofphp/php-cs-fixer: ^3.8
- laravel/pint: ^1.5
- mockery/mockery: ^1.5
- orchestra/testbench: ^8.0
- phpunit/phpunit: ^10.0
- 5.x-dev
- 5.2.0
- 5.1.1
- 5.1.0
- 5.0.1
- 5.0.0
- 4.x-dev
- 4.1.0
- 4.0.0
- 3.x-dev
- 3.1.1
- 3.1.0
- 3.0.1
- 3.0.0
- 2.x-dev
- 2.4.6
- 2.4.5
- 2.4.4
- 2.4.3
- 2.4.2
- 2.4.1
- 2.4.0
- 2.3.0
- 2.2.1
- 2.2.0
- 2.1.1
- 2.1.0
- 2.0.1
- 2.0.0
- 1.x-dev
- 1.1.16
- 1.1.15
- 1.1.14
- 1.1.13
- 1.1.12
- 1.1.11
- 1.1.10
- 1.1.9
- 1.1.8
- 1.1.7
- 1.1.6
- 1.1.5
- 1.1.4
- 1.1.3
- 1.1.2
- 1.1.1
- 1.1.0
- 1.0.1
- 1.0
This package is auto-updated.
Last update: 2024-12-13 06:35:53 UTC
README
User follow unfollow system for Laravel.
Related projects:
- Like: overtrue/laravel-like
- Favorite: overtrue/laravel-favorite
- Subscribe: overtrue/laravel-subscribe
- Vote: overtrue/laravel-vote
Installing
composer require overtrue/laravel-follow -vvv
Configuration and Migrations
php artisan vendor:publish --provider="Overtrue\LaravelFollow\FollowServiceProvider"
Usage
Traits
Overtrue\LaravelFollow\Traits\Follower
Add the Follower trait to your user model:
use Overtrue\LaravelFollow\Traits\Follower; class User extends Authenticatable { use Follower; <...> }
Overtrue\LaravelFollow\Traits\Followable
Then add the Followable trait to your followable model, for example App\User
:
use Overtrue\LaravelFollow\Traits\Followable; class User extends Authenticatable { use Followable; <...> }
or any other model:
use Overtrue\LaravelFollow\Traits\Followable; class Channel extends Model { use Followable; <...> }
API
$user1 = User::find(1); $user2 = User::find(2); $user1->follow($user2); $user1->unfollow($user2); $user1->toggleFollow($user2); $user1->acceptFollowRequestFrom($user2); $user1->rejectFollowRequestFrom($user2); $user1->isFollowing($user2); $user2->isFollowedBy($user1); $user2->hasRequestedToFollow($user1);
Get followings:
$user->followings; $user->approvedFollowings; $user->notApprovedFollowings;
foreach($user->followings()->with('followable')->get() as $following) { $following->created_at; // followed at $following->followable->nickname; // the user attributes }
Get followers:
$user->followers; $user->approvedFollowers; $user->notApprovedFollowers;
foreach($user->followers()->with('followers')->get() as $follower) { $follower->created_at; // followed at $follower->follower->nickname; // the user attributes }
Follow Requests
If you would like to have some follow requests to need to be accepted by the user being followed, simply override the needsToApproveFollowRequests() method in the model that uses the Followable trait with your custom logic:
public function needsToApproveFollowRequests() { // Your custom logic here return (bool) $this->private; }
Aggregations
// followings count $user->followings()->count(); $user->approvedFollowings()->count(); $user->notApprovedFollowings()->count(); // with query where $user->followings()->where('gender', 'female')->count(); // followers count $user->followers()->count(); $user->approvedFollowers()->count(); $user->notApprovedFollowers()->count();
List with *_count
attribute:
$users = User::withCount(['followings', 'followables'])->get(); // or $users = User::withCount(['approvedFollowings', 'approvedFollowers'])->get(); foreach($users as $user) { // $user->followings_count; // $user->followers_count; // or // $user->approved_followings_count; // $user->approved_followers_count; }
Attach user follow status to followable collection
You can use Follower::attachFollowStatus(Collection $followables)
to attach the user follow status, it will set has_followed
attribute to each model of $followables
:
For model
$user1 = User::find(1); $user->attachFollowStatus($user1); // result [ "id" => 1 "name" => "user1" "private" => false "created_at" => "2021-06-07T15:06:47.000000Z" "updated_at" => "2021-06-07T15:06:47.000000Z" "has_followed" => true ]
For Collection | Paginator | LengthAwarePaginator | array
:
$user = auth()->user(); $users = User::oldest('id')->get(); $users = $user->attachFollowStatus($users); $users = $users->toArray(); // result [ [ "id" => 1 "name" => "user1" "private" => false "created_at" => "2021-06-07T15:06:47.000000Z" "updated_at" => "2021-06-07T15:06:47.000000Z" "has_followed" => true ], [ "id" => 2 "name" => "user2" "private" => false "created_at" => "2021-06-07T15:06:47.000000Z" "updated_at" => "2021-06-07T15:06:47.000000Z" "has_followed" => true ], [ "id" => 3 "name" => "user3" "private" => false "created_at" => "2021-06-07T15:06:47.000000Z" "updated_at" => "2021-06-07T15:06:47.000000Z" "has_followed" => false ], [ "id" => 4 "name" => "user4" "private" => false "created_at" => "2021-06-07T15:06:47.000000Z" "updated_at" => "2021-06-07T15:06:47.000000Z" "has_followed" => false ], ]
For pagination
$users = User::paginate(20); $user->attachFollowStatus($users);
Order by followers count
You can query users order by followers count with following methods:
orderByFollowersCountDesc()
orderByFollowersCountAsc()
orderByFollowersCount(string $direction = 'desc')
example:
$users = User::orderByFollowersCountDesc()->get(); $mostPopularUser = User::orderByFollowersCountDesc()->first();
N+1 issue
To avoid the N+1 issue, you can use eager loading to reduce this operation to just 2 queries. When querying, you may specify which relationships should be eager loaded using the with
method:
$users = User::with('followings')->get(); foreach($users as $user) { $user->isFollowing(2); } $users = User::with('followables')->get(); foreach($users as $user) { $user->isFollowedBy(2); }
Events
❤️ Sponsor me
如果你喜欢我的项目并想支持它,点击这里 ❤️
Project supported by JetBrains
Many thanks to Jetbrains for kindly providing a license for me to work on this and other open-source projects.
Contributing
You can contribute in one of three ways:
- File bug reports using the issue tracker.
- Answer questions or fix bugs on the issue tracker.
- Contribute new features or update the wiki.
The code contribution process is not very formal. You just need to make sure that you follow the PSR-0, PSR-1, and PSR-2 coding guidelines. Any new code contributions must be accompanied by unit tests where applicable.
PHP 扩展包开发
想知道如何从零开始构建 PHP 扩展包?
请关注我的实战课程,我会在此课程中分享一些扩展开发经验 —— 《PHP 扩展包实战教程 - 从入门到发布》
License
MIT