What Is WPtouch?

More than just a plugin, WPtouch^TM is a mobile theme for your WordPress website. Modelled after Apple’s app store design specs, WPtouch loads lightning fast and shows your content beautifully, without interfering with your regular site theme.

WPtouch automatically transforms your WordPress blog into a web-application experience when viewed from an iPhone^TM, iPod touch^TM, Android^TM, or BlackBerry Storm^TM touch mobile device.

How Does It Work?

It detects the user agents of these devices and serves up its custom theme to those visitors only. You can add additional user agents if you choose in the admin panel.

I thought the iPhone/iPod touch/Android shows my
website just fine the way it is now?

Not all websites are created equal, with some sites failing to translate well in the viewport of a small mobile device. Sidebars, smaller text, and certain types of content won’t render or do so poorly.

Many WordPress sites today make heavy use of javascript files, image-heavy sidebars and so forth, which increase page load times, driving your visitors on 3G/EDGE batty.

So that’s why a solution like WPtouch makes sense— a lightweight, fast-loading, feature-rich and highly-customized “theme application” to deliver your content.

Trimmed Down, But With All The Trimmings

Though extremely lightweight & optimized for mobile devices, WPtouch still comes complete with all the standard WordPress website features: search, login, categories, tags, archives, photos, thumbnails & more. WPtouch also offers many additional customization features through a beautifully designed WordPress admin panel.

How Do I Set It Up?

WPtouch can be easily installed through your self-hosted WordPress admin, or easily uploaded to your server. Check out the Gallery tab to preview the appearance of both a WPtouch-enabled website and the admin interface, or visit the Installation tab for details on getting WPtouch installed, activated and configured on your website.

Load Time Comparisons

BraveNewCode.com blog regular theme on an iPhone 3G:

BraveNewCode.com blog on an iPhone 3G with WPtouch:

a. Each load was done with an iPhone 3G running 3.1.2 software
b. Full signal bars for each network
c. Reflects load-time average of 3 consecutive loads for each network speed
d. mobileSafari’s cache and history were dumped for each load
e. BraveNewCode.com is a well-optimized site (minified javascript & css), most sites are not as optimized

Requirements

While WPtouch was designed to work in concert with other plugins, handle WordPress updates easily and make a very small footprint on your server, it does have a few requirements which you should be sure you meet before installing WPtouch.

Minimum Requirements

• Self-hosted WordPress or WordPress MU installation
• WordPress 2.7 or WordPress MU 2.8.6 or higher
• WordPress Administrative account access
• PHP 4/5

Recommended

• WordPress 2.9+ or WordPress MU 2.9+
• PHP 5

Plugin Compatibility

WPtouch is compatible with a wide variety of plugins, but does not work or requires additional configuration to work with others. We’ll be providing a list of known issues and incompatibilities here on the website in the future.

WPtouch Features

• Small Theme, Big WordPress Support

  Though WPtouch is less than 500kb as a theme, it supports great WordPress features like pages, categories, tags, search, comments and more.

• Socially Aware

  WPtouch supports some common social networking plugins, but also bundles its own support for Twitter, social bookmarking sites, and e-mailing a post.

• Re-Formats Automagically

  WPtouch takes care of scaling photos, handling post and page styling all by itself— no extra code required.

• Post Thumbnails

  With WordPress 2.9 and WPtouch 1.9.7+, you can show your post thumbnails in the main view of WPtouch easily. WPtouch also supports a couple of other popular ways to use post thumbnails.

• jQuery & Ajax Effects

  WPtouch includes sprinkles of jQuery visual effects, Ajax loading of entries and posting of comments to reduce server load and elevate the mobile experience of your website.

• Top Notch

  Many plugins while useful have unruly, ugly admin panels. WPtouch features an intuitive, polished admin panel as gorgeous as its theme.

• Basic + Advanced

  The WPtouch admin offers many basic features you’d expect from a mobile theme plugin, but also includes more advanced, user-requested features which take control to a whole new level.

• Plugin Support & Compatibility

  The WPtouch admin also includes a pane which displays information about how to access extra features and also information on 3rd party plugin issues.

• Custom Icons

  Easily upload and use your own custom icons, all of which survive plugin upgrades automatically. Set your bookmark icon, logo, and more.

