Difference between revisions of "OX6:OX Mobile Web Interface"

(Supported devices)
 
(200 intermediate revisions by 13 users not shown)
Line 1: Line 1:
= Information and Installation of Open-Xchange Mobile App (Beta)=
+
= Information and Installation of Open-Xchange Mobile Web Interface (Only for OX 6) =
  
 
== Description ==
 
== Description ==
 +
The Open-Xchange Mobile Web Interface provides you access to your data from the Open-Xchange Server 6 via your smartphone. The Open-Xchange Mobile Web Interface offers online and offline access to appointments, contacts and mails on the road using your smartphone's browser. Optimized for low bandwiths the Open-Xchange Mobile Web Interface offers instant and fast over the air access to your data, which are at the same time safely stored on Open-Xchange Server. The following modules are supported:
  
Later this year, Open-Xchange will release Open-Xchange Mobile App, which lets you access data from Open-Xchange Server 6 with your smartphone running a webkit based browser like the iPhone or Android devices.
 
Open-Xchange Mobile App offers online and offline access to appointments, contacts and mails on the road using your smartphone. Optimized for low bandwiths Open-Xchange Mobile App offers instant and fast over the air access to your data , which are at the same time safely stored on Open-Xchange Server. The following modules are supported:
 
 
*E-Mail
 
*E-Mail
 
*Calendar
 
*Calendar
 
*Contacts
 
*Contacts
  
Moreover, you can use start calls by clicking on a phone number in your Open-Xchange contacts on your Smartphone or directly send E-Mails.
+
Moreover the web interface offers seamless integration to use your phones basic functions like phone calls. You can easily start calls from your Open-Xchange contacts on your smartphone or directly send E-Mails.
  
== Features and Functions ==
 
  
=== Module Mail ===
+
===Themeability, branding and i18n ===
*Access on all Open-Xchange standard folder: Inbox, Sent, Trash, Spam and Drafts
 
*Creation of new e-mails
 
*Answer, forward and delete e-mails
 
  
=== Module Contact ===
+
* i18n for DE, EN, ES, FR, NL, PL and JP. Other languages can be added.
*Access on all Open-Xchange contact folder and contacts with details
+
* Themeability by CSS
*Integration of Google Maps® for address data
+
* JavaScript plugins for branding and custom functions.
*Creation of e-mail directly from contact module
 
*Start call directly from contact module
 
  
=== Module Calendar ===
 
* Access on all Open-Xchange calendar folder and appointments with details</li>
 
* Accept/Decline of appointments</li>
 
* Participants and resources list from all appointments</li>
 
* Planned: Additional notes for Accept/Decline function, creation of new appointments</li>
 
 
=== Persistence of the Mobile App ===
 
*Offline capability
 
*All contacts are available offline
 
*All appointments are available offline
 
*All mails header are available offline
 
*All mails which are opened once are available offline
 
 
===Configuration===
 
*Number of e-mails retrieved (25,50,75,100)
 
*Number of days which will be checked for appointments (5,10,20,30)
 
*Animation for iOS-devices (on/off)
 
*Subscribe of contact folder
 
*Autologin
 
 
===Themeability by CSS ===
 
*i18n for DE and EN
 
*Size optimized
 
*It is possible to create app icon on iPhone home screen
 
  
 
== Supported devices ==
 
== Supported devices ==
  
The OX Mobile App should work on devices running a Webkit based browser.
+
The Open-Xchange Mobile Web Interface is designed to run on modern devices running Android or iOS. It can also used with modern desktop browsers.
  
 
{|border="2" rules="all" align="left">
 
{|border="2" rules="all" align="left">
Line 59: Line 28:
 
   |&nbsp;
 
   |&nbsp;
 
|-
 
|-
   |Apple iPhone
+
   |Apple iOS
   |yes (iPhone OS 2.0, 2.1, 3.0, 4.0)
+
   |iOS 3 - 5.1
   |Official Supported from OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
+
   |
 
  |-
 
  |-
 
   |Android
 
   |Android
   |yes
+
   |yes, Android 2.2 - 4.0
   |Official Supported from OX: Google Nexus One (Android Froyo 2.2), HTC Desire (Sense Android 2.1)
+
   |Official Supported by OX: Google Nexus One (Android 2.3.3), Samsung Galaxy Nexus (Android 4.0.3). The web interface is optimized for a display size of 320 x 480 pixels. Smaller resolutions may result displaying issues of some UI elements
|-
 
  |Nokia/Symbian S60 5th Edition
 
  |no
 
  |SW Version 21.0.045
 
|-
 
  |Windows Mobile mit IE
 
  |no
 
  |
 
|-
 
|Windows Phone 7
 
|no
 
|
 
 
|-
 
|-
 
|}
 
|}
  
 
== Technical overview ==
 
