2017-25 © Pedro Peláez
 

library laravel-route-to-class

A Laravel 5 view composer that will convert the current route to a body class. 'admin/product/5/edit' becomes 'admin-product-edit'

image

zschuessler/laravel-route-to-class

A Laravel 5 view composer that will convert the current route to a body class. 'admin/product/5/edit' becomes 'admin-product-edit'

  • Tuesday, February 20, 2018
  • by allay
  • Repository
  • 2 Watchers
  • 25 Stars
  • 5,430 Installations
  • PHP
  • 1 Dependents
  • 0 Suggesters
  • 5 Forks
  • 2 Open issues
  • 13 Versions
  • 5 % Grown

The README.md

Alt text, (*1)

Dynamic Body Classes for Laravel

Quickly add body classes to your Laravel app based on rules you set., (*2)

Example of implementations:, (*3)

  1. Browsing as a guest might add user-isGuest as a class.
  2. Browsing an admin panel might add admin-panel as a class.
  3. All user profile routes might have user-profile as a class.

It's easy to write your own rules! You can either write your own generator classes or use the ad-hoc API by interacting with the library singleton directly., (*4)

Quickstart

Require the package in your composer setup., (*5)

composer require zschuessler/laravel-route-to-class

Publish the configuration file, (*6)

Run the following command in the root directory of your project:, (*7)

php artisan vendor:publish --provider="Zschuessler\RouteToClass\ServiceProvider"

Use In Layout, (*8)

You can either use the included Blade directive, or access the Route2Class facade directly for outputting your classes., (*9)

Blade, (*10)

Two important notes for using the Blade directive:, (*11)

  1. The Blade directive will follow any caching solutions you have setup. This is great for production, but keep in mind on development you may be viewing cached classes when modifying generators.
  2. The Blade directive runs before all other view template code. As such, any calls to the Route2Class package in a view will not show up in your class list. 
<body class="@route2class_generate_classes"></body>

Facade, (*12)

Facades are not cached in the manner Blade directives are, making them great for development environments. And because we aren't using a Blade directive, you can modify classes and generators within view templates too., (*13)

Use it in any of your views like so:, (*14)




<body class="{{ \Route2Class::generateClassString(); }}"></body>

Implement Your Own Rules

You can implement your own rules in one of two methods., (*15)

Create Generator File

This is the preferred method since you will always know where your class modifiers ( called generators) will live., (*16)

First decide where you would like to keep your generators. For the purpose of this example we will use the following directory:, (*17)

app/Providers/RouteToClass/UserTypeGenerator.php, (*18)

All you have to do is extend the GeneratorAbstract.php file and implement a method which returns the class string. See below for a simple example:, (*19)

<?php

namespace App\Providers\RouteToClass;

use Zschuessler\RouteToClass\Generators\GeneratorAbstract;

class UserTypeGenerator extends GeneratorAbstract
{
    public function generateClassName()
    {
        // Use your own logic here to determine user type
        $userType = 'admin';

        return 'user-' . $userType;
    }
}

Next add a reference to the generator in your /config/route2class.php configuration:, (*20)

App\Providers\RouteToClass\UserTypeGenerator::class,

Now when you call the facade or Blade directive in a view template, you will see the class user-admin - neat!, (*21)

See this file for a real-life generator example:, (*22)

https://github.com/zschuessler/laravel-route-to-class/blob/master/src/Generators/FullRoutePath.php, (*23)

Ad-Hoc Class Additions

You can interact with the body classes directly by calling the addClass method on the provider., (*24)

Here's an example using the default Laravel project's routes file:, (*25)

```php Route::get('/', function () { // Add static class as string Route2Class::addClass('homepage');, (*26)

// Add class from anonymous function
Route2Class::addClass(function() {
    // Your custom logic goes here
    return 'my-anon-class-name';
});

return view('welcome');

}); ```, (*27)

You can call the addClass method anywhere - models, controllers, etc. Consider adding generator files instead, as it promotes application maintainability and reduces technical debt., (*28)

Demo Project

The demo project below follows the examples outlined above:, (*29)

https://github.com/zschuessler/route2class-demo, (*30)

License

This is public domain. Do what you want., (*31)

The Versions

20/02 2018

dev-master

9999999-dev

A Laravel 5 view composer that will convert the current route to a body class. 'admin/product/5/edit' becomes 'admin-product-edit'

  Sources   Download

public domain NLPL

The Requires

 

by Zachary Schuessler

20/02 2018

2.5.0

2.5.0.0

A Laravel 5 view composer that will convert the current route to a body class. 'admin/product/5/edit' becomes 'admin-product-edit'

  Sources   Download

public domain

The Requires

 

by Zachary Schuessler

05/10 2017

2.4.0

2.4.0.0

A Laravel 5 view composer that will convert the current route to a body class. 'admin/product/5/edit' becomes 'admin-product-edit'

  Sources   Download

public domain

The Requires

 

by Zachary Schuessler

26/09 2017

2.3.0

2.3.0.0

A Laravel 5 view composer that will convert the current route to a body class. 'admin/product/5/edit' becomes 'admin-product-edit'

  Sources   Download

public domain

The Requires

 

by Zachary Schuessler

08/02 2017

2.2.0

2.2.0.0

A Laravel 5 view composer that will convert the current route to a body class. 'admin/product/5/edit' becomes 'admin-product-edit'

  Sources   Download

public domain

The Requires

 

by Zachary Schuessler

08/02 2017

1.1.2

1.1.2.0

A Laravel 5 view composer that will convert the current route to a body class. 'admin/product/5/edit' becomes 'admin-product-edit'

  Sources   Download

public domain

The Requires

 

by Zachary Schuessler

23/12 2016

2.1.0

2.1.0.0

A Laravel 5 view composer that will convert the current route to a body class. 'admin/product/5/edit' becomes 'admin-product-edit'

  Sources   Download

public domain

The Requires

 

by Zachary Schuessler

21/12 2016

2.0.4

2.0.4.0

A Laravel 5 view composer that will convert the current route to a body class. 'admin/product/5/edit' becomes 'admin-product-edit'

  Sources   Download

public domain

The Requires

 

by Zachary Schuessler

21/12 2016

2.0.3

2.0.3.0

A Laravel 5 view composer that will convert the current route to a body class. 'admin/product/5/edit' becomes 'admin-product-edit'

  Sources   Download

public domain

The Requires

 

by Zachary Schuessler

21/12 2016

2.0.2

2.0.2.0

A Laravel 5 view composer that will convert the current route to a body class. 'admin/product/5/edit' becomes 'admin-product-edit'

  Sources   Download

public domain

The Requires

 

by Zachary Schuessler

21/12 2016

2.0.1

2.0.1.0

A Laravel 5 view composer that will convert the current route to a body class. 'admin/product/5/edit' becomes 'admin-product-edit'

  Sources   Download

public domain

The Requires

 

by Zachary Schuessler

21/12 2016

2

2.0.0.0

A Laravel 5 view composer that will convert the current route to a body class. 'admin/product/5/edit' becomes 'admin-product-edit'

  Sources   Download

public domain

The Requires

 

by Zachary Schuessler

09/12 2016

1.0

1.0.0.0

A Laravel 5 view composer that will convert the current route to a body class. 'admin/product/5/edit' becomes 'admin-product-edit'

  Sources   Download

public domain

The Requires

 

by Zachary Schuessler