erikgall/presenter

Simple view presenters

Laravel Model/View Presenter (Laracasts)

So you have those scenarios where a bit of logic needs to be performed before some data (likely from your entity) is displayed from the view., _(*1)

• Should that logic be hard-coded into the view? No.
• Should we instead store the logic in the model? No again!

Instead, leverage view presenters. That's what they're for! This package provides one such implementation., _(*2)

Install

Pull this package in through Composer., _(*3)

{
    "require": {
        "erikgall/presenter": "1.*"
    }
}

Usage

The first step is to store your presenters somewhere - anywhere. These will be simple objects that do nothing more than format data, as required., _(*4)

Here's an example of a presenter., _(*5)

use EGALL\Presenter\Presenter;

class UserPresenter extends Presenter {

    public function fullName()
    {
        return $this->first . ' ' . $this->last;
    }

    public function accountAge()
    {
        return $this->created_at->diffForHumans();
    }

}

Next, on your entity, pull in the Laracasts\Presenter\PresentableTrait trait, which will automatically instantiate your presenter class., _(*6)

Here's an example - maybe a Laravel User model., _(*7)

<?php

use EGALL\Presenter\PresentableTrait;

class User extends \Eloquent {

    use PresentableTrait;

    protected $presenter = 'UserPresenter';

}

That's it! You're done. Now, within your view, you can do:, _(*8)

    <h1>Hello, {{ $user->present()->fullName }}</h1>