This package is abandoned and no longer maintained. No replacement package was suggested.

Points and Ranks for Eloquent models.

Fund package maintenance!

2.2.0 2019-08-28 13:03 UTC

This package is auto-updated.

Last update: 2020-02-28 14:38:10 UTC


Build Status PHP from Packagist Latest Version License

This package offers to reward entities with points and to create a ranking based on these points.

It is possible to reward, penalize, multiply, redeem and reset points and entities can be blacklisted/whitelisted which makes it possible to prevent certain entities to receive points.

Each entity will receive a rank based on its points which could be used to display a listing of the users with the most points or something like that.


Require this package, with Composer, in the root directory of your project.

$ composer require artisanry/leaderboard

At last you need to publish the migration and run the migration:

php artisan vendor:publish --provider="Artisanry\Leaderboard\LeaderboardServiceProvider" && php artisan migrate




namespace App;

use Artisanry\Leaderboard\Traits\Boardable;

class User
    use Boardable;


$user = App\User::find(1);

$events = [
    'CompletedProfile'      => 10,
    'SocialLoginFacebook'   => 5,
    'SocialLoginTwitter'    => 5,
    'SocialLoginGoogleplus' => 5,

// User filled out address, phone, email, etc.
if($user->completedProfile()) {

// User added his Facebook profile
if($user->hasSocialProfile('facebook')) {

// User removed his Facebook profile
if($user->removedSocialProfile('facebook')) {

// User purchased a premium package
$plan = App\Plan::findByTitle('Premium');

if($user->purchased($plan)) {

// User wants to purchase something
$product = App\Product::find(1);

try {
    if($user->redeem($product->price)) {
        event(new ProductWasPurchased($product, $user));
} catch(\Artisanry\Leaderboard\Exceptions\InsufficientFundsException $e) {
    // Not enough points


Reward the given amount of points.


Remove the given amount of points.


Multiply all points by the given factor.


Redeem the given amount of points.


Reset all points to zero.


Blacklist the user. This will disable all functions except for blacklist/whitelist.


Whitelist the user.



$ phpunit


If you discover a security vulnerability within this package, please send an e-mail to All security vulnerabilities will be promptly addressed.


This project exists thanks to all the people who contribute.


Mozilla Public License Version 2.0 (MPL-2.0).