• WordTwit, GigPress Support

  With zero configuration, WPtouch now integrates tweets from Twitter if you have WordTwit, and your upcoming shows if you have GigPress installed.

…And Much More!

Checkout the Gallery to see some of WPtouch’s great features in action.

WPtouch Gallery

WPtouch Theme Features

•   Main View

  The main view of WPtouch, showing the post thumbnails option.

•   Drop-Down Menu

  The WPtouch drop-down menu is fully customizable in the WPtouch admin settings.

•   Account Login

  WPtouch supports user account login and registration, easily handling account-based WordPress setups.

•   Search

  Full WordPress search is built-in, allowing visitors to easily find what they're looking for.

•   Keep Loading More

  WPtouch loads more posts inline using Ajax, in an iPhone application-like experience.

•   Formatted Posts

  Post images and other content are scaled and handled automatically on touch mobile devices, no user configuration required.

•   Discussion

  Discussion in WPtouch is sleek, minimal, and functional.

•   Mail It

  Users can easily send native e-mail with the title and a link to the post they're reading.

•   Tweet It

  WPtouch supports popular Twitter apps on iPhone & iPod touch + links to mobile twitter on other touch mobile devices.

•   Bookmark It

  WPtouch supports popular bookmarking services.

•   Leaving a Comment

  WPtouch allows for easy commenting w/ Ajax in real time for the user.

•   Archives Support

  WPtouch handles WordPress archives natively.

•  

WPtouch Admin Features

•   Admin Top

  The WPtouch admin panel is one of the most comprehensive, sleek and refined admin interfaces for a WordPress plugin, ever.

•   Advanced Options

  Advanced options allow you to manage and control key mobile features.

•   Style & Color Options

  WPtouch includes several style options. Setup your link color, your font types, headerbar styling, and more.

•   Page Icon Pool

  WPtouch allows for many customizations with pages & icons to add style and character to your mobile site.

•   Help Overlays

  Red question marks link to helpful overlays which detail a setting or option.

•   Adsense, Stats & More

  Adsense, Stats, Custom Code, Plugin Support & Compatibility.

•  

Introduction

Though technically a plugin, WPtouch is a theme when it’s activated on your WordPress website. We chose to have WPtouch as a plugin because it offers us (and you!) far more flexibility in terms of options and features.

Browse below to find out more about installing and using WPtouch.

Getting Started

Before you begin make sure you have a current backup of your WordPress installation and your database. If you’re new to a WordPress backup, you can read this step-by-step guide from WordPress.org. It’s highly unlikely anything will go wrong, but you can always be sure that it won’t matter by backing up… right?

You should also make sure that your WordPress/MU installation is up to date, and that you’re not having any other issues prior to installing/upgrading WPtouch. This will help you identify and solve any issues post-install.

Upgrading

WordPress Admin Method:

To upgrade from within WordPress (2.7 or higher) simply click on the “upgrade automatically” link on the WordPress plugin admin page (wp-admin/plugins). The new update will be downloaded and installed automatically for you. Your admin configuration settings will remain unchanged.

Please check the Changelog for any new features which may have added settings in the admin panel which you might need to set or configure in order to use.

Zip File Upload Method:

If you’re upgrading from a previous version, you can upload the latest version and your settings and icons will remain the same. You can upload and install a .zip file in WordPress easily.

Installing For The First Time

If you’re installing WPtouch for the first time, there are two ways to go about it, which method you choose depends on whether you have access to automatically upgrade a plugin or not.

Search and Install Method

As of WordPress 2.7 plugins can now be installed directly from the admin, without having to be uploaded manually to an FTP server. To install a plugin for the first time in the WordPress admin is also very easy and straightforward.

To begin click on the ‘Add New’ link under the Plugins heading in your WordPress administration panel menu.

On the Add New page you’ll see an input field. Simply enter ‘WPtouch’ into the field, and click the the ‘Search Plugins’ button beside it.

Next you’ll see the Search Results Page. The first result should be WPtouch. Click on the ‘Install’ link on the far right side of the description of WPtouch, and an overlay will appear.

The overlay provides more detail about the plugin, including some of the information which we also provide here on the website such as the Changelog. Click the Install Now button to begin the installation download. WordPress will automatically download the plugin .zip file, and WPtouch will be installed in your plugins directory automatically.

