rickselby/laravel-auto-presenter-mapper

Define presenters in a service provider rather than in the model

Laravel Auto Presenter Mapper

, _(*1)

This is an extension to the excellent laravel-auto-presenter that allows you to define presenters in a service provider or on-the-fly, rather than directly on the model., _(*2)

Compatibility Chart

Installing

Require the project using Composer:, _(*3)

$ composer require rickselby/laravel-auto-presenter-mapper

Laravel 5.5+ will auto-discover the package., _(*4)

For Laravel 5.1-5.4, you should only add this service provider, not the original laravel-auto-presenter service provider, as this one extends it., _(*5)

In your config/app.php add this line to your 'providers' array..., _(*6)

RickSelby\LaravelAutoPresenterMapper\AutoPresenterMapperServiceProvider::class,

... and this line to your 'facades' array., _(*7)

'Presenters' => \RickSelby\LaravelAutoPresenterMapper\Facades\AutoPresenterMapperFacade::class,

Usage

Read the docs at github.com/laravel-auto-presenter/laravel-auto-presenter for the basic use cases., _(*8)

With this package, instead of altering your models to implement HasPresenter, you can define the presenters in a service provider using the facade. For example:, _(*9)

public function register()
{
    \Presenters::map(User::class, UserPresenter::class);
}

This will work exactly how the laravel-auto-presenter works; any User models passed to a view will be wrapped in UserPresenter., _(*10)

The map function also takes an array:, _(*11)

public function register()
{
    \Presenters::map([
        User::class => UserPresenter::class,
        ...
    ]);
}

If you wish to declare a mapping on-the-fly, or override a mapping in a specific instance, the facade can be called from anywhere:, _(*12)

public function show(User $user)
{
    \Presenters::map(User::class, UserJSONPresenter::class);
    ...
}

Decoratable

To mimic the Decoratable interface of the parent package, you can call decoratable:, _(*13)

public function register()
{
    \Presenters::decorate(User::class);
    \Presenters::decorate([
        User::class,
        ...
    ]);
    ...
}

License

Laravel Auto Presenter Mapper is licensed under The MIT License (MIT)., _(*14)