source: inc/core/class.dc.themes.php @ 3874:ab8368569446

<?php
/**
 * @brief Themes specific handler
 *
 * Provides an specialized object to handle themes. An instance of this
 * class should be created when needed.
 *
 * @package Dotclear
 * @subpackage Core
 *
 * @copyright Olivier Meunier & Association Dotclear
 * @copyright GPL-2.0-only
 */

if (!defined('DC_RC_PATH')) {return;}

class dcThemes extends dcModules
{
    protected static $type = 'theme';

    /**
    This method registers a theme in modules list. You should use this to
    register a new theme.

    <var>$parent</var> is a optional value to indicate them inheritance.
    If <var>$parent</var> is null / not set, we simply fall back to
    the standard behavior, by using 'default'.

    <var>$priority</var> is an integer. Modules are sorted by priority and name.
    Lowest priority comes first. This property is currently ignored when dealing
    with themes.

    @param    name            <b>string</b>        Module name
    @param    desc            <b>string</b>        Module description
    @param    author        <b>string</b>        Module author name
    @param    version        <b>string</b>        Module version
    @param    properties    <b>array</b>        extra properties
    (currently available keys : parent, priority, standalone_config, type, tplset)
     */
    public function registerModule($name, $desc, $author, $version, $properties = [])
    {
        # Fallback to legacy registerModule parameters
        if (!is_array($properties)) {
            $args       = func_get_args();
            $properties = [];
            if (isset($args[4])) {
                $properties['parent'] = $args[4];
            }
            if (isset($args[5])) {
                $properties['priority'] = (integer) $args[5];
            }
        }
        # Themes specifics properties
        $properties = array_merge(
            ['parent' => null, 'tplset' => DC_DEFAULT_TPLSET],
            $properties,
            ['permissions' => 'admin'] // force themes perms
        );

        parent::registerModule($name, $desc, $author, $version, $properties);
    }

    /**
    Loads namespace <var>$ns</var> specific file for module with ID
    <var>$id</var>
    Note : actually, only 'public' namespace is supported with themes.

    @param    id        <b>string</b>        Module ID
    @param    ns        <b>string</b>        Namespace name
     */
    public function loadNsFile($id, $ns = null)
    {
        switch ($ns) {
            case 'public':
                $parent = $this->modules[$id]['parent'];
                if ($parent) {
                    // This is not a real cascade - since we don't call loadNsFile -,
                    // thus limiting inclusion process.
                    // TODO : See if we have to change this.
                    $this->loadModuleFile($this->modules[$parent]['root'] . '/_public.php');
                }
                $this->loadModuleFile($this->modules[$id]['root'] . '/_public.php');
                break;
        }
    }
}