.Zip Upload Method

First make sure you’ve downloaded the latest version of WPtouch from our website, and know where you’ve saved it on your computer. Next click on the Add New link under the Plugins heading in your WordPress administration panel menu. You can upload and install a .zip file in WordPress easily by choosing the Upload link from the Add New page’s top menu. Next, select the button to upload a .zip file, and choose the location of the WPtouch .zip file on your computer. WPtouch will be uploaded and installed in your plugins directory automatically.

Activation

WPtouch will work ‘out-of-the-box’ once being activated, without any additional configuration, using its default settings.

There are however many configurable options available in the WPtouch admin panel, located in the Settings->WPtouch page.

WPtouch Admin Panel

The WPtouch admin panel is laid out in vertical blocks which break down the plugins configurable options into sections. This is true of all BraveNewCode plugins.

Each section contains options related to different types of functionality, i.e. Style & Color, Pages & Logo Icons etc. Explore the panels and options to determine which settings apply to your installation preferences.

Visit the Gallery page for screenshots of the admin panel in action.

Accessing More Info

We’ve labelled most settings so that they are self-explanatory, but where a setting might offer additional info you’ll see a red question mark (?). Clicking on the question mark opens a window which explains the feature in greater detail.

Saving and Reset

At the bottom of the admin panel you’ll see two buttons, one for saving settings and one for resetting them. The Save Settings button when pressed will save the current configuration options to your database, and the settings will persist even if you disable the plugin and re-activate it, or upgrade it.

The Reset Settings button will restore the default configuration of the plugin. This can be helpful in troubleshooting or if you wish to start over is setting up the plugin.

Visit the Support page for additional help and information regarding setup and installation.

WPtouch Changelog

The following is a list of the various changes for each WPtouch release.

Version 1.9.9.7

Fixed BraveNewCode RSS feed links (may have caused issues for some)

Fixed more GigPress CSS issues

Added option to choose flat bookmark icon

Version 1.9.9.6

Fix case where missing CURL would stop admin settings from loading

Minor Ajax upload fix

Minor spelling fixes

Version 1.9.9.5

Made changes to the way ajax uploads are handled

Updated and fixed JS error in ajax_upload.js file

Fixed more GigPress CSS issues

Removed replace class javascript for page & post images and caption areas (still needs work)

Only loading the ajax commens js on the single post pages now

Version 1.9.9.4

Updated and edited admin verbiage

Added remove action for Google Libraries plugin (for compatibility)

Added remove action for GigPress CSS

Fixed broken GigPress drop down, added new styling

Changed javascript handlers

Misc tweaks and fixes

Version 1.9.9.3

Theme CSS fixes and revisions

Updated outdated links in the admin panel

Updated outdated text in the admin panel

Re-validated admin XHTML with W3C

Fixed User Agent strings which caused browsers to show WPtouch

Version 1.9.9.2

Updated user agents for Opera Mini and Palm Pre ('mini' and 'pre')

Removed orphaned code relating to ajax comments option

Changed date/time parsing for WordTwit integration

Update to WordTwit 2.3.3 if you see incorrect date/times

Version 1.9.9.1

Bug fix for array warning issue on some installations

Version 1.9.9

Added HTML5 types for comment url and email (devices capable now show unique keyboard layouts for these inputs)

Added and refined jQuery code, effects

Revised post/page image sizing auto-detection features

Changed the way Ajax comments work - will now work for everyone

Changed code for JS - return false;

Changed admin panel to stop using Ajax that would sometimes fail to load

Removed comments-ajax.php from theme (not needed anymore)

Removed ajax comments option from the admin (not needed anymore)

Removed obsolete code orphans from old code methods

Bug fixes

Version 1.9.8.3

Fixes an issue where post thumbnail selection would not be shown in the admin

Adds auto-detection for post and page images and captions (will now center align if above 150px)

Resolves an issue where save/reset settings would cause permissions error or fail

Resolves case where the upload path would not be found for custom-icons

Compatibility with WP 2.9.2

Version 1.9.8.2

Fixed broken thumbnail reflections on Android and other browsers. Now reflections only show for iPhone/iPod

Fixed issue where Tags & Categories links in the header may not show on some devices

Version 1.9.8.1

Added friendly display when there are no Twitter tweets available via WordTwit

