collective.themeswitcher 1.0a2

Theme switcher

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>&lt;!DOCTYPE html&gt;</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

• Planet Makina Corpus

• Contact Makina Corpus

People

• JeanMichel FRANCOIS aka toutpt <[e-mail]>

Changelog

1.0a2 (2013-04-29)

• Nothing changed yet.

1.0a1 (2013-04-20)

• Package created using templer [JeanMichel aka toutpt]