buzz/laravel-theme

Theme Management for Laravel 5.*

Theme Management for Laravel 5.*

Detect device use package serbanghita/Mobile-Detect. If you want to be simple, use a version 1. Note: v2.* switch language to vietnamese, _(*1)

Contents

1. Introduction
2. Installation
3. Configuration
4. Structure
5. Usage

Introduction

This is package support the management view files and assets under separate folders. Compatible with Laravel 5.*, _(*2)

Installation

The first run command:, _(*3)

composer require buzz/laravel-theme 2.*

and then open config/app.php add LaravelThemeServiceProvider to array providers, _(*4)

'providers' => [
    //.....
    'Illuminate\Validation\ValidationServiceProvider',
    'Illuminate\View\ViewServiceProvider,
    //.....
    'Buzz\LaravelTheme\LaravelThemeServiceProvider',
],

Add Theme alias (when set auto_alias => false in theme config):, _(*5)

'aliases' => [
    //.....
    'Validator' => 'Illuminate\Support\Facades\Validator',
    'View'      => 'Illuminate\Support\Facades\View',
    //.....
    'Theme' =>  'Buzz\LaravelTheme\ThemeFacade',
],

Configuration

Publish config file config/theme.php with command:, _(*6)

php artisan vendor:publish --provider="Buzz\LaravelTheme\LaravelThemeServiceProvider"

Usage

Structure

Assets

├── public/
    └── themes/
        ├── theme_name/
        |   ├── js/
        |   ├── css/
        |
        └── another_theme_name/

Views

├── resources/
    └── themes/
        ├── theme_name/
        |   ├── index.blade.php
        |   ├── footer.blade.php
        |
        └── another_theme_name/

Render view

package does not change the way you render view, you still use the View::make or view() as default of laravel, read more on views document. If the render view and the view does not exist in the resources/themes/theme-name, it will render view in resources/views., _(*7)

Theme assets

Use themeAsset() instead of asset() when link to assets in theme, example:, _(*8)

<link rel="stylesheet" href="{!! themeAsset('css/bootstrap.css') !!}">
//render <link rel="stylesheet" href="http://domain/themes/theme-name/css/bootstrap.css">

Change current theme

You can change the theme in the following ways:, _(*9)

app('theme')->set($themeName)

Or use function helper, _(*10)

setTheme($themeName);//function helper

or use Facade, _(*11)

Theme::set($themeName);//use facade

Support methods

Theme::client();//return object of MobileDetect
Theme::pathTheme($name = null);//return path to current theme or name input
Theme::currentTheme();//return name of current theme
Theme::reset();//reset default theme
Theme::set();//set theme
Theme::allTheme($except = [], $config = true);//get list theme in folder themes
themeAsset($name = false);//link to asset current theme or by theme name
setTheme($name);// change theme by theme name

Support other config provider

By default package use provider config of laravel, you can change to provider you want by edit config 'config_provider' => 'provider_name', _(*12)

P/s: excuse me my English., _(*13)