hiqdev/yii2-thememanager

Pluggable themes for Yii2

Yii2 Theme Manager

Pluggable themes for Yii2, _(*1)

, _(*2)

This Yii2 plugin provides easy theming for Yii2 projects. And allows to create and use themes as composer packages. So changing a theme on a site becomes as simple as changing a single require line in composer.json., _(*3)

At the moment there are several themes available:, _(*4)

• AdminLte - yii2-theme-adminlte
• Agency - yii2-theme-agency
• DataServ - yii2-theme-dataserv
• Flat - yii2-theme-flat
• Hyde - yii2-theme-hyde
• Obaju - yii2-theme-obaju
• Yii2 original - yii2-theme-original
• Sailor - yii2-theme-sailor
• Twenty Fifteen - yii2-theme-twentyfifteen

Installation

This package is not intended to be required directly in your project. Instead you should require theme(s) you've chosen and this package will get required as a dependency., _(*5)

Please see hiqdev/hisite-template as example of project using this theming library., _(*6)

Idea

The main goal of this theming library is to allow creation and use of easy pluggable themes: to change a theme on a site it is enough just to require other theme package in project's composer.json., _(*7)

To achieve this goal several technologies were used:, _(*8)

• Yii2 theming with pathMap auto assembling;
• Yii2 dependency injection for widgets and menus;
• composer-config-plugin to create themes as plugins i.e. code combined and distributed together with configuration.

This package provides:, _(*9)

• bootrstrappable ThemeManager component that collects and setups in application view proper Theme object with proper pathMap;
• widgets and menus that can be configured through params and substituted with DI;
• theme DebugPanel showing actual pathMap.

Configuration

This extension is supposed to be used with composer-config-plugin., _(*10)

Also you can use it usual way by copy-pasting config. See src/config/web.php for configuration example., _(*11)

Available configuration parameters:, _(*12)

• themeManager.defaultTheme - default theme
• copyright.year - CopyrightYears widget
• copyright.years
• logo.url - LogoLink widget
• logo.name
• logo.options
• logo.image
• logo.imageOptions
• logo.smallImage
• logo.smallImageOptions
• organization.url - OrganizationLink widget
• organization.name
• organization.options
• poweredBy.url - PoweredBy widget
• poweredBy.name
• poweredBy.version
• poweredBy.options
• socialLinks.links - SocialLinks widget

For more details please see src/config/params.php., _(*13)

License

This project is released under the terms of the BSD-3-Clause license. Read more here., _(*14)

Copyright © 2015-2017, HiQDev (http://hiqdev.com/), _(*15)