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.
Please note: this module is no longer actively maintained.
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".
The W3C recommends a "One web" approach
that uses "Responsive Design"
to adapt content, rather than create isolated mobile experiences under their own domain.
Most of the work on mobile optimization will be in client-side techniques
Responsive design is not covered by this module, and can be achieved with standard
The module also exposes this state in SilverStripe controllers
Sean Harvey (Nickname: halkyon, sharvey)
<sean (at) silverstripe (dot) com>
Will Rossiter (Nickname: wrossiter, willr)
<will (at) silverstripe (dot) com>
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.
Module rating system helping users find modules that are well supported. For more on how the rating system works visit Module standards
Score not correct? Let us know there is a problem