Implementation for Laravel of the presenter design pattern.

1.5.0 2024-05-20 12:31 UTC

This package is auto-updated.

Last update: 2024-05-20 12:35:44 UTC


Presenter is a design pattern for Laravel which is used to modify the data that comes from your model to your views.
It causes the data to be displayed in a way understandable to humans.

Latest Version on Packagist Software License Quality Score Total Downloads

Table of Contents


  • "php" : ">=5.6.0",
  • "illuminate/support": "~5.0|^6.0|^7.0|^8.0|^9.0",
  • "illuminate/database": "~5.0|^6.0|^7.0|^8.0|^9.0"


Laravel 5.x

Execute the following command to get the latest version of the package:

composer require padosoft/laravel-presenter


The first step is to store your presenters somewhere - anywhere. These will be simple objects that do nothing more than format data, as required.
Note that your presenter class must extend Laracodes\Presenter\Presenter:

namespace App\Presenters;

use Laracodes\Presenter\Presenter;

class UserPresenter extends Presenter
    public function fullName()
        return $this->model->first_name . ' ' . $this->model->last_name;
    public function accountAge()
        return $this->model->created_at->diffForHumans();


Next, on your model, pull in the Laracodes\Presenter\Traits\Presentable trait, which will automatically instantiate your presenter class:

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Laracodes\Presenter\Traits\Presentable;

class User extends Model
    use Presentable;
    protected $presenter = 'App\Presenters\UserPresenter';


Done, now you can call it in your views:

<h1>Hello, {{ $user->present()->fullName }}</h1>
<h1>Hello, {{ $user->present()->full_name }}</h1> // automatically convert to camelCase

Notice how the call to the present() method (which will return your new or cached presenter object) also provides the benefit of making it perfectly clear where you must go, should you need to modify how a full name is displayed on the page.


When you call a method that does not exist in its class presenter, this package will automatically call the property in the model with conversion to snake_case.


// automatically calls the property in the model
<h1>Hello, {{ $user->present()->firstName }}</h1> // automatically convert to snake_case
<h1>Hello, {{ $user->present()->first_name }}</h1>

Change log

Please see CHANGELOG for more information what has changed recently.


$ composer test


Please see CONTRIBUTING for details.


If you discover any security related issues, please email instead of using the issue tracker.


This package is largely inspired by this great package by @laracasts and forked from guilhermegonzaga/presenter.

About Padosoft

Padosoft ( is a software house based in Florence, Italy. Specialized in E-commerce and web sites.


The MIT License (MIT). Please see License File for more information.