library presenter {🖫 3,549, ⚐ 6, ★ 0}

tequilarapido/presenter

Simple and straightforward presenter implementation for Eloquent models.

Monday, March 5, 2018
by nbourguig
Repository
2 Watchers
0 Stars
3,549 Installations

PHP
0 Dependents
0 Suggesters
0 Forks
0 Open issues
6 Versions
19 % Grown

The README.md

Simple and straightforward presenter implementation for Eloquent models., _(*1)

, _(*2)

, _(*3)

Installation
Usage
Changelog
Testing
Security
Contributing
Credits
License

Installation

You can install the package using composer, _(*4)

``` bash $ composer require tequilarapido/presenter, _(*5)


## Usage

Let's assume we have a User model class

``` php
class User extends Model {
   protected $fillables = ['first_name', 'last_name'];
}

1/ Create a presenter class like the following, and add presentation methods to it. For the example, we'll make a method that will return the user full name.

``` php use Tequilarapido\Presenter\Presenter;, _(*6)

class UserPresenter extends Presenter {
public function name() { return $this->first_name . ' ' . $this->last_name; } }, _(*7)


> We can access model property directly inside the presenter class. We can also access them via the $model property

``` php
$this->first_name
// or 
$this->model->first_name
// or
$this->model->getAttribute('first_name')

2/ you need to reference this class in the model using a public $presenter property and use the Prensentable trait.

``` php use Tequilarapido\Presenter\Presentable;, _(*8)

class User extends Model { use Presentable;, _(*9)

protected $fillables = ['first_name', 'last_name'];, _(*10)

public $presenter = UserPresenter::class; }, _(*11)


* 3/ You can than get the presented value like so : 

``` php
$user = User::find(1);

// Retreive as property 
$user->present()->name 

// you can alse call the method 
$user->present()->name()