PHPackages                             melsaka/voteable - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. melsaka/voteable

ActiveLibrary[Utility & Helpers](/categories/utility)

melsaka/voteable
================

A Laravel package that allows you to easily implement a voting system in your Laravel applications.

10PHP

Since Sep 12Pushed 2y ago1 watchersCompare

[ Source](https://github.com/melsaka/voteable)[ Packagist](https://packagist.org/packages/melsaka/voteable)[ RSS](/packages/melsaka-voteable/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Voteable
========

[](#voteable)

The Laravel Voteable package provides a convenient way to implement a voting system in your Laravel applications. With this package, you can easily allow users (voters) to vote on various models (voteables) in your application, such as posts, comments, or any other voteable content.

Installation
------------

[](#installation)

Add the package to your Laravel app via Composer:

```
composer require melsaka/voteable
```

Register the package's service provider in config/app.php.

```
'providers' => [
    ...
    Melsaka\Voteable\VoteableServiceProvider::class,
    ...
];
```

Run the migrations to add the required table to your database:

```
php artisan migrate
```

Add `Voter` trait to the voter model, `User` model for example:

```
use Melsaka\Voteable\Voter;

class User extends Model
{
    use Voter;

    // ...
}
```

Add `Voteable` trait to your voteable model, `Post` model for example:

```
use Melsaka\Voteable\Voteable;

class Post extends Model
{
    use Voteable;

    // ...
}
```

Configuration
-------------

[](#configuration)

To configure the package, publish its configuration file:

```
php artisan vendor:publish --tag=voteable
```

You can then modify the configuration file to change the votes table name if you want, default: `votes`.

Usage
-----

[](#usage)

The Laravel Voteable package provides a variety of methods to handle voting. Here are some of the key functionalities:

For the sake of demonstration, We are going to use `User`, and `Post` Models as examples, where `$user` is the voter, and `$post` is voteable.

```
$user = User::first(); // voter
$post = Post::first(); // voteable
```

### Voting on a Post

[](#voting-on-a-post)

You can vote up or down on a post using the following methods:

```
// Vote up to this post by a voter (user)
Vote::up($post, $user);

// Vote down to this post by a voter (user)
Vote::down($post, $user);

// Remove a voter's (user's) vote on this post
Vote::remove($post, $user);
```

### Voting on a Post

[](#voting-on-a-post-1)

You can check if a voter (user) has voted on a post using the following method:

```
// Check if a voter (user) has voted on this post
Vote::has($post, $user);
```

### Alternative Voting Methods

[](#alternative-voting-methods)

You can also use the methods provided by the voteable and voter instances:

```
// Vote up a post using the post instance
$post->upVote($user);

// Vote down a post using the post instance
$post->downVote($user);

// Remove a vote on a post using the post instance
$post->removeVote($user);

// Check if a user has voted on a post using the post instance
$post->hasVote($user);

// You can perform similar actions using the voter instance
$user->upVote($post);
$user->downVote($post);
$user->removeVote($post);
$user->hasVote($post);
```

### Retrieving Voters and Voted Items

[](#retrieving-voters-and-voted-items)

You can retrieve all voters (users) who voted on a specific voteable item and all voted items by a specific voter (user):

```
// Get all voters (users) who voted on a post
$post->voters(User::class)->get();

// Get all voted posts by a voter (user)
$user->voteables(Post::class)->get();
```

### Eager Loading Vote Data

[](#eager-loading-vote-data)

You can also eager load the number of votes and their sum for voteable models:

```
// Eager load the total sum of the post votes
Post::withVotesSum()->get();
$post->loadVotesSum();

// Eager load the number of the post votes
Post::withVotesCount()->get();
$post->loadVotesCount();

// Eager load only the number of the post up votes
Post::withUpVotesCount()->get();
$post->loadUpVotesCount();

// Eager load only the number of the post down votes
Post::withDownVotesCount()->get();
$post->loadDownVotesCount();
```

### Ordering by Votes

[](#ordering-by-votes)

You can order voteable models (e.g., posts) by their vote counts or vote sums:

```
// Order posts by the number of votes
Post::orderByVotesCount()->get();

// Order posts by the total sum of votes
Post::orderByVotesSum()->get();
```

### Checking if a Voter Voted on Multiple Items

[](#checking-if-a-voter-voted-on-multiple-items)

You can get posts and check if a specific voter (user) voted on them:

```
Post::withVoted($user);
```

### Accessing the Votes Relation

[](#accessing-the-votes-relation)

You can access the votes relation through the votes() method:

```
// Access the votes relation for a post
$post->votes();

// Access the votes relation for a voter (user)
$user->votes();
```

### Database Schema

[](#database-schema)

To store the voting data, the package uses the following database schema:

```
Schema::create('votes', function (Blueprint $table) {
    $table->id();
    $table->morphs('voteable');
    $table->morphs('voter');
    $table->tinyInteger('vote');
    $table->timestamps();
});
```

License
-------

[](#license)

This package is released under the MIT license (MIT).

###  Health Score

13

—

LowBetter than 1% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity2

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity21

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/6c7cf52b7cdfb096062f2e3862d4d8f45f9b8b5af8bc8d06e5ed74dcb5316682?d=identicon)[melsaka](/maintainers/melsaka)

---

Top Contributors

[![melsaka](https://avatars.githubusercontent.com/u/16939366?v=4)](https://github.com/melsaka "melsaka (2 commits)")

### Embed Badge

![Health badge](/badges/melsaka-voteable/health.svg)

```
[![Health](https://phpackages.com/badges/melsaka-voteable/health.svg)](https://phpackages.com/packages/melsaka-voteable)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)