ThemeKey allows you to define simple or sophisticated theme-switching rules which allow automatic selection of a theme depending on current path, taxonomy terms, language, node-type, and many, many other properties. It can also be easily extended to support additional properties exposed by other modules. In combination with Drupal's theme inheritance you can easily achieve features like:

  • individually-styled channels
  • a front-page / "splash" screen
  • a date/time-selected Christmas theme
  • mobile themes for different auto-detected mobile devices
  • special themes for "limited" or "old" browsers
  • content, user, or role -specific themes
  • indicating your environment (production, staging, testing, sandbox, … )
  • testing your redesign safely on a live server
  • ...

And unlike other theme switching modules, ThemeKey should play well with internal and external page caches, like Boost or Varnish, even for anonymous users.

Feedback is welcome!

Damn, ThemeKey ... ROCKS! Really appreciate the kick ass work you did on this :) mortendk

I must say, this module is underrated. ThemeKey Properties makes ThemeKey awesome. It's right up there with Rules, Context, and Panels. My mind is blown away at the flexibility. :-) momendo

ThemeKey for Drupal 8 or 9?

We decided to not migrate ThemeKey 7.x to Drupal 8/9 as it is as essential parts in changed in Drupal core and new concepts are available.

ThemeKey rules and properties should be migrated to Drupal's condition system that was introduced in Drupal 8. There's already a tiny theme negotiator that does the theme switching based on conditions: Theme Switcher.

We decided to leverage Theme Switcher as new "engine" for Drupal 8 and 9.

So the current plan is to keep Theme Switcher small and to use ThemeKey as an extension to provide additional conditions if required.

Like in the past it would be better if other contrib modules provide their own conditions, just like we encouraged them to provide their own ThemeKey properties. But we still have the freedom to do some stuff here.

Any help in migrating the rules and properties to conditions is welcome!

ThemeKey 7.x for Drupal 7

ThemeKey 7.x contains some noteworthy differences compared to ThemeKey 6.x:

  • The optional module ThemeKey User Profile replaces the Drupal 6 themes per user core feature, which has been removed from Drupal 7 core.
  • The optional module ThemeKey Compatibility solves the generic problem of concurrent theme switching modules by integrating them into it's Theme Switching Rule Chain. Now you can combine features like core's Administration Theme, Organic Groups Theme and many more using ThemeKey.
  • The additional module ThemeKey Properties became part of ThemeKey itself.

What's new in ThemeKey 7.x-3.x?

3.x offers more functionality for mobile devices. It integrates with Browscap and Mobile Detect and contains a new sub-module named ThemeKey Redirect to create an additional rule chain to redirect the user, for example to a simplified mobile version of a site.

The new sub-module ThemeKey CSS offers an additional rule chain to add single CSS files based on rules, instead of or in addition to switching the theme.

All Fields assigned to nodes became ThemeKey properties to create rules based on field values!

A lot of other improvements. Have a look at the CHANGELOG.txt for details.

For developers: More hooks and some reusable components to extend ThemeKey more easily.

Special Module Integrations

Beside the standard features ThemeKey automatically extends it's features if one of these modules gets installed:

As mentioned above, in D7 every theme switching module that implements hook_custom_theme() could become part of ThemeKey's rule chain using the included ThemeKey Compatibility module.

Related Projects / Modules extending ThemeKey

  • ThemeKey Properties offers additional properties you can choose from to ThemeKey 6.x.
  • Taxonomy Theme offers a user interface to trigger selection of different themes based on taxonomy and uses ThemeKey as its back end.
  • ThemeKey CiviCRM provides CiviCRM related properties.
  • MobileKey - another approach to handle mobile devices beside ThemeKey's internal client detection and the WURFL-Integration.
  • Mobile Tools (7.x-3.x will use ThemeKey for the theme switching part)
  • Crumbs
  • Domain ThemeKey integrates Domain Access and ThemeKey
  • ...

Documentation

After installing ThemeKey, you'll have access to a lot of documentation using Drupal's built-in help system at /admin/help/themekey. You will find descriptions of all ThemeKey properties, some examples, and tutorials. The ThemeKey 6.x tutorials are also available at
http://kalki.de/en/howto/themekey-tutorials.html
Just click the "Tutorials" link to open the collapsed overview.

ThemeKey 7.x contains an optional module called ThemeKey Example to demonstrate developers how to extend ThemeKey.

Sponsors

Sessions / Slides / Videos

Supporting organizations: 
sponsors Drupal 8/9 support

Project information

Releases