== Technical overview ==
* Based on HTML5, CSS, Javascript, Frameworks jQuery and jQTouch
+
* Based on HTML5, CSS, Javascript (jQuery Mobile)
* Optimized for Webkit-Browser (iPhone, Android, S60, no iPad yet)
+
* Optimized for Webkit browsers like Mobile Safari and Chrome. Will also work with restrictions on Firefox and Opera Mobile
* Completely offline capability
+
* Complete offline capability
 +
 
 +
 
 +
'''Updates with version 1.1.0 rev 8'''
 +
 
 +
* True fixed toolbars:
 +
Version 1.1.0 rev 6 of the Mobile Web Interface used dynamic recalcualtion to re-position footer and header bars on the fly after scrolling the document. The new version of jQuery Mobile (1.1) now uses CSS based positioning which is truly native on supported platforms.
 +
 
 +
Some platforms like iOS 4 will now fall back to static positioning where the toolbars simply scroll with the page.
 +
 
 +
Platforms which support fixed toolbars:
 +
 
 +
* iOS5 – iPhone and iPad
 +
* Android 2.2 and 2.3
 +
* Android 3.x tablets (Honeycomb)
 +
* Android 4.x (ICS)
 +
* Chrome for Android (beta)
 +
* BB Playbook 1-2
 +
* All modern desktop browsers (IE, Firefox, Safari, Chrome, etc.)
 +
 
  
== Components ==
+
===Offline Mode details===
  
The Open-Xchange Mobile App (Beta) contains 2 parts. One part is dedicated to the iPhone as webclient and the other one is for most of the other mobile devices which dont have any WEBKIT powered browser installed. The OXtender is written in PHP and therefore requires that you have installed php5 on your Webserver including following modules which are need by the application:
+
The Open-Xchange Mobile Web Interface uses HTML5 to provide an offline mode for the user. To do this, there are two different kinds of storage mechanisms.
 +
 
 +
* The whole web interface uses caching by incorporating the "HTML5 application cache". This will be done on the first visit/start of the web interface. After this initial download, all graphics, language files, js-files and everything else which is needed to run the web interface is stored locally on your phone in a storage managed by the browser.
 +
 
 +
* The data from the OX server will be stored using the HTML5 storage mechanism which will be supportet by the users device. These can be a HTML5 local storage, session storage or an SQLite database. For the user there's no difference between these different storage modes.
  
*gettext
 
*json
 
*mcrypt
 
*curl
 
  
 
== Requirements ==
 
== Requirements ==
  
* Open-Xchange Server >= v.6.14
+
* Open-Xchange Server >= v.6.20 rev 21
* Debian Lenny or Etch, SUSE Linux Enterprise 10
 
* 1GB RAM
 
  
== Download ==
+
== Installation on Open-Xchange v6.22.x ==
  
Please note that everything from this page and beyond is in Beta: That means that nothing is final, changes will be made before final release, stability is not guaranteed and nothing from this site should be used in production.
+
=== Debian GNU/Linux 6.0 ===
  
