mikelmi/mks-theme

Theme support for Laravel

v2.1 2017-02-20 15:26 UTC

Requires

• php: >=7.0

Requires (Dev)

• illuminate/support: >=5.4

MIT

• mike_lmi

• theme
• layout
• laravel
• mks

README

This package supports the management view files and assets under separate folders in Laravel projects.

Installation

1. Installation with

    composer require mikelmi/mks-theme:dev-master

1. Add the service provider in config/app.php, to providers:

    Mikelmi\MksTheme\Providers\MksThemeServiceProvider::class,

1. Add Facade alias in config/app.php, to aliases:

    'Theme' => Mikelmi\MksTheme\Facades\Theme::class,

1. Publish config

    php artisan vendor:publish --provider="Mikelmi\MksTheme\Providers\MksThemeServiceProvider"

Create/configure theme

1. Create new folder in public/themes/, for example public/themes/cool-theme
2. Set your theme in config/theme.php:

    'name' => 'cool-theme'
    ...

1. Now you can overwrite any view from resources/views within the folder public/themes/cool-theme/views

Usage

    Theme::set('theme-name');          // switch to 'theme-name'
    Theme::get();                      // retrieve current theme's name
    Theme::all();                      // retrieve collection with all themes
    Theme::asset('assets/path')        // retrieve url to theme asset (e.g.: Theme::asset('assets/css/styles.css')) 
    Theme::info('key'/** or null */);  // retrive theme info (from file /themes/theme-name/theme.php)