From iThemes Codex
Revision as of 20:00, 22 July 2012 by Ronald (talk | contribs) (Change the default Home page)
Jump to: navigation, search

Advanced technical support for Mobile:


Theme Creation

Live themes are stored in /files/pluginbuddy_mobile/THEMENAME/ (multisites) OR /wp-content/uploads/pluginbuddy_mobile/THEMENAME/ . You should always edit the theme files in these directories.

Non-live original theme files (backups and originals) are stored in /wp-content/plugins/mobile/themes/THEMENAME/ You should never edit the files in this directory.

If you would like to edit an existing theme you may do so by editing the live theme files. If you do this we suggest unchecking the option in Settings for automatically upgrading theme files on automatic upgrades to prevent your changes from being lost. Style manager edits create a CSS file within /files/pluginbuddy_mobile/THEMENAME.css (multisites) or /wp-content/uploads/pluginbuddy_mobile/THEMENAME.css so that these changes will not be lost on upgrades.

To create a new theme you can just clone an existing theme to /files/pluginbuddy_mobile/THEMENAME/ (multisites) or /wp-content/uploads/pluginbuddy_mobile/NEWTHEMENAME/

Additional Head HTML (includes Apple icon definitions)

if ( defined('MOBILEBUDDY_HEAD_CONTENT') ) {

Link to Full Site

if ( defined('MOBILEBUDDY_FULL_SITE_LINK') ) {
   echo '<a href="' . add_query_arg( 'nomobile', '', str_replace( 'mobile', '', $_SERVER['REQUEST_URI'] ) ) . '">View Full Site</a>';

Customize Mobile

Extra Customizations Policies

Check out the official policy and details on any Extra Customizations

Remove Footer Link

You can remove or change the footer text and/or link that is shown to all mobile users by default.

  • 1: To remove OR change that footer, edit the footer.php file in the appropriate theme folder, depending on which Mobile theme you are using. That file will be in one of the theme directories in either of the following directories:
    • wp-content/uploads/pluginbuddy_mobile
    • OR (on Multisites) wp-content/blogs.dir/X/files/pluginbuddy_mobile (change the X to the appropriate site number)
  • 2: Find line 12 of the footer.php to what you want. It currently says
    Mobile Site By <a href="">PluginBuddy</a><br />
  • 3: Change the above to anything you wish to be shown OR hidden from the mobile users in question who will be viewing that theme.

Change the default Home page

This applies if your site is not using a specific page as the homepage (set through wp-dashboard > Settings > Reading)

There is currently no setting to set a specific homepage for the mobile version of your site. You can however change this using the following steps:

1: Create a new page in WordPress with your mobile home page content. Make sure NOT to include that page in your non-mobile theme's navigation. For the sake of these instructions, let's say you created a page with the page slug "mobile-home"

2: Create a new navigation menu (wp-dashboard > Appearance > Menus), and add a custom menu item named "Home" (or whatever you wish to call it) linking to (the page create at #1)
Set this new menu as the default menu for "PluginBuddy Mobile Navigation Menu"

3: edit index.php in your mobile theme and add the following line at the very top:

<?php wp_redirect( '', 302 ); exit; ?>

Note that you need to use FTP or your hosting filemanager to access and edit the index.php file of your mobile theme. You should edit the file that exists in wp-content/uploads/pluginbuddy_mobile/{theme you are using}/

That should make sure that the home link on your mobile site, as well as the landing page resolves to your mobile homepage

Plugin Conflicts

The following plugins are known to cause conflicts with OR in Mobile. You can either disable the following plugins, upgrade them to their latest versions OR let their development team know about this. Mobile works perfectly when such plugins (or some certain versions of them) are not active.

Additional Resources