Questions answered by this recipe
All sections are optional, you can remove those that do not apply to your recipe, and add new ones.
To enable choice-colorchanger, add the following to your config.php file:
$EnableAutoSkinColorList = 1; include_once("
$ValidColorChangerSkins = array('choice','colorimetry','skittlish','mychoice','mycolorimetry','myskittlish');
will allow the additional use of localised versions of the given skins.
In addition, if you want to limit or map the available color schemes and themes, there are two hashes you can set:
To only allow a specific set of colors and themes, create an array called $PageColorList and $PageStyleList that maps names from ?color= or ?skintheme= into the corresponding skin to be used for that name. For example:
$PageColorList = array( # Only allow muted colors 'blue_bold' => 'blue_muted', 'green_bold' => 'green_muted', 'orange_bold' => 'orange_muted', ); $PageStyleList = array( 'light' => 'light', 'dark' => 'light', # Only allow light theme );
To use the recipe, once installed, add various query parameters to set color and theme:
- sets the color scheme for the currently viewed page only. Will not persist to another page or view.
- sets the skin theme (light or dark) for the currently viewed page only. Will not persist to another page or view.
- sets a cookie with the desired color scheme so it will persist throughout the user's visits.
- sets a cookie with the desired skin theme (light or dark) so it will persist throughout the user's visits.
The following query string will set the color sheme to blue_muted and the theme to dark for the current view:
The following query string will set the color scheme to green_bold and the theme to light for all pages for this visitor:
Future plans include developing some markup to insert a color scheme chooser so it can be easily embedded in a page somewhere.
It is possible to specify both the per-page and persistent options on the query string. Both will work, but the per-page set will take precedence (for that view only, then the persistent ones take over).
Change log / Release notes
If the recipe has multiple releases, then release notes can be placed here. Note that it's often easier for people to work with "release dates" instead of "version numbers".
See discussion at ChoiceColorChanger-Talk