Version 1.9.8

Fixed an undefined function error when commenting

Fixed case where post-thumbnails wouldn't work

Stopped GigPress CSS from loading in the header when it's not enabled

Fixed error where Icon Upload would fail in admin

Updated Ajax Upload script to v3.9

Version 1.9.7.7

Attempted fix for broken post thumbs reflections on Android. Now reflections only show for iPhone/iPod

Version 1.9.7.6

Minor administration changes

Updated readme to describe WordPress MU installation

Fixed an issue where thumbnails wouldn't show

Added support for thumbnails using James Lao's 'Simple Post Thumbnails' plugin

Changed functions.php check from version (2.9) to whether function exists (WP Security Scan bypass)

Added missing code to the theme's functions file for Post thumbs

Resolves an issue where blank spaces would appear, not Post Thumbs

Fix for broken switch links (missing images) on some installations when in regular theme view

Added detect for custom field key 'Thumbnail' to work first before using WP 2.9 Thumbs, for those who've been using this method already

Added Post Thumbnails View option (WordPress 2.9 only) for main post listings

Added option to show neither post thumbnails nor calendar icons

Added style option to choose the font of H2 elements on post listings, single entries and pages

Various style & code improvements and fixes

Version 1.9.6

Fixed php logic in adsense-new.php (thx JeanPaulH)

Added support for GigPress' Upcoming Shows to be a drop down in the header menu

Changed relative comments logic, added function for GMT detection

Adding padding, size to multipage links

Removed WP version from footer (security vulnerability)

Changed admin RSS feed from Support Topics to Twitter Topics

Updated admin settings image

Fixed cutoff tweets from WordTwit in the drop-down

Verified WP 2.9 compatibility

Version 1.9.5

Added Twitter updates menu item support for WordTwit's new features

Added CSS for TweetThis and AddThis plugins to be hidden

Added page/post title to HEAD for Tweet purposes

Added user agent detection for non-apple mobile devices to be served Twitter link correctly

Added 180-degree animation to post-arrow dropper and removed excess JS and code

Added new tab pane for the header (menu, tags, categories, account)

Added more theme compatibility for other touch devices

Added 'edit, delete, spam' links for admins on comments

Changed default OBJECT and EMBED css to only apply to .post, not site-wide

Changed comment ajax routine

Changed 'Links' appearance adding support for link categories, removed favicon scripts

Changed the way the header links are setup

Small refinements in the theme CSS all-around

Made progress towards reply and pagination in comments, not there yet

Versions 1.9.4.x

Fixed space appearing below title on single post pages

Added compressed js for the admin

Updated Fancybox script & files to v1.2.5

Updated Ajax Upload script to v3.6

Fix for re-direct issues introduced with 1.9.3.4

Fixes and changes for Adsense appearance

Fix for direct messages not working with WPtouch exclusive mode

Added spam check for Push direct messages via a nonce

Added verification for Prowl API key

Added ability to define custom user agents in the admin (go nuts!)

Minor admin styling changes

Dropped official support for WP 2.6 (sorry folks, you should update!)

Dropped 'skins' references, they'll be a part of WPtouch 2.0

Compressed style.css in theme for faster load times

Removed unused files

Versions 1.9.3.x

Fixed issues with adsense ads

Fixed time since code bug on comments

Fixed issue where comment count could read as 0 when there were no comments

Fix for width bug in some situations when switching themes

Fix for scenarios where a different uploads folder path or name is used

Minor admin refinements

Porting CSS styles to a global sheet applicable to all our plugins

Push messages now come from your blogname not 'wptouch'

Switch link now re-directs to the page the switch request came from, not back to home

Changed downloads admin area to support topics rss feed

Added additional icons in the admin

Fixed international languages display of time since on comments

Fixed logic with PUSH notification via Prowl

Removed unneeded files

Bug fixes

Style fixes for the display of comments

Fixed issue where regular theme view would not allow pinching for zoom

Fixed JS bug in theme

Possible fix for time since on comments not working in some situations

Added option to disable Ajax comments for those who can't get them working

Versions 1.9.2.x

Fixed issue where mobile switch to regular theme was always zoomed in and required refresh

Fixed issue where pages changed from published to unpublished still showed in the WPtouch menu

