Configuring cache plugins for WPtouch

Additional Caching Options (such as the Power Pack extension) are available for WPtouch Pro, as is professional support to assist you with any caching or performance issues you may have. If you are interested in finding out more about WPtouch Pro or purchasing a professional support license, please visit WPtouch.com.

Caching software is used to improve the performance of your website. Unless the caching software has been specifically developed for use with mobile devices, it may override WPtouch Pro and give the appearance that your mobile theme is not functioning. You may see:

Cached posts and pages using your desktop theme on mobile devices, and/or
Cached posts and pages using your mobile theme on desktop devices.
Inconsistency of theme when your site is refreshed.
The switch link to switch to the desktop theme and back to the mobile theme may not work correctly.

Fortunately, most caching plugins and services may be optimized for mobile use by disabling caching when mobile devices are detected.

WPtouch Pro's Power Pack extension may be used in conjunction with other caching plugins or may be used as a replacement for traditional caching plugins. When using a separate caching plugin, disable the setting to “Create cache for desktop users” in Power Pack. Be sure to follow these setup guidelines for best performance of your caching plugin.

Hummingbird

In Hummingbird's settings, disable mobile caching under the caching settings area.

W3 Total Cache

The following instructions should be performed in the W3 Total Cache settings pages.

If “Browser Cache” enabled, disable "Set expires header" in the Browser Cache settings to prevent desktop/mobile switch link issues.
Add the list of user agents below to the "Rejected User Agents" area of the Page Cache, Minify, and CDN settings.
If you have added support for additional mobile devices in WPtouch Pro’s Settings > Devices > Additional User Agents field, you must also include those user agents in the “Rejected User Agents” area in W3 Total Cache.
Save the changes.
Go to the W3 Total Cache “Dashboard” and select “Empty All Caches”.
Ensure that W3 Total Cache is selected in the plugins list in the Settings > Site Compatibility > Active Plugins section of the WPtouch Pro admin panel. (Pro only, enabled by default in WPtouch (free))

iPhone
iPod
Android
BB10
BlackBerry
webOS
IEMobile/7.0
IEMobile/9.0
IEMobile/10.0
MSIE 10.0
iPad
PlayBook
Xoom 
P160U
SCH-I800
Nexus 7
Touch

WP Super Cache

Note: In some scenarios, WP Super Cache seems to ignore the settings for rejected user agents. If you're seeing caching issues after configuring WP Super Cache to ignore the user agent list, give W3 Total Cache or Power Pack a try. Power Pack automatically caches the mobile and desktop pages separately. There's no need to add user agents to an exclusion list. Simply, toggle desktop caching to On after activating the extension.

In the Advanced tab of the WP Super Cache settings select “Mobile Device Support”* and click “Update Status”.
Still in the Advanced tab, scroll down to the “Rejected User Agents” area. Paste the entire list of mobile user agents found below and click “Save UA Strings”.
If you have added support for additional mobile devices in WPtouch Pro’s Settings > Devices > Additional User Agents field, you must also include those user agents in the “Rejected User Agents” area in WP Super Cache.
In the “Contents” tab, click “Delete Expired” and “Delete Cached” to delete pages that were likely cached before adding the new list of rejected user agents.
Ensure that WP Super Cache is selected in the plugins list in the Settings > Site Compatibility > Active Plugins section of the WPtouch Pro admin panel. (Pro only, enabled by default in WPtouch (free))
The native support for the free version of WPtouch found in WP Super Cache (under the “Plugins” tab) must be disabled to prevent conflicts in WPtouch Pro. (Pro only)

iPhone
iPod
Android
BB10
BlackBerry
webOS
IEMobile/7.0
IEMobile/9.0
IEMobile/10.0
MSIE 10.0
iPad
PlayBook
Xoom 
P160U
SCH-I800
Nexus 7
Touch

LiteSpeed Cache

When using the LiteSpeed Cache on your WPtouch-powered website, configuring it to play nicely with WPtouch is very easy. Please follow the steps below.

Go to the LiteSpeed Cache plugin's settings page
Click on the "Cache" tab
Enable the "Cache Mobile" settings
Purge LiteSpeed Cache's cache

Wordfence

Note: These settings only apply for older versions of Wordfence. Newer versions of WordFence (6.2.8+) no longer offer caching, and so no extra configuration is needed to have Wordfence work alongside WPtouch!

Go to the “Performance Setup” in the Wordfence settings and select “User-Agent Contains”. Enter the user agents in the user agent list found below one at a time.
Then, select “Cookie Name Contains”, enter "wptouch_switch_toggle" (without quotes) and click the "Add Exclusion" button
Ensure that Wordfence is selected in the plugins list in the Settings > Site Compatibility > Active Plugins section of the WPtouch Pro admin panel. (Pro only, enabled by default in WPtouch (free))
Click on the "Clear the Cache" button to remove any previously cached files.

iPhone
iPod
Android
BB10
BlackBerry
webOS
IEMobile/7.0
IEMobile/9.0
IEMobile/10.0
MSIE 10.0
iPad
PlayBook
Xoom 
P160U
SCH-I800
Nexus 7
Touch

