Mobilize

Yes, we highly recommend that you make a separate website for cell phones and other mobile devices with small screens. This will make sure visitors using those types of devices will have the best browsing experience possible. Our MobileFusion and SmartDock Mobile themes were created specifically for use with iPhones, cell phones, and similar devices.

If you've ever accessed a major website (like YouTube) from a cell phone, you'll notice that it's quite different from the site you see when visiting from a desktop computer. It's easier to navigate and loads quickly, with less graphics than the regular site. This is the kind of browsing experience you want your mobile visitors to have, and the best way to do that with RapidWeaver® is to create a separate mobile website.

If you create a link from the mobile site to the desktop version (using the "allowMobile" tag described in the Mobilize User Guide), and a visitor to your website clicks on that link, Mobilize remember’s the visitor's preference by storing a cookie in the visitor's browser.

That way the user doesn’t get redirected to the mobile site, time and time again, when they are wanting to view the full desktop version.

To reset the cookie you can put a “View Mobile Site” link on the desktop version (set the “allowMobile” tag to “false” for that link) to reset the cookie.

If you are using cruftless links then it doesn’t matter what file extension your actual pages use, as the URLs indexed by Google and other search engines will not include the file names/extensions.

However, if you have not been using cruftless links for your site so far then you can use a .htaccess file (or similar) to redirect the “old” URLs to the “new” URLs that use the .php file extension. Or, better yet, to the “new” URLs that use cruftless links as mentioned above.

For more information on .htaccess files and how they can be used to redirect visitors trying to access “old” URLs, contact your hosting provider (a quick Google search will also provide many sources of information).

Mobilize uses a .php file extension - if you had previously used a .html or similar file extension for that page, then that means the "old" file (with the .html extension) is still on your hosting account. RapidWeaver® does not remove old files when publishing your website, so you will need to use a FTP program to login to your hosting account and manually remove the "old" file.

The reason for this is because web browsers will, by default (and when given the choice), choose to display a .html file even if there is a .php version of the same file located on your hosting account. As such, the .html version of the file must be removed for web browsers to display the .php page to your visitors.

Version 1.2

Upon completing your purchase you will be redirected to a page that displays your Mobilize serial number and a download link for the Mobilize plugin itself. Additionally, your serial number and download link will be sent via email, to the address specified during checkout.

To activate Mobilize, paste the serial number into the Page Inspector -> Page -> Mobilize Serial Number field, for any Mobilize page in your RapidWeaver® project, then click the Activate button.

Version 1.1.x and Previous

After your transaction was completed, a custom license file was automatically generated and emailed to you. (If you can't find that email, be sure to check your spam folder). You'll need to drag and drop your license file into Mobilize to activate it. Here are directions on how to do so:

  1. Open a Mobilize page in RapidWeaver®, and then open the Page Inspector.
  2. Make sure you've selected the "Page" tab in the Page Inspector.
  3. Drag and drop your license file into the text field indicated by the Page Inspector.
  4. Click Activate, and Mobilize will register your copy and remove all the restrictions.

Version 1.2

License files were replaced with serial numbers starting in v1.2. When entering your serial number make sure there are no excess empty spaces at the beginning or end. These spaces will cause the activation to fail, and for an "invalid serial number" error to be displayed.

Version 1.1.x and Previous

The first thing to check is whether your license file includes spaces in the name of the file itself (or in the path to the file), for example "First Name.mobilize". Currently, the Mobilize plugin can't process spaces in the file name (or in the path to the file).

If there is a space in the file name of your license file follow these steps to activate Mobilize:

  1. Drag your Mobilize license file to the Desktop. For each of the following steps, use this file you have added to the Desktop.
  2. Remove the space from the license file name.
  3. Drag the file to the License Text Activation Field in RapidWeaver®'s Page Inspector.

If you have followed the above directions and still cannot activate Mobilize, there are a couple possible causes:

  1. Your name may include certain special characters (like ü, å, é, etc.) that cannot be processed by by the activation system. If this applies to you, please contact us and we will be happy to re-issue you a new license file.

  2. Though it doesn't happen often, there's also a possibility that your email client could be altering the license file, which would prevent it from being properly read by Mobilize. To get around this, we suggest forwarding the email with your license file to another email address (gmail or something similar, Apple's Mail program will also work fine with Mobilize license files), then download the file to your Mac from there and add it to Mobilize.

Mobilize works great with RW5 and with all 3rd party themes, and there's nothing you need to do if you're using a Mobilize page to redirect visitors to your site.

That being said, if you are adding redirect functionality to a non-Mobilize page in your site, then you may need to adjust the code that Mobilize generates for you. Currently, it will be something like this:

<?php

include("assets/Mobilize.php");

$detect = new Mobilize();

if($detect->isMobile()) {

header( 'Location: http://mobile.yourwebsite.com' );

}

//This page is set to ignore all desktop-class web browsers.

?>

Note the line with "include", and that it is looking for the Mobilize.php file is a folder called "assets". RW5 has changed how it handles page assets - they are now located in a single, sitewide "resources" folder at the root of your website. This means the path to the Mobilize.php file will need to be changed, and here's how to do so (make sure you've updated RapidWeaver® to at least version 5.0.2):

  1. Locate this line of code:

    include("assets/Mobilize.php");

  2. Change it to this:

    include("%resource(Mobilize.php)%");

  3. If your Mobilize.php file is located inside a folder of your site resources, for example "files", then you will need to include the name of that folder as well, like so:

    include("%resource(files/Mobilize.php)%");

For more information about the difference between RW4 and RW5 regarding page assets and sitewide resources, see this post on our blog.

Many online simulators do not properly identify themselves as a "mobile" device, which is why Mobilize doesn't redirect them to the URL you have specified. As such, online simulators are typically not a reliable way to check how your site looks on a mobile device.

Whenever possible, we highly recommend using an actual mobile device to test if your Mobilize page is working correctly.

Not exactly. Mobilize is a "gatekeeper" or "traffic cop" type of plugin. It checks when people visit your website to see if they are using a cell phone or mobile device. If they are, Mobilize will send them to your mobile website.

Keep in mind, Mobilize will not alter or change the theme you are using, or how your website looks.