Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Yii2 Theme Manager

Pluggable themes for Yii2

Latest Stable Version Total Downloads Build Status Scrutinizer Code Coverage Scrutinizer Code Quality Dependency Status

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.

At the moment there are several themes available:


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.

Please see hiqdev/hisite-template as example of project using this theming library.


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.

To achieve this goal several technologies were used:

This package provides:

  • 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.


This extension is supposed to be used with composer-config-plugin.

Also you can use it usual way by copy-pasting config. See src/config/web.php for configuration example.

Available configuration parameters:

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

For more details please see src/config/params.php.


This project is released under the terms of the BSD-3-Clause license. Read more here.

Copyright © 2015-2017, HiQDev (