Mobile

(Difference between revisions)
Jump to: navigation, search
(Added - Customize Mobile: section, "Extra Customizations Policies" and "Remove Footer Link" sub-sections. Removed OLD release date info.)
(8 intermediate revisions by 2 users not shown)
Line 7: Line 7:
  
 
===Theme Creation===
 
===Theme Creation===
Live themes are stored in /files/pluginbuddy_mobile/THEMENAME/
+
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 are stored in /wp-content/plugins/mobile/themes/THEMENAME/
+
  
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 so that these changes will not be lost on upgrades.
+
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.
  
To create a new theme you can just clone an existing theme to /wp-content/uploads/pluginbuddy_mobile/NEWTHEMENAME/
+
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/
  
  
Line 26: Line 27:
 
<pre>
 
<pre>
 
if ( defined('MOBILEBUDDY_FULL_SITE_LINK') ) {
 
if ( defined('MOBILEBUDDY_FULL_SITE_LINK') ) {
   echo '<a href="' . add_query_arg( 'nomobile', '' ) . '">View Full Site</a>';
+
   echo '<a href="' . add_query_arg( 'nomobile', '', str_replace( 'mobile', '', $_SERVER['REQUEST_URI'] ) ) . '">View Full Site</a>';
 
}
 
}
 
</pre>
 
</pre>
  
==Customize Mobile==
+
*Related forum
 +
**http://ithemes.com/forum/index.php?/topic/20587-view-full-site-link-doesnt-always-work/
  
====Extra Customizations Policies====
+
=Customize Mobile=
[http://ithemes.com/codex/page/PluginBuddy#Extra_Customizations Check our the official policy and details on any Extra Customizations]
+
  
====Remove Footer Link====
+
===Extra Customizations Policies===
 +
[http://ithemes.com/codex/page/PluginBuddy#Extra_Customizations 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.
 
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:
+
*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
 
**wp-content/uploads/pluginbuddy_mobile
 
**OR (on Multisites) wp-content/blogs.dir/X/files/pluginbuddy_mobile (change the X to the appropriate site number)
 
**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 <pre brush="html">Mobile Site By <a href="http://pluginbuddy.com/">PluginBuddy</a><br /></pre>
+
*2: Find line 12 of the footer.php to what you want. It currently says <pre brush="html">Mobile Site By <a href="http://pluginbuddy.com/">PluginBuddy</a><br /></pre>
*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.
+
*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.
  
 
*Related thread:
 
*Related thread:
 
**http://ithemes.com/forum/index.php?/topic/14450-removing-the-pluginbuddy-link-from-the-footer/
 
**http://ithemes.com/forum/index.php?/topic/14450-removing-the-pluginbuddy-link-from-the-footer/
  
==Additional Resources==
+
===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"<br />
 +
 
 +
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 http://www.yoursite.com/mobile-home/ (the page create at #1)<br />
 +
Set this new menu as the default menu for "''PluginBuddy Mobile Navigation Menu''"<br />
 +
 
 +
3: edit index.php in your mobile theme and add the following line at the very top:
 +
<pre class="brush:php;">
 +
<?php wp_redirect( 'http://www.yoursite.com/mobile-home/', 302 ); exit; ?>
 +
</pre>
 +
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 <code>wp-content/uploads/pluginbuddy_mobile/{theme you are using}/</code>
 +
 
 +
That should make sure that the home link on your mobile site, as well as the landing page resolves to your mobile homepage
 +
 
 +
===Change the default Home page when using a specific landing page===
 +
 
 +
'''This applies if your site is 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"<br />
 +
 
 +
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 http://www.yoursite.com/mobile-home/ (the page create at #1)<br />
 +
Set this new menu as the default menu for "''PluginBuddy Mobile Navigation Menu''"<br />
 +
 
 +
3: [http://www.techtrot.com/wordpress-page-id/ find the page id] for the page that you have set as the homepage for your non-mobile site (e.g. page-123)
 +
 
 +
4: create a new file in you mobile theme and add the following code:
 +
<pre class="brush:php;">
 +
<?php wp_redirect( 'http://www.yoursite.com/mobile-home/', 302 ); exit; ?>
 +
</pre>
 +
 
 +
Save that file, '''and name it page-123.php'''.
 +
 
 +
Note that you need to use FTP or your hosting filemanager to add page-123.php file to your mobile theme. It should go in <code>wp-content/uploads/pluginbuddy_mobile/{theme you are using}/</code>
 +
 
 +
=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.
 +
 
 +
*SexyBookmarks (by Shareaholic) - Version 4.0.6.2
 +
**Dropdown menu has been confirmed to not work properly with this version
 +
***http://ithemes.com/forum/index.php?/topic/19455-mobile-theme-not-working/
 +
 
 +
=Additional Resources=
 
* [http://pluginbuddy.com/purchase/mobile/ Purchase Mobile]
 
* [http://pluginbuddy.com/purchase/mobile/ Purchase Mobile]
 
* [http://pluginbuddy.com/tutorials/ PluginBuddy Tutorials]
 
* [http://pluginbuddy.com/tutorials/ PluginBuddy Tutorials]

Revision as of 15:16, July 22, 2012

Advanced technical support for Mobile:

Contents

Documentation

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') ) {
   echo 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="http://pluginbuddy.com/">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 http://www.yoursite.com/mobile-home/ (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( 'http://www.yoursite.com/mobile-home/', 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

Change the default Home page when using a specific landing page

This applies if your site is 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 http://www.yoursite.com/mobile-home/ (the page create at #1)
Set this new menu as the default menu for "PluginBuddy Mobile Navigation Menu"

3: find the page id for the page that you have set as the homepage for your non-mobile site (e.g. page-123)

4: create a new file in you mobile theme and add the following code:

<?php wp_redirect( 'http://www.yoursite.com/mobile-home/', 302 ); exit; ?>

Save that file, and name it page-123.php.

Note that you need to use FTP or your hosting filemanager to add page-123.php file to your mobile theme. It should go in wp-content/uploads/pluginbuddy_mobile/{theme you are using}/

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

Personal tools
Namespaces
Variants
Actions
iThemes Codex
Codex Navigation
Toolbox