PHPackages                             ac-developers/eloquent-url-presenter - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. ac-developers/eloquent-url-presenter

ActiveLibrary[Utility & Helpers](/categories/utility)

ac-developers/eloquent-url-presenter
====================================

An easy way to create url presenters for your eloquent models.

v0.2.1(7y ago)2131MITPHPPHP ^7.1.0

Since Jun 6Pushed 7y ago1 watchersCompare

[ Source](https://github.com/tsommie/eloquent-url-presenter)[ Packagist](https://packagist.org/packages/ac-developers/eloquent-url-presenter)[ RSS](/packages/ac-developers-eloquent-url-presenter/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (3)Dependencies (2)Versions (4)Used By (0)

Laravel Url Presenter
=====================

[](#laravel-url-presenter)

This is a simple presenter much like the [Laracast](https://github.com/laracasts) [Presenter](https://github.com/laracasts/Presenter) but specifically tailored for presenting urls in Laravel as suggested by a post on [laravel-news.com](https://laravel-news.com/leverage-eloquent-to-prepare-your-urls) writen by [Jordan Dalton](https://laravel-news.com/@jordandalton).

- [Laravel Url Presenter](#laravel-url-presenter)
    - [1.1. Setting up](#11-setting-up)
        - [1.1.1. Installation on Lumen 5.x and Laravel 5.x.](#111-installation-on-lumen-5x-and-laravel-5x)
        - [1.1.2. Installation on Lumen and Laravel 5.4 and below.](#112-installation-on-lumen-and-laravel-54-and-below)
            - [1.1.2.1. Service Provider](#1121-service-provider)
        - [1.1.3. Publishing config file.](#113-publishing-config-file)
        - [1.1.4. Configure paths for generated processes](#114-configure-paths-for-generated-processes)
    - [1.2. Usage](#12-usage)
        - [1.2.1. Creating a url presenter](#121-creating-a-url-presenter)
        - [1.2.1. Preparing model to use Url Presenter](#121-preparing-model-to-use-url-presenter)
        - [1.3. Laravel url presenter command](#13-laravel-url-presenter-command)
    - [1.3. Security Vulnerabilities](#13-security-vulnerabilities)
    - [1.4. License](#14-license)

1.1. Setting up
---------------

[](#11-setting-up)

### 1.1.1. Installation on Lumen 5.x and Laravel 5.x.

[](#111-installation-on-lumen-5x-and-laravel-5x)

Add the Laravel Form Processor package to your `composer.json` file.

```
composer require ac-developers/eloquent-url-presenter

```

> **Auto-discovery:** Is supported in Laravel Form Processor [auto-discovery](https://medium.com/@taylorotwell/package-auto-discovery-in-laravel-5-5-ea9e3ab20518) for Laravel 5.5 and greater.

### 1.1.2. Installation on Lumen and Laravel 5.4 and below.

[](#112-installation-on-lumen-and-laravel-54-and-below)

#### 1.1.2.1. Service Provider

[](#1121-service-provider)

In your app config, add the `EloquentUrlPresenterServiceProvider` to the providers array.

```
'providers' => [
    AcDevelopers\EloquentUrlPresenter\EloquentUrlPresenterServiceProvider::class,
    ];
```

For **Lumen**, add the provider to your `bootstrap/app.php` file.

```
$app->register(AcDevelopers\EloquentUrlPresenter\EloquentUrlPresenterServiceProvider::class);
```

### 1.1.3. Publishing config file.

[](#113-publishing-config-file)

To publish the config file to `config/eloquent-url-presenter.php` run:

```
php artisan vendor:publish --provider="AcDevelopers\EloquentUrlPresenter\EloquentUrlPresenterServiceProvider"

```

### 1.1.4. Configure paths for generated processes

[](#114-configure-paths-for-generated-processes)

To change the paths of saving the generated url presenters, you need to configure their namespaces in a configuration file `config/ac-developers/eloquent-url-presenter.php`.

```

return [
    /*
    |--------------------------------------------------------------------------
    | Default namespaces for the classes
    |--------------------------------------------------------------------------
    */
    'namespaces' => [
        'presenter'   => 'App\Presenters\Url',
        'model'        => 'App\\',
    ],
];

```

After this your good to go.

1.2. Usage
----------

[](#12-usage)

### 1.2.1. Creating a url presenter

[](#121-creating-a-url-presenter)

Creating a url presenter class is as easy as creating any other php class with just a few steps required to make it url presentable. In our case we will create a UserUrlPresenter class.

first it extends our EloquentUrlPresenterClass. Next you pass in the eloquent model that would be making use of the newly created url presenter in to it's constructor like this:

```
/**
 * UserUrlPresenter constructor.
 *
 * @param \App\User $user
 */
public function __construct(User $user)
{
    parent::__construct($user);

    //
}

```

Then create the method that would return the desired url.

```

/**
 * Get the show url for this user
 *
 * @return string
 */
public function show()
{
    return url('show/{user}', ['slug' => $this->entity])
}

```

If your on Laravel or Lumen and you want to make this presenter resoucesful without manually adding the methods one by one you just have to add the `HasResource` trait to the UrlPresenter and implement the `route` method which should return a string similar to that passed in as first argument in the `Route::resouce` method and the `parameter` method which does exactly what you would expect.

So if in your route method looks like `Route::resource('users', 'UserController')` then the `route` method implemented in the UserUrlPresenter should return `users` else laravel will throw an exception.

And the next is to prepare our model to use our url presenter.

### 1.2.1. Preparing model to use Url Presenter

[](#121-preparing-model-to-use-url-presenter)

Preparing the model that would use the url presenter is simple, Just use the EloquentUrlPresentableTrait and then implementing the urlPresenter methord which will return our UserUrlPresenter class

```
/**
 * Prepare a new or cached url presenter instance
 *
 * @return mixed
*/
public function urlPresenter()
{
    return UserUrlPresenter::class;
}

```

Next we will add "url" to our appends property array like this:

```
/**
 * The accessors to append to the model's array form.
 *
 * @var array
 */
protected $appends = ['url'];

```

Next you add `url` as an array value in our model's `appends` property and then your done.

Now in our code we can link to our user model show page like this:

```
$user->url->show

```

Lets say your using the `HasResource` trait you'll automatically have access to all resourcful route methods and these includes `index`, `create`, `show`, `edit`, `store`, `update` and `destroy`

### 1.3. Laravel url presenter command

[](#13-laravel-url-presenter-command)

> \*\*Note: This is to be used only in Laravel and Lumen applications

Ofcause the following steps narrated previously was to show you how to do it yourself. You can skip this and just run the `php artisan generate:urlPresenter` command. For example to create our `UserUrlPresenter` we would do like this:

```
php artisan generate:urlPresenter UserUrlPresenter --model=User

```

To make a resourceful url presenter all you have to do is pass the `resouces` option while generating the url presenter without a value like so:

```
php artisan generate:urlPresenter UserUrlPresenter --model=User --resource

```

1.3. Security Vulnerabilities
-----------------------------

[](#13-security-vulnerabilities)

If you discover a security vulnerability within Laravel Form Processor, please send an e-mail to Anitche Chisom via . All security vulnerabilities will be promptly addressed.

1.4. License
------------

[](#14-license)

The Eloquent Url Presenter is open-sourced software licensed under the [MIT](LICENSE) license.

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~157 days

Total

3

Last Release

2580d ago

PHP version history (2 changes)v0.1.0PHP >=5.4.0

v0.2.1PHP ^7.1.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/267c0ebc19a68dd31263dab46f2d5224ac2e1ff1af6fb62e4417c8817f419667?d=identicon)[tsommie](/maintainers/tsommie)

---

Top Contributors

[![tsommie](https://avatars.githubusercontent.com/u/10388658?v=4)](https://github.com/tsommie "tsommie (6 commits)")

---

Tags

urllaravellumenpresenterAnitche Chisomeloquent-url-processor

### Embed Badge

![Health badge](/badges/ac-developers-eloquent-url-presenter/health.svg)

```
[![Health](https://phpackages.com/badges/ac-developers-eloquent-url-presenter/health.svg)](https://phpackages.com/packages/ac-developers-eloquent-url-presenter)
```

###  Alternatives

[artesaos/seotools

SEO Tools for Laravel and Lumen

3.3k5.1M60](/packages/artesaos-seotools)[prologue/alerts

Prologue Alerts is a package that handles global site messages.

3486.1M30](/packages/prologue-alerts)[psalm/plugin-laravel

Psalm plugin for Laravel

3274.9M308](/packages/psalm-plugin-laravel)[watson/active

Laravel helper for recognising the current route, controller and action

3253.6M14](/packages/watson-active)[kra8/laravel-snowflake

Snowflake for Laravel and Lumen.

188402.3k6](/packages/kra8-laravel-snowflake)[laracrafts/laravel-url-shortener

Powerful URL shortening tools in Laravel

97110.7k](/packages/laracrafts-laravel-url-shortener)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)