, (*1)
Masterkey Presenter
O pacote Masterkey presenter foi desenvolvido pensando em uma estrutura unificada para exibição de dados. Claro que, a lógica de transfomação fica por conta do desenvolvedor, mas este pacote permite um bootstrap para tais atividades. desenvolvido e pensado para trabalhar com o Laravel 5.4, (*2)
Instalação
Instale-o via composer:, (*3)
sh
$ composer require masterkey/presenter, (*4)
Após instalado, registre o service provider do package, (*5)
php
[
'providers' => [
// Outros providers
Masterkey\Presenter\Providers\PresenterServiceProvider::class,
]
], (*6)
e publique o arquivo de configuração:, (*7)
sh
$ php artisan vendor:publish, (*8)
Neste arquivo de configuração você pode definir o path onde os presenters serão criados, além do namespace que eles receberão., (*9)
Utilização, (*10)
A utilização do pacote é muito simples. Para criar um novo presenter, utilize o comando:, (*11)
sh
$ php artisan make:presenter UsersPresenter, (*12)
Este comando irá criar uma classe, por padrão, em app/Presenters com o namespace definido por você no arquivo de configuração., (*13)
Arquitetura, (*14)
O package gera uma classe que implementa um contrato, a interface Masterkey\Presenter\Contracts\PresenterContract. Para passar dados para o presenter, deve ser passada uma instância do contrato Ìlluminate\Contracts\Support\Arrayable. Em geral, as Collections do Laravel implementam este contrato., (*15)
Após implementar sua lógica, basta recuperar os dados utilizando o método getFormatedData(). Feito isso, basta chutar para o gol e partir para o abraço!, (*16)
Qualquer contribuição a este pacote é muito bem vinda!, (*17)