Note: You are currently viewing documentation for Moodle 3.6. Up-to-date documentation for the latest stable version of Moodle is likely available here: Theme location.

Theme location

From MoodleDocs
Revision as of 12:53, 8 October 2006 by Dan Poltawski (talk | contribs)


In the standard Moodle distribution, all themes are placed in the theme/ directory, this leads to theme developers hardcoding this location into their themes. Theme developers should not take this for granted, and use the variables which moodle provides for this purpose.

Starting with 1.7, moodle will fully support changing the location of themes for use with the theme selector. Themes need to be devloped to ensure compatibility with this feature.

$CFG->themewww

The $CFG->themewww variable contains the web-accessible location of the theme directory. If it is not set by the site administrator it will be the default of $CFG->wwwroot . '/theme'. i.e. 'http://my.moodle.site/theme'.

$CFG->httpsthemewww

The $CFG->httpsthemewww' (introduced in Moodle 1.7) variable contains the same information as $CFG->themewww with the correct http/https prefix. This should be used to provide proper operation of https protected pages.

$CFG->themedir

The $CFG->themedir variable contains the local location on the moodle server of the theme directory. If it is not set by the site administrator it will be the default of $CFG->dirroot . '/theme'. i.e. '/my/moodle/location/theme'.

Changing theme Location

Starting from Moodle 1.7, the location of themes may be altered, using the variables $CFG->themewww and $CFG->themedir - themes from placed in the specified directory will be able to be selected using the theme selector.

If you wish to place themes in a subdirectory called 'my_moodle_themes', your config.php might look like this:

$CFG->wwwroot   = 'http://my.moodle.site.edu';
$CFG->dirroot   = '/var/www/my.moodle.site.edu/public_html';
$CFG->themewww  = $CFG->wwwroot . '/my_moodle_themes';
$CFG->themedir  = $CFG->dirroot . '/my_moodle_themes';