Installation | Features | Screenshots | FAQ | Changelog | Credits

Device Theme Switcher is a WordPress plugin which delivers one of your WordPress themes to handheld visitors and another theme to tablet visitors. Computer visitors are given the active theme in 'Appearance > Themes'.

Install and activate in your WordPress Dashboard 'Plugins > Add New' section by searching for 'Device Theme Switcher'.

After activation you'll have a new menu: 'Appearance > Device Themes'--where you set which theme is given to which visitor device.

Your device themes can be easily accessed to 'test' and see what other devices see.

www.mywebsite.com/?theme=handheld
www.mywebsite.com/?theme=tablet
www.mywebsite.com/?theme=low_support
www.mywebsite.com/?theme=active

Template Tags, Shortcodes, and Widgets all output a simple HTML anchor tag which links to the mobile/active theme for the website by using URL Switching (See Above).

Template tags can be used in any theme or plugin file.

//Display a link to 'View Full Website'
<?php link_to_full_website($link_text = "View Full Website", $css_classes = array(), $echo = true) ?>

//Display a link to 'Return to Mobile Website'
<?php link_back_to_device($link_text = "Return to Mobile Website", $css_classes = array(), $echo = true) ?>

Shortcodes can be used in the content of any post, page, or custom-post-type.

[link_to_full_website link_text="View Full Website" css_classes="blue-text, alignleft"]

[link_back_to_device link_text="Return to Mobile Website" css_classes="red-text, alignright"]

The anchor tags that output both have a CSS class: 'dts-link'. The 'View Full Website' anchor tag also has a class of 'to-full-website' and the 'Return to the Mobile Website' link has an additional class of 'back-to-mobile'. This CSS can be used anywhere in your theme or style.css file.

Link Styling Example (For Tempalte Tags, Widgets, or Shortcodes):

<style type="text/css">
    .dts-link {
        font-size: 1.5em ;
    }
        .dts-link.to-full-website {
            color: red ;
        }
        .dts-link.back-to-mobile {
            color: blue ;
        }
</style>

The DTS Class contains all the current device theme switcher settings and the current user device. You can access the DTS Class anywhere in themes. This could be helpful if for instance, you want one theme to power all devices and are willing to write your own code logic with conditionals and such.

