cross-screen marketing solutions

WordPress Mobile Plugin Install Guide and FAQ


As I needed to create a home page for my WordPress mobile plugin other than that at, I’ve created this post in order to fulfill both that need and provide a forum for people to comment and contribute.

The text is taken straight from the readme file, so if you’ve arrived here rather than the official page at WP, at least you can get the information you need! If you just want to download the plugin, here’s a direct link.

Wapple Architect Mobile plugin for WordPress

Requires at least: 2.0
Tested up to: 2.9.2
Stable tag: 3.4


Wapple Architect Mobile Plugin for WordPress is a plugin that allows you to mobilize your blog in minutes.

Every single mobile device is detected and all aspects of your blog are tailored to the visiting handset. Sites aren’t dumbed down to the lowest common denominator but instead use the features and functionality that advanced phones offer.

Devices are detected by using Wapple’s advanced web services instead of relying on inferior 3rd party tools. If you view your blog with a brand new, never before seen handset, it’ll still work perfectly!

Any theme you’ve installed and have styled for web will be carried across to mobile giving you a consistent look and feel for each and every one of your visitors.

Why it’s different to other plugins:

  • Other mobile plugins for WordPress use a default mobile style which results in an inconsistent experience for your users, Wapple Architect Mobile plugin for WordPress retains the styling of your site from web to mobile.
  • There’s no redirection to a mobile version of the blog – URLs are exactly the same on web and mobile giving you the ability to promote and use one single domain!
  • No transcoding happens here – the mobile version is written in WAPL (an advanced mobile markup language) that results in a completely tailored solution perfect for your mobile visitors.
  • Other plugins try to replicate every single feature and plugin you’ve installed onto the mobile version. We know what mobile users want and have written this plugin with that in mind – the result is a far better user experience.


  • Dynamic resizing of images
  • Retain SEO, preserve your URL structure and promote one single domain
  • Mobile Advertising Integration: Admob & Google Adsense
  • View stats on Mobile Page Impressions
  • Fully compatible with WordPress MU
  • Support for multi-lingual characters – even funny characters that make their way onto your blog (from a copy and paste from Word for example) are handled.
  • Comment from mobile! Turn on the feature and your visitors can leave comments from their handset.
  • Upload mobile specific header/footer images – resized on the fly to fit a visitors handset perfectly
  • Place mobile friendly navigation links around your site to help users browse around your blog
  • Advanced pagination – split up long posts into manageable chunks that make reading a post on mobile easier
  • Any theme that you’ve installed will have its styles carried across to mobile giving you a consistent look and feel for all your visitors.
  • Complete freedom over how you want to style your mobile site. We’ve done our best to make the mobile stylesheet as comprehensive as possible but no doubt there will be a few things you want to change – you can by editing a few settings.
  • Control over almost every element on your mobile page:- change the size and quality of images on posts and pages, show tags and categories in different sections, you can even change the wording of certain elements on your site!
  • Plus much much more! For a full feature list, visit the plugin homepage


  1. To install through WordPress Control Panel:
    • Click “Plugins”, then “Add New”
    • Enter “Wapple Architect” as search term and click “Search Plugins”
    • Click the “Install” link on the right hand side against “Wapple Architect Mobile plugin for WordPress”
    • Click the red “Install Now” button
    • Click the “Activate Plugin” link
    • Enter your Wapple Architect dev key into the control panel. You can get one from here – Wapple Dev Key Registration
  2. To download and install manually:
    • Upload the entire `architect` folder to the `/wp-content/plugins/` directory.
    • Activate the plugin through the `Plugins` menu in WordPress.
    • Enter your Wapple Architect dev key into the control panel. You can get one from here – Wapple Dev Key Registration

Download Plugin .zip

The control panel of Wapple Architect is in `Settings` > `Wapple Architect` (on WordPress 2.3.3 and under, `Options` > `Wapple Architect`).

If you want to use the Wapple Architect Mobile Plugin with WordPress MU as a site-wide plugin, install the wapple-architect folder in the plugins directory and activate on a site-by-site basis.


