Theme switcher
Project description
Introduction
This addon provide a browser view @@themeswitcher which apply on the root and let you override the theme which is used on all theme technologies of Plone.
This addon is intended for integrators.
Plone Theming stack
portal_skins
From CMF this is the most old piece.
This one is monkeypatched.
browser_layer
from Zope3, this is the modern way to create and override views and so “viewpagetemplatefile”.
This one is already set by plone.theme on the portal_skins.
diazo
The last technology it happens after the rendering of the page to make xslt transform on the Plone rendered page.
This one is monkeypatched.
Switcher
This addon has been designed to easily support new switcher. At the moment the only switcher that is implemented is the “mobile switcher” based on user agent from http://detectmobilebrowsers.com/ (python version).
Some ideas on switcher that could be easily done:
switch on domain
switch on protocol (http / https)
switch on role
switch on path
switch on device (mobile, tablet, desktop)
switch on a cookie value
How to use
You just have to configure in portal_registry which switcher you want to use and configure it.
To use a specific diazo theme you have to copy it’s settings to switcher registry.
For example let say you want to use plonetheme.mobile only for a mobile you have to add a registry.xml with:
<record name="collective.themeswitcher.theme.mobile"> <field type="plone.registry.field.ASCIILine"> <title>Mobile theme</title> </field> <value>plonetheme.mobile</value> </record> <record name="collective.themeswitcher.switcher"> <field type="plone.registry.field.TextLine"> <title>Theme switcher</title> <description>The named switcher that will be used</description> </field> <value>themeswitcher_mobile</value> </record> <record name="collective.themeswitcher.absolutePrefix" interface="plone.app.theming.interfaces.IThemeSettings" field="absolutePrefix"> <field type="plone.registry.field.TextLine"> <description>convert_relative_url</description> <required>False</required> <title>absolute_url_prefix</title> </field> <value>/++theme++plonetheme.mobile</value> </record> <record name="collective.themeswitcher.currentTheme" interface="plone.app.theming.interfaces.IThemeSettings" field="currentTheme"> <field type="plone.registry.field.TextLine"> <description>current_theme_description</description> <title>current_theme</title> </field> <value>plonetheme.mobile</value> </record> <record name="collective.themeswitcher.doctype" interface="plone.app.theming.interfaces.IThemeSettings" field="doctype"> <field type="plone.registry.field.ASCIILine"> <default></default> <description>doctype_description</description> <required>False</required> <title>doctype</title> </field> <value><!DOCTYPE html></value> </record> <record name="collective.themeswitcher.enabled" interface="plone.app.theming.interfaces.IThemeSettings" field="enabled"> <field type="plone.registry.field.Bool"> <default>False</default> <description>enable_theme_globally</description> <title>enabled</title> </field> <value>True</value> </record> <record name="collective.themeswitcher.hostnameBlacklist" interface="plone.app.theming.interfaces.IThemeSettings" field="hostnameBlacklist"> <field type="plone.registry.field.List"> <default> <element>127.0.0.1</element> </default> <description>hostname_blacklist_description</description> <required>False</required> <title>hostname_blacklist</title> <value_type type="plone.registry.field.TextLine"/> </field> <value> <element>127.0.0.1</element> </value> </record> <record name="collective.themeswitcher.parameterExpressions" interface="plone.app.theming.interfaces.IThemeSettings" field="parameterExpressions"> <field type="plone.registry.field.Dict"> <default/> <description>parameter_expressions_description</description> <key_type type="plone.registry.field.ASCIILine"/> <required>False</required> <title>parameter_expressions</title> <value_type type="plone.registry.field.ASCIILine"/> </field> <value> <element key="ajax_load">python: request.form.get('ajax_load')</element> </value> </record> <record name="collective.themeswitcher.readNetwork" interface="plone.app.theming.interfaces.IThemeSettings" field="readNetwork"> <field type="plone.registry.field.Bool"> <default>False</default> <description>network_urls_allowed</description> <title>readNetwork</title> </field> <value>False</value> </record> <record name="collective.themeswitcher.rules" interface="plone.app.theming.interfaces.IThemeSettings" field="rules"> <field type="plone.registry.field.TextLine"> <description>rules_file_path</description> <required>False</required> <title>rules_file</title> </field> <value>/++theme++plonetheme.mobile/rules.xml</value> </record>
How to install
This addon can be installed has any other addons. please follow official documentation
Credits
Companies
People
JeanMichel FRANCOIS aka toutpt <toutpt@gmail.com>
Changelog
1.0a2 (2013-04-29)
Nothing changed yet.
1.0a1 (2013-04-20)
Package created using templer [JeanMichel aka toutpt]
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Hashes for collective.themeswitcher-1.0a2.zip
Algorithm | Hash digest | |
---|---|---|
SHA256 | f31b5ab320158899a69da38f203a5e872109808201c01c5af848726fc85af35b |
|
MD5 | ca99f4a6d19a7b875e5b5b61bd68634d |
|
BLAKE2b-256 | 7d9afdfae4c3d9fc08b89b124832463e16b4d55ab515a9c76415182bf22da3e7 |