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.

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.


W3 Total Cache



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


  1. If “Browser Cache” enabled, disable "Set expires header" in the Browser Cache settings to prevent desktop/mobile switch link issues.
  2. Go to the “Page Cache” settings under the "Performance" tab.
  3. Copy the list of mobile user agents found in the list of user agents found below.
    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.
  4. Scroll down to the “Rejected User Agents” field and paste the list of WPtouch default user agents, adding one per line.
  5. Save your changes.
  6. Go to the “Minify” settings under the Performance tab.
  7. Scroll down to the “Rejected User Agents” field and paste the list of WPtouch default user agents, adding one per line.
  8. Save your changes.
  9. Go to the “CDN” settings under the Performance tab.
  10. Scroll down to the “Rejected User Agents” field and paste the list of WPtouch default user agents, adding one per line.
  11. Save your changes.
  12. Finally, go to the W3 Total Cache “Dashboard” and select “Empty All Caches”.
  13. 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 Infinity Cache a try. Infinity Cache 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.



 

  1. In the Advanced tab of the WP Super Cache settings select “Mobile Device Support”* and click “Update Status”.
     
  2. 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”.
     
  3. 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.
  4. 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.
  5. 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))
  6. 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

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!


  1. 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.
     
  2. Then, select “Cookie Name Contains”, enter "wptouch_switch_toggle" (without quotes) and click the "Add Exclusion" button
  3. 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)) 
  4. 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


 
  1. In the "Basic Options" of WP Rocket's settings page, make sure "Enable caching for mobile devices." is deselected.  
     
  2. 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.
  3. 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

 


Hyper Cache


  1. In the "Bypasses" tab, select "Devices (user agents) to bypass"
  2. Add the user agent list below.
  3. Click the "Clean the whole cache" button to remove any previously cached files
  4. 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)


  1. 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.
  2. Click on the "Clear" button in the top right of the Quick Cache Pro settings page.
     
  3. 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

  1. Enable the Advanced settings in Autoptimize.
  2. Add webapp.js in the “Exclude scripts from Autoptimize” field
  3. Click the “Save changes and Empty Cache” button
  4. 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

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

  2. 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
  3. At the bottom of the page, click on "Save All Changes".

  4. At the top of the page, click on the "Clear" button to wipe all old caches.



WP Fastest Cache

  1. In WP Fastest Cache's settings, check-off the option "Don't show the cached version for desktop to mobile devices".

  2. At the bottom, click the Submit button to save the changes.

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



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.

Still need help? Contact Us Contact Us