<?php
    //Access the device theme switcher object anywhere in your theme or plugin
    global $dts

    //See what's in there..
    print_r($dts) ;

    DTS_Switcher Object
    (
        [handheld_theme] => Array
            (
                [name] => Responsive
                [template] => responsive
                [stylesheet] => responsive
            )
        [tablet_theme] => Array
            (
                [name] => Twenty Twelve
                [template] => twentytwelve
                [stylesheet] => twentytwelve
            )
        [low_support_theme] => Array
            (
                [name] => WordPress Default
                [template] => default
                [stylesheet] => default
            )
        [active_theme] => Array
            (
                [name] => Responsive
                [template] => responsive
                [stylesheet] => responsive
            )
        [device] => active (Possible values: active, handheld, tablet, and low_support)
        [theme_override] => tablet (I was given the active theme [I'm on a computer] and I used a url parameter [site.com?theme=tablet] to view the tablet theme)
    )

    //use it..
    if ($dts->device == 'tablet') do_something() ;
?>

View of the 'Appearance > Device Themes' page

View of the two Device Theme Switcher Widgets

How does Device Theme Switcher work?

'Handheld' devices include Android, BlackBerry, iPod, iPhone, Windows Mobile, and other various 'hand held' smart phones. 'Tablet' devices include iPad, Android tablets, Kindle Fire and other large-screen handhelds. 'Low Support' devices include those which have poor CSS & JavaScript rendering capabilities-often these are older devices.

Yes!

If your theme does not work as expected on any of the devices-the issue is with the theme, NOT with the plugin! Follow typical WordPress debugging practices to find and correct the issue in your theme (Or possibly another plugin). The only theme-requirement this plugin relies on is that you have properly-written WordPress themes. If your theme activates in Appearance > Themes and you can preview the theme in your computer's browser-then it is 'properly-written' as far as Device Theme Switcher is concerned.

All Device Theme Switcher really does is change which theme is delivered to the visitor based on the device they're using-but WordPress still thinks the active theme is 'active' the whole time. This means you need to have your register_nav_menu() or register_widget() functions in all your themes! See below for details and examples.

Simply place you register_nav_menu('my-menu-location', 'My Menu Location Name'); function in both of your primary/active and handheld/tablet theme functions.php files. Then, while your primary theme is 'active' go into Appearance > Menus-create your menu and assign it to the menu location-and populate it with some menu items. That's it!

Register a menu location for each theme, and place your register_nav_menus() code in each theme. E.g.:

register_nav_menus(array(
    'active-menu-location' => 'Active Theme Menu Location',
    'handheld-menu-location' => 'Handheld Theme Menu Location',
    'tablet-menu-location' => 'Tablet Theme Menu Location',
));

Then, while your primary theme is 'active' go into Appearance > Menus-create your 3 menus-assign each one to their designated menu location-and populate each with some menu items.

Active theme header.php:

wp_nav_menu(array('theme_location' => 'active-menu-location'));

Handheld theme header.php

wp_nav_menu(array('theme_location' => 'handheld-menu-location'));

Tablet theme header.php

wp_nav_menu(array('theme_location' => 'tablet-menu-location'));

That's it-the important part is that you register each location in each theme!

Place the same register_sidebar() function in each theme's functions.php file, and add your widgets to your sidebar while the primary theme is 'active'.

Place the same 3 register_sidebar() functions in each theme's functions.php file, and add your widgets to each sidebar while the primary theme is 'active'. E.g:

register_sidebar(array('name' => 'Active Theme Sidebar'));
register_sidebar(array('name' => 'Handheld Theme Sidebar'));
register_sidebar(array('name' => 'Tablet Theme Sidebar'));

Active theme page.php:

dynamic_sidebar('Active Theme Sidebar');

Handheld theme page.php

dynamic_sidebar('Handheld Theme Sidebar');

Tablet theme page.php

dynamic_sidebar('Tablet Theme Sidebar');

• Version 2.9.2 - Released 12/19/2013

  • HOTFIX - Completely removed the use of a singleton base class. It just doesn't work for PHP <= 5.2 which we still have to support unfortunately.

• Version 2.9.1 - Released 12/18/2014

  • HOTFIX - Removed use of Late Static Binding which is a PHP 5.3 feature, though WordPress supports back to PHP 5.2.4. Thank you Craig S. for pointing this out!

• Version 2.9.0 - Released 12/18/2014

  • IMPROVRMENT - Rewrites/Modifications throughout the plugin code to improve overall stability, maintainability, and adherence to WordPress Coding Standards.
  • IMPROVEMENT - Rewrote the updating routine to be far more stable, logical, and to allow 3 digit version numbers (ex: 2.9.0).
  • IMPROVEMENT - Added initial .pot for i18n. Users can now provide translations via .po files by using the .pot.
  • FIX - Corrected an issue reported by QStudio (https://wordpress.org/support/topic/small-bug-in-28?replies=2#post-6238900) whereby the plugin update routine would fail and run on each page load. Ouch.

• Version 2.8 - Released 5/18/2014

  • FIX - Removed an empty space (whitespace) preceding <?php which caused numerous issues for people by PHP throwing PHP Warning: Cannot modify header information - headers already sent by (output started at /my-home/wp-content/plugins/device-theme-switcher/inc/class.switcher.php:1) in /my-home/wp-content/plugins/device-theme-switcher/inc/class.switcher.php on line 176 -- thanks @jontroth

• Version 2.7 - Released 05/11/2014

  • IMPROVEMENT - Ensure the ?theme= GET variables added to each link via DTS_Switcher::build_html_link() preserve the existing GET variables already in place.
  • FIX - An issue where the DTS Widgets would produce a PHP Warning

• Version 2.6 - Released 05/8/2014

  • FIX - An issue where the 2.4php update script wouldn't load properly on some setups

• Version 2.5 - Released 05/7/2014

  • FIX - An issue where dts_cookie_name would not be set properly on update

• Version 2.4 - Released 05/7/2014

  • IMPROVEMENT - Replaced the use of PHP Sessions with Cookies (This is gonna fix a lot of past issues!)
  • IMPROVEMENT - Refactored all plugin code to contain proper Docblock commenting and be more legible
  • FIX - Corrected an issue where X UA Device fallback was handheld, not active. Thanks @Dachande663!
  • FIX - Corrected an issue where DTS_Switcher would not execute during an ajax request to admin_ajax. Thanks Ray @ qStudio!
  • REMOVAL - Removed the Dashboard Right Now DTS Output, it wasn't that cool to begin with..

• Version 2.3 - Released 09/16/2013

  • FIX - Corrected an issue which caused a PHP error to be thrown under odd conditions. Thanks Davis Wuolle!

• Version 2.2 - Released 08/28/2012

  • FIX - Corrected an issue which caused folks running WordPress Version Pre 3.4 to not see themes in the admin theme select lists. Thanks jstroem for 346b5ec (https://github.com/jstroem/device-theme-switcher/commit/346b5ec1582539b621ef4583153a7dbc6c9423b9)

• Version 2.1 - Released 08/26/2013

  • FIX - Corrected an issue (http://wordpress.org/support/topic/version-20-compatibilities-problems-with-jonradio-multiple-themes) where plugins which modify pre_option_template or pre_option_stylesheet would be overridden by Device Theme Switcher. Thanks EmuZone for pointing this out!
  • FIX - Corrected an issue with the Admin Dashboard 'Right Now' to properly display the active device themes.

• Version 2.0 - Released 08/24/2013

  • Complete code rewrites to improve overall performance, redundancy, and improve extensibility.
  • NEW - DTS Class access for use in themes; obtain info on the current user's device and saved dts settings. Examples in the FAQ.
  • NEW - URL Switching - Easily check what other devices see. Examples in the FAQ.
  • NEW - Session Timeout, so users who visit the 'Desktop' theme are bumped back to their device theme after 15 minutes
  • NEW - Optional Settings section in the WordPress admin in Appearance > Device Themes Allows users to override the session timeout. Also moved the low-support theme setting to this section. This new section also a
  • NEW - Help & Support section in the WordPress admin in Appearance > Device Themes
  • Included the latest version of MobileESP ~ Thanks Anthony!!

• Version 1.9

  • Note: DTS Version 1.9 was not released to the public
  • NEW - Made the Admin UI more presentable and WordPressy
  • FIX - Included a pull request from Tim Broder (https://github.com/broderboy) which adds support for Varnish Device Detect (https://github.com/varnish/varnish-devicedetect). Thanks Tim!!

• Version 1.8

  • Updated the Kindle detection for a wider range of support

• Version 1.7

  • Updated the plugin to provide backwards compatible support for WordPress < v3.4 (Pre the new Themes API)
  • Added a 3rd theme selection option for older/non-compliant devices, so theme authors can also supply a text-only version to those devices if they like.
  • Revised some language in the plugin readme file

• Version 1.6

  • Updated the plugin to use the new Theme API within WordPress 3.4
  • Updated MobileESP Library to the latest verion (April 23, 2012) which adds support for BlackBerry Curve Touch, e-Ink Kindle, and Kindle Fire in Silk mode. And fixed many other bugs.
  • Updated the Device Theme Switcher widgets so they only display to the devices they should, e.g. The 'View Full Website' widget will only display in the handheld theme.
  • Revised readme language and added a WordPress Plugin Repository banner graphic.

• Version 1.5

  • Modified the way themes are deliveried so the process is more stable for users with odd WordPress setups, by detecting where their theme folders are located instead of assuming wp-content/themes

• Version 1.4

  • Updated to the latest version of the MobileESP library which now detects some newer phones like the BlackBerry Bold Touch (9900 and 9930)

• Version 1.3

  • Changed the admin page to submit to admin_url() for those who have changed /wp-admin/
  • Added a warning suppresor to session_start() in case another plugin has already called it
  • Updated language in the WordPress readme file

• Version 1.2

  • Added the handheld and tablet theme choices to the WordPress Dashboard Right Now panel
  • Update both GitHub and WordPress readme files to be better styled and versed
  • Added two wigets for users to put in their themes
  • Coding and efficiency improvements

• Version 1.1

  • Bug fixes
  • Efficiency improvements

• Version 1.0

  • First Public Stable Release

This plugin is powered by the MobileESP PHP library created by Anthony Hand.

This plugin is based on the concepts provided by Jonas Vorwerk's Mobile theme switcher plugin , and Jeremy Arntz's Mobile Theme Switcher plugin.

Copyright (C) 2014 James Mehorter