kappa/themes-manager

Package for easier work with themes

Kappa\ThemesManager

Package for easier work with themes, _(*1)

Requirements:

• PHP 5.4 or higher
• nette\di 2.2 or higher
• nette\application 2.2 or higher

Installation:

The best way to install Kappa\ThemesManager is using Composer, _(*2)

$ composer require kappa/themes-manager:@dev

Usages

First you must register extension, _(*3)

extensions:
    themes: Kappa\ThemesManager\DI\ThemesManagerExtension

Now you can configure templates for your application in config file, _(*4)

themes:
    themeName:
        themeDir: %wwwDir%/../../ # required
        assetsDir: :themeDir:/assets # required
        params:
            # params
        helpers:
            # helpers in format helperName: @service::method
        macros:
            # macros
        pathMasks:
            templates:
                # path masks for formatTemplateFiles
            layouts:
                # path masks for formatLayoutTemplateFiles

All settings will be used only in own section., _(*5)

In masks you can use next placeholders:, _(*6)

• :themeDir: - contains theme dir path
• :assetsDir: - contains assets dir path for create temp copy into public directory. In templates now you can use {$assetsDir} variable as base path for scripts, styles and etc... files
• :presenter: - contains presenter name (without modules)
• :modules: - contains module name (module name My:Module will be replaced to My/Module)
• :module_(number): - contains module name (My:Module => module_1 = My, module_2 => Module)
• :action: - contains presenter acion name
• :view: - contains presenter view name
• :themeName: - will be replaced for theme name

In your presenter you can get template factory and file formats, _(*7)

Usages kdyby/autowired, it is recommended, _(*8)

class BasePresenter extends Presenter
{
    use AutowireProperties;

    /**
     * @var \Kappa\ThemesManager\Theme
     * @autowire(admin, factory=\Kappa\ThemesManager\ThemeRegistry)
     */
    public $theme;

or classic, _(*9)

class BasePresenter extends Presenter
{
    /** @var \Kappa\ThemesManager\ThemesRegistry @inject */
    public $themesRegistry;

Update template:, _(*10)

public function getTemplateFactory()
{
    $templateFactory = parent::createTemplate();
    // For kdyby/autowired
    $templateFactory->setTheme($this->theme);
    // Else
    $theme = $this->themesRegistry->getTheme('admin');
    $templateFactory->setTheme($theme);

    return $templateFactory;
}

now your presenter have macros, helpers and params from section 'themeName' defined in config file, _(*11)

Next you can use custom path masks. Example:, _(*12)

public function formatLayoutTemplateFiles()
{
    $list = $this->theme->getPathMapper()->getFormatLayoutTemplateFiles();

    return $list;
}

public function formatTemplateFiles()
{
    $list = $this->theme->getPathMapper()->getFormatTemplateFiles();

    return $list;
}