WP Rocket

In the "Basic Options" of WP Rocket's settings page, make sure "Enable caching for mobile devices." is deselected.
In the "Advanced Options" section of the WP Rocket settings, add the user agent list below to the "Never send cache pages for these user agents". Save the changes and clear all caches.
Ensure that WP Rocket is selected in the plugins list in the Settings > Site Compatibility > Active Plugins section of the WPtouch Pro admin panel. (Pro only, enabled by default in WPtouch (free))

iPhone
iPod
Android
BB10
BlackBerry
webOS
IEMobile/7.0
IEMobile/9.0
IEMobile/10.0
MSIE 10.0
iPad
PlayBook
Xoom
P160U
SCH-I800
Nexus 7
Touch

WP Rocket

Devices can be excluded from the cache in WP Rocket. The following steps can be used to do so:

Go to the Advanced Rules tab in WP Rocket.
Find the field labeled “Never cache (user agents)" and add the following list:

iPad
NexusTablet
SamsungTablet
HPTablet
AsusTablet
BlackBerryTablet
HTCtablet
MotorolaTablet
AcerTablet
ToshibaTablet
LGTablet
FujitsuTablet
LenovoTablet
DellTablet
SonyTablet
PhilipsTablet
HuaweiTablet

Hyper Cache

In the "Bypasses" tab, select "Devices (user agents) to bypass"
Add the user agent list below.
Click the "Clean the whole cache" button to remove any previously cached files
Ensure that HyperCache is selected in the plugins list in the Settings > Site Compatibility > Active Plugins section of the WPtouch Pro admin panel. (Pro only, enabled by default in WPtouch (free))

iPhone
iPod
Android
BB10
BlackBerry
webOS
IEMobile/7.0
IEMobile/9.0
IEMobile/10.0
MSIE 10.0
iPad
PlayBook
Xoom 
P160U
SCH-I800
Nexus 7
Touch

Quick Cache Pro (ZenCache)

In the Quick Cache Pro options, expand “User-Agent Exclusion Patterns” and enter the list of mobile user agents found below and click the Save Changes button.
Click on the "Clear" button in the top right of the Quick Cache Pro settings page.
Ensure that Quick Cache (Pro) is selected in the plugins list in the Settings > Site Compatibility > Active Plugins section of the WPtouch Pro admin panel. (Pro only, enabled by default in WPtouch (free))

iPhone
iPod
Android
BB10
BlackBerry
webOS
IEMobile/7.0
IEMobile/9.0
IEMobile/10.0
MSIE 10.0
iPad
PlayBook
Xoom 
P160U
SCH-I800
Nexus 7
Touch

WP Simple Cache / WP Green Cache

This plugin is not in active development and does not include options to exclude user agents. Please use a cache plugin in active development.

WPEngine

Please contact WPEngine's support team and ask them to exclude the user agents found below.

iPhone
iPod
Android
BB10
BlackBerry
webOS
IEMobile/7.0
IEMobile/9.0
IEMobile/10.0
MSIE 10.0
iPad
PlayBook
Xoom 
P160U
SCH-I800
Nexus 7
Touch

Autoptimize

Enable the Advanced settings in Autoptimize.
Add webapp.js in the “Exclude scripts from Autoptimize” field
Click the “Save changes and Empty Cache” button
Ensure that Autoptimize is selected in the plugins list in the Compatibility section of the WPtouch Pro admin panel. (Pro only, enabled by default in WPtouch (free))

Sucuri

The latest version of the Sucuri Scanner plugin no longer includes caching functionality.

Comet Cache

In Comet Cache's settings, scroll down and expand the "User-Agent Exclusion Patterns".

In the text box, paste in the following list of user agents. There should be one per line.

iPhone
iPod
Android
BB10
BlackBerry
webOS
IEMobile/7.0
IEMobile/9.0
IEMobile/10.0
MSIE 10.0
iPad
PlayBook
Xoom
P160U
SCH-I800
Nexus 7
Touch

At the bottom of the page, click on "Save All Changes".
At the top of the page, click on the "Clear" button to wipe all old caches.

WP Fastest Cache

In WP Fastest Cache's settings, check-off the option "Don't show the cached version for desktop to mobile devices".
At the bottom, click the Submit button to save the changes.
Click on the "Exclude" tab and find the "Exclude User-Agents" section.
Click the "Add New Rule" button and add the list of user agents below, one at a time.

In the top menu-bar, hover over WPFC and then click on Delete Cache.

iPhone
iPod
Android
BB10
BlackBerry
webOS
IEMobile/7.0
IEMobile/9.0
IEMobile/10.0
MSIE 10.0
iPad
PlayBook
Xoom 
P160U
SCH-I800
Nexus 7
Touch

Other Caching Plugins or Services

In general, caching may be disabled for mobile devices by instructing the plugin or service not to cache pages nor serve cached pages when devices on the WPtouch Pro list of mobile user agents are encountered. If there is no “rejected user agents” area or similar, contact the plugin’s developer or the service’s support department for assistance.

If you have added additional mobile user agents to WPtouch Pro, be sure to include those when optimizing for mobile use.