The mobile module provides detection for mobile devices, and can serve a different SilverStripe theme to them.The module can either use redirection to a separate mobile domain, or serve mobile optimized content under the same URLs.
The mobile module provides detection for mobile devices, and can serve a different SilverStripe theme to them. The module can either use redirection to a separate mobile domain, or serve mobile optimised content under the same URLs. It includes a default "blackcandymobile" theme to demonstrate the effects.
The codebase relies on server-side device detection based on user agent strings, which is an unreliable way to determine if a device is considered to be "mobile".
Responsive design is not covered by this module, and can be achieved with standard SilverStripe functionality.
Sean Harvey (Nickname: halkyon, sharvey)
Will Rossiter (Nickname: wrossiter, willr)
Unpack and copy the mobile folder into your SilverStripe project.
Run "dev/build" in your browser, for example: "http://localhost/silverstripe/dev/build?flush=all"
A new theme called "blackcandymobile" will be created in your themes folder after invoking the database (dev) build. This theme is a good starting point which you can modify to create your own mobile theme.
If the themes folder can't be written to by the web server during dev/build, please manually copy "blackcandymobile" into your themes folder from the mobile folder.
Alternatively, the module contains a "jquerymobile" sample theme
which creates a basic navigation interface through jQuery Mobile.
To use this theme, copy it to
/themes in the same way,
and set it in your
SiteConfig as described below.
Once opened, there's a "Mobile" tab which exposes the configuration options of the mobile module.
These options are quite simple. One set of radio buttons controls the behaviour of the mobile site, and there's text input fields to enter which domain you want to act as the mobile, and which is the full site, so that redirection can occur when a user accesses your site on a mobile device.
There's also a dropdown of all themes on the site. The theme chosen here will be the one that mobile users of your site will see.
Please keep in mind that the mobile domain must point to your site before it will work.
The module follows Google's recommendations by using a 301 HTTP redirection when using the module in "domain redirection" mode. When using the same URLs, but different themes for mobile and non-mobile content, Google will detect this change by using a different user agent, and index accordingly.