Theme config file: diferència entre les revisions
(coloring the code, amending broken text) |
|||
| Línia 3: | Línia 3: | ||
The theme config.php file contains configuration variables that control how Moodle uses a specific theme. | The theme config.php file contains configuration variables that control how Moodle uses a specific theme. | ||
==User styles== | == User styles == | ||
This variable is an array containing the names of all the | <code php> | ||
$THEME->sheets = array('user_styles'); | |||
</code> | |||
This variable is an array containing the names of all the style sheet files you want included in this theme, and in what order | |||
== Standard sheets == | |||
<code php> | |||
$THEME->standardsheets = array('styles_layout'); | |||
</code> | |||
This variable can be set to an array containing file names from the *STANDARD* theme. If the array exists, it will be used to choose the files to include in the standard style sheet. When false, then no files are used. When true or NON-EXISTENT, then ALL standard files are used. This parameter can be used, for example, to prevent having to override too many classes. Note that the trailing .css should not be included e.g.: | |||
<code php> | |||
$THEME->standardsheets = array('styles_layout','styles_fonts','styles_color'); | |||
</code> | |||
==Parent== | == Parent == | ||
<code php> | |||
$THEME->parent = ''; | |||
</code> | |||
This variable can be set to the name of a parent theme which you want to have included before the current theme. This can make it easy to make modifications to another theme without having to actually change the files If this variable is empty or false then a parent theme is not used. | This variable can be set to the name of a parent theme which you want to have included before the current theme. This can make it easy to make modifications to another theme without having to actually change the files If this variable is empty or false then a parent theme is not used. | ||
==Parent sheets== | == Parent sheets == | ||
This variable can be set to an array containing | <code php> | ||
$THEME->parentsheets = false; | |||
</code> | |||
This variable can be set to an array containing file names from a chosen *PARENT* theme. If the array exists, it will be used to choose the files to include in the standard style sheet. When false, then no files are used. When true or NON-EXISTENT, then ALL standard files are used. This parameter can be used, for example, to prevent having to override too many classes. Note that the trailing .css should not be included eg $THEME->parentsheets = array('styles_layout','styles_fonts','styles_color'); | |||
== Mod sheets == | == Mod sheets == | ||
| Línia 48: | Línia 62: | ||
== Course format sheets == | == Course format sheets == | ||
<code php> | <code php> | ||
$THEME->courseformatsheets = true; | $THEME->courseformatsheets = true; | ||
| Línia 54: | Línia 69: | ||
When this is enabled, this theme will search for files named "styles.php" inside all course formats and include them. This allows course formats to provide their own default styles. | When this is enabled, this theme will search for files named "styles.php" inside all course formats and include them. This allows course formats to provide their own default styles. | ||
==Meta include== | == Meta include == | ||
<code php> | |||
$THEME->metainclude = true; | |||
</code> | |||
When this is enabled (or not set!) then Moodle will try to include a file meta.php from this theme into the <head></head> part of the page. | |||
== Standard meta include == | |||
<code php> | |||
$THEME->standardmetainclude = true; | |||
</code> | |||
When this is enabled (or not set!) then Moodle will try to include a file meta.php from the standard theme into the <head><head> part of the page. | |||
== Parent meta include == | |||
<code php> | |||
$THEME->parentmetainclude = false; | |||
</code> | |||
When this is enabled (or not set!) then Moodle will try to include a file meta.php from the parent theme into the <head><head> part of the page. | |||
== Nav menu width == | |||
<code php> | |||
$THEME->navmenuwidth = 50; | |||
</code> | |||
You can use this to control the cutoff point for strings in the navmenus (list of activities in popup menu etc) Default is 50 characters wide. | You can use this to control the cutoff point for strings in the navmenus (list of activities in popup menu etc) Default is 50 characters wide. | ||
==Make nav menu list== | == Make nav menu list == | ||
<code php> | |||
$THEME->makenavmenulist = false; | |||
</code> | |||
By setting this to true, then you will have access to a new variable in your header.html and footer.html called $navmenulist ... this contains a simple XHTML menu of all activities in the current course, mostly useful for creating popup navigation menus and so on. | By setting this to true, then you will have access to a new variable in your header.html and footer.html called $navmenulist ... this contains a simple XHTML menu of all activities in the current course, mostly useful for creating popup navigation menus and so on. | ||
==Chameleon enabled== | == Chameleon enabled == | ||
<code php> | |||
$THEME->chameleonenabled = false; | |||
</code> | |||
By setting this to true it enables editing of the stylsheets. It is recommended to set this to false again once you're satisfied with your theme. | By setting this to true it enables editing of the stylsheets. It is recommended to set this to false again once you're satisfied with your theme. | ||
==Chameleon teacher edit enabled== | == Chameleon teacher edit enabled == | ||
<code php> | |||
$THEME->chameleonteachereditenabled = false; | $THEME->chameleonteachereditenabled = false; | ||
</code> | |||
If you use chameleon as a course theme setting this to true will allow teachers on that course to edit the theme. | If you use chameleon as a course theme setting this to true will allow teachers on that course to edit the theme. | ||
==Resource mp3 player colors== | == Resource mp3 player colors == | ||
<code php> | |||
$THEME->resource_mp3player_colors = | |||
'bgColour=000000&btnColour=ffffff&btnBorderColour=cccccc&iconColour=000000&'. | 'bgColour=000000&btnColour=ffffff&btnBorderColour=cccccc&iconColour=000000&'. | ||
'iconOverColour=00cc00&trackColour=cccccc&handleColour=ffffff&loaderColour=ffffff&'. | 'iconOverColour=00cc00&trackColour=cccccc&handleColour=ffffff&loaderColour=ffffff&'. | ||
'font=Arial&fontColour=3333FF&buffer=10&waitForPlay=no&autoPlay=yes'; | 'font=Arial&fontColour=3333FF&buffer=10&waitForPlay=no&autoPlay=yes'; | ||
</code> | |||
With this you can control the colours of the "big" MP3 player that is used for MP3 resources. | With this you can control the colours of the "big" MP3 player that is used for MP3 resources. | ||
==Filter media plugin colors== | == Filter media plugin colors == | ||
<code php> | |||
$THEME->filter_mediaplugin_colors = | |||
'bgColour=000000&btnColour=ffffff&btnBorderColour=cccccc&iconColour=000000&'. | 'bgColour=000000&btnColour=ffffff&btnBorderColour=cccccc&iconColour=000000&'. | ||
'iconOverColour=00cc00&trackColour=cccccc&handleColour=ffffff&loaderColour=ffffff&'. | 'iconOverColour=00cc00&trackColour=cccccc&handleColour=ffffff&loaderColour=ffffff&'. | ||
'waitForPlay=yes'; | 'waitForPlay=yes'; | ||
</code> | |||
This controls the small embedded player | This controls the small embedded player | ||
==Custom pix== | == Custom pix == | ||
<code php> | |||
$THEME->custompix = true; | |||
</code> | |||
If true, then this theme must have a "pix" subdirectory that contains copies of all files from the moodlepix directory, plus a "pixmod" directory containing all the icons for all the activity modules. | If true, then this theme must have a "pix" subdirectory that contains copies of all files from the moodlepix directory, plus a "pixmod" directory containing all the icons for all the activity modules. | ||
Revisió del 19:48, 19 maig 2009
The theme config.php file contains configuration variables that control how Moodle uses a specific theme.
User styles
$THEME->sheets = array('user_styles');
This variable is an array containing the names of all the style sheet files you want included in this theme, and in what order
Standard sheets
$THEME->standardsheets = array('styles_layout');
This variable can be set to an array containing file names from the *STANDARD* theme. If the array exists, it will be used to choose the files to include in the standard style sheet. When false, then no files are used. When true or NON-EXISTENT, then ALL standard files are used. This parameter can be used, for example, to prevent having to override too many classes. Note that the trailing .css should not be included e.g.:
$THEME->standardsheets = array('styles_layout','styles_fonts','styles_color');
Parent
$THEME->parent = ;
This variable can be set to the name of a parent theme which you want to have included before the current theme. This can make it easy to make modifications to another theme without having to actually change the files If this variable is empty or false then a parent theme is not used.
Parent sheets
$THEME->parentsheets = false;
This variable can be set to an array containing file names from a chosen *PARENT* theme. If the array exists, it will be used to choose the files to include in the standard style sheet. When false, then no files are used. When true or NON-EXISTENT, then ALL standard files are used. This parameter can be used, for example, to prevent having to override too many classes. Note that the trailing .css should not be included eg $THEME->parentsheets = array('styles_layout','styles_fonts','styles_color');
Mod sheets
$THEME->modsheets = true;
When this is enabled, then this theme will search for files named "styles.php" inside all Activity modules and include them. This allows modules to provide some basic layouts so they work out of the box. It is HIGHLY recommended to leave this enabled.
Blocksheets
$THEME->blocksheets = true;
When this is enabled, then this theme will search for files named "styles.php" inside all Block modules and include them. This allows Blocks to provide some basic layouts so they work out of the box. It is HIGHLY recommended to leave this enabled.
Lang sheets
$THEME->langsheets = false;
By setting this to true, then this theme will search for a file named "styles.php" inside the current language directory. This allows different languages to provide different styles.
Course format sheets
$THEME->courseformatsheets = true;
When this is enabled, this theme will search for files named "styles.php" inside all course formats and include them. This allows course formats to provide their own default styles.
Meta include
$THEME->metainclude = true;
When this is enabled (or not set!) then Moodle will try to include a file meta.php from this theme into the <head></head> part of the page.
Standard meta include
$THEME->standardmetainclude = true;
When this is enabled (or not set!) then Moodle will try to include a file meta.php from the standard theme into the <head><head> part of the page.
Parent meta include
$THEME->parentmetainclude = false;
When this is enabled (or not set!) then Moodle will try to include a file meta.php from the parent theme into the <head><head> part of the page.
$THEME->navmenuwidth = 50;
You can use this to control the cutoff point for strings in the navmenus (list of activities in popup menu etc) Default is 50 characters wide.
$THEME->makenavmenulist = false;
By setting this to true, then you will have access to a new variable in your header.html and footer.html called $navmenulist ... this contains a simple XHTML menu of all activities in the current course, mostly useful for creating popup navigation menus and so on.
Chameleon enabled
$THEME->chameleonenabled = false;
By setting this to true it enables editing of the stylsheets. It is recommended to set this to false again once you're satisfied with your theme.
Chameleon teacher edit enabled
$THEME->chameleonteachereditenabled = false;
If you use chameleon as a course theme setting this to true will allow teachers on that course to edit the theme.
Resource mp3 player colors
$THEME->resource_mp3player_colors =
'bgColour=000000&btnColour=ffffff&btnBorderColour=cccccc&iconColour=000000&'.
'iconOverColour=00cc00&trackColour=cccccc&handleColour=ffffff&loaderColour=ffffff&'.
'font=Arial&fontColour=3333FF&buffer=10&waitForPlay=no&autoPlay=yes';
With this you can control the colours of the "big" MP3 player that is used for MP3 resources.
Filter media plugin colors
$THEME->filter_mediaplugin_colors =
'bgColour=000000&btnColour=ffffff&btnBorderColour=cccccc&iconColour=000000&'.
'iconOverColour=00cc00&trackColour=cccccc&handleColour=ffffff&loaderColour=ffffff&'.
'waitForPlay=yes';
This controls the small embedded player
Custom pix
$THEME->custompix = true;
If true, then this theme must have a "pix" subdirectory that contains copies of all files from the moodlepix directory, plus a "pixmod" directory containing all the icons for all the activity modules.