Fixed issue where 'Load More Entries' caused blank page or other issues. WPtouch now detect possible issues and defaults to pagination

WPtouch now loads minified versions of its CSS and JS for the theme, speeding up load times

Added check for wp-load.php before attempting ajax comments. Should fix WP comment posting issues. Working on better Disqus and Intense Debate support as well

Removed 'Find in this page' button, until bugs are resolved

Now WPtouch will not hide mobileSafari addressbar on single post pages on slower connections

Fixed bug where WPtouch admin would report that CURL wasn't installed even if it was

Version 1.9.1

Fixed bug for admin panel Ajax not working in some situations

Adsense re-enabled

Fixed bug where SPAM comments were pushed via Prowl

Push Notification options now announces if Curl is not available, instead of not appearing at all

Removed text-size adjust option, now replaced with user-adjustable font sizes

Minor code corrections

Version 1.9

Fully compatible with WordPress 2.6 - 2.8.x

Major rewrites of theme files, css for simplicity, CoreTheme

Adsense has been temporarily disabled until we update code for new Google API changes

Added experimental support for Opera Mini & Palm Pre mobile browsers

Added filter trackbacks and pingbacks from display in comment counts

Added friendly 'noscript' display bezel for users with javascript Turned off

Added support for Prowl Push notifications for comments, user registrations, and direct messages (if Curl exists on the server)

Added ability to exclude categories

Added native select for Tags

Added theme switch confirm message, saves a cookie to not repeat

Added jQuery color picker in admin hex areas for easy selections

Added link to online icon generator in admin

Added style declaration for images in comments

Added 'My Account' button in the sub//header for logged in users replacing Logout

Added theme skin selection support, still no other skins enabled yet

Added post-options bar on single post page

Added new background selections

Updated plugin compatibility listing now loads from bravenewcode.com

Updated style for comments, working on full support for WP 2.7 comments, Intense Debate

Updated success message for ajax comments

Updated font zoom replaced by font-size adjust button

Updated ajax upload script to v3.1

Updated fancybox to compressed v1.2.1

Updated Ajax Upload script to 3.2

Updated compatibility code (Various WordPress install scenarios) ~ thanks to Will Norris for the suggestions

Updated a check if comments are open before showing the comments link

Updated local jquery in exclusive mode to use WP, not Google

Updated admin style and design

Updated search now floats overtop the headerbar

Updated the_content_rss() for excerpts, created a custom function which handles it nicely

Updated several images in the core images folder, building more dependency on CoreTheme

Removed support for WordPress 2.3, lowest known WordPress version supported: 2.6

Removed 404 image with English text in it, replaced it with localized 404 text

Removed depreciated or unused functions from previous releases

Removed ability to disable jQuery; WPtouch Exclusive mode should fix JS issues

Fixed home link in menu drop down now respects the logo/bookmark icon choice

Fixed WP Spam Free users having had new comments blocked

Fixed WPtouch appearing zoomed out and wide

Fixed custom page icons not showing up on pages

Fixed some domains not showing the beta download/news areas

Fixed style issue for icons on pages

Fixed the way javascript is called for a elements, should work better in other mobile browsers

Fixed switch link issue where regular theme switch link was broken

Fixed issue where chosen pages and icons did not appear in the drop down

Fixed a variety of scenarios where paths to files and images were broken

Fixed a few areas that had text not yet localized, improperly coded

More preparation for languages support

Preparation for WPtouch 2.0 and themes support (based on CoreTheme)

Other minor optimizations, fixes, changes

Version 1.8.9.1

Fixed refresh issue (some pages keep re-loading)

Fixed mkdir issue on PHP4 installations

Set viewport to fixed width for device to prevent some sites from loading wide

Minor revisions to new CSS calendar icon styling

Added exclusive mode feature to help in situations where other plugins are incompatible, load too many scripts/css files and both break and slow down WPtouch

Added Fancybox for some feature descriptions in the admin

Versions 1.8.x

Changed calendar icons from images to CSS-based only (they look sexay!)

Refined styling of header logo, text shadow, general appearance

Removed unneeded declarations from the WPtouch stylesheet

Tested and works efficiently with WordPress MU when installed site-wide (Finally!)

Disqus commenting plugins out-of-the-box styling enhancements

Changed post nav on the single post page to prev/next post, instead of entry titles for length's sake

