touhidurabir/laravel-presenter

A package that helps to group methods that mostly use for the view presentation purpose.

1.0.1 2021-11-17 10:43 UTC

This package is auto-updated.

Last update: 2024-10-17 17:09:50 UTC


README

A package that helps to group methods that mostly use for the view presentation purpose.

Installation

Require the package using composer:

composer require touhidurabir/laravel-presenter

To publish the config file:

php artisan vendor:publish --provider="Touhidurabir\Presenter\PresenterServiceProvider" --tag=config

Configurations

Check the published config file for the details of configurations options.

Usage

First step is to generate a presenter class . To make this process easy, this package comes with a command that helps to generate the presenter classes. To generate the presenter class via command, do as

php artisan make:presenter PresenterClassName

For example :

php artisan make:presenter UserPresenter

will generate a UserPresenter at the App\Presenters namespaced path.

it will have following content

namespace Touhidurabir\Presenter\Tests\App\Presenters;

use Touhidurabir\Presenter\BasePresenter;

class UserPresenter extends BasePresenter {

}

Now to use this with the combination of User model class, drop the HasPresenter trait and defined property $presenter as :

use Illuminate\Database\Eloquent\Model;
use Touhidurabir\Presenter\HasPresenter;
use Touhidurabir\Presenter\Tests\App\Presenters\UserPresenter;

class User extends Model {

    use HasPresenter;

    protected $presenter = UserPresenter::class;
}

Now to define a method in our presenter class, follow as :

class UserPresenter extends BasePresenter {

    public function someMethod() {

        return $this->model->some_presentable_data;
    }
}

And Now any public method defined in the UserPresenter class can be accesses as :

$user->present()->someMethod

It is also possible to not define the $presenter property while using the presenter class for models . In that case it will try to resolve the presenter through the model name and default store namespace defined in the config file .

For example, by default it will try to find a class in the App\Presenters location with name of UserPresenter for User model if the $presenter property not set in the User model. If it can find it, then it will use that for User model presenter . If none found, it will throw exception.

It is also possible to set/update the presenter on fly . To do that , need to user the setPresenter method defined in the HasPresenter trait as :

$user->setPresenter(UserPresenter::class);
$user->present()->anyMethodDefinedInPresenter;

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

License

MIT