Requires WordPress Version: 3.0 or higher
Compatible up to: 3.1.4
WordPress Multi Site Mobile Edition is a conversion of the famous WordPress Mobile Edition plugin suitable for WP3+ in both normal and multi-site mode. It will make WordPress use the Carrington Mobile theme designed for mobile devices when visitors come to your site or any site on your network with a mobile device.
See your single site or all sites in your network jump from less than 2 to nearly 5 out of 5 score on MobiReady
Mobile browsers are automatically detected, the list of mobile browsers can be customized on either Super Admin > Mobile or Appearance > Mobile depending on your setup.
TODO: Optionally disallow individual site owners to change the settings for their site.
Translations
None yet… Please submit yours and get mentioned here 
Installation Instructions
Quick installation: Install now !
… OR …
Search for “wpms mobile edition” and install from your slick Plugins > Add New back-end page.
… OR …
Follow these steps:
- Download the archive and either drop the included /wpms-mobile-edition/ directory with its content in your /plugins/ directory or drop only the content of wpms-mobile-edition.php file in your /mu-plugins/ directory.
- Download and install the latest Carrington Mobile theme or do a search and install from that slick new theme installation on Appearance > Themes > Install Themes on your WordPress back-end. Do NOT activate the theme, it only needs to be installed.
- If you installed in /plugins/ you can now choose to either ‘Activate’ or ‘Network Activate’ from the main site.
Done!
Frequently Asked Questions
Does this plugin include any mobile themes ?
No, you need to install one yourself. After plugin activation, you will get instructions for easy automated installation of compatible Mobile themes hosted on WordPress Extend. At this point ( version 0.3 ) this is only Carrington Mobile.
Is this compatible with the WP plugin auto-upgrade feature?
Yes.
Is this compatible with Multi Site mode?
Yes.
Can I install it in the /mu-plugins/ folder?
Yes.
Is this compatible with WP (Super) Cache or others ?
Yes, it is compatible with WP Super Cache 0.9+ (using WP Cache mode). Be sure to activate the Mobile option. It has also been tested on Quick Cache where you need to copy the list of mobile and touch browsers to the No-Cache User-Agent Patterns section.
Does this create a mobile admin interface too?
No, it does not.
Does this serve a mobile interface to mobile web search crawlers?
Yes, to Google and Yahoo mobile search crawlers. You can add any others by adding their user agents in the plugin’s Settings page.
Does this support iPhones and other “touch” browsers?
Yes, the mobile theme Carrington Mobile has a customized interface for advanced mobile browsers and special styling to make things “finger-sized” for touch browsers.
My mobile device isn’t automatically detected, what do I do?
Visit the settings page and use the link there to identify your mobile browser’s User Agent.
Then add that to the list of mobile browsers in your settings.
Does this conflict with other iPhone theme plugins?
Remove the iPhone from the list of detected browsers, then the other iPhone theme should work as normal.
Can I create a link normal visitors can see the mobile version?
Yes. The link can be added to your theme by using the wpms_mobile_link() template tag:
<?php if (function_exists('wpms_mobile_link')) { wpms_mobile_link(); } ?>This will output HTML code like <a href="?wpmsme_action=show_mobile">Mobile Edition</a> on you blog page.
When a user follows that link, the mobile version will be displayed with after each post/page content a link back to the Standard Edition.
Note: this does not work well if you have WP Cache enabled.
Why are recent posts shown on every page?
This is a feature of the plugin to allow easy access to recent content.
How do I customize the display of the mobile interface?
You will need to edit the templates is the /carrington-mobile/ theme folder. Any changes you make there will affect the display of the mobile interface.
Changelog
Really? Ok then… Read the full WPMS Mobile Edition changelog
Download
Latest version: Download WPMS Mobile Edition 0.4 [zip]
Downloaded 13674 times.
47 Reacties
Nice plugin to display all sites in mobile view, beautiful. On testing, I found this plugin loads content much faster than WP-Touch. Looking forward to more functions – adsense, display options, etc. I will be hacking Carrington mobile theme for now.
Thankyou.
Hi George,
Hacking the Carrington Mobile theme is the way to go. But be careful to not overwrite your hack when there is a new version of that theme available!
The WPMS Mobile Edition plugin itself will not get features like specific display option or adsence or anything. It basically functions like a filter for mobile visitors and presents those visitors your content packaged in the Carrington Mobile theme.
What I do plan is make WPMS Mobile Edition compatible with more than just the Carrington Mobile theme. So if you find a mobile theme (preferably on WordPress Extend Themes) that features those options you are looking for, please let me know. I might get around to make WPMS Mobile Edition recognize and use it
Great Plugin, Although i do have a quick question.
I currently have WP-touch plugin installed and I would like to also install your plugin so the phones that don’t go to WP-touch will be redirected to the WPMS Mobile Edition. (mainly the blackberry models)
I have customized the WP-touch theme so much that it would not be option to start from scratch on your plugin. My question is, will your plug-in interfere with the phones that are directed to the WP-Touch Site and can i just turn the touch models off on your plugin and they will continue to work with WP-touch. Thanks for your help.
Yes, you can set the plugin on the Appearance > Mobile admin page to ignore touch browsers (just make that field empty) so that WP-Touch can kick in and do it’s work
Just one note: if you are using this plugin on a multi-site setup, at this point, you’ll have to make the changes on EACH site in your network manually OR (maybe easier) edit the source code so that the default settings for touch browsers is empty… If on a (normal) single site setup, just igore this last remark. If you have no clue what I am talking about here, just let me know
Hi. I installed your plugin a few days ago and so far, I really like it. I have one problem, though, and I’m hoping that you can help me out. I’m trying to add a link to the non-mobile version of the site to allow users to flip over to the mobile, but the script you listed in your FAQ doesn’t seem to work (). If I put it in my header.php, the whole page comes up blank…is there another step that I’m missing? I don’t have wp-cache installed, so that shouldn’t be the problem. Thanks in advance for your help!
Hi Catharine,
Thanks for reporting
Please upgrade to version 0.4 and use the code
if (function_exists('wpms_mobile_link')) { wpms_mobile_link(); }in your template file.Let me know if you run into anything.
Hi again…I’ve run into another issue, and I’m hoping that you can help me out again
So, I’ve made my mobile version using Carrington Mobile and it looks great in the browser and on the iPod Touch and Android phones I’ve tested it on, but my client is using a Blackberry and has run into some problems. I’m not sure if this is a question for you or for the Carrington people, but since it seems to be phone-based, I thought that you might be my best choice. So, just in case you haven’t looked at the Carrington theme much, the theme goes header graphic, latest posts, and then pages, and our client is seeing the pages repeat themselves so that it goes header graphic, latest posts, pages, pages. Do you have any suggestions about what might be happening? I saw that Blackberry and BlackBerry9530 are included in your default list of browsers, but since it’s not happening on any of the other phones/devices, I’m at a bit of a loss. Have you had this happen before? Any help you can provide would be much appreciated 
Hi Catharine, it looks like the plugin does what it is supposed to do: present the site using the Carrington theme to — in this case — a Blackberry phone. Or am I misunderstanding the issue?
The problem with the repeated pages list, seems something in the Carrington theme itself. For support on that theme, please go to http://crowdfavorite.com/forums/forum/carrington-mobile or http://wordpress.org/tags/carrington-mobile?forum_id=5#postform to report the issue. I am sure the developer, Alex King, is interested in hearing about your findings.
Good luck
I wasn’t sure if the repeating had to do with your plugin or the theme, but you were so nice and helped me out a few weeks ago that I thought you might be able to help again. The Blackberry is definitely showing the mobile version, it’s just that the mobile version is a little funky — wasn’t sure where the problems originated, but it makes sense that they’d fall under the theme. I’ll contact that plugin writer
Thanks for your help, and I always appreciate that you get back to me so quickly!
Love your plugin/theme, and believe it should be an essential plugin used by every WP site.
Unfortunately, I have a site that doesn’t seem to work right – it will not recognize a mobile device after install/activation, and just shows the regular site. It did work fine on one site, but fails on another: http://wpweaver.info. I tried both an iPod and a Nokia phone, and it did not detect on either. It does work from a full browser if I use the “?wpmsme_action=show_mobile” switch to test. I do use a bunch of plugins.
Unfortunately, the site is live and busy, so I can’t disable my plugins one by one to find the issue. I can provide a list of plugins I use.
My site is the home of the 2010 Weaver WP theme and has been a top 20 theme on WP.org for months now. I don’t have a mobile version, and would very much like to add a link you your very cool plugin/theme, but I need to get it to work on my own site first! I’d appreciate any hints you might have.
Hi Bruce, I’m honored to learn that the maker of the Twenty Ten Weaver theme — got it installed too, just not using it on any of my sites yet — is using my plugin
I plan to develop WPMS Mobile Edition further so it can be used in conjunction with more mobile themes. So if, one day, you decide to do a Mobile Weaver theme, please let me know and I will make WPMS Mobile Edition compatible with it…
Now for the issue with the plugin on some sites (but not others?) we need to do some testing. I ‘d like to get to the bottom of this but I notice you have switched the plugin off on your main site, correct? Is that site running on WP3 in Multi Site or Single mode? If on Multi Site mode, maybe you could create a sub-site like test.wpweaver.info and activate the same plugins there to see if we can replicate the issue.
On first note: I see you are using Quick Cache. Did you copy the complete list of user agents (both Mobile and Touch Browsers!) from your Appearance > Mobile admin page to the No-Cache User-Agent Patterns field under Quick Cache > Config Options. If not, it’s very likely that you are seeing a cached version of the site in standard mode when you visit your site on the iPad and Nokia.
If that’s not it, please contact me by e-mail (or use the contact form) so we can try to figure this out
Allard
cool, great, plugins and running smooth and fast.. Thank you very much…!
Hi,
How can I create a link that mobile visitors can see the normal version, overriding UA based redirection during session or for the visitor, maybe by setting a cookie?
Sorry for the last comment, I have to correct:
How can I create a link that mobile visitors can see the normal version, overriding UA based redirection during session instead of setting a cookie for the visitor?
Sorry, the plugin does not work with session variables…
How can I show the links to other sites (I’ve got multisite) on mobile version?
The plugin only takes care of presenting your site to mobile visitors using the mobile theme that you have selected (version 0.4 only supports Carrington Mobile but 0.5 will have more themes to choose from) but beyond that, I cannot help you. In the case of Carrington Mobile, please see http://carringtontheme.com/ (documentation/forum/developer support) on how to show links to other sites in your network.
Great plugin…Just one bit of weirdness (maybe it’s for the theme, I dunno); on my base site it looks perfect on my Galaxy, but with the forwarded and masked URL it looks like a spread-out version (you know, the way mobile versions look on a desktop). Check it out:
http://vacation.studiobaric.ca (looks fantastic)
http://www.vacationreportcard.com (looks itty bitty)
I am pretty sure it is the masked/iframed URL forwarding that is interfering here. I would advise against any kind of iframe masking in general. It’s bad for SEO, completely inaccessible for some visitors and just plain confusing to others — to say the least… If you can, try Donncha’s excellent Domain Mapping plugin to take care of URL/domain redirection in a search engine and mobile theme friendly way
Doesn’t look like this is compatible with Buddypress Mobile – any way to make it “step aside” if that’s enabled?
Hi, I have no experience with BuddyPress Mobile but if anybody would like to suggest code to make it ‘step aside’ I am not against incorporating it
Hi Ravan,
according to GeceBekcisi’s question, now the same from me. you’ve described how to place a link for normal users to see the mobile version, but is it also possible the other way round. create a link that mobile visitors can see the normal version (if their browsers and devices allow that) so that mobile users can decide whether they want to see the normal version OR the mobile version?
Many thanks in advance & greez from Vienna
Currently in 0.5alpha (under heavy development, use at own risk) you should be able to use the code
< ?php if (function_exists('wpms_mobile_link')) { wpms_mobile_link('desktop'); } ?>(remove the space between < and ?)Use this code in your mobile theme where you want to display the link.
Oh, and here is a link to the dev version: http://downloads.wordpress.org/plugin/wpms-mobile-edition.zip
Let me know!
many thanks!
what’s the dev version?
do i have to uninstall the old wpm-edition first?
or just put the new one into the plugi-folder? sorry for the stupid questions …
not a stupid question at all
download http://downloads.wordpress.org/plugin/wpms-mobile-edition.zip and then go to your wp admin “Plugins > Add new” section. then click the “Upload” tab and choose the zip to upload and install…
one more question: i use the carrington mobile, I know it’s in the /wp-content/themes/carrington-mobile folder, but into which file do I have to put the code
the functions.php or the index.php or …
thx
I’m not familiar with the inner workings of Carrington Mobile but I would start by trying to add the code
if (function_exists('wpms_mobile_link')) { wpms_mobile_link('desktop'); }to line 2 (just below < ?php) of footer-default.php and see if it turns up at all…Hi there -
Great plugin – thank you! Quick question about iPhone. The site renders the mobile version just fine on iPhone 4, but not on iPhone 3GS (and presumably 3). Any ideas on what I need to add into the settings area? I added iPhone into the Mobile Browsers section, so it appears in both areas. Any other advice?
http://richmondsfblog.com
Hi Sarah, just when I was finishing the following answer, I decided to go through the source code of your pages to look for any redirection scripts or anything like that and then I noticed right at the bottom that you are using WP Super Cache. So before continuing with the following speculations, you need to make sure that WP Super Cache is NOT serving cached pages to mobile users! There is an option for that on the Super Cache settings page. Something about Mobile Compatibility mode or other…
There seems to be something going wrong on your site, not only for iPhone 3GS… Check for example http://ready.mobi/results.jsp?uri=http://richmondsfblog.com/ it gives you a sold 4.90 out of 5 but when you check http://ready.mobi/results.jsp?uri=http://richmondsfblog.com/2011/01/28/richmondsfblog-now-mobile-friendly/ you get less than 2 points! The mobile mimicking application on that page there shows that page is loading in the Desktop version (using your normal theme) before it actually throws an error… Same result when switching to different User Agents.However, the most recent post http://ready.mobi/results.jsp?uri=http://richmondsfblog.com/2011/01/29/video-a-visit-to-pauls-hat-works/ shows the mobile theme is being used! Even though it gets a very low ranking because of the use of iframes, this means the plugin is working on both the front page and the most recent post, but not others (as far as I checked) …
I tested some of my sites but cannot reproduce this behaviour.
To make sure there is nothing wrong with your settings nor with your iPhone 3GS, go to http://show-ip.net/useragent/ and see if there is iPhone somewhere in the User-agent string. Probably right after the ‘(‘ … And if it is there, your default settings on WordPress admin Appearance > Mobile should be just fine. Click for both fields on “Reset to Default” to make sure. Then check if the above link again to see if it changed anything.
Hi,
i’m sorry to be so direct but i need help :\
How can I create a link in my mobile version so i can see the normal version on a phone? I tried everything i can think of with no results.
Thanks for any help
Hi Daniel, in the current version there is no option to force such a link. WPMS Mobile Edition will put such a link after page/post content if it detect certain parameter in the URL or a browser cookie indicating it is dealing with a normal visitor that came to the mobile version on purpose. I will consider adding an option to force this link for all visitors but I as I’m rather busy at the moment, I cannot promise a new release soon.
But you could edit the mobile theme (I cannot help you with that, it’s not mine, but you might try the footer.php just above or below
cfct_footer();) to contain the following PHP code (wrap in opening<?phpand closing?>tags if you need to) anywhere you want the link to show:if (function_exists('wpms_mobile_link')) { echo '<a href="' . wpms_mobile_link('reject_mobile',false) . '">Standard Edition</a>'; }Hope you can make it work
currently i am using your pluggin,
it is great at the moment among other wap plugins .
but still it does not support different post type.
Hi vishal, it looks like that is a problem with the Carrington Mobile theme and not my plugin (which merely redirects all mobile traffic to that theme)… Make sure you have the latest version of Carrington Mobile installed (but not selected as current theme) on your system. If you are on a Multi-site setup, you might need to make the theme available for all sites by network activating it. If that does not solve issues with post-types, please contact the Carrington Mobile theme developer about it
Hi,
I have been using Carrington mobile for a while now, had it tested by buddies having smartphones to check the display and it was alright.
Now starting to switch to multisite, with WordPress 3.1, and having seen the new multisite version I’m trying to install it.
Something does not work, I keep getting a message stating that the theme could not be found, although I have followed all the steps carefully. I first tried to install from withing the automated functions, then seeing it didn’t work installed with Filezilla as I used to in the past, but still no way ! → “The required mobile theme carrington-mobile is not found. Please check the settins.” (settins – http://citrotux.org/wp-admin/themes.php?page=wpms-mobile-edition)
What can it be that is wrong ?
Thanks,
Mélodie
Hi Mélodie, you are right that the the automated installation of Carrington Moblie is not compatible with the new 3.1 way of handling themes in mulit-site mode. So you installed it via FTP which is fine, but trying to access the Carrington Mobile stylesheet directly on http://citrotux.org/wp-content/themes/carrington-mobile/style.css I get a “404 page not found” response. Are you sure you uploaded the theme to the correct location? Do you see it listed on http://4visions.nl/wp-admin/network/themes.php (All tab) and if so, can you try Enabling it for the Network and what is the URL to the stylesheet? If not, can you try installing it via the WP back-end?
Using the plug-in and it’s great. When I make changes to my navigation menu in WP-admin it doesn’t update the mobile version. Am I missing something?
Hi, WPMS Mobile Edition currently only supports one theme: Carrington Mobile. This theme does not support custom menus, so any changes you make to your custom menu in the desktop theme, will be ignored by the mobile theme. Future versions of my plugin will be supporting other mobile themes, all with their own features and limitations.
If you want to edit the Carrington Mobile theme options from your desktop browser, I can recommend the plugin “Theme Test Drive”.
I translated this plugin to persian language. how i can send translation files to you? i
How do I install multiple Carrington Mobile themes on one WordPress network? I want to have one for development and one for my live site.
Hi Jarred, you can copy/rename the complete theme directory and rename the Theme in its style.css to be able to see the difference in the WP back-end. But the WPMS Mobile Edition can only work with the official Carrington Mobile theme… For development, I’d advise you to do a separate WP install.
how can i make java or ajax available in this plugin? so my mobile site can display java & ajax. thx
Hi maniaklagu, the plugin does nothing more than handle the redirection of mobile visitors to the alternative theme “Carrington Mobile”. I do not think that theme allows for much fancy stuff because it really is meant for the smaller mobile devices. If you wish to allow access to advanced site features to so called Touch devices, you can remove those devices from the user agents list for Touch devices in the WPMS Mobile settings. This will result in the normal theme being used for those visitors.
The next version of WPMS Mobile Edition is planned to support other mobile themes then just Carrington Mobile and allow you to differentiate between normal mobile and touch devices. But there is no schedule for the next release so I cannot promise anything soon.
Hi there, great script! Works really well, even better than some other paid ones I’ve seen.
I had to get this because WpTouch works only for touch screen and this plugin defaults when they have say an older blackberry version
A couple of issues I’ve noticed which I hope someone might be able to help with:
1) Images get cut off instead of resized or “fit to width” of the screen. How do we fix it?
2) How do you make a custom homepage template? custom page templates?
I found the plug: – `is_home()`
But it does not say how or where to implement? I’ve looked through content, pages etc and can’t find anything.
Thanks
Hi Jack, the plugin WPMS Mobile Edition does nothing more than redirect mobile devices to view your site in a mobile theme. Currently, only the Carrington Mobile theme is supported. The questions you ask are theme related. You can find the public support forum for that theme on http://crowdfavorite.com/forums/forum/carrington-mobile
The site loads fine in a normal desktop browser. When I load the site in a mobile device the Home page does not display any content other than a link to the Home page and the site of the site navigation. The other pages load fine. Any idea what could cause that?
Hi Eric, you probably have a static page as home page? The Carrington Mobile theme does not work well with that. Future versions of the Mobile Editions will support other mobile themes so you will have the option to choose a theme that works better with static home pages…