liliom/laravel-acquaintances

This package gives Eloquent models the ability to manage friendships (with groups), interactions along with Likes, favorites..etc .

Laravel Acquaintances

, _(*1)

, _(*2)

Clean, modular social features for Eloquent models: Friendships, Verifications, Interactions (Follow/Like/Favorite/Report/Subscribe/Vote/View), and multi-type Ratings., _(*3)

• PHP >= 8.0
• Illuminate components ^9.0 | ^10.0 | ^11.0 | ^12.0 (Laravel 9–12)
• Laravel News: https://laravel-news.com/manage-friendships-likes-and-more-with-the-acquaintances-laravel-package

TL;DR

$user1 = User::find(1);
$user2 = User::find(2);

// Friendships
$user1->befriend($user2);
$user2->acceptFriendRequest($user1);

// The messy breakup :(
$user2->unfriend($user1);

// Verifications (message is optional)
$user1->verify($user2, "Worked together on several Laravel projects.");
$user2->acceptVerificationRequest($user1);

if ($user1->isVerifiedWith($user2)) {
    echo "Verified!";
}

Documentation

To keep this README concise, the full documentation lives under docs/: - Overview - Installation - Configuration - Friendships - Verifications - Interactions (Follow/Like/Favorite/Report/Subscribe/Vote/View) - Ratings - Migrations - Events - Testing - FAQ - Upgrade Notes, _(*4)

Quickstart

1) Install, _(*5)

composer require multicaret/laravel-acquaintances

2) Publish (optional) and migrate, _(*6)

php artisan vendor:publish --provider="Multicaret\\Acquaintances\\AcquaintancesServiceProvider"
php artisan migrate

3) Add traits to your models, _(*7)

use Multicaret\\Acquaintances\\Traits\\Friendable;
use Multicaret\\Acquaintances\\Traits\\Verifiable;
use Multicaret\\Acquaintances\\Traits\\CanFollow;
use Multicaret\\Acquaintances\\Traits\\CanBeFollowed;
use Multicaret\\Acquaintances\\Traits\\CanLike;
use Multicaret\\Acquaintances\\Traits\\CanBeLiked;
use Multicaret\\Acquaintances\\Traits\\CanRate;
use Multicaret\\Acquaintances\\Traits\\CanBeRated;

class User extends Model {
    use Friendable, Verifiable;
    use CanFollow, CanBeFollowed;
    use CanLike, CanBeLiked;
    use CanRate, CanBeRated;
}

Explore the feature guides linked above for full APIs and examples., _(*8)

Compatibility

• Laravel 9–12 (Illuminate components only; no laravel/framework hard dependency)
• PHP >= 8.0

Contributing / Changelog

• Contributing: see CONTRIBUTING.md
• Changes: see CHANGELOG.md