Download the PHP package sunveloper/teepluss-themes without Composer

Laradic Themes for Laravel 5

Version 0.3

Laravel 5 package providing multi-theme inherited cascading support for views and assets.

• Easy and worry free setup Does not conflict with the standard Laravel view system.
• Template Languages Works with PHP, Blade, Twig and any other view engine.
• Cascading & Inheritance Themes are able to inherit all options from other themes, providing a smart and intuitive way to extend existing themes.
• Asset Management Dependable assets or asset groups with caching, minification, filters(scss, less, etc), etc.
• And much more...

Overview

• Overview
• Todo for 1.0
• Installation
  • Composer
  • Laravel
  • Configuration
• First time usage guide and explenation
  • Inheritance system basics
  • Cascade system basics
    • To create a namespace
    • To create package
• Views/Themes
  • Common methods overview
    • Themes (Facade => ThemeFactory)
    • Theme (instance of a theme)
• Assets
  • AssetGroup
• The theme file
• Navigation/Breadcrumbs
• Console Commands
  • List publishers
  • Publish a theme
  • Creating a theme
  • Creating the initial theme structure (ment as example)
• Copyright/License

Todo for 1.0

• [ ] Proper/updated documentation (not this README.md file)
• [ ] Example application
• [ ] Unit tests for Assets
• [x] Jenkins, travis, etc
• [x] Unit tests for Themes

Installation

Composer

Laravel

Add the ThemesServiceProvider to your config.

Optionally, you can add any of the Facades below:

Configuration

<sub>[^](#top)</sub>

First time usage guide and explenation

Open up the laradic.config.php file. For first time use, just change the theme folder path to your desired location.

Save it and run php artisan themes:init. This will generate a few folders and files matching the default config settings. It only serves as an example, showing the directory structure for a theme and theme view inheritance.

Loading a view file is the same as normal.

Inheritance system basics

Load priority [Active Theme View Folder]() > [Parent Theme View Folder(if set)]() > [Default Theme View Folder]() > [Default Laravel View Folder]()

If you understand that, skip these points. Otherwise, more details about this:

• If you open the index.blade.php file, you see it @extends layout.
• If there was a layout.blade.php file in the same folder, it would use that one (duhh).
• However, that's not the case right now. So the Theme manager will start looking in other theme directories if they have the file (with the same relative path).
• It will first check the parent theme of 'example/main', defined in the theme.php file (or not, its optional).
• If its not there either, it will check the default theme. Which in this case, has the layout.blade.php file.
• If by any chance, the default folder doesn't have that file either, it will lastly check the standard Laravel view folder for that file.

The same goes for loading Views, Assets, etc.

Cascade system basics

To put it simply, every theme can have "sub-themes". Inside a theme folder, you notice the namespaces and packages folder.

To create a namespace

For example:

• create the lingo folder inside the namespaces folder of the example/main theme.
• Inside that folder, create the assets and views folder.

• Create a myview.blade.php inside the view folder

• Create a subdir/otherview.blade.php inside the view folder

To create package

A package need to be in 2 directories.

• So create the foo/bar folder inside the packages folder of the example/main theme.
• Inside that folder, create the assets and views folder.

• Create a hakker.blade.php inside the view folder

• Create a subdir/otherhakker.blade.php inside the view folder

The same goes for assets

Views/Themes

The active and default theme can be set in the configuration by altering the active and default keys.
You can set the active theme on the fly by using Theme::setActive('theme/slug').
You can set the default theme on the fly by using Theme::setDefault('theme/slug').

Common methods overview

Check out the API documentation for the full list of methods.

Themes (Facade => ThemeFactory)

Theme (instance of a theme)

Assets

The Asset Facade links to AssetFactory. It should not be confused with the Asset class that Asset::make returns, which actually holds asset data.

Note $path is the same as with Views (namespaces, packages, etc)

AssetGroup

Is used to group assets. Has several features you could use:

• Depencency management
• Minifaction & concenation
• Caching

The theme file

Beside the obvious fields, the boot field is rather important. Use the boot field closure to register namespaces for your theme, define assets and asset groups, and other global stuff.

Navigation/Breadcrumbs

Console Commands

List publishers

Publish a theme

Creating a theme

Creating the initial theme structure (ment as example)

Copyright/License

Copyright 2015 Robin Radic - MIT Licensed