Follow this [http://software.open-xchange.com/OX6/OXtender-unstable/MobileApp link] to download the Installation package and the Release Notes.
+
Add the following entry to /etc/apt/sources.list if not already present:
  
The access-data are:
+
deb http://LDBACCOUNT:LDBPASSWD@software.open-xchange.com/OX6/6.22/OXtender-stable/MobileWebInterface/DebianSqueeze/ /
* User name: oxmobileapp
 
* Password: first$cut
 
  
== Installation on the Open-Xchange Server==
+
and run
  
* Installation on the Apache or other Webserver
+
$ apt-get update
* After the download of the package, you can start the installation via your favorite package manager. On Debian you can use "dpkg -i" or on SUSE you would use the "rpm -Uvh" command.
+
$ apt-get install open-xchange-mobile open-xchange-mobile-theme-default open-xchange-mobile-config
* Please add a hostaddress at the config file
 
* Please note: You have the possibility to deploy the OXtender as hyprid-app via cross-compiling tools like PhoneGap
 
  
== Configuration ==
+
=== SUSE Linux Enterprise Server 11===
 +
 
 +
Add the package repository using zypper if not already present:
 +
 
 +
$ zypper ar http://LDBACCOUNT:LDBPASSWD@software.open-xchange.com/OX6/6.22/OXtender-stable/MobileWebInterface/SLES11 MobileWebInterface
 +
 
 +
and run
 +
 
 +
$ zypper ref
 +
$ zypper in open-xchange-mobile open-xchange-mobile-theme-default open-xchange-mobile-config
 +
 
 +
=== RedHat Enterprise Linux 6 ===
 +
 
 +
Start a console and create a software repository file if not already present:
 +
 
 +
$ vim /etc/yum.repos.d/MobileWebInterface.repo
 +
 
 +
[MobileWebInterface]
 +
name=Open-Xchange
 +
baseurl=http://LDBACCOUNT:LDBPASSWD@software.open-xchange.com/OX6/6.22/OXtender-stable/MobileWebInterface/RHEL6/
 +
gpgkey=http://software.open-xchange.com/oxbuildkey.pub
 +
enabled=1
 +
gpgcheck=1
 +
metadata_expire=0m
 +
 
 +
and run
 +
 
 +
$ yum update
 +
$ yum install open-xchange-mobile open-xchange-mobile-theme-default open-xchange-mobile-config
 +
 
 +
=== CentOS 6===
 +
 
 +
Start a console and create a software repository file if not already present:
 +
 
 +
$ vim /etc/yum.repos.d/MobileWebInterface.repo
 +
 
 +
[MobileWebInterface]
 +
name=Open-Xchange
 +
baseurl=http://LDBACCOUNT:LDBPASSWD@software.open-xchange.com/OX6/6.22/OXtender-stable/MobileWebInterface/RHEL6/
 +
gpgkey=http://software.open-xchange.com/oxbuildkey.pub
 +
enabled=1
 +
gpgcheck=1
 +
metadata_expire=0m
 +
 
 +
and run
 +
 
 +
$ yum update
 +
$ yum install open-xchange-mobile open-xchange-mobile-theme-default open-xchange-mobile-config
 +
 
 +
== Optional link to Mobile Web Interface in OX6 login mask (since 6.20.3) ==
 +
There is an optional plugin available which adds a link to the Mobile Web Interface to the common OX6 login screen.
 +
 
 +
=== Debian ===
 +
$ apt-get install open-xchange-gui-mobile-redirect-plugin
 +
 
 +
 
 +
=== SUSE Linux Enterprise Server ===
 +
$ zypper install open-xchange-gui-mobile-redirect-plugin
 +
 
 +
 
 +
=== RedHat Enterprise Linux ===
 +
$ yum install open-xchange-gui-mobile-redirect-plugin
 +
 
 +
 
 +
The plugin needs to be configured in ${DOCROOT}/ox6/plugins/com.openexchange.mobile.redirect/config/config.js
 +
 
 +
data = {
 +
    url: "https://m.example.com//",
 +
    isEnabled: function() {
 +
        return true;
 +
        //----- example to add a device check instead of always returning true -----//
 +
        // return (/iphone|ipod|android|/i.test(navigator.userAgent.toLowerCase()));
 +
    },
 +
    getText: function() {
 +
        return _("Switch to mobile version");
 +
    }
 +
};
 +
 
 +
 
 +
 
 +
 
 +
 
 +
== Upgrading from previous versions ==
 +
If you have the previous version of the Mobile Web Interface installed (1.0), you can not upgrade to version 1.1 or later directly. Due to a package rename you have to remove the old packages before installing the new ones. The packages for version 1.0 are prefixed with "open-xchange-gui-mobile-v2", the new ones are prefixed with "open-xchange-mobile*".
 +
 
 +
 
 +
=== Debian ===
 +
$ apt-get purge open-xchange-gui-mobile-v2
 +
$ apt-get purge open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2-theme-default
 +
 
 +
 
 +
=== SUSE Linux Enterprise Server ===
 +
$ zypper remove open-xchange-gui-mobile-v2
 +
$ zypper remove open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2-theme-default
 +
 
 +
 
 +
=== RedHat Enterprise Linux ===
 +
$ yum remove open-xchange-gui-mobile-v2
 +
$ yum remove open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2-theme-default
 +
 
 +
Please note, the package open-xchange-gui-mobile-v2 is located on your ox backend system, open-xchange-gui-mobile-v2-gui and open-xchange-gui-mobile-v2-theme-default are installed on your webserver machine. If both systems are the same you have to remove all packes on the same system.
 +
 
 +
After removing the old packages proceed with the installation of the new version 1.1 or later
 +
 
 +
== Installation on OX App Suite ==
 +
The download and installation information for Open-Xchange App Suite product family (Open-Xchange Server Edition and Hosting Edition) is available at: http://oxpedia.org/wiki/index.php?title=AppSuite:OX_Mobile_Web_Interface
 +
 
 +
 
 +
= Configuration =
 +
Installation on the Apache 2 webserver:
 +
 
 +
'''Important note for upgraders:'''
 +
In previous versions (lower 1.1) a server address had to be entered in the cache.manifest file to grant access to the OX6 backend. This not needed anymore. The new version of the mobile web grants per default access to all uncached ressources. Don't edit the cache.manifest manually.
 +
 
 +
* You need to add a new mimetype to your webserver configuration to make sure the caching (offline mode) works.
 +
** On Apache servers you can add the mimetype either global or via "<code>.htaccess</code>" file.
 +
** For global configuration edit the file <code>mime.conf</code> under  <code>/etc/apache2/mods-enabled/</code>
 +
** Add the line "<code>AddType text/cache-manifest .manifest</code>" to the file, save and restart apache
 +
** For configuration via <code>.htaccess</code> file just add a .htaccess file to the install directory. This should include the line  "<code>AddType text/cache-manifest .manifest'</code>". '''Note''': Either the global configuration or the .htaccess file should be used. (.htaccess files will only work if your Apache settings contain <code>AllowOverride</code>. For further information on mime types, please refer to your webservers user manual)
 +
 
 +
* To direct to the correct host another site in apache is needed. Create a file named "mobile" in /etc/apache2/sites-available (and enable it by linking to it from sites-enabled, of course):
 +
 
 +
<VirtualHost *:80>
 +
    ServerAdmin webmaster@localhost
 +
    ServerName mobile.YOUR_DOMAINAME.TLD
 +
    ServerAlias m.YOUR_DOMAINAME.TLD
 +
    DocumentRoot /var/www/mobile
 +
    <Directory />
 +
        Options FollowSymLinks
 +
        AllowOverride None
 +
    </Directory>
 +
    <Directory /var/www/mobile>
 +
        Options Indexes FollowSymLinks MultiViews
 +
        AllowOverride None
 +
        Order allow,deny
 +
        allow from all
 +
    </Directory>
 +
    ErrorLog /var/log/apache2/error.log
 +
    # Possible values include: debug, info, notice, warn, error, crit,
 +
    # alert, emerg.
 +
    LogLevel warn
 +
    CustomLog /var/log/apache2/access.log combined
 +
</VirtualHost>
  
* After the installation of the Open-Xchange Mobile App (Beta), you will find an Open-Xchange configuration file in /var/www/ox6-mobile/ called config.php. Please edit this file and set the hostname etc. according to your OX 6 installation. Make also sure your locales (en_EN@utf8,de_de@utf8)on the system are correctly installed and configured. Else you wont see any translated page.
 
 
* For more details and README see the systems documentation directory (/usr/share/doc).
 
* For more details and README see the systems documentation directory (/usr/share/doc).
  
==Reporting==
+
 
 +
=Running the Open-Xchange Mobile Web Interface on your smartphone=
 +
 
 +
After installation of the web interface on your webserver, a client can easily access the web interface via his phone's browser. We recommend to add a new subdomain to your web address to make access for clients easy. A short subdomain like <code>https://m.example.com</code> which points to your installation will save users from entering a long URL on their devices.
 +
 
 +
Like mentioned before, the Open-Xchange Mobile Web Interface is a pure web application. Due to this fact there is no installation or download needed to use this web interface on a smartphone. Just add a bookmark in your browser to access the web interface again later.
 +
 
 +
Especially on iOS devices there's a seamless integration within the native apps installed via the AppStore®. Just add a new bookmark to the Open-Xchange Mobile Web Interface and choose "Add to homescreen". After this, the Open-Xchange Mobile Web Interface will place a new app icon on the homescreen.
 +
 
 +
 
 +
==Using the offline mode==
 +
 
 +
During the first run, the web interface is stored localy on your smartphone. These caching mechanism makes a later access to the web interface very fast and gives you the possibility to run the web interface even if there's no internet connection available.
 +
 
 +
The Open-Xchange Mobile Web Interface detects on startup whether there's an internet connection available or not. If not, the web interface will start in offline mode. In this case most features which need a internet connection are disabled. In offline mode you can access all your subscribed contacts and all of your appointments. Also all your mail headlines are available. Furthermore each email which was opened earlier is available in offline mode.
 +
 
 +
 
 +
=Known Issues=
 +
 
 +
 
 +
==Client==
 +
 
 +
* The Open-Xchange Mobile Web Interface uses a custom, built-in navigation and history. To navigate back you will have to use the "back" buttons located on the top-left of the page. Using the browser's back button will sometimes not bring you back to the right page.
 +
 
 +
* If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.
 +
 
 +
 
 +
==Server==
 +
* The Open-Xchange backend uses a security mechanism called "IP check". This feature is enabled by default for a OX Server. This feature will have an impact on the usage of the Open-Xchange Mobile Web Interface, especially the option "Stay logged in". This feature will only work if your IP address does not change between the restarts of the web interface. If you are changing your network connection often when you travel around (different GSM spots, WIFI connections), your phone will get new IP addresses to access the internet. This will cause the OX backend to refuse your auto-login attempt (which is performed on every start of the web interface) because your IP address has changed. To avoid this you can either turn off the IP check feature on the OX backend or add the Open-Xchange Mobile Web Interface to the client whitelist table for IP-check. This will disable the IP check just for the web interface.
 +
 
 +
 
 +
= Theming =
 +
 
 +
The Open-Xchange Mobile Web Interface is themed via CSS and HTML. To create your own theme you will have to create new graphics and edit the css file in the theme path. To do so follow the steps below:
 +
 
 +
# Locate the theme path under "path to your webroot/mobile/theme"
 +
# To create your own theme make a copy of this folder and backup the original one
 +
# The folder contains a css file which holds all editable values for the web interface. To change values edit the original file or create a new one which overwrites some of the old styles. Use Firebug or the Chrome/Safari developer tools to locate css classes and styles you want to edit.
 +
# The folders "img" holds all graphics which are used in the web interface.
 +
# Always remember: Your are designing for mobile. This means: Keep fonts clear and easy to read. Keep file sizes small due to small bandwiths. Keep buttons big enought the user can touch them easily.
 +
 
 +
 
 +
=Reporting Bugs=
 +
 
 
Open-Xchange is interested in learning about bugs, specifically in your runtime environment. If you experience any misbehaviors, please report bugs via our public bugzilla:
 
Open-Xchange is interested in learning about bugs, specifically in your runtime environment. If you experience any misbehaviors, please report bugs via our public bugzilla:
[https://bugzilla.open-xchange.com/enter_bug.cgi?product=OX%20Mobile%20App Open-Xchange Bugzilla]<br>
+
[https://bugs.open-xchange.com/ Open-Xchange Bugzilla]<br>
Product: OX Mobile App
+
Product: Mobile Web Interface
  
== Please Note ==
+
The Open-Xchange Mobile Web Interface logs all errors to a logfile which can be found under Settings -> System Messages
  
After Installation of Open-Xchange Mobile App (Beta) on a Debian 32-bit systems Appointments may be displayed wrongly within the Mobile-GUI. Please read the SDB-Article to inform you about the reasons and solution.
 
  
 
[[Category: OX6]]
 
[[Category: OX6]]

Latest revision as of 09:44, 6 April 2017

Information and Installation of Open-Xchange Mobile Web Interface (Only for OX 6)

Description

The Open-Xchange Mobile Web Interface provides you access to your data from the Open-Xchange Server 6 via your smartphone. The Open-Xchange Mobile Web Interface offers online and offline access to appointments, contacts and mails on the road using your smartphone's browser. Optimized for low bandwiths the Open-Xchange Mobile Web Interface offers instant and fast over the air access to your data, which are at the same time safely stored on Open-Xchange Server. The following modules are supported:

  • E-Mail
  • Calendar
  • Contacts

Moreover the web interface offers seamless integration to use your phones basic functions like phone calls. You can easily start calls from your Open-Xchange contacts on your smartphone or directly send E-Mails.


Themeability, branding and i18n

  • i18n for DE, EN, ES, FR, NL, PL and JP. Other languages can be added.
  • Themeability by CSS
  • JavaScript plugins for branding and custom functions.


Supported devices

The Open-Xchange Mobile Web Interface is designed to run on modern devices running Android or iOS. It can also used with modern desktop browsers.

Device Support    
Apple iOS iOS 3 - 5.1
Android yes, Android 2.2 - 4.0 Official Supported by OX: Google Nexus One (Android 2.3.3), Samsung Galaxy Nexus (Android 4.0.3). The web interface is optimized for a display size of 320 x 480 pixels. Smaller resolutions may result displaying issues of some UI elements

Technical overview

  • Based on HTML5, CSS, Javascript (jQuery Mobile)
  • Optimized for Webkit browsers like Mobile Safari and Chrome. Will also work with restrictions on Firefox and Opera Mobile
  • Complete offline capability


Updates with version 1.1.0 rev 8

  • True fixed toolbars:

Version 1.1.0 rev 6 of the Mobile Web Interface used dynamic recalcualtion to re-position footer and header bars on the fly after scrolling the document. The new version of jQuery Mobile (1.1) now uses CSS based positioning which is truly native on supported platforms.

Some platforms like iOS 4 will now fall back to static positioning where the toolbars simply scroll with the page.

Platforms which support fixed toolbars:

  • iOS5 – iPhone and iPad
  • Android 2.2 and 2.3
  • Android 3.x tablets (Honeycomb)
  • Android 4.x (ICS)
  • Chrome for Android (beta)
  • BB Playbook 1-2
  • All modern desktop browsers (IE, Firefox, Safari, Chrome, etc.)


Offline Mode details

The Open-Xchange Mobile Web Interface uses HTML5 to provide an offline mode for the user. To do this, there are two different kinds of storage mechanisms.

  • The whole web interface uses caching by incorporating the "HTML5 application cache". This will be done on the first visit/start of the web interface. After this initial download, all graphics, language files, js-files and everything else which is needed to run the web interface is stored locally on your phone in a storage managed by the browser.
  • The data from the OX server will be stored using the HTML5 storage mechanism which will be supportet by the users device. These can be a HTML5 local storage, session storage or an SQLite database. For the user there's no difference between these different storage modes.


Requirements

  • Open-Xchange Server >= v.6.20 rev 21

Installation on Open-Xchange v6.22.x

Debian GNU/Linux 6.0

Add the following entry to /etc/apt/sources.list if not already present:

deb http://LDBACCOUNT:LDBPASSWD@software.open-xchange.com/OX6/6.22/OXtender-stable/MobileWebInterface/DebianSqueeze/ /

and run

$ apt-get update
$ apt-get install open-xchange-mobile open-xchange-mobile-theme-default open-xchange-mobile-config

SUSE Linux Enterprise Server 11

Add the package repository using zypper if not already present:

$ zypper ar http://LDBACCOUNT:LDBPASSWD@software.open-xchange.com/OX6/6.22/OXtender-stable/MobileWebInterface/SLES11 MobileWebInterface

and run

$ zypper ref
$ zypper in open-xchange-mobile open-xchange-mobile-theme-default open-xchange-mobile-config

RedHat Enterprise Linux 6

Start a console and create a software repository file if not already present:

$ vim /etc/yum.repos.d/MobileWebInterface.repo
[MobileWebInterface]
name=Open-Xchange
baseurl=http://LDBACCOUNT:LDBPASSWD@software.open-xchange.com/OX6/6.22/OXtender-stable/MobileWebInterface/RHEL6/
gpgkey=http://software.open-xchange.com/oxbuildkey.pub
enabled=1
gpgcheck=1
metadata_expire=0m

and run

$ yum update
$ yum install open-xchange-mobile open-xchange-mobile-theme-default open-xchange-mobile-config

CentOS 6

Start a console and create a software repository file if not already present:

$ vim /etc/yum.repos.d/MobileWebInterface.repo
[MobileWebInterface]
name=Open-Xchange
baseurl=http://LDBACCOUNT:LDBPASSWD@software.open-xchange.com/OX6/6.22/OXtender-stable/MobileWebInterface/RHEL6/
gpgkey=http://software.open-xchange.com/oxbuildkey.pub
enabled=1
gpgcheck=1
metadata_expire=0m

and run

$ yum update
$ yum install open-xchange-mobile open-xchange-mobile-theme-default open-xchange-mobile-config

Optional link to Mobile Web Interface in OX6 login mask (since 6.20.3)

There is an optional plugin available which adds a link to the Mobile Web Interface to the common OX6 login screen.

Debian

$ apt-get install open-xchange-gui-mobile-redirect-plugin


SUSE Linux Enterprise Server

$ zypper install open-xchange-gui-mobile-redirect-plugin


RedHat Enterprise Linux

$ yum install open-xchange-gui-mobile-redirect-plugin


The plugin needs to be configured in ${DOCROOT}/ox6/plugins/com.openexchange.mobile.redirect/config/config.js

data = {
    url: "https://m.example.com//",
    isEnabled: function() {
        return true;
        //----- example to add a device check instead of always returning true -----//
        // return (/iphone|ipod|android|/i.test(navigator.userAgent.toLowerCase()));
    },
    getText: function() {
        return _("Switch to mobile version");
    }
};



Upgrading from previous versions

If you have the previous version of the Mobile Web Interface installed (1.0), you can not upgrade to version 1.1 or later directly. Due to a package rename you have to remove the old packages before installing the new ones. The packages for version 1.0 are prefixed with "open-xchange-gui-mobile-v2", the new ones are prefixed with "open-xchange-mobile*".


Debian

$ apt-get purge open-xchange-gui-mobile-v2
$ apt-get purge open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2-theme-default


SUSE Linux Enterprise Server

$ zypper remove open-xchange-gui-mobile-v2
$ zypper remove open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2-theme-default


RedHat Enterprise Linux

$ yum remove open-xchange-gui-mobile-v2
$ yum remove open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2-theme-default

Please note, the package open-xchange-gui-mobile-v2 is located on your ox backend system, open-xchange-gui-mobile-v2-gui and open-xchange-gui-mobile-v2-theme-default are installed on your webserver machine. If both systems are the same you have to remove all packes on the same system.

After removing the old packages proceed with the installation of the new version 1.1 or later

Installation on OX App Suite

The download and installation information for Open-Xchange App Suite product family (Open-Xchange Server Edition and Hosting Edition) is available at: http://oxpedia.org/wiki/index.php?title=AppSuite:OX_Mobile_Web_Interface


Configuration

Installation on the Apache 2 webserver:

Important note for upgraders: In previous versions (lower 1.1) a server address had to be entered in the cache.manifest file to grant access to the OX6 backend. This not needed anymore. The new version of the mobile web grants per default access to all uncached ressources. Don't edit the cache.manifest manually.

  • You need to add a new mimetype to your webserver configuration to make sure the caching (offline mode) works.
    • On Apache servers you can add the mimetype either global or via ".htaccess" file.
    • For global configuration edit the file mime.conf under /etc/apache2/mods-enabled/
    • Add the line "AddType text/cache-manifest .manifest" to the file, save and restart apache
    • For configuration via .htaccess file just add a .htaccess file to the install directory. This should include the line "AddType text/cache-manifest .manifest'". Note: Either the global configuration or the .htaccess file should be used. (.htaccess files will only work if your Apache settings contain AllowOverride. For further information on mime types, please refer to your webservers user manual)
  • To direct to the correct host another site in apache is needed. Create a file named "mobile" in /etc/apache2/sites-available (and enable it by linking to it from sites-enabled, of course):
<VirtualHost *:80>
   ServerAdmin webmaster@localhost
   ServerName mobile.YOUR_DOMAINAME.TLD
   ServerAlias m.YOUR_DOMAINAME.TLD
   DocumentRoot /var/www/mobile
   <Directory />
       Options FollowSymLinks
       AllowOverride None
   </Directory>
   <Directory /var/www/mobile>
       Options Indexes FollowSymLinks MultiViews
       AllowOverride None
       Order allow,deny
       allow from all
   </Directory>
   ErrorLog /var/log/apache2/error.log
   # Possible values include: debug, info, notice, warn, error, crit,
   # alert, emerg.
   LogLevel warn
   CustomLog /var/log/apache2/access.log combined
</VirtualHost>
  • For more details and README see the systems documentation directory (/usr/share/doc).


Running the Open-Xchange Mobile Web Interface on your smartphone

After installation of the web interface on your webserver, a client can easily access the web interface via his phone's browser. We recommend to add a new subdomain to your web address to make access for clients easy. A short subdomain like https://m.example.com which points to your installation will save users from entering a long URL on their devices.

Like mentioned before, the Open-Xchange Mobile Web Interface is a pure web application. Due to this fact there is no installation or download needed to use this web interface on a smartphone. Just add a bookmark in your browser to access the web interface again later.

Especially on iOS devices there's a seamless integration within the native apps installed via the AppStore®. Just add a new bookmark to the Open-Xchange Mobile Web Interface and choose "Add to homescreen". After this, the Open-Xchange Mobile Web Interface will place a new app icon on the homescreen.


Using the offline mode

During the first run, the web interface is stored localy on your smartphone. These caching mechanism makes a later access to the web interface very fast and gives you the possibility to run the web interface even if there's no internet connection available.

The Open-Xchange Mobile Web Interface detects on startup whether there's an internet connection available or not. If not, the web interface will start in offline mode. In this case most features which need a internet connection are disabled. In offline mode you can access all your subscribed contacts and all of your appointments. Also all your mail headlines are available. Furthermore each email which was opened earlier is available in offline mode.


Known Issues

Client

  • The Open-Xchange Mobile Web Interface uses a custom, built-in navigation and history. To navigate back you will have to use the "back" buttons located on the top-left of the page. Using the browser's back button will sometimes not bring you back to the right page.
  • If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.


Server

  • The Open-Xchange backend uses a security mechanism called "IP check". This feature is enabled by default for a OX Server. This feature will have an impact on the usage of the Open-Xchange Mobile Web Interface, especially the option "Stay logged in". This feature will only work if your IP address does not change between the restarts of the web interface. If you are changing your network connection often when you travel around (different GSM spots, WIFI connections), your phone will get new IP addresses to access the internet. This will cause the OX backend to refuse your auto-login attempt (which is performed on every start of the web interface) because your IP address has changed. To avoid this you can either turn off the IP check feature on the OX backend or add the Open-Xchange Mobile Web Interface to the client whitelist table for IP-check. This will disable the IP check just for the web interface.


Theming

The Open-Xchange Mobile Web Interface is themed via CSS and HTML. To create your own theme you will have to create new graphics and edit the css file in the theme path. To do so follow the steps below:

  1. Locate the theme path under "path to your webroot/mobile/theme"
  2. To create your own theme make a copy of this folder and backup the original one
  3. The folder contains a css file which holds all editable values for the web interface. To change values edit the original file or create a new one which overwrites some of the old styles. Use Firebug or the Chrome/Safari developer tools to locate css classes and styles you want to edit.
  4. The folders "img" holds all graphics which are used in the web interface.
  5. Always remember: Your are designing for mobile. This means: Keep fonts clear and easy to read. Keep file sizes small due to small bandwiths. Keep buttons big enought the user can touch them easily.


Reporting Bugs

Open-Xchange is interested in learning about bugs, specifically in your runtime environment. If you experience any misbehaviors, please report bugs via our public bugzilla: Open-Xchange Bugzilla
Product: Mobile Web Interface

The Open-Xchange Mobile Web Interface logs all errors to a logfile which can be found under Settings -> System Messages