Roundcube for Mobile Devices

We are well aware of the fact that Roundcube performs nicely on desktop browsers, it can be operated on tablets but when opening Roundcube from a smartphone, you’re out of luck.

Although creating a fully responsive theme which works on all screen sizes is on our roadmap and some volunteers are currently drafting it, we still looking at several months until the fully integrated solution will be available.

Luckily there are alternatives, thanks to the nature of free software! The most sophisticated amongst them is the Melanie2 Larry Mobile theme by Thomas Payen. It builds on top of the jQuery Mobile framework and completely replaces the default Roundcube skin with a fully optimized view when connecting with a mobile device. To do the automatic switch, the help of an additional Roundcube plugin is required. So here’s a quick guide how to install all the pieces in order to make your Roundcube mobile friendly:

1. Download the theme from GitHub

git clone https://github.com/messagerie-melanie2/Roundcube-Skin-Melanie2-Larry-Mobile.git skins/melanie2_larry_mobile

If you don’t have a git client available, simply download the Zip archive and unpack it into skins/melanie2_larry_mobile.

2. Install “mobile” and “jquery_mobile” plugins

php composer.phar require melanie2/mobile:dev-master

Since jquery_mobile is a dependency of the mobile plugin, this command will install both plugins right away.

ATTENTION: only the mobile plugin should be activated in Roundcube. Thus, when prompted “Do you want to activate the plugin jquery_mobile? [N|y]“, type “n” and later when the same prompt appears again for the mobile plugin, accept with “y“.

That’s already it.

With both the melanie2_larry_mobile skin and the mobile plugin installed, mobile devices will automatically see the mobile theme when accessing Roundcube. Kudos to Thomas, who added the missing piece to the Roundcube universe!

5 thoughts on “Roundcube for Mobile Devices

  1. oper says:

    1. download jquery_mobile”(https://github.com/messagerie-melanie2/Roundcube-Plugin-JQuery-Mobile) and “mobile” (https://github.com/messagerie-melanie2/Roundcube-Plugin-Mobile) in roundcube/plugins

    2. dowload composer.phar (https://getcomposer.org/download/1.1.2/composer.phar) in roundcube/plugins

    3. running ‘php composer.phar require melanie2/mobile:dev-master’
    show following message, how to fix it please
    ./composer.json has been created
    Loading composer repositories with package information

    Installation failed, deleting ./composer.json.

    [Composer\Downloader\TransportException]
    The “https://packagist.org/packages.json” file could not be downloaded: allow_url_fopen must be enabled in php.ini (https:// wrapper is disabled in the server configuration by allow_url_fopen=0
    failed to open stream: no suitable wrapper could be found)

    require [–dev] [–prefer-source] [–prefer-dist] [–no-progress] [–no-update] [–update-no-dev] [–update-with-dependencies] [–ignore-platform-reqs] [–sort-packages] [-o|–optimize-autoloader] [-a|–classmap-authoritative] [–] []…

    sorry , I don’t know how to install plug in Roundcube

  2. Peter Pan says:

    @oper

    you need to set allow_url_fopen=1 in php.ini. after successful installation set it back to 0 (security).

  3. Wignu says:

    @oper Hi There, tried installing the plugins and received error:

    “The requested package melanie2/mobile could not be found in any version, there may be a typo in the package name.”

    Do you know if the package has been changed?

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s