Mobile Web Junkie

Mobile Web Junkie

Spigner Mohammed

Spigner Mohammed

Meticulous Design Studios

Meticulous Design Studios

Frequently Asked Questions

How do I get a dev key?

Head over to Wapple and fill out the simple form, you should be able to get your dev key within a couple of minutes!

Why doesn’t the plugin work? I see the web version on my mobile!

Have you entered your dev key into the Wapple Architect settings?
If not, head over to Settings > Wapple Architect (or Options > Wapple Architect if you’re on version 2.3.3 and under) and enter it into the “Dev Key” input box.

Do I need SOAP and SimpleXML running for this plugin to work?

In older versions of the plugin, you needed SOAP and SimpleXML, but not any more! From version 1.5.13, the dependancy on SimpleXML has been totally removed! You also do not need SOAP and can communicate with Wapple’s web services via REST.

How do I customize the header and/or CSS?

If you want to upload a custom mobile header image, check out the settings area, it’s in the section titled: “Basic
Settings” and at the bottom there’s a section called “Mobile Theme Settings” – your mobile stylesheet is in there!

You’re free to customize any of these, infact, the more you customize the CSS, the better your site will look!

I can’t customize my CSS or upload a header/footer image!

Check write permissions on the /wp-content/uploads/ folder, it needs to be writable!


  • Version 4.1
    • Added canonical links to make Google SEO more friendly
    • Fixed issue with menu not showing permalinks correctly
    • Fixed an issue with menus growing
    • Added option to remove menu separators
  • Version 4.0
    • Added Google Analytics Support
    • Integration with Google Analyticator
  • Version 3.9.7
    • Fixed menu ordering – now more consistent with desktop order
  • Version 3.9.6
    • Removed donate links
  • Version 3.9.5
    • Added new URLs for signup
  • Version 3.9.4
    • Fixed Twitter link
    • Updated styles and error handling when no dev key found
  • Version 3.9.3
    • Added better handling of SOAP errors
    • Added upgrade notification if over page impressions
  • Version 3.9.2
    • Added support for PrimePress
  • Version 3.9.1
    • Fixed issue with some title characters
    • Fixed menu URL issue
  • Version 3.9
    • Fixed issue with random theme page templates not loading mobile version
    • Fixed issue with absolute URLs
    • Fixed issue with random characters in page menu titles
    • No zooming on smart phones – not needed as page should render perfectly
  • Version 3.8.4
    • Fixed issue with an ndash character
    • Fixed issue with pagination on some posts
    • Added compatibility with WordPress 3.8.4
  • Version 3.8.3
    • Added compatibility with WordPress 3.8.3
  • Version 3.8.2
    • Fixed some function redeclaration errors
  • Version 3.8.1
    • Changed default option for showing excerpts on the homepage
  • Version 3.8
    • Changed default theme
  • Version 3.7
    • Added compatibility for SmartPhone Location Lookup Plugin
  • Version 3.6
    • Added compatibility with WordPress 3.0
    • Fixed bug with foreign characters in comments
  • Version 3.5.1
    • Fixed bug with the mobile menu
    • Fixed bug on a home page excerpt
  • Version 3.5
    • Added sidebar functionality – choose which widgets to show, which pages to show it and a sidebar header
    • Added a few missing CSS placeholders
    • Added a few more screenshots in to view pre-built themes
    • Added gravatar support
  • Version 3.4.1
    • Fixed bug when a form item doesn’t have a type
  • Version 3.4
    • Added better youtube video handling
    • Fixed styling for div mode
    • Images less than 75px wide don’t get scaled
  • Version 3.3
    • Added Mobile stats
  • Version 3.2
    • Added 2 new iPhone styled themes
    • Fixed issue with lists and links
  • Version 3.1.1
    • Fixed issue with foreign characters in the loop
  • Version 3.1
    • Added option to make home page image as a link
    • Added option to remove normal links from home page
    • Changed a few screenshots
    • Fixed bug in menu element
    • Fixed bug with “&” chars in footer
    • Updated the WAPL scheme in wapl_builder.php
  • Version 3.0.2
    • Fixed bug with random HTML tags in post headings
  • Version 3.0.1
    • Turned off check for parent class scaling – causing issues
  • Version 3.0
    • Turn your mobile blog into a money making opportunity with these Mobile Advertisers
      • Admob
      • Google Adsense
    • Added compatibility with other plugins that use Simple HTML DOM
    • Fixed bug with parent images and resizing
    • Fixed bug with strong and em tags
  • Version 2.3
    • Added support for custom theme designs
  • Version 2.2
    • Fixed a random error when a wordsChunk tag was being converted to all lowercase
  • Version 2.1
    • Fixed small issue with comments not appearing in the correct format
  • Version 2.0
    • Added pre-designed themes
    • Added ability to switch layout
    • Added compatibility for every plugin that uses shortcodes – eg. download manager, contact form 7, powerpress
    • Added some extra classes for more styling
    • Added full WPMU functionality for styling
    • Compatible with WordPress 2.9
  • Version 1.5.13
    • Fixed error with captions in images not showing the correct image
    • Compatible with PHP4
    • Removed dependancy on SimpleXML
    • Fixed issue with pagination
  • Version 1.5.12
    • Fixed issue with more missing functions in WP. Despite documentation saying it’s there!
  • Version 1.5.11
    • Fixed issue with missing functions in WP < 2.8
    • Added compatibility with WordPress 2.8.6
  • Version 1.5.10
    • Fixed issue with menus and strange characters
    • Archives page now uses theloop element
    • Fixed bug with images in a post showing an incorrect file extension
  • Version 1.5.9
    • Added better support for rogue HTML characters
    • Added support for native OBJECT functions
    • Fixed issue when images were inside form labels
    • Fixed issue when pagination goes over an embedded image
  • Version 1.5.8
    • Completed all language, punctuation and mathematical symbol sets
    • Fixed bug on comments on a post
    • Added some help for mobile styling
    • Fixed issue with dates not appearing in the right place if you had a preview image on the home page
    • Fixed Smart YouTube bug
  • Version 1.5.7
    • Added support for YouTube videos
    • Added support for Japanese, Chinese, Korean, Hebrew, etc, characters
    • Some pages were displaying an empty page – fixed
    • Removed multiple install scripts running when upgrading the plugin
  • Version
    • Fixed bug with missing function
  • Version
    • Fixed bug with template loader
    • Fixed admin bug
  • Version 1.5.6
    • Fixed an issue with sub pages in WordPress menus
    • Better form handling
    • Added support for pages with alternative templates
    • Fixed issue with links when using certain types of permalinks
    • Fixed bug with transparency background colour on archive pages
    • Made some performance improvements
  • Version
    • Bug fix for installing in sub-directories
    • Fixed issue with footer image previews
  • Version
    • Fixed bug with page views
  • Version 1.5.5
    • Much better administration page
    • Fixed bug with image transparency colour on the home page
    • Fixed small bug with upper case image extensions
    • Updated path to signup page
    • Fixed a few random characters errors
  • Version 1.5.4
    • Better handling of comments
  • Version 1.5.3
    • Fixed further windows error when DIRECTORY_SEPARATOR is not set correctly
    • Fixed header error with WTF
    • Added support for password protected posts
    • Added support for access keys
    • Made some speed improvements in The Loop(TM)
  • Version 1.5.2
    • Fixed bug with windows / linux slash
  • Version 1.5.1
    • REST services now take priority over SOAP for better error handling
    • Added compatibility with plugins that output to screen before they should do!
    • Added full compatibility with WP Super Cache
  • Version 1.5
    • Added option: Configure your index page to have categories shown on home page
    • Added support for French & German character sets
    • Added option: Redirect site to a different URL
    • Added option: Remove images from index page excerpt
    • Added option: Turn post date on or off on home page
    • Added option: Ability to define all english text in a different language – fully internationalized
    • Added option: Have header image AND header text
    • Added option: Show first image as thumbnail on home page
    • Bug fix: Page headers appear at bottom
    • Bug fix: Some pages were showing a “more” link without any content showing
    • Bug fix: Fixed a random error when showing 2nd page
    • Bug fix: A few characters were breaking the title, » and « to name 2
    • Bug fix: Selecting menus with non-conforming html characters doesn’t work
    • Improved some areas of documentation
  • Version 1.4.10
    • Added support for Russian (cyrillic) character set
  • Version 1.4.9
    • Added extra web service error handling
    • Fixed bug with &copy; and &nbsp; characters
  • Version 1.4.8
    • Added option: Configurable menus – turn pages on or off on mobile
    • Compatible with mobiready test
    • Fixed a few erroneous PHP/SOAP/Linux error messages
    • Fixed return plugin path for NFS server setups with load balanced web servers where plugin path is not on web servers
  • Version 1.4.7
    • Fixed WP bug when some titles/descriptions come back with quotes and some don’t
  • Version 1.4.6
    • Fixed bug with & in the blog title/description
  • Version 1.4.5
    • Added option: Display a different title or description on mobile
    • Added support for WTF in mobile title and description
    • Added meta tags to the page
    • Added some pre-configured classes to help you style up your site
    • New style admin panel – easier to navigate
  • Version 1.4.4
    • Fixed bug with CURL communication
  • Version 1.4.3
    • Fixed upgrade bug
  • Version 1.4.2
    • Added option: Show comments on mobile
    • Added option: Change text on previous/next posts link
    • Fixed some file permissions. Gracefully downgrade and display nice error message
    • Added CSS for text spacers
  • Version 1.4.1
    • Removed SOAP error message – not needed anymore
  • Version 1.4
    • Added support for REST web services as well as SOAP
    • Compatible with WordPress 2.8.4
    • Fixed captions
    • Fixed WP formatting issues with strong tags
    • Fixed a few multi-language bugs as WP handles posts differently to pages and titles
    • Added ability to switch back to mobile site from the website
    • Can have have special chars in the footer text
    • Added option: Set transparency colours for all images on your mobile site
    • Added option: Add a specific image for posts to replace the main site image
    • Added support for small images: share links, smileys, etc
    • Added class to captions for styling
    • Fixed WP dodgy support for italic, emphasis and strong. WP does weird things with those!
    • Added support for WTF in footer text: Read more about WTF
  • Version 1.3.3
    • Fixed link to standard site
  • Version 1.3.2
    • Fixed bug on certain mobiles with a dodgy &
  • Version 1.3.1
    • Better handling of text formatting
    • Support for forms
    • Support for list items
    • Updated schema
  • Version 1.3
    • Compatible with WordPress 2.8.3
    • Header images / text can now be flagged as a “back to home” link
    • Added a “switch to desktop” option
    • Fixed few CSS bugs
    • Added an installation script that sets a few default values on / off
    • Specify the number of posts to display on the home page
    • Show the tagline of the blog
    • Show the author name of the blog
    • Show categories on the home page
    • Set hard limits on the size of excerpt on home page
  • Version 1.2.1
    • Fixed a bug with tags
  • Version 1.2
    • Added a next/prev link on home page if more posts
    • Added next/prev classes to style up
    • Added handling of multi-language characters
    • Added footer text to go with a footer image (also added an empty footer row if no image or text)
    • Added 100% support for images – no scrollbar
    • Added handling if no SOAP or no simpleXML
    • Tidied up some CSS
    • Add new class to post titles to distinguish between them and links
    • Added admin notification if plugin isn’t working (SOAP/simpleXML/dev key)
    • Added a configurable home link at the top of the posts page
    • Added lots of admin help
  • Version 1.1.3
    • Fixes a CSS bug and adds compatibility with WordPress 2.8.2
  • Version 1.1.2
    • Fixed bug with auto-install on wordpress 2.8.1
  • Version 1.1.1
    • Removed a rogue admin comment
  • Version 1.1
    • Add comments from mobile
    • Turn menu on or off your mobile site
    • Long menus wrapped at the top
    • Various fixes to do with text formatting
    • Set transparency colour on header and footer images
  • Version 1.0.2
    • Fixes a minor bug with header and footer image previews
  • Version 1.0.1
    • Fixes a minor bug with header and footer images
    • Support for WordPress 2.8


