Versions
Look up a class, method, property or event

CThemeManager

Package system.web
Inheritance class CThemeManager » CApplicationComponent » CComponent
Implements IApplicationComponent
Since 1.0
Version $Id: CThemeManager.php 1799 2010-02-07 19:03:33Z qiang.xue $
CThemeManager manages the themes for the Web application.

A theme is a collection of view/layout files and resource files (e.g. css, image, js files). When a theme is active, CController will look for the specified view/layout under the theme folder first. The corresponding view/layout files will be used if the theme provides them. Otherwise, the default view/layout files will be used.

By default, each theme is organized as a directory whose name is the theme name. All themes are located under the "WebRootPath/themes" directory.

To activate a theme, set the theme property to be the name of that theme.

Since a self-contained theme often contains resource files that are made Web accessible, please make sure the view/layout files are protected from Web access.

Public Properties

Hide inherited properties

PropertyTypeDescriptionDefined By
basePath string the base path for all themes. CThemeManager
baseUrl string the base URL for all themes. CThemeManager
behaviors array the behaviors that should be attached to this component. CApplicationComponent
isInitialized boolean whether this application component has been initialized (i. CApplicationComponent
themeClass string the name of the theme class for representing a theme. CThemeManager
themeNames array list of available theme names CThemeManager

Public Methods

Hide inherited methods

MethodDescriptionDefined By
__call() Calls the named method which is not a class method. CComponent
__get() Returns a property value, an event handler list or a behavior based on its name. CComponent
__isset() Checks if a property value is null. CComponent
__set() Sets value of a component property. CComponent
__unset() Sets a component property to be null. CComponent
asa() Returns the named behavior object. CComponent
attachBehavior() Attaches a behavior to this component. CComponent
attachBehaviors() Attaches a list of behaviors to the component. CComponent
attachEventHandler() Attaches an event handler to an event. CComponent
canGetProperty() Determines whether a property can be read. CComponent
canSetProperty() Determines whether a property can be set. CComponent
detachBehavior() Detaches a behavior from the component. CComponent
detachBehaviors() Detaches all behaviors from the component. CComponent
detachEventHandler() Detaches an existing event handler. CComponent
disableBehavior() Disables an attached behavior. CComponent
disableBehaviors() Disables all behaviors attached to this component. CComponent
enableBehavior() Enables an attached behavior. CComponent
enableBehaviors() Enables all behaviors attached to this component. CComponent
getBasePath() CThemeManager
getBaseUrl() CThemeManager
getEventHandlers() Returns the list of attached event handlers for an event. CComponent
getIsInitialized() CApplicationComponent
getTheme() CThemeManager
getThemeNames() CThemeManager
hasEvent() Determines whether an event is defined. CComponent
hasEventHandler() Checks whether the named event has attached handlers. CComponent
hasProperty() Determines whether a property is defined. CComponent
init() Initializes the application component. CApplicationComponent
raiseEvent() Raises an event. CComponent
setBasePath() CThemeManager
setBaseUrl() CThemeManager

Property Details

basePath property
public string getBasePath()
public void setBasePath(string $value)

the base path for all themes. Defaults to "WebRootPath/themes".

baseUrl property
public string getBaseUrl()
public void setBaseUrl(string $value)

the base URL for all themes. Defaults to "/WebRoot/themes".

themeClass property
public string $themeClass;

the name of the theme class for representing a theme. Defaults to CTheme. This can also be a class name in dot syntax.

themeNames property read-only
public array getThemeNames()

list of available theme names

Method Details

getBasePath() method
public string getBasePath()
{return} string the base path for all themes. Defaults to "WebRootPath/themes".

getBaseUrl() method
public string getBaseUrl()
{return} string the base URL for all themes. Defaults to "/WebRoot/themes".

getTheme() method
public CTheme getTheme(string $name)
$name string name of the theme to be retrieved
{return} CTheme the theme retrieved. Null if the theme does not exist.

getThemeNames() method
public array getThemeNames()
{return} array list of available theme names

setBasePath() method
public void setBasePath(string $value)
$value string the base path for all themes.

setBaseUrl() method
public void setBaseUrl(string $value)
$value string the base URL for all themes.

Be the first person to leave a comment

Please to leave your comment.