Fixed bug related to RSS feeds being broken in some situations

Fixed fatal error on line 153 undefined 'is_front_page' function for WP 2.3.x users

Fixed jQuery failing to load for WP 2.3.x users

Added option for font-zoom on rotate for accessibility, on by default

Fixed various styling bugs

Changed switch link in WPtouch to remain fixed width

Fixed various content overflow issues in WPtouch theme files

As a note for WordPress 2.3 users, WPtouch 1.9 will require WordPress 2.5+

Fixed new switch link to work under different WordPress install scenarios

Fixed switch link CSS style-sheet loading issues in some situations

Fixed missing mime types for icon upload through IE7

Fixed issues related to automatic favicon generation on a Links page

Changed footer switch links to mimic iPhone settings app appearance

Fixed misc scenarios for ajax-upload errors

Fixed path issues related to custom icons (sites on windows servers)

Fixed issues related to ajax comments not working in some situations

Added check for 'Allow Comments' on pages

Fixed Apache error (reported in logs)

Fixed admin styling issues on IE7, Firefox

Fixed issue with custom icons and the header logo

Fixed issue with the Classic background not appearing

Significant rewrite of core code for increased efficiency

Changed database calls to use wpdb object, will hopefully work with wpmu

Internationalization preparation of the admin and theme files (for WPtouch 1.9)

Added ability to add/delete custom icons that survive WPtouch & WordPress upgrades

Added ability to select left/full text justification, 3 font sizes

Changed how WPtouch admin panel shows icons, more room for custom icons

Added channel capability for Adsense

Now suppresses banners created by the Ribbon Manger Plugin

Minor tweaks to login, register, admin links, footer appearance

Minor tweaks to drop down menus, header styling

More refinements for search, categories & tag pages, 'load more' link

Text & code refinements in the WPtouch admin

Experimental support for the Blackberry Storm

Fixed issue with WPtouch header title display issue

Fixed issue related to login/logout/admin/register link path issues

Fixed issue where Bookmarks link when Advanced JS is turned off

Fixed issue with default icon case

Fixed issue with switch code on systems with PHP4

Fixed issue related to fresh installs

Fixed issue with Android and the sub-header menu links not working

Versions 1.7.x

Added option to do GZIP compression

Suppressed warning about multiple gzhandlers

Fixed user agent detection code

Added ability to choose if WPtouch or regular version of your site is shown first

Fixed WP login/out button bugs

Added login/out auto-detect for WP 2.7 or pre-WP 2.7 sites

Fixed loading path issue that caused drop-down menu button to fail

Added choice between alphabetical or page order sorting of the drop down menu

Added clock icon