If you plan on enhancing the plugin with some styling and/or images, check out the Step by Step guide to Enhancing your WordPress mobile blog.

Further Comments

If you’ve used my plugin, have any suggestions or just want to say hello, please leave a comment – any feedback is appreciated and it’d be good to see a few people using my plugin in the wild.

233 Responses

  1. wholesale says:

    he plugin works great.
    adsense or any advertisement code , it make your blog look ugly in mobile .

  2. Tracey says:

    Hi again, the new site I’m still tweaking is not showing at all on any phone I know of. We’re all getting an xtml parse code error. Earlier it was showing a line number; now it just says “no name”, at least on my Android-based phone. Like others, I’ve been trying to locate the answer for this with no luck. My settings for the plugin all look right.

  3. WFHO says:

    I have installed and setup the plugin and it was pretty simple. I am however getting an error when i try to visit my site on an android device. The page post an error saying “error on line 32 at column 2798: ATTVALUE: ” or ‘ expected. Can you tell me how to fix this?

  4. Les says:

    Nice plugin, thanks!

    Problem though, when I try to activate “show menu in header” in the basic admin area, WA just throws a single blank button up. Is the menu built using “Configure pages on menu” in the advanced tab? Because I can’t seem to edit that list in any way. Or is it supposed to be pulling the header menu from the WP menu widgets? If so, that’s not working either.

    Or am I missing something…?

    Version is 3.9.1 on WordPress 3.1

    Thanks :)

  5. sham says:

    I am using this really awesome plugin.It works great.But i want to make a small tweak.In google Mobile Search results i want to show off a green mobile icon like this

    What tweak should i make in the plugin code to get this..Can you please help me out on this.It will be really helpful to all users.

    Where should i place the mobile tag ?

  6. sham says:

    I am using this plugin.But mobile version of the page is getting indexed and being show in even desktop google search results version how to avoid that and see to that mobile version of the page gets displayed only in google mobile search results?

  7. Winglet says:

    Plugin working OK with WP 3.1!

  8. Corey says:

    FYI, when I installed the plugin HTML5 Multimedia Framework for wordpress, it broke the mobile site generated by Wapple Architect. Deactivating that plugin fixed the problem.

    Great plugin, though, thanks!

  9. Lim Ho says:

    I like it! I like this plug-in!!
    But I have just one wish, I want to use comments for my pages(not archives). I can use comments for my pages with normal browsing, or other mobile plugin, but I like your mobile themes and functions.
    Please make it.. please..^^..

  10. I have a multilingual site using qtranslate for language switching. I installed and activated the Wapple Architect plugin, but unfortunately I can’t use it as it throws an error in my RSS widget when on the French side of the site: Here’s the error I get

    Fatal error: Allowed memory size of 67108864 bytes exhausted (tried to allocate 7680 bytes) in /home/hears732/public_html/bia/wp-includes/class-simplepie.php on line 14813

    This is part of the code I use in the widget to fetch RSS: ‘<?php // Get RSS Feed(s)
    include_once(ABSPATH . WPINC . '/feed.php');

    // Get a SimplePie feed object from the specified feed source.
    $rss = fetch_feed……'

    Everything is working perfectly when the Wapple Architect plugin is deactived.

    Any solution??

  11. r3v says:

    how to change background article , coz the color is white n i am not like white .. please help me , very thanks if u can send me email how to make it..

  12. Ginny Carter says:

    I’ve clicked your link to get a Wapple Registration key, and filled in the fields and clicked ‘sign up’. But where does the key get sent to as there is nowhere to enter an email address? Thanks.

  13. Anne Thomas says:

    Hi there, sorry that you are having some problems. If you sign up for a free (developer) account then log in you will see the dashboard. One of the choices you should then see if generate registration key. Click “Create new” to generate a developer key and it will be shown on the page for you. You can then use this to paste into your Wapple Architect/Mobile pLugin to mobilise your blog. Further help can be found wihtin the dashboard community should you require any further assistance.

  14. jg says:

    i’m sorry, but with the change instituted re advertising I am afraid wapple is a goner on my site… I realize everyone needs to earn a living, but I am not earning one from my blog, and it would be nice to have a small free version available as it was for sites like mine. wapple just bit the dust for me, I have no advertising on my site. I am sorry because I do think it is a great product for those that can afford it. good luck to you and those that use your product. I realize I don’t pay your bills, so I am not a great loss, on the other hand I had told several people about the product. Maybe that counts for something you should consider.

  15. Anne Thomas says:

    Thank you for taking the time to feed this back to us. I do understand your position, just as you have recognised ours and I’m sorry on this occasion that we couldn’t find a solution for you. We will bear all your comments in mind when we review this. In the meantime I wish you all the best with your blog and hope there will be another occasion where we are able to further assist you.

  16. Hi there,

    having some trouble here, how can I remove the default top and bottom banner from my mobile page?

    Also, the menu links aren’t working, do I need permalinks activated?


  17. Hi there,
    In the basic settings I selected to have the menu at the top. But the menu uses the full page names instead of the menu names I gave them in the WP appearence/menu section. How do I fix this. It looks rather ugly.

  18. Anne Thomas says:

    Hi there, if you drop into the forum on the dashboard you should get the help you need over there, here’s the link for you

  19. JAy W says:

    I am trying to get your Wapple advertisement off of the top and bottom of our mobile site. Does this require an upgrade or will it always be on there?

  20. Anne Thomas says:

    Hi there the free version of the plugin does carry adverts in order to subsidise it. Upgrading your account will remove the banners. You should be able to upgrade from the dashboard and will find support in our forum for the plugin too

  21. JAy W says:

    I thought that was the case but find myself double checking everything these days. Thank you for your quick response as well as this incredible plugin.
    Take care

  22. KevEd says:

    I’ve registered for the free trial and added the dev key to the Architect panel in my WP 3.3.1 install but the site doesn’t show up on a phone browser (android). Do I need to sign up for paid version for it to work? No problem doing that, but I’d like to be assured it will work – the freebie doesn’t appear to.

  23. Anne Thomas says:

    Hi there, I’m sorry to hear you are experiencing a few issues with this. There is no need to upgrade to the paid version to resolve your articular issue, the paid version would remove the adverts that are served to the free version. if you drop into the dashboard > forum you should be able to post (or search) in there and our support team will be able to assist you. Include your account, url and phone type as that may speed up a resolution for you >

  24. Donald says:

    I have installed the plugin, and have entered the correct dev key as well, but still it fails to show the mobile version when I access my website from my android smartphone.

    Kindly help?


  25. Anne Thomas says:

    Hey there, sorry you’re having a few issues with this. The best place for the help you require is in the support forum. Login to the dashboard > Forum and search or post in there. HTH

  26. jamie says:

    hi i currently run a movie website at and was wondering if this plugin would work on my site, as if you go to the trailer section with most wordpress mobile plugins nothing comes up and i am just wondering if this may be the same case with this plugin.

  27. Anne Thomas says:

    Hi there our support team would be better placed to help you with your query. If you login to the dashbaord you will find the support forums in there. HTH

  28. Hi. Site made with Wapple Achitect work fine on all mobil phones (tested by me) and work fine in Firefox. But Internet Explorer 9, show me mobile version, not clasical web view. Where is the catch.

  29. Anne Thomas says:

    Hi There, Thanks for flagging this. If you post in the community area you’ll receive the support that you need there HTH

  30. sex says:

    Very nice post. I just stumbled upon your weblog and wanted to say that I have really enjoyed browsing your blog posts.

    In any case I will be subscribing to your
    feed and I hope you write again soon!

  31. bijoy says:

    Very nice post. I just stumbled upon your weblog and wanted to say that I have really enjoyed browsing your blog posts.