Fixes for categories drop-down menu (now shows post #'s)

Minor fix for categories drop-down menu

Automatic detection & support for Peter's anti-spam plugin

Built-in support for Adsense in posts

Moved Stats tracking box beside Advertising Options

Better WordPress version support detection

More refined image auto-sizing with WP added images & galleries in posts / pages

Fix for WordPress shortcodes appearing in excerpts

Changed how WPtouch shows switch links

Auto-adjusting width/height for MobileSafari plugin objects (YouTube, Quicktime)

Versions 1.6.x

Auto-resizing images in posts/pages on orientation change!

Auto-resizing WP image galleries

Better support for captions on images, gallery items

Added the ability to enable a quick login button w/ drop-down in the WPtouch header

Added the ability to enable categories as a drop-down item in the WPtouch header

Added the ability to disable WPtouch automatic homepage redirection (resolves white page issue)

Added the ability to manually select a re-direct landing page

Refinements in WPtouch admin

Enhanced support for WordPress 2.7 admin

Re-designed post comment bubble icon

Input box to inject custom code (Google Analytics, MINT, etc) into WPtouch

Basic support for Incognito & WebMate browsers on iPhone & iPod touch

Other code fixes, cleanups & optimizations

Other theme style cleanups and enhancements

Versions 1.5.x

Added support for WordPress image galleries

Added support for single post page split navigation

Fixed admin footer links which did not locate WordPress install correctly

Added basic Google Android support

Changes in WPtouch admin appearance and styling

Added donate message in WPtouch admin

WPtouch now supports WordPress 2.3 or higher

Versions 1.4.x

More jQuery tune-ups, now loads through wp_enqueue_script() or Google to prevent collisions

Changed $J to $wptouch to prevent collisions using jQuery

Offloaded jQuery loading from our folder to Google instead for WP > 2.5 sites

Fixed a bug in wptouch.php on line 232, fixing drop-down menu display issue

Fixed a bug where blank admin options were allowed instead of refused

Fixed a bug with overriding the site title in the WPtouch admin

Fixed some instances where ajax comments would not work

Fixed a bug where the loading of javascript files would load in your site's default theme

Enhanced drop-down menu appearance

More compatibility with other plugins

Code cleanups and optimizations

Versions 1.3.x

Tweaks for the jQuery bugs

No conflict setting added for jQuery

Support for DISQUS 2.0.2-x Plugin

Minor style edits and enhancements for the search dropdown

Another fix for drop-down Menu not working

Added ability to change the header border background color

Fix for slashes appearing before apostrophes in the header title

Admin wording changes, styling changes

Minor style enhancements to the theme

Fix for Menu not working on some installations

Style enhancements for the menu, search, drop downs

Style enhancements for comments, logged in users

Font adjustments for titles

Style changes for single post page heading, for better clarity

Admin wording changes

Versions 1.2.x

Fix for the theme appearing in Safari browsers

Switch from Prototype to the more WordPress-native jQuery for javascript (much faster!)

Fix for wrong re-directs happening unintentionally if you use a static home page

Elimination of unneeded images, javascript (shaving more than 100KB!)

More template file cleanups, image & code optimizations

The addition of more comments in code templates to help you make custom modifications

Option to enable comments on pages

Option to manually enter in a new blog title (fixes cases where the blog title runs the length of the header and wraps)

Option to hide/show excerpts by default on the home, search, and archive pages

Switch code links are automatically injected into your regular theme's footer now, and is only seen on the iPhone/ipod touch

In all, despite the addition of new features we've cut load times for WPtouch in half with this release over 1.2.x releases!

The ability to disable Gravatars in comments (more control over optimization & speed)

Redundant, unused template file cleanups (archive.php, search.php & page.php are now all just index.php)

More style enhancements and tweaks, fixes

Switched to Snoopy from CURL for the admin news section (thanks to Joost de Valk (yoast.com)

Version 1.1

The ability to disable advanced javascript effects (fixes effects not working for some, speeds up the load time considerably)

Proper styling of embedded YouTube videos on mobileSafari in iPhone 2.0

Fix for the switch code not working on some blog installations

Redundant, unused code cleanups

More style enhancements and tweaks, fixes

the ability to enable/disable the default home, rss and email menu items

support for WordPress installations that have static home pages

dynamic WPtouch news in the administration panel

the ability to modify the default hyperlink color

major CSS & PHP cleaning, resulting in reduced size and faster load times

the ability to enable/disable tags, categories and author names on the index, search and author pages

support for DISQUS commenting

CSS refinements for comments, the drop-down menu, and overall appearance

styling for YouTube embedded videos

bug fixes for blogs installed in directories other than root

Version 1.0

Initial release

Common Issues

Stylesheet Missing Error

Despite providing a mobile theme, WPtouch is a WordPress plugin, not a theme.

If you’re receiving a ‘Stylesheet Missing Error’ after installing WPtouch, you’ve likely installed it as a theme in wp-content/themes as opposed to wp-content/plugins.

Missing Footer Switch Link

If you click the mobile theme switch link in the footer of WPtouch and see your desktop theme without the same switch link at the bottom of the page, chances are that your desktop theme is missing a piece of WordPress code common (and usually used) by plugins to add things to the footer space in a website.

Simply add <?php wp_footer(); ?> just above </body> and </html> in your desktop theme’s footer.php file.

Seeing or Not Seeing WPtouch Infrequently

A hard issue to describe, but the issue usually presents itself as being able to see the WPtouch theme active on your website for some pages but not others. This is usually caused by not configuring your cache plugin to reject mobile user agents or to skip trying to cache mobile visits.

Check out our short video screencast tutorial on configuring the popular WP Super Cache plugin to work properly with WPtouch.

Support Forums

We’ve recently re-designed and overhauled our website, and the same for our forums.

Visit bravenewcode.com/support for assistance and our bug reporter tool (requires a BNCID account).