Open-Xchange - User contributions [en]

OX6:OX Mobile Web Interface

2011-08-25T07:43:09Z

Alexquast: /* Requirements */

= Information and Installation of Open-Xchange Mobile Web App =

== Description ==

The Open-Xchange Mobile Web App provides you access to your data from the Open-Xchange Server 6 via your smartphone. The Open-Xchange Mobile Web App 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 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
*Calendar
*Contacts

Moreover the app 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 ==

=== Mail Module ===
*Access to all Open-Xchange private mail folders
*Creation of new e-mails
*Answer, forward and delete e-mails
*Mail attachments (Attachment handling/support is defined by mobile device)

=== Contact Module ===
*Access to all Open-Xchange contact folders and contacts with details
*Creation of e-mails directly from contact module
*Start calls directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folders and appointments with details
* Accept/Decline appointments
* View participants, resources and notes each appointment

=== Persistence of the Mobile Web App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Subscription of mail folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE, EN, ES, FR, NL and PL, other languages can be added.
* Branding options: App name and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile Web App runs on devices with a Webkit-based browser. These are mainly devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend using Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1, 4.3)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android 2.3.3), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|yes
|Opera Mobile is recommended to guarantee a proper user experience. Symbian's default browser is simply too slow. (Tested on Opera Mobile 11.10.14xx)
|-
|Windows Mobile 6.5 running Internet Explorer
|no, not planed
|
|-
|Windows Phone 7
|not yet, scheduled for version 1.2
|
|-
|}

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

===Offline Mode details===

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

* The whole application will be cached using the "HTML5 application cache". This will be done on the first visit/start of the app. After this initial download, all graphics, language files, js-files and everything else which is needed to run the app 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.

Note: In case your device has no storage support (like the Nokia N97), a log message will inform you about this. The log can be found under the settings page, hitting the button in the upper right corner showing the exclamation mark symbol.

== Requirements ==

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

{{InstallPlugin|pluginname=open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2-theme-default open-xchange-gui-mobile-v2|sopath=OXtender-stable/MobileApp|reponame=mobilewebapp}}

{{UpdatePackage}}

== Configuration ==

Installation on the Apache or another webserver:
* After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
* Edit the file <code>"ox-access.conf"</code> in directory ox6-mobile-v2
* Change localhost to the address the mobile app will be reachable followed by "/ajax", i.e. "<code>https://m.example.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
* The Mobile App acts like a second UI next to the normal web frontend.
* run the command (adopt webserver path on SLES/RHEL).
$ /opt/open-xchange/sbin/update-cache.manifest /var/www/ox6-mobile-v2/cache.manifest.in /var/www/ox6-mobile-v2/cache.manifest /var/www/ox6-mobile-v2/ox-access.conf
* You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile Web App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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 OX Mobile Web App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile Web App and choose "Add to homescreen". After this, the OX Mobile Web App will place a new app icon on the homescreen.

===Common mistakes===
Most problems can be solved by clearing the browser cache and reload the app. Try this before you request a bug or change the server settings.

Problem: After login a page is shown showing "Connection problem. Received response code 0".

Resolution: Your ox-access.conf is not configured correctlly. You must enter the full web app server address followed by the /ajax path. Server address means the full url a user will type in his browser to access the app. I.e. "https://m.example.com/". If everything on the backend is configured correctly, try to reload the app.

Problem: Using the browser's back button brings me back to the login page. After this the app does not work correctly.

Resolution: Only use the navigation of the app. On each subpage a back button is located at the upper left corner which brings you back to the previous page.

===Using the offline mode===

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

The OX Mobile Web App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' The Mobile Web App will detect the state of your internet connection live. Open the log under the settings page for informations

==Known Issues==

===Client===

* The OX Mobile Web App 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. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

* If you want to use the App in airplane mode or no network connection is availabe, the android browser will show up a message like "page could not be loaded due to missing network connection". Just ignore this alert and press "OK". The app will work in offline mode even android shows up this message.

* If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.

===Server===
* The OX 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 OX Mobile App, especially the option "Stay logged in". This feature will only work if your IP address does not change between the restarts of the app. 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 App) because your IP address has changed.

To avoid this you can either turn off the IP check feature on the OX backend or set up a second server with weaker security settings only for mobile clients.

== Deployment as native app ==

The OX Mobile Web App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile Web App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile Web App comes with the standard name set "OX Mobile Web App". This title is saved in a png file under "/lib/jqtouch/themes/default/external/i18n_img/brand_[locale].png". To brand the app with your custom title just replace the files for each language to your needs. The i18n tool will show the graphic for each language. To configure the page title (in html title tag) please use the customisation plugin located at custom/custom.js

* open the file custom.js in folder "custom" located at your install dir
* open the file custom.js.sample located in the same folder
* use the sample file as template for your customisations. Change the values of APP_TITLE and ABOUT_PAGE_TEXT to your needs.
* copy and overwrite your custom.js.sample to the file custom.js

== Theming ==

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

# Locate the theme path under "path to your webroot/ox6-mobile-v2/lib/jqtouch/themes"
# The default theme is named "default". 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 app. 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. Then create a new css file and place it next to mox.min.css. Edit this file to your needs and add a new "style" tag to the index.html just AFTER the mox.min.css style tag. This will ensure that your styles overwrite the original ones.
# The folders "img" and "external" hold all graphics which are used in the app. To change them, just edit and save them under the same name. Don't change filenames or the theme will be broken. Also keep all file dimensions and file types (*.png, *.jpg). Changing files dimensions will corrupt the theme and layout will be broken.
# 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:
[https://bugzilla.open-xchange.com/enter_bug.cgi?product=OX%20Mobile%20Web%20App Open-Xchange Bugzilla] 
Product: OX Mobile Web App

The OX Mobile Web App logs all errors to a logfile which can be found under settings -> log.

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-08-11T11:51:56Z

Alexquast: /* Supported devices */

= Information and Installation of Open-Xchange Mobile Web App =

== Description ==

The Open-Xchange Mobile Web App provides you access to your data from the Open-Xchange Server 6 via your smartphone. The Open-Xchange Mobile Web App 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 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
*Calendar
*Contacts

Moreover the app 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 ==

=== Mail Module ===
*Access to all Open-Xchange private mail folders
*Creation of new e-mails
*Answer, forward and delete e-mails
*Mail attachments (Attachment handling/support is defined by mobile device)

=== Contact Module ===
*Access to all Open-Xchange contact folders and contacts with details
*Creation of e-mails directly from contact module
*Start calls directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folders and appointments with details
* Accept/Decline appointments
* View participants, resources and notes each appointment

=== Persistence of the Mobile Web App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Subscription of mail folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE, EN, ES, FR, NL and PL, other languages can be added.
* Branding options: App name and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile Web App runs on devices with a Webkit-based browser. These are mainly devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend using Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1, 4.3)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android 2.3.3), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|yes
|Opera Mobile is recommended to guarantee a proper user experience. Symbian's default browser is simply too slow. (Tested on Opera Mobile 11.10.14xx)
|-
|Windows Mobile 6.5 running Internet Explorer
|no, not planed
|
|-
|Windows Phone 7
|not yet, scheduled for version 1.2
|
|-
|}

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

===Offline Mode details===

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

* The whole application will be cached using the "HTML5 application cache". This will be done on the first visit/start of the app. After this initial download, all graphics, language files, js-files and everything else which is needed to run the app 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.

Note: In case your device has no storage support (like the Nokia N97), a log message will inform you about this. The log can be found under the settings page, hitting the button in the upper right corner showing the exclamation mark symbol.

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

{{InstallPlugin|pluginname=open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2-theme-default open-xchange-gui-mobile-v2|sopath=OXtender-stable/MobileApp|reponame=mobilewebapp}}

{{UpdatePackage}}

== Configuration ==

Installation on the Apache or another webserver:
* After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
* Edit the file <code>"ox-access.conf"</code> in directory ox6-mobile-v2
* Change localhost to the address the mobile app will be reachable followed by "/ajax", i.e. "<code>https://m.example.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
* The Mobile App acts like a second UI next to the normal web frontend.
* run the command (adopt webserver path on SLES/RHEL).
$ /opt/open-xchange/sbin/update-cache.manifest /var/www/ox6-mobile-v2/cache.manifest.in /var/www/ox6-mobile-v2/cache.manifest /var/www/ox6-mobile-v2/ox-access.conf
* You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile Web App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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 OX Mobile Web App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile Web App and choose "Add to homescreen". After this, the OX Mobile Web App will place a new app icon on the homescreen.

===Common mistakes===
Most problems can be solved by clearing the browser cache and reload the app. Try this before you request a bug or change the server settings.

Problem: After login a page is shown showing "Connection problem. Received response code 0".

Resolution: Your ox-access.conf is not configured correctlly. You must enter the full web app server address followed by the /ajax path. Server address means the full url a user will type in his browser to access the app. I.e. "https://m.example.com/". If everything on the backend is configured correctly, try to reload the app.

Problem: Using the browser's back button brings me back to the login page. After this the app does not work correctly.

Resolution: Only use the navigation of the app. On each subpage a back button is located at the upper left corner which brings you back to the previous page.

===Using the offline mode===

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

The OX Mobile Web App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' The Mobile Web App will detect the state of your internet connection live. Open the log under the settings page for informations

==Known Issues==

===Client===

* The OX Mobile Web App 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. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

* If you want to use the App in airplane mode or no network connection is availabe, the android browser will show up a message like "page could not be loaded due to missing network connection". Just ignore this alert and press "OK". The app will work in offline mode even android shows up this message.

* If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.

===Server===
* The OX 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 OX Mobile App, especially the option "Stay logged in". This feature will only work if your IP address does not change between the restarts of the app. 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 App) because your IP address has changed.

To avoid this you can either turn off the IP check feature on the OX backend or set up a second server with weaker security settings only for mobile clients.

== Deployment as native app ==

The OX Mobile Web App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile Web App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile Web App comes with the standard name set "OX Mobile Web App". This title is saved in a png file under "/lib/jqtouch/themes/default/external/i18n_img/brand_[locale].png". To brand the app with your custom title just replace the files for each language to your needs. The i18n tool will show the graphic for each language. To configure the page title (in html title tag) please use the customisation plugin located at custom/custom.js

* open the file custom.js in folder "custom" located at your install dir
* open the file custom.js.sample located in the same folder
* use the sample file as template for your customisations. Change the values of APP_TITLE and ABOUT_PAGE_TEXT to your needs.
* copy and overwrite your custom.js.sample to the file custom.js

== Theming ==

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

# Locate the theme path under "path to your webroot/ox6-mobile-v2/lib/jqtouch/themes"
# The default theme is named "default". 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 app. 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. Then create a new css file and place it next to mox.min.css. Edit this file to your needs and add a new "style" tag to the index.html just AFTER the mox.min.css style tag. This will ensure that your styles overwrite the original ones.
# The folders "img" and "external" hold all graphics which are used in the app. To change them, just edit and save them under the same name. Don't change filenames or the theme will be broken. Also keep all file dimensions and file types (*.png, *.jpg). Changing files dimensions will corrupt the theme and layout will be broken.
# 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:
[https://bugzilla.open-xchange.com/enter_bug.cgi?product=OX%20Mobile%20Web%20App Open-Xchange Bugzilla] 
Product: OX Mobile Web App

The OX Mobile Web App logs all errors to a logfile which can be found under settings -> log.

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-08-04T08:24:17Z

Alexquast: /* Known Problems */

= Information and Installation of Open-Xchange Mobile Web App =

== Description ==

The Open-Xchange Mobile Web App provides you access to your data from the Open-Xchange Server 6 via your smartphone. The Open-Xchange Mobile Web App 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 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
*Calendar
*Contacts

Moreover the app 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 ==

=== Mail Module ===
*Access to all Open-Xchange private mail folders
*Creation of new e-mails
*Answer, forward and delete e-mails
*Mail attachments (Attachment handling/support is defined by mobile device)

=== Contact Module ===
*Access to all Open-Xchange contact folders and contacts with details
*Creation of e-mails directly from contact module
*Start calls directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folders and appointments with details
* Accept/Decline appointments
* View participants, resources and notes each appointment

=== Persistence of the Mobile Web App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Subscription of mail folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE, EN, ES, FR, NL and PL, other languages can be added.
* Branding options: App name and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile Web App runs on devices with a Webkit-based browser. These are mainly devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend using Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1, 4.3)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android 2.3.3), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|yes
|Opera Mobile is recommended to guarantee a proper user experience. Symbian's default browser is simply too slow.
|-
|Windows Mobile 6.5 running Internet Explorer
|no, not planed
|
|-
|Windows Phone 7
|not yet, scheduled for version 1.2
|
|-
|}

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

===Offline Mode details===

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

* The whole application will be cached using the "HTML5 application cache". This will be done on the first visit/start of the app. After this initial download, all graphics, language files, js-files and everything else which is needed to run the app 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.

Note: In case your device has no storage support (like the Nokia N97), a log message will inform you about this. The log can be found under the settings page, hitting the button in the upper right corner showing the exclamation mark symbol.

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

{{InstallPlugin|pluginname=open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2-theme-default open-xchange-gui-mobile-v2|sopath=OXtender-stable/MobileApp|reponame=mobilewebapp}}

{{UpdatePackage}}

== Configuration ==

Installation on the Apache or another webserver:
* After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
* Edit the file <code>"ox-access.conf"</code> in directory ox6-mobile-v2
* Change localhost to the address the mobile app will be reachable followed by "/ajax", i.e. "<code>https://m.example.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
* The Mobile App acts like a second UI next to the normal web frontend.
* run the command (adopt webserver path on SLES/RHEL).
$ /opt/open-xchange/sbin/update-cache.manifest /var/www/ox6-mobile-v2/cache.manifest.in /var/www/ox6-mobile-v2/cache.manifest /var/www/ox6-mobile-v2/ox-access.conf
* You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile Web App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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 OX Mobile Web App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile Web App and choose "Add to homescreen". After this, the OX Mobile Web App will place a new app icon on the homescreen.

===Common mistakes===
Most problems can be solved by clearing the browser cache and reload the app. Try this before you request a bug or change the server settings.

Problem: After login a page is shown showing "Connection problem. Received response code 0".

Resolution: Your ox-access.conf is not configured correctlly. You must enter the full web app server address followed by the /ajax path. Server address means the full url a user will type in his browser to access the app. I.e. "https://m.example.com/". If everything on the backend is configured correctly, try to reload the app.

Problem: Using the browser's back button brings me back to the login page. After this the app does not work correctly.

Resolution: Only use the navigation of the app. On each subpage a back button is located at the upper left corner which brings you back to the previous page.

===Using the offline mode===

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

The OX Mobile Web App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' The Mobile Web App will detect the state of your internet connection live. Open the log under the settings page for informations

==Known Issues==

===Client===

* The OX Mobile Web App 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. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

* If you want to use the App in airplane mode or no network connection is availabe, the android browser will show up a message like "page could not be loaded due to missing network connection". Just ignore this alert and press "OK". The app will work in offline mode even android shows up this message.

* If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.

===Server===
* The OX 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 OX Mobile App, especially the option "Stay logged in". This feature will only work if your IP address does not change between the restarts of the app. 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 App) because your IP address has changed.

To avoid this you can either turn off the IP check feature on the OX backend or set up a second server with weaker security settings only for mobile clients.

== Deployment as native app ==

The OX Mobile Web App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile Web App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile Web App comes with the standard name set "OX Mobile Web App". This title is saved in a png file under "/lib/jqtouch/themes/default/external/i18n_img/brand_[locale].png". To brand the app with your custom title just replace the files for each language to your needs. The i18n tool will show the graphic for each language. To configure the page title (in html title tag) please use the customisation plugin located at custom/custom.js

* open the file custom.js in folder "custom" located at your install dir
* open the file custom.js.sample located in the same folder
* use the sample file as template for your customisations. Change the values of APP_TITLE and ABOUT_PAGE_TEXT to your needs.
* copy and overwrite your custom.js.sample to the file custom.js

== Theming ==

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

# Locate the theme path under "path to your webroot/ox6-mobile-v2/lib/jqtouch/themes"
# The default theme is named "default". 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 app. 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. Then create a new css file and place it next to mox.min.css. Edit this file to your needs and add a new "style" tag to the index.html just AFTER the mox.min.css style tag. This will ensure that your styles overwrite the original ones.
# The folders "img" and "external" hold all graphics which are used in the app. To change them, just edit and save them under the same name. Don't change filenames or the theme will be broken. Also keep all file dimensions and file types (*.png, *.jpg). Changing files dimensions will corrupt the theme and layout will be broken.
# 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:
[https://bugzilla.open-xchange.com/enter_bug.cgi?product=OX%20Mobile%20Web%20App Open-Xchange Bugzilla] 
Product: OX Mobile Web App

The OX Mobile Web App logs all errors to a logfile which can be found under settings -> log.

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-07-04T09:53:19Z

Alexquast: /* Common mistakes */

= Information and Installation of Open-Xchange Mobile Web App =

== Description ==

The Open-Xchange Mobile Web App provides you access to your data from the Open-Xchange Server 6 via your smartphone. The Open-Xchange Mobile Web App 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 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
*Calendar
*Contacts

Moreover the app 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 ==

=== Mail Module ===
*Access to all Open-Xchange private mail folders
*Creation of new e-mails
*Answer, forward and delete e-mails
*Mail attachments (Attachment handling/support is defined by mobile device)

=== Contact Module ===
*Access to all Open-Xchange contact folders and contacts with details
*Creation of e-mails directly from contact module
*Start calls directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folders and appointments with details
* Accept/Decline appointments
* View participants, resources and notes each appointment

=== Persistence of the Mobile Web App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Subscription of mail folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE, EN, ES, FR, NL and PL, other languages can be added.
* Branding options: App name and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile Web App runs on devices with a Webkit-based browser. These are mainly devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend using Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1, 4.3)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android 2.3.3), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|yes
|Opera Mobile is recommended to guarantee a proper user experience. Symbian's default browser is simply too slow.
|-
|Windows Mobile 6.5 running Internet Explorer
|no, not planed
|
|-
|Windows Phone 7
|not yet, scheduled for version 1.2
|
|-
|}

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

===Offline Mode details===

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

* The whole application will be cached using the "HTML5 application cache". This will be done on the first visit/start of the app. After this initial download, all graphics, language files, js-files and everything else which is needed to run the app 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.

Note: In case your device has no storage support (like the Nokia N97), a log message will inform you about this. The log can be found under the settings page, hitting the button in the upper right corner showing the exclamation mark symbol.

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download & Documentation==

Follow this [http://software.open-xchange.com/OX6/OXtender-stable/MobileApp/ link] to download the installation package, Release Notes and documentation.

'''Please Note:''' You cannot just upgrade to this new version because we changed the versioning to a lower version (from 6.20.0.0 to 0.9.0). In order to install this latest version, you either need to uninstall the current version or download the latest version manually and install using

$ dpkg -i open-xchange-gui-mobile*.deb

on Debian and on RPM based systems

$ rpm --force -Uhv open-xchange-gui-mobile*.rpm

{{InstallPlugin|pluginname=open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2|sopath=OXtender-stable/MobileApp|reponame=mobilewebapp}}

== Configuration ==

Installation on the Apache or another webserver:
* After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
* Edit the file <code>"ox-access.conf"</code> in directory ox6-mobile-v2
* Change localhost to the address the mobile app will be reachable followed by "/ajax", i.e. "<code>https://m.example.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
* The Mobile App acts like a second UI next to the normal web frontend.
* run the command (adopt webserver path on SLES/RHEL).
$ /opt/open-xchange/sbin/update-cache.manifest /var/www/ox6-mobile-v2/cache.manifest.in /var/www/ox6-mobile-v2/cache.manifest /var/www/ox6-mobile-v2/ox-access.conf
* You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile Web App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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 OX Mobile Web App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile Web App and choose "Add to homescreen". After this, the OX Mobile Web App will place a new app icon on the homescreen.

===Common mistakes===
Most problems can be solved by clearing the browser cache and reload the app. Try this before you request a bug or change the server settings.

Problem: After login a page is shown showing "Connection problem. Received response code 0".

Resolution: Your ox-access.conf is not configured correctlly. You must enter the full web app server address followed by the /ajax path. Server address means the full url a user will type in his browser to access the app. I.e. "https://m.example.com/". If everything on the backend is configured correctly, try to reload the app.

Problem: Using the browser's back button brings me back to the login page. After this the app does not work correctly.

Resolution: Only use the navigation of the app. On each subpage a back button is located at the upper left corner which brings you back to the previous page.

===Using the offline mode===

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

The OX Mobile Web App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' The Mobile Web App will detect the state of your internet connection live. Open the log under the settings page for informations

===Known Problems===

* The OX Mobile Web App 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. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

* If you want to use the App in airplane mode or no network connection is availabe, the android browser will show up a message like "page could not be loaded due to missing network connection". Just ignore this alert and press "OK". The app will work in offline mode even android shows up this message.

* If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.

== Deployment as native app ==

The OX Mobile Web App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile Web App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile Web App comes with the standard name set "OX Mobile Web App". This title is saved in a png file under "/lib/jqtouch/themes/cupertino/external/i18n_img/brand_[locale].png". To brand the app with your custom title just replace the files for each language to your needs. The i18n tool will show the graphic for each language. To configure the page title (in html title tag) please use the i18n module:

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the line containing msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
# Do this for all language files
* Note: Do not change the '''msgid''', this must be "OX Mobile". Only change the '''msgstr''' value.

This title will also be the "App title" for the iPhone when the function "Add to homescreen" is used.

== Theming ==

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

# Locate the theme path under "path to your webroot/ox6-mobile-v2/lib/jqtouch/themes"
# The default theme is named "cupertino". To create your own theme make a copy of this folder and backup the original one
# The folder contains two css files and two folders with images. The file jqt_theme.css contains all styles which belong to the "overall" look of the app. These are styles for lists, buttons, background, toolbars and so on. The file ox_theme.css contains more high level theming styles such as module icons, progress bars, infobox and the way the details in lists are shown (like the appointment lists or mail list). To change the whole look of the app (like colors) you will mainly edit the file jqt_theme.css
# The folders "img" and "external" hold all graphics which are used in the app. To change them, just edit and save them under the same name. Don't change filenames or the theme will be broken. Also keep all file dimensions and file types (*.png, *.jpg). Changing files dimensions will corrupt the theme and layout will be broken.
# 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:
[https://bugzilla.open-xchange.com/enter_bug.cgi?product=OX%20Mobile%20Web%20App Open-Xchange Bugzilla] 
Product: OX Mobile Web App

The OX Mobile Web App logs all errors to a logfile which can be found under settings -> log.

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-07-04T09:49:22Z

Alexquast: /* Configuration */

= Information and Installation of Open-Xchange Mobile Web App =

== Description ==

The Open-Xchange Mobile Web App provides you access to your data from the Open-Xchange Server 6 via your smartphone. The Open-Xchange Mobile Web App 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 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
*Calendar
*Contacts

Moreover the app 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 ==

=== Mail Module ===
*Access to all Open-Xchange private mail folders
*Creation of new e-mails
*Answer, forward and delete e-mails
*Mail attachments (Attachment handling/support is defined by mobile device)

=== Contact Module ===
*Access to all Open-Xchange contact folders and contacts with details
*Creation of e-mails directly from contact module
*Start calls directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folders and appointments with details
* Accept/Decline appointments
* View participants, resources and notes each appointment

=== Persistence of the Mobile Web App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Subscription of mail folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE, EN, ES, FR, NL and PL, other languages can be added.
* Branding options: App name and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile Web App runs on devices with a Webkit-based browser. These are mainly devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend using Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1, 4.3)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android 2.3.3), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|yes
|Opera Mobile is recommended to guarantee a proper user experience. Symbian's default browser is simply too slow.
|-
|Windows Mobile 6.5 running Internet Explorer
|no, not planed
|
|-
|Windows Phone 7
|not yet, scheduled for version 1.2
|
|-
|}

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

===Offline Mode details===

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

* The whole application will be cached using the "HTML5 application cache". This will be done on the first visit/start of the app. After this initial download, all graphics, language files, js-files and everything else which is needed to run the app 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.

Note: In case your device has no storage support (like the Nokia N97), a log message will inform you about this. The log can be found under the settings page, hitting the button in the upper right corner showing the exclamation mark symbol.

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download & Documentation==

Follow this [http://software.open-xchange.com/OX6/OXtender-stable/MobileApp/ link] to download the installation package, Release Notes and documentation.

'''Please Note:''' You cannot just upgrade to this new version because we changed the versioning to a lower version (from 6.20.0.0 to 0.9.0). In order to install this latest version, you either need to uninstall the current version or download the latest version manually and install using

$ dpkg -i open-xchange-gui-mobile*.deb

on Debian and on RPM based systems

$ rpm --force -Uhv open-xchange-gui-mobile*.rpm

{{InstallPlugin|pluginname=open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2|sopath=OXtender-stable/MobileApp|reponame=mobilewebapp}}

== Configuration ==

Installation on the Apache or another webserver:
* After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
* Edit the file <code>"ox-access.conf"</code> in directory ox6-mobile-v2
* Change localhost to the address the mobile app will be reachable followed by "/ajax", i.e. "<code>https://m.example.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
* The Mobile App acts like a second UI next to the normal web frontend.
* run the command (adopt webserver path on SLES/RHEL).
$ /opt/open-xchange/sbin/update-cache.manifest /var/www/ox6-mobile-v2/cache.manifest.in /var/www/ox6-mobile-v2/cache.manifest /var/www/ox6-mobile-v2/ox-access.conf
* You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile Web App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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 OX Mobile Web App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile Web App and choose "Add to homescreen". After this, the OX Mobile Web App will place a new app icon on the homescreen.

===Common mistakes===
Most problems can be solved by clearing the browser cache and reload the app. Try this before you request a bug or change the server settings.

Problem: After login a page is shown showing "Can not connect to backend. Please check your server settings in ox-access.conf".

Resolution: Your ox-access.conf is not configured correctlly. You must enter you server address on which the mobile app can get access to the OX backend. If everything on the backend is configured correctly, try to reload the app.

Problem: Using the browser's back button brings me back to the login page. After this the app does not work correctly.

Resolution: Only use the navigation of the app. On each subpage a back button is located at the upper left corner which brings you back to the previous page.

===Using the offline mode===

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

The OX Mobile Web App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' The Mobile Web App will detect the state of your internet connection live. Open the log under the settings page for informations

===Known Problems===

* The OX Mobile Web App 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. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

* If you want to use the App in airplane mode or no network connection is availabe, the android browser will show up a message like "page could not be loaded due to missing network connection". Just ignore this alert and press "OK". The app will work in offline mode even android shows up this message.

* If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.

== Deployment as native app ==

The OX Mobile Web App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile Web App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile Web App comes with the standard name set "OX Mobile Web App". This title is saved in a png file under "/lib/jqtouch/themes/cupertino/external/i18n_img/brand_[locale].png". To brand the app with your custom title just replace the files for each language to your needs. The i18n tool will show the graphic for each language. To configure the page title (in html title tag) please use the i18n module:

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the line containing msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
# Do this for all language files
* Note: Do not change the '''msgid''', this must be "OX Mobile". Only change the '''msgstr''' value.

This title will also be the "App title" for the iPhone when the function "Add to homescreen" is used.

== Theming ==

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

# Locate the theme path under "path to your webroot/ox6-mobile-v2/lib/jqtouch/themes"
# The default theme is named "cupertino". To create your own theme make a copy of this folder and backup the original one
# The folder contains two css files and two folders with images. The file jqt_theme.css contains all styles which belong to the "overall" look of the app. These are styles for lists, buttons, background, toolbars and so on. The file ox_theme.css contains more high level theming styles such as module icons, progress bars, infobox and the way the details in lists are shown (like the appointment lists or mail list). To change the whole look of the app (like colors) you will mainly edit the file jqt_theme.css
# The folders "img" and "external" hold all graphics which are used in the app. To change them, just edit and save them under the same name. Don't change filenames or the theme will be broken. Also keep all file dimensions and file types (*.png, *.jpg). Changing files dimensions will corrupt the theme and layout will be broken.
# 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:
[https://bugzilla.open-xchange.com/enter_bug.cgi?product=OX%20Mobile%20Web%20App Open-Xchange Bugzilla] 
Product: OX Mobile Web App

The OX Mobile Web App logs all errors to a logfile which can be found under settings -> log.

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-06-17T09:19:39Z

Alexquast: /* Configuration */

= Information and Installation of Open-Xchange Mobile Web App =

== Description ==

The Open-Xchange Mobile Web App provides you access to your data from the Open-Xchange Server 6 via your smartphone. The Open-Xchange Mobile Web App 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 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
*Calendar
*Contacts

Moreover the app 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 ==

=== Mail Module ===
*Access to all Open-Xchange private mail folders
*Creation of new e-mails
*Answer, forward and delete e-mails
*Mail attachments (Attachment handling/support is defined by mobile device)

=== Contact Module ===
*Access to all Open-Xchange contact folders and contacts with details
*Creation of e-mails directly from contact module
*Start calls directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folders and appointments with details
* Accept/Decline appointments
* View participants, resources and notes each appointment

=== Persistence of the Mobile Web App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Subscription of mail folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE, EN, ES, FR, NL and PL, other languages can be added.
* Branding options: App name and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile Web App runs on devices with a Webkit-based browser. These are mainly devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend using Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1, 4.3)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android 2.3.3), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|yes
|Opera Mobile is recommended to guarantee a proper user experience. Symbian's default browser is simply too slow.
|-
|Windows Mobile 6.5 running Internet Explorer
|no, not planed
|
|-
|Windows Phone 7
|not yet, scheduled for version 1.2
|
|-
|}

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

===Offline Mode details===

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

* The whole application will be cached using the "HTML5 application cache". This will be done on the first visit/start of the app. After this initial download, all graphics, language files, js-files and everything else which is needed to run the app 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.

Note: In case your device has no storage support (like the Nokia N97), a log message will inform you about this. The log can be found under the settings page, hitting the button in the upper right corner showing the exclamation mark symbol.

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download & Documentation==

Follow this [http://software.open-xchange.com/OX6/OXtender-stable/MobileApp/ link] to download the installation package, Release Notes and documentation.

'''Please Note:''' You cannot just upgrade to this new version because we changed the versioning to a lower version (from 6.20.0.0 to 0.9.0). In order to install this latest version, you either need to uninstall the current version or download the latest version manually and install using

$ dpkg -i open-xchange-gui-mobile*.deb

on Debian and on RPM based systems

$ rpm --force -Uhv open-xchange-gui-mobile*.rpm

{{InstallPlugin|pluginname=open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2|sopath=OXtender-stable/MobileApp|reponame=mobilewebapp}}

== Configuration ==

Installation on the Apache or another webserver:
* After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
* Edit the file <code>"ox-access.conf"</code> in directory ox6-mobile-v2
* Change localhost to your OX server address followed by "/ajax", i.e. "<code>https://example.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
* run the command (adopt webserver path on SLES/RHEL).
$ /opt/open-xchange/sbin/update-cache.manifest /var/www/ox6-mobile-v2/cache.manifest.in /var/www/ox6-mobile-v2/cache.manifest /var/www/ox6-mobile-v2/ox-access.conf
* You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile Web App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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 OX Mobile Web App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile Web App and choose "Add to homescreen". After this, the OX Mobile Web App will place a new app icon on the homescreen.

===Common mistakes===
Most problems can be solved by clearing the browser cache and reload the app. Try this before you request a bug or change the server settings.

Problem: After login a page is shown showing "Can not connect to backend. Please check your server settings in ox-access.conf".

Resolution: Your ox-access.conf is not configured correctlly. You must enter you server address on which the mobile app can get access to the OX backend. If everything on the backend is configured correctly, try to reload the app.

Problem: Using the browser's back button brings me back to the login page. After this the app does not work correctly.

Resolution: Only use the navigation of the app. On each subpage a back button is located at the upper left corner which brings you back to the previous page.

===Using the offline mode===

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

The OX Mobile Web App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' The Mobile Web App will detect the state of your internet connection live. Open the log under the settings page for informations

===Known Problems===

* The OX Mobile Web App 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. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

* If you want to use the App in airplane mode or no network connection is availabe, the android browser will show up a message like "page could not be loaded due to missing network connection". Just ignore this alert and press "OK". The app will work in offline mode even android shows up this message.

* If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.

== Deployment as native app ==

The OX Mobile Web App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile Web App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile Web App comes with the standard name set "OX Mobile Web App". This title is saved in a png file under "/lib/jqtouch/themes/cupertino/external/i18n_img/brand_[locale].png". To brand the app with your custom title just replace the files for each language to your needs. The i18n tool will show the graphic for each language. To configure the page title (in html title tag) please use the i18n module:

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the line containing msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
# Do this for all language files
* Note: Do not change the '''msgid''', this must be "OX Mobile". Only change the '''msgstr''' value.

This title will also be the "App title" for the iPhone when the function "Add to homescreen" is used.

== Theming ==

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

# Locate the theme path under "path to your webroot/ox6-mobile-v2/lib/jqtouch/themes"
# The default theme is named "cupertino". To create your own theme make a copy of this folder and backup the original one
# The folder contains two css files and two folders with images. The file jqt_theme.css contains all styles which belong to the "overall" look of the app. These are styles for lists, buttons, background, toolbars and so on. The file ox_theme.css contains more high level theming styles such as module icons, progress bars, infobox and the way the details in lists are shown (like the appointment lists or mail list). To change the whole look of the app (like colors) you will mainly edit the file jqt_theme.css
# The folders "img" and "external" hold all graphics which are used in the app. To change them, just edit and save them under the same name. Don't change filenames or the theme will be broken. Also keep all file dimensions and file types (*.png, *.jpg). Changing files dimensions will corrupt the theme and layout will be broken.
# 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:
[https://bugzilla.open-xchange.com/enter_bug.cgi?product=OX%20Mobile%20Web%20App Open-Xchange Bugzilla] 
Product: OX Mobile Web App

The OX Mobile Web App logs all errors to a logfile which can be found under settings -> log.

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-05-05T10:16:05Z

Alexquast: /* Calendar Module */

= Information and Installation of Open-Xchange Mobile Web App =

== Description ==

The Open-Xchange Mobile Web App provides you access to your data from the Open-Xchange Server 6 via your smartphone. The Open-Xchange Mobile Web App 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 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
*Calendar
*Contacts

Moreover the app 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 ==

=== Mail Module ===
*Access to all Open-Xchange private mail folders
*Creation of new e-mails
*Answer, forward and delete e-mails
*Mail attachments (Attachment handling/support is defined by mobile device)

=== Contact Module ===
*Access to all Open-Xchange contact folders and contacts with details
*Creation of e-mails directly from contact module
*Start calls directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folders and appointments with details
* Accept/Decline appointments
* View participants, resources and notes each appointment

=== Persistence of the Mobile Web App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Subscription of mail folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE, EN, ES, FR, NL and PL, other languages can be added.
* Branding options: App name and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile Web App runs on devices with a Webkit-based browser. These are mainly devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend using Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1, 4.3)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android 2.3.3), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|yes
|Opera Mobile is recommended to guarantee a proper user experience. Symbian's default browser is simply too slow.
|-
|Windows Mobile 6.5 running Internet Explorer
|no, not planed
|
|-
|Windows Phone 7
|not yet, scheduled for version 1.2
|
|-
|}

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

===Offline Mode details===

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

* The whole application will be cached using the "HTML5 application cache". This will be done on the first visit/start of the app. After this initial download, all graphics, language files, js-files and everything else which is needed to run the app 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.

Note: In case your device has no storage support (like the Nokia N97), a log message will inform you about this. The log can be found under the settings page, hitting the button in the upper right corner showing the exclamation mark symbol.

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download & Documentation==

Follow this [http://software.open-xchange.com/OX6/OXtender-stable/MobileApp/ link] to download the installation package, Release Notes and documentation.

'''Please Note:''' You cannot just upgrade to this new version because we changed the versioning to a lower version (from 6.20.0.0 to 0.9.0). In order to install this latest version, you either need to uninstall the current version or download the latest version manually and install using

$ dpkg -i open-xchange-gui-mobile*.deb

on Debian and on RPM based systems

$ rpm --force -Uhv open-xchange-gui-mobile*.rpm

{{InstallPlugin|pluginname=open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2|sopath=OXtender-stable/MobileApp|reponame=mobilewebapp}}

== Configuration ==

Installation on the Apache or another webserver:
* After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
* Edit the file <code>"ox-access.conf"</code> in directory ox6-mobile-v2
* If your open-xchange server is running on a different host, change localhost to your OX server address, i.e. "<code>https://example.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
* run the command (adopt webserver path on SLES/RHEL).
$ /opt/open-xchange/sbin/update-cache.manifest /var/www/ox6-mobile-v2/cache.manifest.in /var/www/ox6-mobile-v2/cache.manifest /var/www/ox6-mobile-v2/ox-access.conf
* You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile Web App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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 OX Mobile Web App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile Web App and choose "Add to homescreen". After this, the OX Mobile Web App will place a new app icon on the homescreen.

===Common mistakes===
Most problems can be solved by clearing the browser cache and reload the app. Try this before you request a bug or change the server settings.

Problem: After login a page is shown showing "Can not connect to backend. Please check your server settings in ox-access.conf".

Resolution: Your ox-access.conf is not configured correctlly. You must enter you server address on which the mobile app can get access to the OX backend. If everything on the backend is configured correctly, try to reload the app.

Problem: Using the browser's back button brings me back to the login page. After this the app does not work correctly.

Resolution: Only use the navigation of the app. On each subpage a back button is located at the upper left corner which brings you back to the previous page.

===Using the offline mode===

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

The OX Mobile Web App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' The Mobile Web App will detect the state of your internet connection live. Open the log under the settings page for informations

===Known Problems===

* The OX Mobile Web App 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. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

* If you want to use the App in airplane mode or no network connection is availabe, the android browser will show up a message like "page could not be loaded due to missing network connection". Just ignore this alert and press "OK". The app will work in offline mode even android shows up this message.

* If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.

== Deployment as native app ==

The OX Mobile Web App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile Web App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile Web App comes with the standard name set "OX Mobile Web App". This title is saved in a png file under "/lib/jqtouch/themes/cupertino/external/i18n_img/brand_[locale].png". To brand the app with your custom title just replace the files for each language to your needs. The i18n tool will show the graphic for each language. To configure the page title (in html title tag) please use the i18n module:

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the line containing msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
# Do this for all language files
* Note: Do not change the '''msgid''', this must be "OX Mobile". Only change the '''msgstr''' value.

This title will also be the "App title" for the iPhone when the function "Add to homescreen" is used.

== Theming ==

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

# Locate the theme path under "path to your webroot/ox6-mobile-v2/lib/jqtouch/themes"
# The default theme is named "cupertino". To create your own theme make a copy of this folder and backup the original one
# The folder contains two css files and two folders with images. The file jqt_theme.css contains all styles which belong to the "overall" look of the app. These are styles for lists, buttons, background, toolbars and so on. The file ox_theme.css contains more high level theming styles such as module icons, progress bars, infobox and the way the details in lists are shown (like the appointment lists or mail list). To change the whole look of the app (like colors) you will mainly edit the file jqt_theme.css
# The folders "img" and "external" hold all graphics which are used in the app. To change them, just edit and save them under the same name. Don't change filenames or the theme will be broken. Also keep all file dimensions and file types (*.png, *.jpg). Changing files dimensions will corrupt the theme and layout will be broken.
# 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:
[https://bugzilla.open-xchange.com/enter_bug.cgi?product=OX%20Mobile%20Web%20App Open-Xchange Bugzilla] 
Product: OX Mobile Web App

The OX Mobile Web App logs all errors to a logfile which can be found under settings -> log.

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-05-05T10:14:55Z

Alexquast: /* Description */

= Information and Installation of Open-Xchange Mobile Web App =

== Description ==

The Open-Xchange Mobile Web App provides you access to your data from the Open-Xchange Server 6 via your smartphone. The Open-Xchange Mobile Web App 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 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
*Calendar
*Contacts

Moreover the app 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 ==

=== Mail Module ===
*Access to all Open-Xchange private mail folders
*Creation of new e-mails
*Answer, forward and delete e-mails
*Mail attachments (Attachment handling/support is defined by mobile device)

=== Contact Module ===
*Access to all Open-Xchange contact folders and contacts with details
*Creation of e-mails directly from contact module
*Start calls directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folder and appointments with details
* Accept/Decline of appointments
* Participants and resources list from all appointments

=== Persistence of the Mobile Web App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Subscription of mail folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE, EN, ES, FR, NL and PL, other languages can be added.
* Branding options: App name and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile Web App runs on devices with a Webkit-based browser. These are mainly devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend using Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1, 4.3)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android 2.3.3), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|yes
|Opera Mobile is recommended to guarantee a proper user experience. Symbian's default browser is simply too slow.
|-
|Windows Mobile 6.5 running Internet Explorer
|no, not planed
|
|-
|Windows Phone 7
|not yet, scheduled for version 1.2
|
|-
|}

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

===Offline Mode details===

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

* The whole application will be cached using the "HTML5 application cache". This will be done on the first visit/start of the app. After this initial download, all graphics, language files, js-files and everything else which is needed to run the app 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.

Note: In case your device has no storage support (like the Nokia N97), a log message will inform you about this. The log can be found under the settings page, hitting the button in the upper right corner showing the exclamation mark symbol.

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download & Documentation==

Follow this [http://software.open-xchange.com/OX6/OXtender-stable/MobileApp/ link] to download the installation package, Release Notes and documentation.

'''Please Note:''' You cannot just upgrade to this new version because we changed the versioning to a lower version (from 6.20.0.0 to 0.9.0). In order to install this latest version, you either need to uninstall the current version or download the latest version manually and install using

$ dpkg -i open-xchange-gui-mobile*.deb

on Debian and on RPM based systems

$ rpm --force -Uhv open-xchange-gui-mobile*.rpm

{{InstallPlugin|pluginname=open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2|sopath=OXtender-stable/MobileApp|reponame=mobilewebapp}}

== Configuration ==

Installation on the Apache or another webserver:
* After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
* Edit the file <code>"ox-access.conf"</code> in directory ox6-mobile-v2
* If your open-xchange server is running on a different host, change localhost to your OX server address, i.e. "<code>https://example.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
* run the command (adopt webserver path on SLES/RHEL).
$ /opt/open-xchange/sbin/update-cache.manifest /var/www/ox6-mobile-v2/cache.manifest.in /var/www/ox6-mobile-v2/cache.manifest /var/www/ox6-mobile-v2/ox-access.conf
* You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile Web App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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 OX Mobile Web App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile Web App and choose "Add to homescreen". After this, the OX Mobile Web App will place a new app icon on the homescreen.

===Common mistakes===
Most problems can be solved by clearing the browser cache and reload the app. Try this before you request a bug or change the server settings.

Problem: After login a page is shown showing "Can not connect to backend. Please check your server settings in ox-access.conf".

Resolution: Your ox-access.conf is not configured correctlly. You must enter you server address on which the mobile app can get access to the OX backend. If everything on the backend is configured correctly, try to reload the app.

Problem: Using the browser's back button brings me back to the login page. After this the app does not work correctly.

Resolution: Only use the navigation of the app. On each subpage a back button is located at the upper left corner which brings you back to the previous page.

===Using the offline mode===

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

The OX Mobile Web App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' The Mobile Web App will detect the state of your internet connection live. Open the log under the settings page for informations

===Known Problems===

* The OX Mobile Web App 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. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

* If you want to use the App in airplane mode or no network connection is availabe, the android browser will show up a message like "page could not be loaded due to missing network connection". Just ignore this alert and press "OK". The app will work in offline mode even android shows up this message.

* If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.

== Deployment as native app ==

The OX Mobile Web App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile Web App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile Web App comes with the standard name set "OX Mobile Web App". This title is saved in a png file under "/lib/jqtouch/themes/cupertino/external/i18n_img/brand_[locale].png". To brand the app with your custom title just replace the files for each language to your needs. The i18n tool will show the graphic for each language. To configure the page title (in html title tag) please use the i18n module:

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the line containing msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
# Do this for all language files
* Note: Do not change the '''msgid''', this must be "OX Mobile". Only change the '''msgstr''' value.

This title will also be the "App title" for the iPhone when the function "Add to homescreen" is used.

== Theming ==

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

# Locate the theme path under "path to your webroot/ox6-mobile-v2/lib/jqtouch/themes"
# The default theme is named "cupertino". To create your own theme make a copy of this folder and backup the original one
# The folder contains two css files and two folders with images. The file jqt_theme.css contains all styles which belong to the "overall" look of the app. These are styles for lists, buttons, background, toolbars and so on. The file ox_theme.css contains more high level theming styles such as module icons, progress bars, infobox and the way the details in lists are shown (like the appointment lists or mail list). To change the whole look of the app (like colors) you will mainly edit the file jqt_theme.css
# The folders "img" and "external" hold all graphics which are used in the app. To change them, just edit and save them under the same name. Don't change filenames or the theme will be broken. Also keep all file dimensions and file types (*.png, *.jpg). Changing files dimensions will corrupt the theme and layout will be broken.
# 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:
[https://bugzilla.open-xchange.com/enter_bug.cgi?product=OX%20Mobile%20Web%20App Open-Xchange Bugzilla] 
Product: OX Mobile Web App

The OX Mobile Web App logs all errors to a logfile which can be found under settings -> log.

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-05-05T10:00:58Z

Alexquast: /* Description */

= Information and Installation of Open-Xchange Mobile Web App =

== Description ==

The Open-Xchange Mobile Web App provides you access to your data from the Open-Xchange Server 6 via your smartphone. The Open-Xchange Mobile Web App offers online and offline access to appointments, contacts and mails on the road using your smartphones browser. Optimized for low bandwiths the Open-Xchange Mobile Web 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
*Calendar
*Contacts

Moreover the app 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 ==

=== Mail Module ===
*Access to all Open-Xchange private mail folders
*Creation of new e-mails
*Answer, forward and delete e-mails
*Mail attachments (Attachment handling/support is defined by mobile device)

=== Contact Module ===
*Access to all Open-Xchange contact folders and contacts with details
*Creation of e-mails directly from contact module
*Start calls directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folder and appointments with details
* Accept/Decline of appointments
* Participants and resources list from all appointments

=== Persistence of the Mobile Web App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Subscription of mail folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE, EN, ES, FR, NL and PL, other languages can be added.
* Branding options: App name and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile Web App runs on devices with a Webkit-based browser. These are mainly devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend using Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1, 4.3)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android 2.3.3), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|yes
|Opera Mobile is recommended to guarantee a proper user experience. Symbian's default browser is simply too slow.
|-
|Windows Mobile 6.5 running Internet Explorer
|no, not planed
|
|-
|Windows Phone 7
|not yet, scheduled for version 1.2
|
|-
|}

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

===Offline Mode details===

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

* The whole application will be cached using the "HTML5 application cache". This will be done on the first visit/start of the app. After this initial download, all graphics, language files, js-files and everything else which is needed to run the app 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.

Note: In case your device has no storage support (like the Nokia N97), a log message will inform you about this. The log can be found under the settings page, hitting the button in the upper right corner showing the exclamation mark symbol.

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download & Documentation==

Follow this [http://software.open-xchange.com/OX6/OXtender-stable/MobileApp/ link] to download the installation package, Release Notes and documentation.

'''Please Note:''' You cannot just upgrade to this new version because we changed the versioning to a lower version (from 6.20.0.0 to 0.9.0). In order to install this latest version, you either need to uninstall the current version or download the latest version manually and install using

$ dpkg -i open-xchange-gui-mobile*.deb

on Debian and on RPM based systems

$ rpm --force -Uhv open-xchange-gui-mobile*.rpm

{{InstallPlugin|pluginname=open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2|sopath=OXtender-stable/MobileApp|reponame=mobilewebapp}}

== Configuration ==

Installation on the Apache or another webserver:
* After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
* Edit the file <code>"ox-access.conf"</code> in directory ox6-mobile-v2
* If your open-xchange server is running on a different host, change localhost to your OX server address, i.e. "<code>https://example.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
* run the command (adopt webserver path on SLES/RHEL).
$ /opt/open-xchange/sbin/update-cache.manifest /var/www/ox6-mobile-v2/cache.manifest.in /var/www/ox6-mobile-v2/cache.manifest /var/www/ox6-mobile-v2/ox-access.conf
* You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile Web App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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 OX Mobile Web App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile Web App and choose "Add to homescreen". After this, the OX Mobile Web App will place a new app icon on the homescreen.

===Common mistakes===
Most problems can be solved by clearing the browser cache and reload the app. Try this before you request a bug or change the server settings.

Problem: After login a page is shown showing "Can not connect to backend. Please check your server settings in ox-access.conf".

Resolution: Your ox-access.conf is not configured correctlly. You must enter you server address on which the mobile app can get access to the OX backend. If everything on the backend is configured correctly, try to reload the app.

Problem: Using the browser's back button brings me back to the login page. After this the app does not work correctly.

Resolution: Only use the navigation of the app. On each subpage a back button is located at the upper left corner which brings you back to the previous page.

===Using the offline mode===

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

The OX Mobile Web App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' The Mobile Web App will detect the state of your internet connection live. Open the log under the settings page for informations

===Known Problems===

* The OX Mobile Web App 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. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

* If you want to use the App in airplane mode or no network connection is availabe, the android browser will show up a message like "page could not be loaded due to missing network connection". Just ignore this alert and press "OK". The app will work in offline mode even android shows up this message.

* If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.

== Deployment as native app ==

The OX Mobile Web App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile Web App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile Web App comes with the standard name set "OX Mobile Web App". This title is saved in a png file under "/lib/jqtouch/themes/cupertino/external/i18n_img/brand_[locale].png". To brand the app with your custom title just replace the files for each language to your needs. The i18n tool will show the graphic for each language. To configure the page title (in html title tag) please use the i18n module:

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the line containing msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
# Do this for all language files
* Note: Do not change the '''msgid''', this must be "OX Mobile". Only change the '''msgstr''' value.

This title will also be the "App title" for the iPhone when the function "Add to homescreen" is used.

== Theming ==

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

# Locate the theme path under "path to your webroot/ox6-mobile-v2/lib/jqtouch/themes"
# The default theme is named "cupertino". To create your own theme make a copy of this folder and backup the original one
# The folder contains two css files and two folders with images. The file jqt_theme.css contains all styles which belong to the "overall" look of the app. These are styles for lists, buttons, background, toolbars and so on. The file ox_theme.css contains more high level theming styles such as module icons, progress bars, infobox and the way the details in lists are shown (like the appointment lists or mail list). To change the whole look of the app (like colors) you will mainly edit the file jqt_theme.css
# The folders "img" and "external" hold all graphics which are used in the app. To change them, just edit and save them under the same name. Don't change filenames or the theme will be broken. Also keep all file dimensions and file types (*.png, *.jpg). Changing files dimensions will corrupt the theme and layout will be broken.
# 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:
[https://bugzilla.open-xchange.com/enter_bug.cgi?product=OX%20Mobile%20Web%20App Open-Xchange Bugzilla] 
Product: OX Mobile Web App

The OX Mobile Web App logs all errors to a logfile which can be found under settings -> log.

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-05-05T09:50:38Z

Alexquast: /* Mail Module */

= Information and Installation of Open-Xchange Mobile Web App =

== Description ==

Open-Xchange Mobile Web 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 Web App offers online and offline access to appointments, contacts and mails on the road using your smartphone. Optimized for low bandwiths Open-Xchange Mobile Web 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
*Calendar
*Contacts

Moreover the app 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 ==

=== Mail Module ===
*Access to all Open-Xchange private mail folders
*Creation of new e-mails
*Answer, forward and delete e-mails
*Mail attachments (Attachment handling/support is defined by mobile device)

=== Contact Module ===
*Access to all Open-Xchange contact folders and contacts with details
*Creation of e-mails directly from contact module
*Start calls directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folder and appointments with details
* Accept/Decline of appointments
* Participants and resources list from all appointments

=== Persistence of the Mobile Web App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Subscription of mail folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE, EN, ES, FR, NL and PL, other languages can be added.
* Branding options: App name and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile Web App runs on devices with a Webkit-based browser. These are mainly devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend using Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1, 4.3)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android 2.3.3), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|yes
|Opera Mobile is recommended to guarantee a proper user experience. Symbian's default browser is simply too slow.
|-
|Windows Mobile 6.5 running Internet Explorer
|no, not planed
|
|-
|Windows Phone 7
|not yet, scheduled for version 1.2
|
|-
|}

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

===Offline Mode details===

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

* The whole application will be cached using the "HTML5 application cache". This will be done on the first visit/start of the app. After this initial download, all graphics, language files, js-files and everything else which is needed to run the app 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.

Note: In case your device has no storage support (like the Nokia N97), a log message will inform you about this. The log can be found under the settings page, hitting the button in the upper right corner showing the exclamation mark symbol.

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download & Documentation==

Follow this [http://software.open-xchange.com/OX6/OXtender-stable/MobileApp/ link] to download the installation package, Release Notes and documentation.

'''Please Note:''' You cannot just upgrade to this new version because we changed the versioning to a lower version (from 6.20.0.0 to 0.9.0). In order to install this latest version, you either need to uninstall the current version or download the latest version manually and install using

$ dpkg -i open-xchange-gui-mobile*.deb

on Debian and on RPM based systems

$ rpm --force -Uhv open-xchange-gui-mobile*.rpm

{{InstallPlugin|pluginname=open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2|sopath=OXtender-stable/MobileApp|reponame=mobilewebapp}}

== Configuration ==

Installation on the Apache or another webserver:
* After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
* Edit the file <code>"ox-access.conf"</code> in directory ox6-mobile-v2
* If your open-xchange server is running on a different host, change localhost to your OX server address, i.e. "<code>https://example.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
* run the command (adopt webserver path on SLES/RHEL).
$ /opt/open-xchange/sbin/update-cache.manifest /var/www/ox6-mobile-v2/cache.manifest.in /var/www/ox6-mobile-v2/cache.manifest /var/www/ox6-mobile-v2/ox-access.conf
* You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile Web App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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 OX Mobile Web App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile Web App and choose "Add to homescreen". After this, the OX Mobile Web App will place a new app icon on the homescreen.

===Common mistakes===
Most problems can be solved by clearing the browser cache and reload the app. Try this before you request a bug or change the server settings.

Problem: After login a page is shown showing "Can not connect to backend. Please check your server settings in ox-access.conf".

Resolution: Your ox-access.conf is not configured correctlly. You must enter you server address on which the mobile app can get access to the OX backend. If everything on the backend is configured correctly, try to reload the app.

Problem: Using the browser's back button brings me back to the login page. After this the app does not work correctly.

Resolution: Only use the navigation of the app. On each subpage a back button is located at the upper left corner which brings you back to the previous page.

===Using the offline mode===

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

The OX Mobile Web App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' The Mobile Web App will detect the state of your internet connection live. Open the log under the settings page for informations

===Known Problems===

* The OX Mobile Web App 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. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

* If you want to use the App in airplane mode or no network connection is availabe, the android browser will show up a message like "page could not be loaded due to missing network connection". Just ignore this alert and press "OK". The app will work in offline mode even android shows up this message.

* If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.

== Deployment as native app ==

The OX Mobile Web App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile Web App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile Web App comes with the standard name set "OX Mobile Web App". This title is saved in a png file under "/lib/jqtouch/themes/cupertino/external/i18n_img/brand_[locale].png". To brand the app with your custom title just replace the files for each language to your needs. The i18n tool will show the graphic for each language. To configure the page title (in html title tag) please use the i18n module:

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the line containing msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
# Do this for all language files
* Note: Do not change the '''msgid''', this must be "OX Mobile". Only change the '''msgstr''' value.

This title will also be the "App title" for the iPhone when the function "Add to homescreen" is used.

== Theming ==

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

# Locate the theme path under "path to your webroot/ox6-mobile-v2/lib/jqtouch/themes"
# The default theme is named "cupertino". To create your own theme make a copy of this folder and backup the original one
# The folder contains two css files and two folders with images. The file jqt_theme.css contains all styles which belong to the "overall" look of the app. These are styles for lists, buttons, background, toolbars and so on. The file ox_theme.css contains more high level theming styles such as module icons, progress bars, infobox and the way the details in lists are shown (like the appointment lists or mail list). To change the whole look of the app (like colors) you will mainly edit the file jqt_theme.css
# The folders "img" and "external" hold all graphics which are used in the app. To change them, just edit and save them under the same name. Don't change filenames or the theme will be broken. Also keep all file dimensions and file types (*.png, *.jpg). Changing files dimensions will corrupt the theme and layout will be broken.
# 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:
[https://bugzilla.open-xchange.com/enter_bug.cgi?product=OX%20Mobile%20Web%20App Open-Xchange Bugzilla] 
Product: OX Mobile Web App

The OX Mobile Web App logs all errors to a logfile which can be found under settings -> log.

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-05-05T09:50:19Z

Alexquast: /* Contact Module */

= Information and Installation of Open-Xchange Mobile Web App =

== Description ==

Open-Xchange Mobile Web 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 Web App offers online and offline access to appointments, contacts and mails on the road using your smartphone. Optimized for low bandwiths Open-Xchange Mobile Web 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
*Calendar
*Contacts

Moreover the app 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 ==

=== Mail Module ===
*Access to all Open-Xchange private mail foldes
*Creation of new e-mails
*Answer, forward and delete e-mails
*Mail attachments (Attachment handling/support is defined by mobile device)

=== Contact Module ===
*Access to all Open-Xchange contact folders and contacts with details
*Creation of e-mails directly from contact module
*Start calls directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folder and appointments with details
* Accept/Decline of appointments
* Participants and resources list from all appointments

=== Persistence of the Mobile Web App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Subscription of mail folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE, EN, ES, FR, NL and PL, other languages can be added.
* Branding options: App name and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile Web App runs on devices with a Webkit-based browser. These are mainly devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend using Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1, 4.3)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android 2.3.3), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|yes
|Opera Mobile is recommended to guarantee a proper user experience. Symbian's default browser is simply too slow.
|-
|Windows Mobile 6.5 running Internet Explorer
|no, not planed
|
|-
|Windows Phone 7
|not yet, scheduled for version 1.2
|
|-
|}

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

===Offline Mode details===

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

* The whole application will be cached using the "HTML5 application cache". This will be done on the first visit/start of the app. After this initial download, all graphics, language files, js-files and everything else which is needed to run the app 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.

Note: In case your device has no storage support (like the Nokia N97), a log message will inform you about this. The log can be found under the settings page, hitting the button in the upper right corner showing the exclamation mark symbol.

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download & Documentation==

Follow this [http://software.open-xchange.com/OX6/OXtender-stable/MobileApp/ link] to download the installation package, Release Notes and documentation.

'''Please Note:''' You cannot just upgrade to this new version because we changed the versioning to a lower version (from 6.20.0.0 to 0.9.0). In order to install this latest version, you either need to uninstall the current version or download the latest version manually and install using

$ dpkg -i open-xchange-gui-mobile*.deb

on Debian and on RPM based systems

$ rpm --force -Uhv open-xchange-gui-mobile*.rpm

{{InstallPlugin|pluginname=open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2|sopath=OXtender-stable/MobileApp|reponame=mobilewebapp}}

== Configuration ==

Installation on the Apache or another webserver:
* After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
* Edit the file <code>"ox-access.conf"</code> in directory ox6-mobile-v2
* If your open-xchange server is running on a different host, change localhost to your OX server address, i.e. "<code>https://example.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
* run the command (adopt webserver path on SLES/RHEL).
$ /opt/open-xchange/sbin/update-cache.manifest /var/www/ox6-mobile-v2/cache.manifest.in /var/www/ox6-mobile-v2/cache.manifest /var/www/ox6-mobile-v2/ox-access.conf
* You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile Web App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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 OX Mobile Web App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile Web App and choose "Add to homescreen". After this, the OX Mobile Web App will place a new app icon on the homescreen.

===Common mistakes===
Most problems can be solved by clearing the browser cache and reload the app. Try this before you request a bug or change the server settings.

Problem: After login a page is shown showing "Can not connect to backend. Please check your server settings in ox-access.conf".

Resolution: Your ox-access.conf is not configured correctlly. You must enter you server address on which the mobile app can get access to the OX backend. If everything on the backend is configured correctly, try to reload the app.

Problem: Using the browser's back button brings me back to the login page. After this the app does not work correctly.

Resolution: Only use the navigation of the app. On each subpage a back button is located at the upper left corner which brings you back to the previous page.

===Using the offline mode===

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

The OX Mobile Web App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' The Mobile Web App will detect the state of your internet connection live. Open the log under the settings page for informations

===Known Problems===

* The OX Mobile Web App 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. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

* If you want to use the App in airplane mode or no network connection is availabe, the android browser will show up a message like "page could not be loaded due to missing network connection". Just ignore this alert and press "OK". The app will work in offline mode even android shows up this message.

* If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.

== Deployment as native app ==

The OX Mobile Web App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile Web App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile Web App comes with the standard name set "OX Mobile Web App". This title is saved in a png file under "/lib/jqtouch/themes/cupertino/external/i18n_img/brand_[locale].png". To brand the app with your custom title just replace the files for each language to your needs. The i18n tool will show the graphic for each language. To configure the page title (in html title tag) please use the i18n module:

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the line containing msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
# Do this for all language files
* Note: Do not change the '''msgid''', this must be "OX Mobile". Only change the '''msgstr''' value.

This title will also be the "App title" for the iPhone when the function "Add to homescreen" is used.

== Theming ==

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

# Locate the theme path under "path to your webroot/ox6-mobile-v2/lib/jqtouch/themes"
# The default theme is named "cupertino". To create your own theme make a copy of this folder and backup the original one
# The folder contains two css files and two folders with images. The file jqt_theme.css contains all styles which belong to the "overall" look of the app. These are styles for lists, buttons, background, toolbars and so on. The file ox_theme.css contains more high level theming styles such as module icons, progress bars, infobox and the way the details in lists are shown (like the appointment lists or mail list). To change the whole look of the app (like colors) you will mainly edit the file jqt_theme.css
# The folders "img" and "external" hold all graphics which are used in the app. To change them, just edit and save them under the same name. Don't change filenames or the theme will be broken. Also keep all file dimensions and file types (*.png, *.jpg). Changing files dimensions will corrupt the theme and layout will be broken.
# 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:
[https://bugzilla.open-xchange.com/enter_bug.cgi?product=OX%20Mobile%20Web%20App Open-Xchange Bugzilla] 
Product: OX Mobile Web App

The OX Mobile Web App logs all errors to a logfile which can be found under settings -> log.

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-05-05T09:49:37Z

Alexquast: /* Supported devices */

= Information and Installation of Open-Xchange Mobile Web App =

== Description ==

Open-Xchange Mobile Web 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 Web App offers online and offline access to appointments, contacts and mails on the road using your smartphone. Optimized for low bandwiths Open-Xchange Mobile Web 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
*Calendar
*Contacts

Moreover the app 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 ==

=== Mail Module ===
*Access to all Open-Xchange private mail foldes
*Creation of new e-mails
*Answer, forward and delete e-mails
*Mail attachments (Attachment handling/support is defined by mobile device)

=== Contact Module ===
*Access to all Open-Xchange contact folder and contacts with details
*Creation of e-mail directly from contact module
*Start call directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folder and appointments with details
* Accept/Decline of appointments
* Participants and resources list from all appointments

=== Persistence of the Mobile Web App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Subscription of mail folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE, EN, ES, FR, NL and PL, other languages can be added.
* Branding options: App name and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile Web App runs on devices with a Webkit-based browser. These are mainly devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend using Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1, 4.3)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android 2.3.3), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|yes
|Opera Mobile is recommended to guarantee a proper user experience. Symbian's default browser is simply too slow.
|-
|Windows Mobile 6.5 running Internet Explorer
|no, not planed
|
|-
|Windows Phone 7
|not yet, scheduled for version 1.2
|
|-
|}

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

===Offline Mode details===

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

* The whole application will be cached using the "HTML5 application cache". This will be done on the first visit/start of the app. After this initial download, all graphics, language files, js-files and everything else which is needed to run the app 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.

Note: In case your device has no storage support (like the Nokia N97), a log message will inform you about this. The log can be found under the settings page, hitting the button in the upper right corner showing the exclamation mark symbol.

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download & Documentation==

Follow this [http://software.open-xchange.com/OX6/OXtender-stable/MobileApp/ link] to download the installation package, Release Notes and documentation.

'''Please Note:''' You cannot just upgrade to this new version because we changed the versioning to a lower version (from 6.20.0.0 to 0.9.0). In order to install this latest version, you either need to uninstall the current version or download the latest version manually and install using

$ dpkg -i open-xchange-gui-mobile*.deb

on Debian and on RPM based systems

$ rpm --force -Uhv open-xchange-gui-mobile*.rpm

{{InstallPlugin|pluginname=open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2|sopath=OXtender-stable/MobileApp|reponame=mobilewebapp}}

== Configuration ==

Installation on the Apache or another webserver:
* After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
* Edit the file <code>"ox-access.conf"</code> in directory ox6-mobile-v2
* If your open-xchange server is running on a different host, change localhost to your OX server address, i.e. "<code>https://example.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
* run the command (adopt webserver path on SLES/RHEL).
$ /opt/open-xchange/sbin/update-cache.manifest /var/www/ox6-mobile-v2/cache.manifest.in /var/www/ox6-mobile-v2/cache.manifest /var/www/ox6-mobile-v2/ox-access.conf
* You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile Web App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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 OX Mobile Web App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile Web App and choose "Add to homescreen". After this, the OX Mobile Web App will place a new app icon on the homescreen.

===Common mistakes===
Most problems can be solved by clearing the browser cache and reload the app. Try this before you request a bug or change the server settings.

Problem: After login a page is shown showing "Can not connect to backend. Please check your server settings in ox-access.conf".

Resolution: Your ox-access.conf is not configured correctlly. You must enter you server address on which the mobile app can get access to the OX backend. If everything on the backend is configured correctly, try to reload the app.

Problem: Using the browser's back button brings me back to the login page. After this the app does not work correctly.

Resolution: Only use the navigation of the app. On each subpage a back button is located at the upper left corner which brings you back to the previous page.

===Using the offline mode===

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

The OX Mobile Web App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' The Mobile Web App will detect the state of your internet connection live. Open the log under the settings page for informations

===Known Problems===

* The OX Mobile Web App 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. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

* If you want to use the App in airplane mode or no network connection is availabe, the android browser will show up a message like "page could not be loaded due to missing network connection". Just ignore this alert and press "OK". The app will work in offline mode even android shows up this message.

* If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.

== Deployment as native app ==

The OX Mobile Web App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile Web App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile Web App comes with the standard name set "OX Mobile Web App". This title is saved in a png file under "/lib/jqtouch/themes/cupertino/external/i18n_img/brand_[locale].png". To brand the app with your custom title just replace the files for each language to your needs. The i18n tool will show the graphic for each language. To configure the page title (in html title tag) please use the i18n module:

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the line containing msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
# Do this for all language files
* Note: Do not change the '''msgid''', this must be "OX Mobile". Only change the '''msgstr''' value.

This title will also be the "App title" for the iPhone when the function "Add to homescreen" is used.

== Theming ==

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

# Locate the theme path under "path to your webroot/ox6-mobile-v2/lib/jqtouch/themes"
# The default theme is named "cupertino". To create your own theme make a copy of this folder and backup the original one
# The folder contains two css files and two folders with images. The file jqt_theme.css contains all styles which belong to the "overall" look of the app. These are styles for lists, buttons, background, toolbars and so on. The file ox_theme.css contains more high level theming styles such as module icons, progress bars, infobox and the way the details in lists are shown (like the appointment lists or mail list). To change the whole look of the app (like colors) you will mainly edit the file jqt_theme.css
# The folders "img" and "external" hold all graphics which are used in the app. To change them, just edit and save them under the same name. Don't change filenames or the theme will be broken. Also keep all file dimensions and file types (*.png, *.jpg). Changing files dimensions will corrupt the theme and layout will be broken.
# 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:
[https://bugzilla.open-xchange.com/enter_bug.cgi?product=OX%20Mobile%20Web%20App Open-Xchange Bugzilla] 
Product: OX Mobile Web App

The OX Mobile Web App logs all errors to a logfile which can be found under settings -> log.

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-05-05T09:48:16Z

Alexquast: /* Common mistakes */

= Information and Installation of Open-Xchange Mobile Web App =

== Description ==

Open-Xchange Mobile Web 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 Web App offers online and offline access to appointments, contacts and mails on the road using your smartphone. Optimized for low bandwiths Open-Xchange Mobile Web 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
*Calendar
*Contacts

Moreover the app 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 ==

=== Mail Module ===
*Access to all Open-Xchange private mail foldes
*Creation of new e-mails
*Answer, forward and delete e-mails
*Mail attachments (Attachment handling/support is defined by mobile device)

=== Contact Module ===
*Access to all Open-Xchange contact folder and contacts with details
*Creation of e-mail directly from contact module
*Start call directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folder and appointments with details
* Accept/Decline of appointments
* Participants and resources list from all appointments

=== Persistence of the Mobile Web App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Subscription of mail folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE, EN, ES, FR, NL and PL, other languages can be added.
* Branding options: App name and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile Web App runs on devices with a Webkit-based browser. These are mainly devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend using Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1, 4.3)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android 2.3.3), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|yes
|Opera Mobile is recommended to guarantee a proper user experience. Symbian's default browser is simply too slow.
|-
|Windows Mobile running Internet Explorer
|no
|
|-
|Windows Phone 7
|not yet
|
|-
|}

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

===Offline Mode details===

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

* The whole application will be cached using the "HTML5 application cache". This will be done on the first visit/start of the app. After this initial download, all graphics, language files, js-files and everything else which is needed to run the app 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.

Note: In case your device has no storage support (like the Nokia N97), a log message will inform you about this. The log can be found under the settings page, hitting the button in the upper right corner showing the exclamation mark symbol.

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download & Documentation==

Follow this [http://software.open-xchange.com/OX6/OXtender-stable/MobileApp/ link] to download the installation package, Release Notes and documentation.

'''Please Note:''' You cannot just upgrade to this new version because we changed the versioning to a lower version (from 6.20.0.0 to 0.9.0). In order to install this latest version, you either need to uninstall the current version or download the latest version manually and install using

$ dpkg -i open-xchange-gui-mobile*.deb

on Debian and on RPM based systems

$ rpm --force -Uhv open-xchange-gui-mobile*.rpm

{{InstallPlugin|pluginname=open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2|sopath=OXtender-stable/MobileApp|reponame=mobilewebapp}}

== Configuration ==

Installation on the Apache or another webserver:
* After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
* Edit the file <code>"ox-access.conf"</code> in directory ox6-mobile-v2
* If your open-xchange server is running on a different host, change localhost to your OX server address, i.e. "<code>https://example.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
* run the command (adopt webserver path on SLES/RHEL).
$ /opt/open-xchange/sbin/update-cache.manifest /var/www/ox6-mobile-v2/cache.manifest.in /var/www/ox6-mobile-v2/cache.manifest /var/www/ox6-mobile-v2/ox-access.conf
* You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile Web App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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 OX Mobile Web App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile Web App and choose "Add to homescreen". After this, the OX Mobile Web App will place a new app icon on the homescreen.

===Common mistakes===
Most problems can be solved by clearing the browser cache and reload the app. Try this before you request a bug or change the server settings.

Problem: After login a page is shown showing "Can not connect to backend. Please check your server settings in ox-access.conf".

Resolution: Your ox-access.conf is not configured correctlly. You must enter you server address on which the mobile app can get access to the OX backend. If everything on the backend is configured correctly, try to reload the app.

Problem: Using the browser's back button brings me back to the login page. After this the app does not work correctly.

Resolution: Only use the navigation of the app. On each subpage a back button is located at the upper left corner which brings you back to the previous page.

===Using the offline mode===

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

The OX Mobile Web App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' The Mobile Web App will detect the state of your internet connection live. Open the log under the settings page for informations

===Known Problems===

* The OX Mobile Web App 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. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

* If you want to use the App in airplane mode or no network connection is availabe, the android browser will show up a message like "page could not be loaded due to missing network connection". Just ignore this alert and press "OK". The app will work in offline mode even android shows up this message.

* If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.

== Deployment as native app ==

The OX Mobile Web App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile Web App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile Web App comes with the standard name set "OX Mobile Web App". This title is saved in a png file under "/lib/jqtouch/themes/cupertino/external/i18n_img/brand_[locale].png". To brand the app with your custom title just replace the files for each language to your needs. The i18n tool will show the graphic for each language. To configure the page title (in html title tag) please use the i18n module:

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the line containing msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
# Do this for all language files
* Note: Do not change the '''msgid''', this must be "OX Mobile". Only change the '''msgstr''' value.

This title will also be the "App title" for the iPhone when the function "Add to homescreen" is used.

== Theming ==

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

# Locate the theme path under "path to your webroot/ox6-mobile-v2/lib/jqtouch/themes"
# The default theme is named "cupertino". To create your own theme make a copy of this folder and backup the original one
# The folder contains two css files and two folders with images. The file jqt_theme.css contains all styles which belong to the "overall" look of the app. These are styles for lists, buttons, background, toolbars and so on. The file ox_theme.css contains more high level theming styles such as module icons, progress bars, infobox and the way the details in lists are shown (like the appointment lists or mail list). To change the whole look of the app (like colors) you will mainly edit the file jqt_theme.css
# The folders "img" and "external" hold all graphics which are used in the app. To change them, just edit and save them under the same name. Don't change filenames or the theme will be broken. Also keep all file dimensions and file types (*.png, *.jpg). Changing files dimensions will corrupt the theme and layout will be broken.
# 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:
[https://bugzilla.open-xchange.com/enter_bug.cgi?product=OX%20Mobile%20Web%20App Open-Xchange Bugzilla] 
Product: OX Mobile Web App

The OX Mobile Web App logs all errors to a logfile which can be found under settings -> log.

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-05-05T09:46:29Z

Alexquast: /* Application name */

= Information and Installation of Open-Xchange Mobile Web App =

== Description ==

Open-Xchange Mobile Web 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 Web App offers online and offline access to appointments, contacts and mails on the road using your smartphone. Optimized for low bandwiths Open-Xchange Mobile Web 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
*Calendar
*Contacts

Moreover the app 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 ==

=== Mail Module ===
*Access to all Open-Xchange private mail foldes
*Creation of new e-mails
*Answer, forward and delete e-mails
*Mail attachments (Attachment handling/support is defined by mobile device)

=== Contact Module ===
*Access to all Open-Xchange contact folder and contacts with details
*Creation of e-mail directly from contact module
*Start call directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folder and appointments with details
* Accept/Decline of appointments
* Participants and resources list from all appointments

=== Persistence of the Mobile Web App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Subscription of mail folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE, EN, ES, FR, NL and PL, other languages can be added.
* Branding options: App name and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile Web App runs on devices with a Webkit-based browser. These are mainly devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend using Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1, 4.3)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android 2.3.3), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|yes
|Opera Mobile is recommended to guarantee a proper user experience. Symbian's default browser is simply too slow.
|-
|Windows Mobile running Internet Explorer
|no
|
|-
|Windows Phone 7
|not yet
|
|-
|}

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

===Offline Mode details===

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

* The whole application will be cached using the "HTML5 application cache". This will be done on the first visit/start of the app. After this initial download, all graphics, language files, js-files and everything else which is needed to run the app 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.

Note: In case your device has no storage support (like the Nokia N97), a log message will inform you about this. The log can be found under the settings page, hitting the button in the upper right corner showing the exclamation mark symbol.

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download & Documentation==

Follow this [http://software.open-xchange.com/OX6/OXtender-stable/MobileApp/ link] to download the installation package, Release Notes and documentation.

'''Please Note:''' You cannot just upgrade to this new version because we changed the versioning to a lower version (from 6.20.0.0 to 0.9.0). In order to install this latest version, you either need to uninstall the current version or download the latest version manually and install using

$ dpkg -i open-xchange-gui-mobile*.deb

on Debian and on RPM based systems

$ rpm --force -Uhv open-xchange-gui-mobile*.rpm

{{InstallPlugin|pluginname=open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2|sopath=OXtender-stable/MobileApp|reponame=mobilewebapp}}

== Configuration ==

Installation on the Apache or another webserver:
* After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
* Edit the file <code>"ox-access.conf"</code> in directory ox6-mobile-v2
* If your open-xchange server is running on a different host, change localhost to your OX server address, i.e. "<code>https://example.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
* run the command (adopt webserver path on SLES/RHEL).
$ /opt/open-xchange/sbin/update-cache.manifest /var/www/ox6-mobile-v2/cache.manifest.in /var/www/ox6-mobile-v2/cache.manifest /var/www/ox6-mobile-v2/ox-access.conf
* You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile Web App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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 OX Mobile Web App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile Web App and choose "Add to homescreen". After this, the OX Mobile Web App will place a new app icon on the homescreen.

===Common mistakes===
Problem: After login a page is shown showing "Can not connect to backend. Please check your server settings in ox-access.conf".

Resolution: Your ox-access.conf is not configured correctlly. You must enter you server address on which the mobile app can get access to the OX backend. If everything on the backend is configured correctly, try to reload the app.

Problem: Using the browser's back button brings me back to the login page. After this the app does not work correctly.

Resolution: Only use the navigation of the app. On each subpage a back button is located at the upper left corner which brings you back to the previous page.

===Using the offline mode===

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

The OX Mobile Web App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' The Mobile Web App will detect the state of your internet connection live. Open the log under the settings page for informations

===Known Problems===

* The OX Mobile Web App 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. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

* If you want to use the App in airplane mode or no network connection is availabe, the android browser will show up a message like "page could not be loaded due to missing network connection". Just ignore this alert and press "OK". The app will work in offline mode even android shows up this message.

* If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.

== Deployment as native app ==

The OX Mobile Web App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile Web App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile Web App comes with the standard name set "OX Mobile Web App". This title is saved in a png file under "/lib/jqtouch/themes/cupertino/external/i18n_img/brand_[locale].png". To brand the app with your custom title just replace the files for each language to your needs. The i18n tool will show the graphic for each language. To configure the page title (in html title tag) please use the i18n module:

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the line containing msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
# Do this for all language files
* Note: Do not change the '''msgid''', this must be "OX Mobile". Only change the '''msgstr''' value.

This title will also be the "App title" for the iPhone when the function "Add to homescreen" is used.

== Theming ==

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

# Locate the theme path under "path to your webroot/ox6-mobile-v2/lib/jqtouch/themes"
# The default theme is named "cupertino". To create your own theme make a copy of this folder and backup the original one
# The folder contains two css files and two folders with images. The file jqt_theme.css contains all styles which belong to the "overall" look of the app. These are styles for lists, buttons, background, toolbars and so on. The file ox_theme.css contains more high level theming styles such as module icons, progress bars, infobox and the way the details in lists are shown (like the appointment lists or mail list). To change the whole look of the app (like colors) you will mainly edit the file jqt_theme.css
# The folders "img" and "external" hold all graphics which are used in the app. To change them, just edit and save them under the same name. Don't change filenames or the theme will be broken. Also keep all file dimensions and file types (*.png, *.jpg). Changing files dimensions will corrupt the theme and layout will be broken.
# 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:
[https://bugzilla.open-xchange.com/enter_bug.cgi?product=OX%20Mobile%20Web%20App Open-Xchange Bugzilla] 
Product: OX Mobile Web App

The OX Mobile Web App logs all errors to a logfile which can be found under settings -> log.

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-05-05T09:42:20Z

Alexquast: /* Known Problems */

= Information and Installation of Open-Xchange Mobile Web App =

== Description ==

Open-Xchange Mobile Web 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 Web App offers online and offline access to appointments, contacts and mails on the road using your smartphone. Optimized for low bandwiths Open-Xchange Mobile Web 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
*Calendar
*Contacts

Moreover the app 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 ==

=== Mail Module ===
*Access to all Open-Xchange private mail foldes
*Creation of new e-mails
*Answer, forward and delete e-mails
*Mail attachments (Attachment handling/support is defined by mobile device)

=== Contact Module ===
*Access to all Open-Xchange contact folder and contacts with details
*Creation of e-mail directly from contact module
*Start call directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folder and appointments with details
* Accept/Decline of appointments
* Participants and resources list from all appointments

=== Persistence of the Mobile Web App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Subscription of mail folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE, EN, ES, FR, NL and PL, other languages can be added.
* Branding options: App name and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile Web App runs on devices with a Webkit-based browser. These are mainly devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend using Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1, 4.3)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android 2.3.3), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|yes
|Opera Mobile is recommended to guarantee a proper user experience. Symbian's default browser is simply too slow.
|-
|Windows Mobile running Internet Explorer
|no
|
|-
|Windows Phone 7
|not yet
|
|-
|}

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

===Offline Mode details===

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

* The whole application will be cached using the "HTML5 application cache". This will be done on the first visit/start of the app. After this initial download, all graphics, language files, js-files and everything else which is needed to run the app 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.

Note: In case your device has no storage support (like the Nokia N97), a log message will inform you about this. The log can be found under the settings page, hitting the button in the upper right corner showing the exclamation mark symbol.

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download & Documentation==

Follow this [http://software.open-xchange.com/OX6/OXtender-stable/MobileApp/ link] to download the installation package, Release Notes and documentation.

'''Please Note:''' You cannot just upgrade to this new version because we changed the versioning to a lower version (from 6.20.0.0 to 0.9.0). In order to install this latest version, you either need to uninstall the current version or download the latest version manually and install using

$ dpkg -i open-xchange-gui-mobile*.deb

on Debian and on RPM based systems

$ rpm --force -Uhv open-xchange-gui-mobile*.rpm

{{InstallPlugin|pluginname=open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2|sopath=OXtender-stable/MobileApp|reponame=mobilewebapp}}

== Configuration ==

Installation on the Apache or another webserver:
* After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
* Edit the file <code>"ox-access.conf"</code> in directory ox6-mobile-v2
* If your open-xchange server is running on a different host, change localhost to your OX server address, i.e. "<code>https://example.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
* run the command (adopt webserver path on SLES/RHEL).
$ /opt/open-xchange/sbin/update-cache.manifest /var/www/ox6-mobile-v2/cache.manifest.in /var/www/ox6-mobile-v2/cache.manifest /var/www/ox6-mobile-v2/ox-access.conf
* You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile Web App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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 OX Mobile Web App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile Web App and choose "Add to homescreen". After this, the OX Mobile Web App will place a new app icon on the homescreen.

===Common mistakes===
Problem: After login a page is shown showing "Can not connect to backend. Please check your server settings in ox-access.conf".

Resolution: Your ox-access.conf is not configured correctlly. You must enter you server address on which the mobile app can get access to the OX backend. If everything on the backend is configured correctly, try to reload the app.

Problem: Using the browser's back button brings me back to the login page. After this the app does not work correctly.

Resolution: Only use the navigation of the app. On each subpage a back button is located at the upper left corner which brings you back to the previous page.

===Using the offline mode===

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

The OX Mobile Web App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' The Mobile Web App will detect the state of your internet connection live. Open the log under the settings page for informations

===Known Problems===

* The OX Mobile Web App 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. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

* If you want to use the App in airplane mode or no network connection is availabe, the android browser will show up a message like "page could not be loaded due to missing network connection". Just ignore this alert and press "OK". The app will work in offline mode even android shows up this message.

* If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.

== Deployment as native app ==

The OX Mobile Web App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile Web App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile Web App comes with the standard name set "OX Mobile Web App". This title is saved in a png file under "/lib/jqtouch/themes/cupertino/external/brand.png". To brand the app with you custom title just replace this file in the standard theme or you own theme. To configure the page title (in html title tag) please use the i18n module:

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the line containing msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
# Do this for all language files
* Note: Do not change the '''msgid''', this must be "OX Mobile". Only change the '''msgstr''' value.

This title will also be the "App title" for the iPhone when the function "Add to homescreen" is used.

== Theming ==

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

# Locate the theme path under "path to your webroot/ox6-mobile-v2/lib/jqtouch/themes"
# The default theme is named "cupertino". To create your own theme make a copy of this folder and backup the original one
# The folder contains two css files and two folders with images. The file jqt_theme.css contains all styles which belong to the "overall" look of the app. These are styles for lists, buttons, background, toolbars and so on. The file ox_theme.css contains more high level theming styles such as module icons, progress bars, infobox and the way the details in lists are shown (like the appointment lists or mail list). To change the whole look of the app (like colors) you will mainly edit the file jqt_theme.css
# The folders "img" and "external" hold all graphics which are used in the app. To change them, just edit and save them under the same name. Don't change filenames or the theme will be broken. Also keep all file dimensions and file types (*.png, *.jpg). Changing files dimensions will corrupt the theme and layout will be broken.
# 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:
[https://bugzilla.open-xchange.com/enter_bug.cgi?product=OX%20Mobile%20Web%20App Open-Xchange Bugzilla] 
Product: OX Mobile Web App

The OX Mobile Web App logs all errors to a logfile which can be found under settings -> log.

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-05-05T09:41:48Z

Alexquast: /* Using the offline mode */

= Information and Installation of Open-Xchange Mobile Web App =

== Description ==

Open-Xchange Mobile Web 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 Web App offers online and offline access to appointments, contacts and mails on the road using your smartphone. Optimized for low bandwiths Open-Xchange Mobile Web 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
*Calendar
*Contacts

Moreover the app 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 ==

=== Mail Module ===
*Access to all Open-Xchange private mail foldes
*Creation of new e-mails
*Answer, forward and delete e-mails
*Mail attachments (Attachment handling/support is defined by mobile device)

=== Contact Module ===
*Access to all Open-Xchange contact folder and contacts with details
*Creation of e-mail directly from contact module
*Start call directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folder and appointments with details
* Accept/Decline of appointments
* Participants and resources list from all appointments

=== Persistence of the Mobile Web App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Subscription of mail folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE, EN, ES, FR, NL and PL, other languages can be added.
* Branding options: App name and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile Web App runs on devices with a Webkit-based browser. These are mainly devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend using Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1, 4.3)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android 2.3.3), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|yes
|Opera Mobile is recommended to guarantee a proper user experience. Symbian's default browser is simply too slow.
|-
|Windows Mobile running Internet Explorer
|no
|
|-
|Windows Phone 7
|not yet
|
|-
|}

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

===Offline Mode details===

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

* The whole application will be cached using the "HTML5 application cache". This will be done on the first visit/start of the app. After this initial download, all graphics, language files, js-files and everything else which is needed to run the app 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.

Note: In case your device has no storage support (like the Nokia N97), a log message will inform you about this. The log can be found under the settings page, hitting the button in the upper right corner showing the exclamation mark symbol.

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download & Documentation==

Follow this [http://software.open-xchange.com/OX6/OXtender-stable/MobileApp/ link] to download the installation package, Release Notes and documentation.

'''Please Note:''' You cannot just upgrade to this new version because we changed the versioning to a lower version (from 6.20.0.0 to 0.9.0). In order to install this latest version, you either need to uninstall the current version or download the latest version manually and install using

$ dpkg -i open-xchange-gui-mobile*.deb

on Debian and on RPM based systems

$ rpm --force -Uhv open-xchange-gui-mobile*.rpm

{{InstallPlugin|pluginname=open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2|sopath=OXtender-stable/MobileApp|reponame=mobilewebapp}}

== Configuration ==

Installation on the Apache or another webserver:
* After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
* Edit the file <code>"ox-access.conf"</code> in directory ox6-mobile-v2
* If your open-xchange server is running on a different host, change localhost to your OX server address, i.e. "<code>https://example.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
* run the command (adopt webserver path on SLES/RHEL).
$ /opt/open-xchange/sbin/update-cache.manifest /var/www/ox6-mobile-v2/cache.manifest.in /var/www/ox6-mobile-v2/cache.manifest /var/www/ox6-mobile-v2/ox-access.conf
* You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile Web App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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 OX Mobile Web App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile Web App and choose "Add to homescreen". After this, the OX Mobile Web App will place a new app icon on the homescreen.

===Common mistakes===
Problem: After login a page is shown showing "Can not connect to backend. Please check your server settings in ox-access.conf".

Resolution: Your ox-access.conf is not configured correctlly. You must enter you server address on which the mobile app can get access to the OX backend. If everything on the backend is configured correctly, try to reload the app.

Problem: Using the browser's back button brings me back to the login page. After this the app does not work correctly.

Resolution: Only use the navigation of the app. On each subpage a back button is located at the upper left corner which brings you back to the previous page.

===Using the offline mode===

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

The OX Mobile Web App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' The Mobile Web App will detect the state of your internet connection live. Open the log under the settings page for informations

===Known Problems===

* The OX Mobile Web App 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. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

* If you want to use the App in airplane mode or no network connection is availabe, the android browser will show up a message like "page could not be loaded due to missing network connection". Just ignore this alert and press "OK". The app will work in offline mode even android shows up this message.

* The "Stay logged in" option does not work on Opera Browsers. You have to login each time you start the app

* If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.

== Deployment as native app ==

The OX Mobile Web App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile Web App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile Web App comes with the standard name set "OX Mobile Web App". This title is saved in a png file under "/lib/jqtouch/themes/cupertino/external/brand.png". To brand the app with you custom title just replace this file in the standard theme or you own theme. To configure the page title (in html title tag) please use the i18n module:

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the line containing msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
# Do this for all language files
* Note: Do not change the '''msgid''', this must be "OX Mobile". Only change the '''msgstr''' value.

This title will also be the "App title" for the iPhone when the function "Add to homescreen" is used.

== Theming ==

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

# Locate the theme path under "path to your webroot/ox6-mobile-v2/lib/jqtouch/themes"
# The default theme is named "cupertino". To create your own theme make a copy of this folder and backup the original one
# The folder contains two css files and two folders with images. The file jqt_theme.css contains all styles which belong to the "overall" look of the app. These are styles for lists, buttons, background, toolbars and so on. The file ox_theme.css contains more high level theming styles such as module icons, progress bars, infobox and the way the details in lists are shown (like the appointment lists or mail list). To change the whole look of the app (like colors) you will mainly edit the file jqt_theme.css
# The folders "img" and "external" hold all graphics which are used in the app. To change them, just edit and save them under the same name. Don't change filenames or the theme will be broken. Also keep all file dimensions and file types (*.png, *.jpg). Changing files dimensions will corrupt the theme and layout will be broken.
# 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:
[https://bugzilla.open-xchange.com/enter_bug.cgi?product=OX%20Mobile%20Web%20App Open-Xchange Bugzilla] 
Product: OX Mobile Web App

The OX Mobile Web App logs all errors to a logfile which can be found under settings -> log.

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-05-05T09:40:02Z

Alexquast: /* Common mistakes */

= Information and Installation of Open-Xchange Mobile Web App =

== Description ==

Open-Xchange Mobile Web 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 Web App offers online and offline access to appointments, contacts and mails on the road using your smartphone. Optimized for low bandwiths Open-Xchange Mobile Web 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
*Calendar
*Contacts

Moreover the app 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 ==

=== Mail Module ===
*Access to all Open-Xchange private mail foldes
*Creation of new e-mails
*Answer, forward and delete e-mails
*Mail attachments (Attachment handling/support is defined by mobile device)

=== Contact Module ===
*Access to all Open-Xchange contact folder and contacts with details
*Creation of e-mail directly from contact module
*Start call directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folder and appointments with details
* Accept/Decline of appointments
* Participants and resources list from all appointments

=== Persistence of the Mobile Web App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Subscription of mail folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE, EN, ES, FR, NL and PL, other languages can be added.
* Branding options: App name and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile Web App runs on devices with a Webkit-based browser. These are mainly devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend using Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1, 4.3)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android 2.3.3), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|yes
|Opera Mobile is recommended to guarantee a proper user experience. Symbian's default browser is simply too slow.
|-
|Windows Mobile running Internet Explorer
|no
|
|-
|Windows Phone 7
|not yet
|
|-
|}

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

===Offline Mode details===

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

* The whole application will be cached using the "HTML5 application cache". This will be done on the first visit/start of the app. After this initial download, all graphics, language files, js-files and everything else which is needed to run the app 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.

Note: In case your device has no storage support (like the Nokia N97), a log message will inform you about this. The log can be found under the settings page, hitting the button in the upper right corner showing the exclamation mark symbol.

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download & Documentation==

Follow this [http://software.open-xchange.com/OX6/OXtender-stable/MobileApp/ link] to download the installation package, Release Notes and documentation.

'''Please Note:''' You cannot just upgrade to this new version because we changed the versioning to a lower version (from 6.20.0.0 to 0.9.0). In order to install this latest version, you either need to uninstall the current version or download the latest version manually and install using

$ dpkg -i open-xchange-gui-mobile*.deb

on Debian and on RPM based systems

$ rpm --force -Uhv open-xchange-gui-mobile*.rpm

{{InstallPlugin|pluginname=open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2|sopath=OXtender-stable/MobileApp|reponame=mobilewebapp}}

== Configuration ==

Installation on the Apache or another webserver:
* After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
* Edit the file <code>"ox-access.conf"</code> in directory ox6-mobile-v2
* If your open-xchange server is running on a different host, change localhost to your OX server address, i.e. "<code>https://example.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
* run the command (adopt webserver path on SLES/RHEL).
$ /opt/open-xchange/sbin/update-cache.manifest /var/www/ox6-mobile-v2/cache.manifest.in /var/www/ox6-mobile-v2/cache.manifest /var/www/ox6-mobile-v2/ox-access.conf
* You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile Web App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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 OX Mobile Web App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile Web App and choose "Add to homescreen". After this, the OX Mobile Web App will place a new app icon on the homescreen.

===Common mistakes===
Problem: After login a page is shown showing "Can not connect to backend. Please check your server settings in ox-access.conf".

Resolution: Your ox-access.conf is not configured correctlly. You must enter you server address on which the mobile app can get access to the OX backend. If everything on the backend is configured correctly, try to reload the app.

Problem: Using the browser's back button brings me back to the login page. After this the app does not work correctly.

Resolution: Only use the navigation of the app. On each subpage a back button is located at the upper left corner which brings you back to the previous page.

===Using the offline mode===

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

The OX Mobile Web App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' At the moment the OX Mobile Web App will not detect if internet connection reappears during a run in offline mode. To re-enter online mode just restart the app.

===Known Problems===

* The OX Mobile Web App 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. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

* If you want to use the App in airplane mode or no network connection is availabe, the android browser will show up a message like "page could not be loaded due to missing network connection". Just ignore this alert and press "OK". The app will work in offline mode even android shows up this message.

* The "Stay logged in" option does not work on Opera Browsers. You have to login each time you start the app

* If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.

== Deployment as native app ==

The OX Mobile Web App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile Web App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile Web App comes with the standard name set "OX Mobile Web App". This title is saved in a png file under "/lib/jqtouch/themes/cupertino/external/brand.png". To brand the app with you custom title just replace this file in the standard theme or you own theme. To configure the page title (in html title tag) please use the i18n module:

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the line containing msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
# Do this for all language files
* Note: Do not change the '''msgid''', this must be "OX Mobile". Only change the '''msgstr''' value.

This title will also be the "App title" for the iPhone when the function "Add to homescreen" is used.

== Theming ==

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

# Locate the theme path under "path to your webroot/ox6-mobile-v2/lib/jqtouch/themes"
# The default theme is named "cupertino". To create your own theme make a copy of this folder and backup the original one
# The folder contains two css files and two folders with images. The file jqt_theme.css contains all styles which belong to the "overall" look of the app. These are styles for lists, buttons, background, toolbars and so on. The file ox_theme.css contains more high level theming styles such as module icons, progress bars, infobox and the way the details in lists are shown (like the appointment lists or mail list). To change the whole look of the app (like colors) you will mainly edit the file jqt_theme.css
# The folders "img" and "external" hold all graphics which are used in the app. To change them, just edit and save them under the same name. Don't change filenames or the theme will be broken. Also keep all file dimensions and file types (*.png, *.jpg). Changing files dimensions will corrupt the theme and layout will be broken.
# 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:
[https://bugzilla.open-xchange.com/enter_bug.cgi?product=OX%20Mobile%20Web%20App Open-Xchange Bugzilla] 
Product: OX Mobile Web App

The OX Mobile Web App logs all errors to a logfile which can be found under settings -> log.

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-05-02T13:07:49Z

Alexquast: /* Themeability, branding and i18n */

= Information and Installation of Open-Xchange Mobile Web App (Preview)=

== Description ==

Later this year, Open-Xchange will release Open-Xchange Mobile Web 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 Web App offers online and offline access to appointments, contacts and mails on the road using your smartphone. Optimized for low bandwiths Open-Xchange Mobile Web 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
*Calendar
*Contacts

Moreover the app 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 ==

=== Mail Module ===
*Access to all Open-Xchange private mail foldes
*Creation of new e-mails
*Answer, forward and delete e-mails
*Mail attachments (Attachment handling/support is defined by mobile device)

=== Contact Module ===
*Access to all Open-Xchange contact folder and contacts with details
*Creation of e-mail directly from contact module
*Start call directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folder and appointments with details
* Accept/Decline of appointments
* Participants and resources list from all appointments
* Planned: Additional notes for Accept/Decline function, creation of new appointments

=== Persistence of the Mobile Web App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Subscription of mail folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE, EN, ES, FR, NL and PL, other languages can be added.
* Branding options: App name and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile Web App runs on devices with a Webkit-based browser. These are mainly devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend using Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1, 4.3)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android 2.3.3), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|yes
|Opera Mobile is recommended to guarantee a proper user experience. Symbian's default browser is simply too slow.
|-
|Windows Mobile running Internet Explorer
|no
|
|-
|Windows Phone 7
|not yet
|
|-
|}

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

===Offline Mode details===

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

* The whole application will be cached using the "HTML5 application cache". This will be done on the first visit/start of the app. After this initial download, all graphics, language files, js-files and everything else which is needed to run the app 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.

Note: In case your device has no storage support (like the Nokia N97), a log message will inform you about this. The log can be found under the settings page, hitting the button in the upper right corner showing the exclamation mark symbol.

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download & Documentation==

Please note that everything from this page and beyond is in Preview: This means nothing is final, changes will be made before final release, stability is not guaranteed and nothing from this site should be used in production.

Follow this [http://software.open-xchange.com/OX6/OXtender-unstable/MobileApp/ link] to download the installation package, Release Notes and documentation.

'''Please Note:''' You cannot just upgrade to this new version because we changed the versioning to a lower version (from 6.20.0.0 to 0.9.0). In order to install this latest version, you either need to uninstall the current version or download the latest version manually and install using

$ dpkg -i open-xchange-gui-mobile*.deb

on Debian and on RPM based systems

$ rpm --force -Uhv open-xchange-gui-mobile*.rpm

{{InstallPlugin|pluginname=open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2|sopath=OXtender-unstable/MobileApp|reponame=mobilewebapp}}

== Configuration ==

Installation on the Apache or another webserver:
* After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
* Edit the file <code>"ox-access.conf"</code> in directory ox6-mobile-v2
* If your open-xchange server is running on a different host, change localhost to your OX server address, i.e. "<code>https://example.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
* run the command (adopt webserver path on SLES/RHEL).
$ /opt/open-xchange/sbin/update-cache.manifest /var/www/ox6-mobile-v2/cache.manifest.in /var/www/ox6-mobile-v2/cache.manifest /var/www/ox6-mobile-v2/ox-access.conf
* You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile Web App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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 OX Mobile Web App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile Web App and choose "Add to homescreen". After this, the OX Mobile Web App will place a new app icon on the homescreen.

===Common mistakes===
Problem: After login a page is shown showing "An Arror occured, Error 0". After closing this, main menu is shown but no data is listed for each module

Resolution: Your ox-access.conf is not configured correctlly. You must enter you server address on which the mobile app can get access to the OX backend.

Problem: Using the browser's back button brings me back to the login page. After this the app does not work correctly.

Resolution: Only use the navigation of the app. On each subpage a back button is located at the upper left corner which brings you back to the previous page.

===Using the offline mode===

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

The OX Mobile Web App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' At the moment the OX Mobile Web App will not detect if internet connection reappears during a run in offline mode. To re-enter online mode just restart the app.

===Known Problems===

* The OX Mobile Web App 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. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

* If you want to use the App in airplane mode or no network connection is availabe, the android browser will show up a message like "page could not be loaded due to missing network connection". Just ignore this alert and press "OK". The app will work in offline mode even android shows up this message.

* The "Stay logged in" option does not work on Opera Browsers. You have to login each time you start the app

* If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.

== Deployment as native app ==

The OX Mobile Web App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile Web App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not. These option will not be available for the Preview version of the app.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile Web App comes with the standard name set "OX Mobile Web App". This title is saved in a png file under "/lib/jqtouch/themes/cupertino/external/brand.png". To brand the app with you custom title just replace this file in the standard theme or you own theme. To configure the page title (in html title tag) please use the i18n module:

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the line containing msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
# Do this for all language files
* Note: Do not change the '''msgid''', this must be "OX Mobile". Only change the '''msgstr''' value.

This title will also be the "App title" for the iPhone when the function "Add to homescreen" is used.

== Theming ==

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

# Locate the theme path under "path to your webroot/ox6-mobile-v2/lib/jqtouch/themes"
# The default theme is named "cupertino". To create your own theme make a copy of this folder and backup the original one
# The folder contains two css files and two folders with images. The file jqt_theme.css contains all styles which belong to the "overall" look of the app. These are styles for lists, buttons, background, toolbars and so on. The file ox_theme.css contains more high level theming styles such as module icons, progress bars, infobox and the way the details in lists are shown (like the appointment lists or mail list). To change the whole look of the app (like colors) you will mainly edit the file jqt_theme.css
# The folders "img" and "external" hold all graphics which are used in the app. To change them, just edit and save them under the same name. Don't change filenames or the theme will be broken. Also keep all file dimensions and file types (*.png, *.jpg). Changing files dimensions will corrupt the theme and layout will be broken.
# 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:
[https://bugzilla.open-xchange.com/enter_bug.cgi?product=OX%20Mobile%20App Open-Xchange Bugzilla] 
Product: OX Mobile App

The OX Mobile Web App logs all errors to a logfile which can be found under settings -> log.

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-05-02T12:57:44Z

Alexquast: /* Supported devices */

= Information and Installation of Open-Xchange Mobile Web App (Preview)=

== Description ==

Later this year, Open-Xchange will release Open-Xchange Mobile Web 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 Web App offers online and offline access to appointments, contacts and mails on the road using your smartphone. Optimized for low bandwiths Open-Xchange Mobile Web 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
*Calendar
*Contacts

Moreover the app 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 ==

=== Mail Module ===
*Access to all Open-Xchange private mail foldes
*Creation of new e-mails
*Answer, forward and delete e-mails
*Mail attachments (Attachment handling/support is defined by mobile device)

=== Contact Module ===
*Access to all Open-Xchange contact folder and contacts with details
*Creation of e-mail directly from contact module
*Start call directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folder and appointments with details
* Accept/Decline of appointments
* Participants and resources list from all appointments
* Planned: Additional notes for Accept/Decline function, creation of new appointments

=== Persistence of the Mobile Web App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Subscription of mail folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE and EN, other languages can be added.
* Branding options: App name and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile Web App runs on devices with a Webkit-based browser. These are mainly devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend using Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1, 4.3)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android 2.3.3), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|yes
|Opera Mobile is recommended to guarantee a proper user experience. Symbian's default browser is simply too slow.
|-
|Windows Mobile running Internet Explorer
|no
|
|-
|Windows Phone 7
|not yet
|
|-
|}

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

===Offline Mode details===

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

* The whole application will be cached using the "HTML5 application cache". This will be done on the first visit/start of the app. After this initial download, all graphics, language files, js-files and everything else which is needed to run the app 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.

Note: In case your device has no storage support (like the Nokia N97), a log message will inform you about this. The log can be found under the settings page, hitting the button in the upper right corner showing the exclamation mark symbol.

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download & Documentation==

Please note that everything from this page and beyond is in Preview: This means nothing is final, changes will be made before final release, stability is not guaranteed and nothing from this site should be used in production.

Follow this [http://software.open-xchange.com/OX6/OXtender-unstable/MobileApp/ link] to download the installation package, Release Notes and documentation.

'''Please Note:''' You cannot just upgrade to this new version because we changed the versioning to a lower version (from 6.20.0.0 to 0.9.0). In order to install this latest version, you either need to uninstall the current version or download the latest version manually and install using

$ dpkg -i open-xchange-gui-mobile*.deb

on Debian and on RPM based systems

$ rpm --force -Uhv open-xchange-gui-mobile*.rpm

{{InstallPlugin|pluginname=open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2|sopath=OXtender-unstable/MobileApp|reponame=mobilewebapp}}

== Configuration ==

Installation on the Apache or another webserver:
* After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
* Edit the file <code>"ox-access.conf"</code> in directory ox6-mobile-v2
* If your open-xchange server is running on a different host, change localhost to your OX server address, i.e. "<code>https://example.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
* run the command (adopt webserver path on SLES/RHEL).
$ /opt/open-xchange/sbin/update-cache.manifest /var/www/ox6-mobile-v2/cache.manifest.in /var/www/ox6-mobile-v2/cache.manifest /var/www/ox6-mobile-v2/ox-access.conf
* You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile Web App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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 OX Mobile Web App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile Web App and choose "Add to homescreen". After this, the OX Mobile Web App will place a new app icon on the homescreen.

===Common mistakes===
Problem: After login a page is shown showing "An Arror occured, Error 0". After closing this, main menu is shown but no data is listed for each module

Resolution: Your ox-access.conf is not configured correctlly. You must enter you server address on which the mobile app can get access to the OX backend.

Problem: Using the browser's back button brings me back to the login page. After this the app does not work correctly.

Resolution: Only use the navigation of the app. On each subpage a back button is located at the upper left corner which brings you back to the previous page.

===Using the offline mode===

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

The OX Mobile Web App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' At the moment the OX Mobile Web App will not detect if internet connection reappears during a run in offline mode. To re-enter online mode just restart the app.

===Known Problems===

* The OX Mobile Web App 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. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

* If you want to use the App in airplane mode or no network connection is availabe, the android browser will show up a message like "page could not be loaded due to missing network connection". Just ignore this alert and press "OK". The app will work in offline mode even android shows up this message.

* The "Stay logged in" option does not work on Opera Browsers. You have to login each time you start the app

* If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.

== Deployment as native app ==

The OX Mobile Web App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile Web App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not. These option will not be available for the Preview version of the app.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile Web App comes with the standard name set "OX Mobile Web App". This title is saved in a png file under "/lib/jqtouch/themes/cupertino/external/brand.png". To brand the app with you custom title just replace this file in the standard theme or you own theme. To configure the page title (in html title tag) please use the i18n module:

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the line containing msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
# Do this for all language files
* Note: Do not change the '''msgid''', this must be "OX Mobile". Only change the '''msgstr''' value.

This title will also be the "App title" for the iPhone when the function "Add to homescreen" is used.

== Theming ==

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

# Locate the theme path under "path to your webroot/ox6-mobile-v2/lib/jqtouch/themes"
# The default theme is named "cupertino". To create your own theme make a copy of this folder and backup the original one
# The folder contains two css files and two folders with images. The file jqt_theme.css contains all styles which belong to the "overall" look of the app. These are styles for lists, buttons, background, toolbars and so on. The file ox_theme.css contains more high level theming styles such as module icons, progress bars, infobox and the way the details in lists are shown (like the appointment lists or mail list). To change the whole look of the app (like colors) you will mainly edit the file jqt_theme.css
# The folders "img" and "external" hold all graphics which are used in the app. To change them, just edit and save them under the same name. Don't change filenames or the theme will be broken. Also keep all file dimensions and file types (*.png, *.jpg). Changing files dimensions will corrupt the theme and layout will be broken.
# 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:
[https://bugzilla.open-xchange.com/enter_bug.cgi?product=OX%20Mobile%20App Open-Xchange Bugzilla] 
Product: OX Mobile App

The OX Mobile Web App logs all errors to a logfile which can be found under settings -> log.

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-05-02T12:55:38Z

Alexquast: /* Supported devices */

= Information and Installation of Open-Xchange Mobile Web App (Preview)=

== Description ==

Later this year, Open-Xchange will release Open-Xchange Mobile Web 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 Web App offers online and offline access to appointments, contacts and mails on the road using your smartphone. Optimized for low bandwiths Open-Xchange Mobile Web 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
*Calendar
*Contacts

Moreover the app 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 ==

=== Mail Module ===
*Access to all Open-Xchange private mail foldes
*Creation of new e-mails
*Answer, forward and delete e-mails
*Mail attachments (Attachment handling/support is defined by mobile device)

=== Contact Module ===
*Access to all Open-Xchange contact folder and contacts with details
*Creation of e-mail directly from contact module
*Start call directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folder and appointments with details
* Accept/Decline of appointments
* Participants and resources list from all appointments
* Planned: Additional notes for Accept/Decline function, creation of new appointments

=== Persistence of the Mobile Web App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Subscription of mail folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE and EN, other languages can be added.
* Branding options: App name and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile Web App runs on devices with a Webkit-based browser. These are mainly devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend using Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1, 4.3)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android 2.3.3), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|yes (Opera Mobile is recommended)
|Bad user experience since Symbian's default browser is very slow
|-
|Windows Mobile running Internet Explorer
|no
|
|-
|Windows Phone 7
|not yet
|
|-
|}

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

===Offline Mode details===

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

* The whole application will be cached using the "HTML5 application cache". This will be done on the first visit/start of the app. After this initial download, all graphics, language files, js-files and everything else which is needed to run the app 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.

Note: In case your device has no storage support (like the Nokia N97), a log message will inform you about this. The log can be found under the settings page, hitting the button in the upper right corner showing the exclamation mark symbol.

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download & Documentation==

Please note that everything from this page and beyond is in Preview: This means nothing is final, changes will be made before final release, stability is not guaranteed and nothing from this site should be used in production.

Follow this [http://software.open-xchange.com/OX6/OXtender-unstable/MobileApp/ link] to download the installation package, Release Notes and documentation.

'''Please Note:''' You cannot just upgrade to this new version because we changed the versioning to a lower version (from 6.20.0.0 to 0.9.0). In order to install this latest version, you either need to uninstall the current version or download the latest version manually and install using

$ dpkg -i open-xchange-gui-mobile*.deb

on Debian and on RPM based systems

$ rpm --force -Uhv open-xchange-gui-mobile*.rpm

{{InstallPlugin|pluginname=open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2|sopath=OXtender-unstable/MobileApp|reponame=mobilewebapp}}

== Configuration ==

Installation on the Apache or another webserver:
* After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
* Edit the file <code>"ox-access.conf"</code> in directory ox6-mobile-v2
* If your open-xchange server is running on a different host, change localhost to your OX server address, i.e. "<code>https://example.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
* run the command (adopt webserver path on SLES/RHEL).
$ /opt/open-xchange/sbin/update-cache.manifest /var/www/ox6-mobile-v2/cache.manifest.in /var/www/ox6-mobile-v2/cache.manifest /var/www/ox6-mobile-v2/ox-access.conf
* You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile Web App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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 OX Mobile Web App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile Web App and choose "Add to homescreen". After this, the OX Mobile Web App will place a new app icon on the homescreen.

===Common mistakes===
Problem: After login a page is shown showing "An Arror occured, Error 0". After closing this, main menu is shown but no data is listed for each module

Resolution: Your ox-access.conf is not configured correctlly. You must enter you server address on which the mobile app can get access to the OX backend.

Problem: Using the browser's back button brings me back to the login page. After this the app does not work correctly.

Resolution: Only use the navigation of the app. On each subpage a back button is located at the upper left corner which brings you back to the previous page.

===Using the offline mode===

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

The OX Mobile Web App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' At the moment the OX Mobile Web App will not detect if internet connection reappears during a run in offline mode. To re-enter online mode just restart the app.

===Known Problems===

* The OX Mobile Web App 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. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

* If you want to use the App in airplane mode or no network connection is availabe, the android browser will show up a message like "page could not be loaded due to missing network connection". Just ignore this alert and press "OK". The app will work in offline mode even android shows up this message.

* The "Stay logged in" option does not work on Opera Browsers. You have to login each time you start the app

* If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.

== Deployment as native app ==

The OX Mobile Web App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile Web App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not. These option will not be available for the Preview version of the app.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile Web App comes with the standard name set "OX Mobile Web App". This title is saved in a png file under "/lib/jqtouch/themes/cupertino/external/brand.png". To brand the app with you custom title just replace this file in the standard theme or you own theme. To configure the page title (in html title tag) please use the i18n module:

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the line containing msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
# Do this for all language files
* Note: Do not change the '''msgid''', this must be "OX Mobile". Only change the '''msgstr''' value.

This title will also be the "App title" for the iPhone when the function "Add to homescreen" is used.

== Theming ==

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

# Locate the theme path under "path to your webroot/ox6-mobile-v2/lib/jqtouch/themes"
# The default theme is named "cupertino". To create your own theme make a copy of this folder and backup the original one
# The folder contains two css files and two folders with images. The file jqt_theme.css contains all styles which belong to the "overall" look of the app. These are styles for lists, buttons, background, toolbars and so on. The file ox_theme.css contains more high level theming styles such as module icons, progress bars, infobox and the way the details in lists are shown (like the appointment lists or mail list). To change the whole look of the app (like colors) you will mainly edit the file jqt_theme.css
# The folders "img" and "external" hold all graphics which are used in the app. To change them, just edit and save them under the same name. Don't change filenames or the theme will be broken. Also keep all file dimensions and file types (*.png, *.jpg). Changing files dimensions will corrupt the theme and layout will be broken.
# 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:
[https://bugzilla.open-xchange.com/enter_bug.cgi?product=OX%20Mobile%20App Open-Xchange Bugzilla] 
Product: OX Mobile App

The OX Mobile Web App logs all errors to a logfile which can be found under settings -> log.

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-05-02T12:48:25Z

Alexquast: /* Supported devices */

= Information and Installation of Open-Xchange Mobile Web App (Preview)=

== Description ==

Later this year, Open-Xchange will release Open-Xchange Mobile Web 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 Web App offers online and offline access to appointments, contacts and mails on the road using your smartphone. Optimized for low bandwiths Open-Xchange Mobile Web 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
*Calendar
*Contacts

Moreover the app 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 ==

=== Mail Module ===
*Access to all Open-Xchange private mail foldes
*Creation of new e-mails
*Answer, forward and delete e-mails
*Mail attachments (Attachment handling/support is defined by mobile device)

=== Contact Module ===
*Access to all Open-Xchange contact folder and contacts with details
*Creation of e-mail directly from contact module
*Start call directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folder and appointments with details
* Accept/Decline of appointments
* Participants and resources list from all appointments
* Planned: Additional notes for Accept/Decline function, creation of new appointments

=== Persistence of the Mobile Web App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Subscription of mail folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE and EN, other languages can be added.
* Branding options: App name and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile Web App should work on devices running a Webkit based browser. These are mainly the devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend to use Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1, 4.3)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android 2.3.3), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|Opera Mobiler recommended
|Built in Webkit browser is very slow
|-
|Windows Mobile running Internet Explorer
|no
|
|-
|Windows Phone 7
|not yet
|
|-
|}

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

===Offline Mode details===

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

* The whole application will be cached using the "HTML5 application cache". This will be done on the first visit/start of the app. After this initial download, all graphics, language files, js-files and everything else which is needed to run the app 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.

Note: In case your device has no storage support (like the Nokia N97), a log message will inform you about this. The log can be found under the settings page, hitting the button in the upper right corner showing the exclamation mark symbol.

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download & Documentation==

Please note that everything from this page and beyond is in Preview: This means nothing is final, changes will be made before final release, stability is not guaranteed and nothing from this site should be used in production.

Follow this [http://software.open-xchange.com/OX6/OXtender-unstable/MobileApp/ link] to download the installation package, Release Notes and documentation.

'''Please Note:''' You cannot just upgrade to this new version because we changed the versioning to a lower version (from 6.20.0.0 to 0.9.0). In order to install this latest version, you either need to uninstall the current version or download the latest version manually and install using

$ dpkg -i open-xchange-gui-mobile*.deb

on Debian and on RPM based systems

$ rpm --force -Uhv open-xchange-gui-mobile*.rpm

{{InstallPlugin|pluginname=open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2|sopath=OXtender-unstable/MobileApp|reponame=mobilewebapp}}

== Configuration ==

Installation on the Apache or another webserver:
* After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
* Edit the file <code>"ox-access.conf"</code> in directory ox6-mobile-v2
* If your open-xchange server is running on a different host, change localhost to your OX server address, i.e. "<code>https://example.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
* run the command (adopt webserver path on SLES/RHEL).
$ /opt/open-xchange/sbin/update-cache.manifest /var/www/ox6-mobile-v2/cache.manifest.in /var/www/ox6-mobile-v2/cache.manifest /var/www/ox6-mobile-v2/ox-access.conf
* You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile Web App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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 OX Mobile Web App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile Web App and choose "Add to homescreen". After this, the OX Mobile Web App will place a new app icon on the homescreen.

===Common mistakes===
Problem: After login a page is shown showing "An Arror occured, Error 0". After closing this, main menu is shown but no data is listed for each module

Resolution: Your ox-access.conf is not configured correctlly. You must enter you server address on which the mobile app can get access to the OX backend.

Problem: Using the browser's back button brings me back to the login page. After this the app does not work correctly.

Resolution: Only use the navigation of the app. On each subpage a back button is located at the upper left corner which brings you back to the previous page.

===Using the offline mode===

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

The OX Mobile Web App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' At the moment the OX Mobile Web App will not detect if internet connection reappears during a run in offline mode. To re-enter online mode just restart the app.

===Known Problems===

* The OX Mobile Web App 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. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

* If you want to use the App in airplane mode or no network connection is availabe, the android browser will show up a message like "page could not be loaded due to missing network connection". Just ignore this alert and press "OK". The app will work in offline mode even android shows up this message.

* The "Stay logged in" option does not work on Opera Browsers. You have to login each time you start the app

* If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.

== Deployment as native app ==

The OX Mobile Web App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile Web App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not. These option will not be available for the Preview version of the app.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile Web App comes with the standard name set "OX Mobile Web App". This title is saved in a png file under "/lib/jqtouch/themes/cupertino/external/brand.png". To brand the app with you custom title just replace this file in the standard theme or you own theme. To configure the page title (in html title tag) please use the i18n module:

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the line containing msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
# Do this for all language files
* Note: Do not change the '''msgid''', this must be "OX Mobile". Only change the '''msgstr''' value.

This title will also be the "App title" for the iPhone when the function "Add to homescreen" is used.

== Theming ==

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

# Locate the theme path under "path to your webroot/ox6-mobile-v2/lib/jqtouch/themes"
# The default theme is named "cupertino". To create your own theme make a copy of this folder and backup the original one
# The folder contains two css files and two folders with images. The file jqt_theme.css contains all styles which belong to the "overall" look of the app. These are styles for lists, buttons, background, toolbars and so on. The file ox_theme.css contains more high level theming styles such as module icons, progress bars, infobox and the way the details in lists are shown (like the appointment lists or mail list). To change the whole look of the app (like colors) you will mainly edit the file jqt_theme.css
# The folders "img" and "external" hold all graphics which are used in the app. To change them, just edit and save them under the same name. Don't change filenames or the theme will be broken. Also keep all file dimensions and file types (*.png, *.jpg). Changing files dimensions will corrupt the theme and layout will be broken.
# 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:
[https://bugzilla.open-xchange.com/enter_bug.cgi?product=OX%20Mobile%20App Open-Xchange Bugzilla] 
Product: OX Mobile App

The OX Mobile Web App logs all errors to a logfile which can be found under settings -> log.

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-05-02T12:47:00Z

Alexquast: /* Configuration */

= Information and Installation of Open-Xchange Mobile Web App (Preview)=

== Description ==

Later this year, Open-Xchange will release Open-Xchange Mobile Web 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 Web App offers online and offline access to appointments, contacts and mails on the road using your smartphone. Optimized for low bandwiths Open-Xchange Mobile Web 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
*Calendar
*Contacts

Moreover the app 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 ==

=== Mail Module ===
*Access to all Open-Xchange private mail foldes
*Creation of new e-mails
*Answer, forward and delete e-mails
*Mail attachments (Attachment handling/support is defined by mobile device)

=== Contact Module ===
*Access to all Open-Xchange contact folder and contacts with details
*Creation of e-mail directly from contact module
*Start call directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folder and appointments with details
* Accept/Decline of appointments
* Participants and resources list from all appointments
* Planned: Additional notes for Accept/Decline function, creation of new appointments

=== Persistence of the Mobile Web App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Subscription of mail folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE and EN, other languages can be added.
* Branding options: App name and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile Web App should work on devices running a Webkit based browser. These are mainly the devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend to use Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1, 4.3)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android 2.3.3), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|via Opera Mini
|i.e Nokia N97 (Although there is a built-in Webkit browser running on this device a Symbian bug in the cookie-handling which prevents login to the OX-Server)
|-
|Windows Mobile running Internet Explorer
|no
|
|-
|Windows Phone 7
|not yet
|
|-
|}

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

===Offline Mode details===

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

* The whole application will be cached using the "HTML5 application cache". This will be done on the first visit/start of the app. After this initial download, all graphics, language files, js-files and everything else which is needed to run the app 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.

Note: In case your device has no storage support (like the Nokia N97), a log message will inform you about this. The log can be found under the settings page, hitting the button in the upper right corner showing the exclamation mark symbol.

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download & Documentation==

Please note that everything from this page and beyond is in Preview: This means nothing is final, changes will be made before final release, stability is not guaranteed and nothing from this site should be used in production.

Follow this [http://software.open-xchange.com/OX6/OXtender-unstable/MobileApp/ link] to download the installation package, Release Notes and documentation.

'''Please Note:''' You cannot just upgrade to this new version because we changed the versioning to a lower version (from 6.20.0.0 to 0.9.0). In order to install this latest version, you either need to uninstall the current version or download the latest version manually and install using

$ dpkg -i open-xchange-gui-mobile*.deb

on Debian and on RPM based systems

$ rpm --force -Uhv open-xchange-gui-mobile*.rpm

{{InstallPlugin|pluginname=open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2|sopath=OXtender-unstable/MobileApp|reponame=mobilewebapp}}

== Configuration ==

Installation on the Apache or another webserver:
* After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
* Edit the file <code>"ox-access.conf"</code> in directory ox6-mobile-v2
* If your open-xchange server is running on a different host, change localhost to your OX server address, i.e. "<code>https://example.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
* run the command (adopt webserver path on SLES/RHEL).
$ /opt/open-xchange/sbin/update-cache.manifest /var/www/ox6-mobile-v2/cache.manifest.in /var/www/ox6-mobile-v2/cache.manifest /var/www/ox6-mobile-v2/ox-access.conf
* You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile Web App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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 OX Mobile Web App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile Web App and choose "Add to homescreen". After this, the OX Mobile Web App will place a new app icon on the homescreen.

===Common mistakes===
Problem: After login a page is shown showing "An Arror occured, Error 0". After closing this, main menu is shown but no data is listed for each module

Resolution: Your ox-access.conf is not configured correctlly. You must enter you server address on which the mobile app can get access to the OX backend.

Problem: Using the browser's back button brings me back to the login page. After this the app does not work correctly.

Resolution: Only use the navigation of the app. On each subpage a back button is located at the upper left corner which brings you back to the previous page.

===Using the offline mode===

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

The OX Mobile Web App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' At the moment the OX Mobile Web App will not detect if internet connection reappears during a run in offline mode. To re-enter online mode just restart the app.

===Known Problems===

* The OX Mobile Web App 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. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

* If you want to use the App in airplane mode or no network connection is availabe, the android browser will show up a message like "page could not be loaded due to missing network connection". Just ignore this alert and press "OK". The app will work in offline mode even android shows up this message.

* The "Stay logged in" option does not work on Opera Browsers. You have to login each time you start the app

* If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.

== Deployment as native app ==

The OX Mobile Web App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile Web App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not. These option will not be available for the Preview version of the app.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile Web App comes with the standard name set "OX Mobile Web App". This title is saved in a png file under "/lib/jqtouch/themes/cupertino/external/brand.png". To brand the app with you custom title just replace this file in the standard theme or you own theme. To configure the page title (in html title tag) please use the i18n module:

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the line containing msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
# Do this for all language files
* Note: Do not change the '''msgid''', this must be "OX Mobile". Only change the '''msgstr''' value.

This title will also be the "App title" for the iPhone when the function "Add to homescreen" is used.

== Theming ==

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

# Locate the theme path under "path to your webroot/ox6-mobile-v2/lib/jqtouch/themes"
# The default theme is named "cupertino". To create your own theme make a copy of this folder and backup the original one
# The folder contains two css files and two folders with images. The file jqt_theme.css contains all styles which belong to the "overall" look of the app. These are styles for lists, buttons, background, toolbars and so on. The file ox_theme.css contains more high level theming styles such as module icons, progress bars, infobox and the way the details in lists are shown (like the appointment lists or mail list). To change the whole look of the app (like colors) you will mainly edit the file jqt_theme.css
# The folders "img" and "external" hold all graphics which are used in the app. To change them, just edit and save them under the same name. Don't change filenames or the theme will be broken. Also keep all file dimensions and file types (*.png, *.jpg). Changing files dimensions will corrupt the theme and layout will be broken.
# 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:
[https://bugzilla.open-xchange.com/enter_bug.cgi?product=OX%20Mobile%20App Open-Xchange Bugzilla] 
Product: OX Mobile App

The OX Mobile Web App logs all errors to a logfile which can be found under settings -> log.

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-05-02T12:45:56Z

Alexquast: /* Mail Module */

= Information and Installation of Open-Xchange Mobile Web App (Preview)=

== Description ==

Later this year, Open-Xchange will release Open-Xchange Mobile Web 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 Web App offers online and offline access to appointments, contacts and mails on the road using your smartphone. Optimized for low bandwiths Open-Xchange Mobile Web 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
*Calendar
*Contacts

Moreover the app 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 ==

=== Mail Module ===
*Access to all Open-Xchange private mail foldes
*Creation of new e-mails
*Answer, forward and delete e-mails
*Mail attachments (Attachment handling/support is defined by mobile device)

=== Contact Module ===
*Access to all Open-Xchange contact folder and contacts with details
*Creation of e-mail directly from contact module
*Start call directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folder and appointments with details
* Accept/Decline of appointments
* Participants and resources list from all appointments
* Planned: Additional notes for Accept/Decline function, creation of new appointments

=== Persistence of the Mobile Web App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE and EN, other languages can be added.
* Branding options: App name and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile Web App should work on devices running a Webkit based browser. These are mainly the devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend to use Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1, 4.3)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android 2.3.3), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|via Opera Mini
|i.e Nokia N97 (Although there is a built-in Webkit browser running on this device a Symbian bug in the cookie-handling which prevents login to the OX-Server)
|-
|Windows Mobile running Internet Explorer
|no
|
|-
|Windows Phone 7
|not yet
|
|-
|}

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

===Offline Mode details===

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

* The whole application will be cached using the "HTML5 application cache". This will be done on the first visit/start of the app. After this initial download, all graphics, language files, js-files and everything else which is needed to run the app 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.

Note: In case your device has no storage support (like the Nokia N97), a log message will inform you about this. The log can be found under the settings page, hitting the button in the upper right corner showing the exclamation mark symbol.

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download & Documentation==

Please note that everything from this page and beyond is in Preview: This means nothing is final, changes will be made before final release, stability is not guaranteed and nothing from this site should be used in production.

Follow this [http://software.open-xchange.com/OX6/OXtender-unstable/MobileApp/ link] to download the installation package, Release Notes and documentation.

'''Please Note:''' You cannot just upgrade to this new version because we changed the versioning to a lower version (from 6.20.0.0 to 0.9.0). In order to install this latest version, you either need to uninstall the current version or download the latest version manually and install using

$ dpkg -i open-xchange-gui-mobile*.deb

on Debian and on RPM based systems

$ rpm --force -Uhv open-xchange-gui-mobile*.rpm

{{InstallPlugin|pluginname=open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2|sopath=OXtender-unstable/MobileApp|reponame=mobilewebapp}}

== Configuration ==

Installation on the Apache or another webserver:
* After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
* Edit the file <code>"ox-access.conf"</code> in directory ox6-mobile-v2
* If your open-xchange server is running on a different host, change localhost to your OX server address, i.e. "<code>https://example.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
* run the command (adopt webserver path on SLES/RHEL).
$ /opt/open-xchange/sbin/update-cache.manifest /var/www/ox6-mobile-v2/cache.manifest.in /var/www/ox6-mobile-v2/cache.manifest /var/www/ox6-mobile-v2/ox-access.conf
* You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile Web App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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 OX Mobile Web App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile Web App and choose "Add to homescreen". After this, the OX Mobile Web App will place a new app icon on the homescreen.

===Common mistakes===
Problem: After login a page is shown showing "An Arror occured, Error 0". After closing this, main menu is shown but no data is listed for each module

Resolution: Your ox-access.conf is not configured correctlly. You must enter you server address on which the mobile app can get access to the OX backend.

Problem: Using the browser's back button brings me back to the login page. After this the app does not work correctly.

Resolution: Only use the navigation of the app. On each subpage a back button is located at the upper left corner which brings you back to the previous page.

===Using the offline mode===

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

The OX Mobile Web App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' At the moment the OX Mobile Web App will not detect if internet connection reappears during a run in offline mode. To re-enter online mode just restart the app.

===Known Problems===

* The OX Mobile Web App 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. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

* If you want to use the App in airplane mode or no network connection is availabe, the android browser will show up a message like "page could not be loaded due to missing network connection". Just ignore this alert and press "OK". The app will work in offline mode even android shows up this message.

* The "Stay logged in" option does not work on Opera Browsers. You have to login each time you start the app

* If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.

== Deployment as native app ==

The OX Mobile Web App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile Web App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not. These option will not be available for the Preview version of the app.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile Web App comes with the standard name set "OX Mobile Web App". This title is saved in a png file under "/lib/jqtouch/themes/cupertino/external/brand.png". To brand the app with you custom title just replace this file in the standard theme or you own theme. To configure the page title (in html title tag) please use the i18n module:

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the line containing msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
# Do this for all language files
* Note: Do not change the '''msgid''', this must be "OX Mobile". Only change the '''msgstr''' value.

This title will also be the "App title" for the iPhone when the function "Add to homescreen" is used.

== Theming ==

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

# Locate the theme path under "path to your webroot/ox6-mobile-v2/lib/jqtouch/themes"
# The default theme is named "cupertino". To create your own theme make a copy of this folder and backup the original one
# The folder contains two css files and two folders with images. The file jqt_theme.css contains all styles which belong to the "overall" look of the app. These are styles for lists, buttons, background, toolbars and so on. The file ox_theme.css contains more high level theming styles such as module icons, progress bars, infobox and the way the details in lists are shown (like the appointment lists or mail list). To change the whole look of the app (like colors) you will mainly edit the file jqt_theme.css
# The folders "img" and "external" hold all graphics which are used in the app. To change them, just edit and save them under the same name. Don't change filenames or the theme will be broken. Also keep all file dimensions and file types (*.png, *.jpg). Changing files dimensions will corrupt the theme and layout will be broken.
# 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:
[https://bugzilla.open-xchange.com/enter_bug.cgi?product=OX%20Mobile%20App Open-Xchange Bugzilla] 
Product: OX Mobile App

The OX Mobile Web App logs all errors to a logfile which can be found under settings -> log.

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-04-20T11:42:48Z

Alexquast: /* Known Problems */

= Information and Installation of Open-Xchange Mobile Web App (Preview)=

== Description ==

Later this year, Open-Xchange will release Open-Xchange Mobile Web 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 Web App offers online and offline access to appointments, contacts and mails on the road using your smartphone. Optimized for low bandwiths Open-Xchange Mobile Web 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
*Calendar
*Contacts

Moreover the app 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 ==

=== Mail Module ===
*Access to all Open-Xchange standard folder: Inbox, Sent, Trash, Spam and Drafts
*Creation of new e-mails
*Answer, forward and delete e-mails
*Mail attachments (Attachment handling/support is defined by mobile device)

=== Contact Module ===
*Access to all Open-Xchange contact folder and contacts with details
*Creation of e-mail directly from contact module
*Start call directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folder and appointments with details
* Accept/Decline of appointments
* Participants and resources list from all appointments
* Planned: Additional notes for Accept/Decline function, creation of new appointments

=== Persistence of the Mobile Web App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE and EN, other languages can be added.
* Branding options: App name and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile Web App should work on devices running a Webkit based browser. These are mainly the devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend to use Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1, 4.3)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android 2.3.3), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|via Opera Mini
|i.e Nokia N97 (Although there is a built-in Webkit browser running on this device a Symbian bug in the cookie-handling which prevents login to the OX-Server)
|-
|Windows Mobile running Internet Explorer
|no
|
|-
|Windows Phone 7
|not yet
|
|-
|}

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

===Offline Mode details===

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

* The whole application will be cached using the "HTML5 application cache". This will be done on the first visit/start of the app. After this initial download, all graphics, language files, js-files and everything else which is needed to run the app 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.

Note: In case your device has no storage support (like the Nokia N97), a log message will inform you about this. The log can be found under the settings page, hitting the button in the upper right corner showing the exclamation mark symbol.

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download & Documentation==

Please note that everything from this page and beyond is in Preview: This means nothing is final, changes will be made before final release, stability is not guaranteed and nothing from this site should be used in production.

Follow this [http://software.open-xchange.com/OX6/OXtender-unstable/MobileApp/ link] to download the installation package, Release Notes and documentation.

'''Please Note:''' You cannot just upgrade to this new version because we changed the versioning to a lower version (from 6.20.0.0 to 0.9.0). In order to install this latest version, you either need to uninstall the current version or download the latest version manually and install using

$ dpkg -i open-xchange-gui-mobile*.deb

on Debian and on RPM based systems

$ rpm --force -Uhv open-xchange-gui-mobile*.rpm

{{InstallPlugin|pluginname=open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2|sopath=OXtender-unstable/MobileApp|reponame=mobilewebapp}}

== Configuration ==

Installation on the Apache or another webserver:
* After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
* Edit the file <code>"ox-access.conf"</code> in directory ox6-mobile-v2
* If your open-xchange server is running on a different host, change localhost to your OX server address, i.e. "<code>https://example.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
* run the command (adopt webserver path on SLES/RHEL).
$ /opt/open-xchange/sbin/update-cache.manifest /var/www/ox6-mobile-v2/cache.manifest.in /var/www/ox6-mobile-v2/cache.manifest /var/www/ox6-mobile-v2/ox-access.conf
* You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile Web App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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 OX Mobile Web App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile Web App and choose "Add to homescreen". After this, the OX Mobile Web App will place a new app icon on the homescreen.

===Common mistakes===
Problem: After login a page is shown showing "An Arror occured, Error 0". After closing this, main menu is shown but no data is listed for each module

Resolution: Your ox-access.conf is not configured correctlly. You must enter you server address on which the mobile app can get access to the OX backend.

Problem: Using the browser's back button brings me back to the login page. After this the app does not work correctly.

Resolution: Only use the navigation of the app. On each subpage a back button is located at the upper left corner which brings you back to the previous page.

===Using the offline mode===

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

The OX Mobile Web App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' At the moment the OX Mobile Web App will not detect if internet connection reappears during a run in offline mode. To re-enter online mode just restart the app.

===Known Problems===

* The OX Mobile Web App 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. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

* If you want to use the App in airplane mode or no network connection is availabe, the android browser will show up a message like "page could not be loaded due to missing network connection". Just ignore this alert and press "OK". The app will work in offline mode even android shows up this message.

* The "Stay logged in" option does not work on Opera Browsers. You have to login each time you start the app

* If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.

== Deployment as native app ==

The OX Mobile Web App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile Web App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not. These option will not be available for the Preview version of the app.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile Web App comes with the standard name set "OX Mobile Web App". This title is saved in a png file under "/lib/jqtouch/themes/cupertino/external/brand.png". To brand the app with you custom title just replace this file in the standard theme or you own theme. To configure the page title (in html title tag) please use the i18n module:

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the line containing msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
# Do this for all language files
* Note: Do not change the '''msgid''', this must be "OX Mobile". Only change the '''msgstr''' value.

This title will also be the "App title" for the iPhone when the function "Add to homescreen" is used.

== Theming ==

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

# Locate the theme path under "path to your webroot/ox6-mobile-v2/lib/jqtouch/themes"
# The default theme is named "cupertino". To create your own theme make a copy of this folder and backup the original one
# The folder contains two css files and two folders with images. The file jqt_theme.css contains all styles which belong to the "overall" look of the app. These are styles for lists, buttons, background, toolbars and so on. The file ox_theme.css contains more high level theming styles such as module icons, progress bars, infobox and the way the details in lists are shown (like the appointment lists or mail list). To change the whole look of the app (like colors) you will mainly edit the file jqt_theme.css
# The folders "img" and "external" hold all graphics which are used in the app. To change them, just edit and save them under the same name. Don't change filenames or the theme will be broken. Also keep all file dimensions and file types (*.png, *.jpg). Changing files dimensions will corrupt the theme and layout will be broken.
# 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:
[https://bugzilla.open-xchange.com/enter_bug.cgi?product=OX%20Mobile%20App Open-Xchange Bugzilla] 
Product: OX Mobile App

The OX Mobile Web App logs all errors to a logfile which can be found under settings -> log.

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-04-08T06:55:17Z

Alexquast: /* Common mistakes */

= Information and Installation of Open-Xchange Mobile Web App (Preview)=

== Description ==

Later this year, Open-Xchange will release Open-Xchange Mobile Web 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 Web App offers online and offline access to appointments, contacts and mails on the road using your smartphone. Optimized for low bandwiths Open-Xchange Mobile Web 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
*Calendar
*Contacts

Moreover the app 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 ==

=== Mail Module ===
*Access to all Open-Xchange standard folder: Inbox, Sent, Trash, Spam and Drafts
*Creation of new e-mails
*Answer, forward and delete e-mails
*Mail attachments (Attachment handling/support is defined by mobile device)

=== Contact Module ===
*Access to all Open-Xchange contact folder and contacts with details
*Creation of e-mail directly from contact module
*Start call directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folder and appointments with details
* Accept/Decline of appointments
* Participants and resources list from all appointments
* Planned: Additional notes for Accept/Decline function, creation of new appointments

=== Persistence of the Mobile Web App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE and EN, other languages can be added.
* Branding options: App name and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile Web App should work on devices running a Webkit based browser. These are mainly the devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend to use Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1, 4.3)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android 2.3.3), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|via Opera Mini
|i.e Nokia N97 (Although there is a built-in Webkit browser running on this device a Symbian bug in the cookie-handling which prevents login to the OX-Server)
|-
|Windows Mobile running Internet Explorer
|no
|
|-
|Windows Phone 7
|not yet
|
|-
|}

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

===Offline Mode details===

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

* The whole application will be cached using the "HTML5 application cache". This will be done on the first visit/start of the app. After this initial download, all graphics, language files, js-files and everything else which is needed to run the app 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.

Note: In case your device has no storage support (like the Nokia N97), a log message will inform you about this. The log can be found under the settings page, hitting the button in the upper right corner showing the exclamation mark symbol.

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download & Documentation==

Please note that everything from this page and beyond is in Preview: This means nothing is final, changes will be made before final release, stability is not guaranteed and nothing from this site should be used in production.

Follow this [http://software.open-xchange.com/OX6/OXtender-unstable/MobileApp/ link] to download the installation package, Release Notes and documentation.

{{InstallPlugin|pluginname=open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2|sopath=OXtender-unstable/MobileApp|reponame=mobilewebapp}}

== Configuration ==

Installation on the Apache or another webserver:
* After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
* Edit the file <code>"ox-access.conf"</code> in directory ox6-mobile-v2
* If your open-xchange server is running on a different host, change localhost to your OX server address, i.e. "<code>https://example.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
* run the command (adopt webserver path on SLES/RHEL).
$ /opt/open-xchange/sbin/update-cache.manifest /var/www/ox6-mobile-v2/cache.manifest.in /var/www/ox6-mobile-v2/cache.manifest /var/www/ox6-mobile-v2/ox-access.conf
* You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile Web App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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 OX Mobile Web App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile Web App and choose "Add to homescreen". After this, the OX Mobile Web App will place a new app icon on the homescreen.

===Common mistakes===
Problem: After login a page is shown showing "An Arror occured, Error 0". After closing this, main menu is shown but no data is listed for each module

Resolution: Your ox-access.conf is not configured correctlly. You must enter you server address on which the mobile app can get access to the OX backend.

Problem: Using the browser's back button brings me back to the login page. After this the app does not work correctly.

Resolution: Only use the navigation of the app. On each subpage a back button is located at the upper left corner which brings you back to the previous page.

===Using the offline mode===

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

The OX Mobile Web App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' At the moment the OX Mobile Web App will not detect if internet connection reappears during a run in offline mode. To re-enter online mode just restart the app.

===Known Problems===

* The OX Mobile Web App 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. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

* If you want to use the App in airplane mode or no network connection is availabe, the android browser will show up a message like "page could not be loaded due to missing network connection". Just ignore this alert and press "OK". The app will work in offline mode even android shows up this message.

* If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.

== Deployment as native app ==

The OX Mobile Web App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile Web App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not. These option will not be available for the Preview version of the app.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile Web App comes with the standard name set "OX Mobile Web App". This title is saved in a png file under "/lib/jqtouch/themes/cupertino/external/brand.png". To brand the app with you custom title just replace this file in the standard theme or you own theme. To configure the page title (in html title tag) please use the i18n module:

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the line containing msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
# Do this for all language files
* Note: Do not change the '''msgid''', this must be "OX Mobile". Only change the '''msgstr''' value.

This title will also be the "App title" for the iPhone when the function "Add to homescreen" is used.

== Theming ==

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

# Locate the theme path under "path to your webroot/ox6-mobile-v2/lib/jqtouch/themes"
# The default theme is named "cupertino". To create your own theme make a copy of this folder and backup the original one
# The folder contains two css files and two folders with images. The file jqt_theme.css contains all styles which belong to the "overall" look of the app. These are styles for lists, buttons, background, toolbars and so on. The file ox_theme.css contains more high level theming styles such as module icons, progress bars, infobox and the way the details in lists are shown (like the appointment lists or mail list). To change the whole look of the app (like colors) you will mainly edit the file jqt_theme.css
# The folders "img" and "external" hold all graphics which are used in the app. To change them, just edit and save them under the same name. Don't change filenames or the theme will be broken. Also keep all file dimensions and file types (*.png, *.jpg). Changing files dimensions will corrupt the theme and layout will be broken.
# 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:
[https://bugzilla.open-xchange.com/enter_bug.cgi?product=OX%20Mobile%20App Open-Xchange Bugzilla] 
Product: OX Mobile App

The OX Mobile Web App logs all errors to a logfile which can be found under settings -> log.

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-04-07T08:17:18Z

Alexquast: /* Running the OX Mobile Web App on your smartphone */

= Information and Installation of Open-Xchange Mobile Web App (Preview)=

== Description ==

Later this year, Open-Xchange will release Open-Xchange Mobile Web 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 Web App offers online and offline access to appointments, contacts and mails on the road using your smartphone. Optimized for low bandwiths Open-Xchange Mobile Web 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
*Calendar
*Contacts

Moreover the app 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 ==

=== Mail Module ===
*Access to all Open-Xchange standard folder: Inbox, Sent, Trash, Spam and Drafts
*Creation of new e-mails
*Answer, forward and delete e-mails
*Mail attachments (Attachment handling/support is defined by mobile device)

=== Contact Module ===
*Access to all Open-Xchange contact folder and contacts with details
*Creation of e-mail directly from contact module
*Start call directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folder and appointments with details
* Accept/Decline of appointments
* Participants and resources list from all appointments
* Planned: Additional notes for Accept/Decline function, creation of new appointments

=== Persistence of the Mobile Web App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE and EN, other languages can be added.
* Branding options: App name and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile Web App should work on devices running a Webkit based browser. These are mainly the devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend to use Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1, 4.3)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android 2.3.3), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|via Opera Mini
|i.e Nokia N97 (Although there is a built-in Webkit browser running on this device a Symbian bug in the cookie-handling which prevents login to the OX-Server)
|-
|Windows Mobile running Internet Explorer
|no
|
|-
|Windows Phone 7
|not yet
|
|-
|}

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

===Offline Mode details===

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

* The whole application will be cached using the "HTML5 application cache". This will be done on the first visit/start of the app. After this initial download, all graphics, language files, js-files and everything else which is needed to run the app 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.

Note: In case your device has no storage support (like the Nokia N97), a log message will inform you about this. The log can be found under the settings page, hitting the button in the upper right corner showing the exclamation mark symbol.

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download & Documentation==

Please note that everything from this page and beyond is in Preview: This means nothing is final, changes will be made before final release, stability is not guaranteed and nothing from this site should be used in production.

Follow this [http://software.open-xchange.com/OX6/OXtender-unstable/MobileApp/ link] to download the installation package, Release Notes and documentation.

{{InstallPlugin|pluginname=open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2|sopath=OXtender-unstable/MobileApp|reponame=mobilewebapp}}

== Configuration ==

Installation on the Apache or another webserver:
* After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
* Edit the file <code>"ox-access.conf"</code> in directory ox6-mobile-v2
* If your open-xchange server is running on a different host, change localhost to your OX server address, i.e. "<code>https://example.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
* run the command (adopt webserver path on SLES/RHEL).
$ /opt/open-xchange/sbin/update-cache.manifest /var/www/ox6-mobile-v2/cache.manifest.in /var/www/ox6-mobile-v2/cache.manifest /var/www/ox6-mobile-v2/ox-access.conf
* You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile Web App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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 OX Mobile Web App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile Web App and choose "Add to homescreen". After this, the OX Mobile Web App will place a new app icon on the homescreen.

===Common mistakes===
Problem: After login a page is shown showing "An Arror occured, Error 0". After closing this, main menu is shown but no data is listed for each module

Resolution: Your ox-access.conf is not configured correctlly. You must enter you server address on which the mobile app can get access to the OX backend.

===Using the offline mode===

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

The OX Mobile Web App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' At the moment the OX Mobile Web App will not detect if internet connection reappears during a run in offline mode. To re-enter online mode just restart the app.

===Known Problems===

* The OX Mobile Web App 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. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

* If you want to use the App in airplane mode or no network connection is availabe, the android browser will show up a message like "page could not be loaded due to missing network connection". Just ignore this alert and press "OK". The app will work in offline mode even android shows up this message.

* If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.

== Deployment as native app ==

The OX Mobile Web App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile Web App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not. These option will not be available for the Preview version of the app.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile Web App comes with the standard name set "OX Mobile Web App". This title is saved in a png file under "/lib/jqtouch/themes/cupertino/external/brand.png". To brand the app with you custom title just replace this file in the standard theme or you own theme. To configure the page title (in html title tag) please use the i18n module:

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the line containing msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
# Do this for all language files
* Note: Do not change the '''msgid''', this must be "OX Mobile". Only change the '''msgstr''' value.

This title will also be the "App title" for the iPhone when the function "Add to homescreen" is used.

== Theming ==

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

# Locate the theme path under "path to your webroot/ox6-mobile-v2/lib/jqtouch/themes"
# The default theme is named "cupertino". To create your own theme make a copy of this folder and backup the original one
# The folder contains two css files and two folders with images. The file jqt_theme.css contains all styles which belong to the "overall" look of the app. These are styles for lists, buttons, background, toolbars and so on. The file ox_theme.css contains more high level theming styles such as module icons, progress bars, infobox and the way the details in lists are shown (like the appointment lists or mail list). To change the whole look of the app (like colors) you will mainly edit the file jqt_theme.css
# The folders "img" and "external" hold all graphics which are used in the app. To change them, just edit and save them under the same name. Don't change filenames or the theme will be broken. Also keep all file dimensions and file types (*.png, *.jpg). Changing files dimensions will corrupt the theme and layout will be broken.
# 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==

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] 
Product: OX Mobile App

The OX Mobile Web App logs all errors to a logfile which can be found under settings -> log.

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-03-22T12:03:08Z

Alexquast: /* Known Problems */

= Information and Installation of Open-Xchange Mobile Web App (Preview)=

== Description ==

Later this year, Open-Xchange will release Open-Xchange Mobile Web 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 Web App offers online and offline access to appointments, contacts and mails on the road using your smartphone. Optimized for low bandwiths Open-Xchange Mobile Web 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
*Calendar
*Contacts

Moreover the app 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 ==

=== Mail Module ===
*Access to all Open-Xchange standard folder: Inbox, Sent, Trash, Spam and Drafts
*Creation of new e-mails
*Answer, forward and delete e-mails
*Mail attachments (Attachment handling/support is defined by mobile device)

=== Contact Module ===
*Access to all Open-Xchange contact folder and contacts with details
*Creation of e-mail directly from contact module
*Start call directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folder and appointments with details
* Accept/Decline of appointments
* Participants and resources list from all appointments
* Planned: Additional notes for Accept/Decline function, creation of new appointments

=== Persistence of the Mobile Web App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE and EN, other languages can be added.
* Branding options: App name and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile Web App should work on devices running a Webkit based browser. These are mainly the devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend to use Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1, 4.3)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android 2.3.3), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|via Opera Mini
|i.e Nokia N97 (Although there is a built-in Webkit browser running on this device a Symbian bug in the cookie-handling which prevents login to the OX-Server)
|-
|Windows Mobile running Internet Explorer
|no
|
|-
|Windows Phone 7
|not yet
|
|-
|}

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

===Offline Mode details===

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

* The whole application will be cached using the "HTML5 application cache". This will be done on the first visit/start of the app. After this initial download, all graphics, language files, js-files and everything else which is needed to run the app 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.

Note: In case your device has no storage support (like the Nokia N97), a log message will inform you about this. The log can be found under the settings page, hitting the button in the upper right corner showing the exclamation mark symbol.

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download & Documentation==

Please note that everything from this page and beyond is in Preview: This means nothing is final, changes will be made before final release, stability is not guaranteed and nothing from this site should be used in production.

Follow this [http://software.open-xchange.com/OX6/OXtender-unstable/MobileApp/ link] to download the installation package, Release Notes and documentation.

The access data are:
* Username: oxmobileapp
* Password: first$cut

{{InstallPlugin|pluginname=open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2|sopath=OXtender-unstable/MobileApp|reponame=mobilewebapp}}

== Configuration ==

Installation on the Apache or another webserver:
# After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
# Edit the file <code>"ox-access.conf"</code> in directory ox6-mobile-v2
# If your open-xchange server is running on a different host, change localhost to your OX server address, i.e. "<code>https://example.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
# run the command <code>/opt/open-xchange/sbin/update-cache.manifest /var/www/ox6-mobile-v2/cache.manifest.in /var/www/ox6-mobile-v2/cache.manifest /var/www/ox6-mobile-v2/ox-access.conf</code> - path might be different on SLES/RHEL -.
# You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile Web App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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 OX Mobile Web App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile Web App and choose "Add to homescreen". After this, the OX Mobile Web App will place a new app icon on the homescreen.

===Using the offline mode===

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

The OX Mobile Web App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' At the moment the OX Mobile Web App will not detect if internet connection reappears during a run in offline mode. To re-enter online mode just restart the app.

===Known Problems===

* The OX Mobile Web App 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. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

* If you want to use the App in airplane mode or no network connection is availabe, the android browser will show up a message like "page could not be loaded due to missing network connection". Just ignore this alert and press "OK". The app will work in offline mode even android shows up this message.

* If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.

== Deployment as native app ==

The OX Mobile Web App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile Web App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not. These option will not be available for the Preview version of the app.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile Web App comes with the standard name set "OX Mobile Web App". This title is saved in a png file under "/lib/jqtouch/themes/cupertino/external/brand.png". To brand the app with you custom title just replace this file in the standard theme or you own theme. To configure the page title (in html title tag) please use the i18n module:

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the line containing msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
# Do this for all language files
* Note: Do not change the '''msgid''', this must be "OX Mobile". Only change the '''msgstr''' value.

This title will also be the "App title" for the iPhone when the function "Add to homescreen" is used.

== Theming ==

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

# Locate the theme path under "path to your webroot/ox6-mobile-v2/lib/jqtouch/themes"
# The default theme is named "cupertino". To create your own theme make a copy of this folder and backup the original one
# The folder contains two css files and two folders with images. The file jqt_theme.css contains all styles which belong to the "overall" look of the app. These are styles for lists, buttons, background, toolbars and so on. The file ox_theme.css contains more high level theming styles such as module icons, progress bars, infobox and the way the details in lists are shown (like the appointment lists or mail list). To change the whole look of the app (like colors) you will mainly edit the file jqt_theme.css
# The folders "img" and "external" hold all graphics which are used in the app. To change them, just edit and save them under the same name. Don't change filenames or the theme will be broken. Also keep all file dimensions and file types (*.png, *.jpg). Changing files dimensions will corrupt the theme and layout will be broken.
# 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==

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] 
Product: OX Mobile Web App

The OX Mobile Web App logs all errors to a logfile which can be found under settings -> log.

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-03-22T08:23:47Z

Alexquast: /* Supported devices */

= Information and Installation of Open-Xchange Mobile Web App (Preview)=

== Description ==

Later this year, Open-Xchange will release Open-Xchange Mobile Web 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 Web App offers online and offline access to appointments, contacts and mails on the road using your smartphone. Optimized for low bandwiths Open-Xchange Mobile Web 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
*Calendar
*Contacts

Moreover the app 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 ==

=== Mail Module ===
*Access to all Open-Xchange standard folder: Inbox, Sent, Trash, Spam and Drafts
*Creation of new e-mails
*Answer, forward and delete e-mails
*Mail attachments (Attachment handling/support is defined by mobile device)

=== Contact Module ===
*Access to all Open-Xchange contact folder and contacts with details
*Creation of e-mail directly from contact module
*Start call directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folder and appointments with details
* Accept/Decline of appointments
* Participants and resources list from all appointments
* Planned: Additional notes for Accept/Decline function, creation of new appointments

=== Persistence of the Mobile Web App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE and EN, other languages can be added.
* Branding options: App name and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile Web App should work on devices running a Webkit based browser. These are mainly the devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend to use Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1, 4.3)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android 2.3.3), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|via Opera Mini
|i.e Nokia N97 (Although there is a built-in Webkit browser running on this device a Symbian bug in the cookie-handling which prevents login to the OX-Server)
|-
|Windows Mobile running Internet Explorer
|no
|
|-
|Windows Phone 7
|not yet
|
|-
|}

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

===Offline Mode details===

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

* The whole application will be cached using the "HTML5 application cache". This will be done on the first visit/start of the app. After this initial download, all graphics, language files, js-files and everything else which is needed to run the app 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.

Note: In case your device has no storage support (like the Nokia N97), a log message will inform you about this. The log can be found under the settings page, hitting the button in the upper right corner showing the exclamation mark symbol.

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download & Documentation==

Please note that everything from this page and beyond is in Preview: This means nothing is final, changes will be made before final release, stability is not guaranteed and nothing from this site should be used in production.

Follow this [http://software.open-xchange.com/OX6/OXtender-unstable/MobileApp/ link] to download the installation package, Release Notes and documentation.

The access data are:
* Username: oxmobileapp
* Password: first$cut

{{InstallPlugin|pluginname=open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2|sopath=OXtender-unstable/MobileApp|reponame=mobilewebapp}}

== Configuration ==

Installation on the Apache or another webserver:
# After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
# Edit the file <code>"ox-access.conf"</code> in directory ox6-mobile-v2
# If your open-xchange server is running on a different host, change localhost to your OX server address, i.e. "<code>https://example.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
# run the command <code>/opt/open-xchange/sbin/update-cache.manifest /var/www/ox6-mobile-v2/cache.manifest.in /var/www/ox6-mobile-v2/cache.manifest /var/www/ox6-mobile-v2/ox-access.conf</code> - path might be different on SLES/RHEL -.
# You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile Web App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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 OX Mobile Web App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile Web App and choose "Add to homescreen". After this, the OX Mobile Web App will place a new app icon on the homescreen.

===Using the offline mode===

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

The OX Mobile Web App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' At the moment the OX Mobile Web App will not detect if internet connection reappears during a run in offline mode. To re-enter online mode just restart the app.

===Known Problems===

The OX Mobile Web App 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. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.

== Deployment as native app ==

The OX Mobile Web App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile Web App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not. These option will not be available for the Preview version of the app.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile Web App comes with the standard name set "OX Mobile Web App". This title is saved in a png file under "/lib/jqtouch/themes/cupertino/external/brand.png". To brand the app with you custom title just replace this file in the standard theme or you own theme. To configure the page title (in html title tag) please use the i18n module:

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the line containing msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
# Do this for all language files
* Note: Do not change the '''msgid''', this must be "OX Mobile". Only change the '''msgstr''' value.

This title will also be the "App title" for the iPhone when the function "Add to homescreen" is used.

== Theming ==

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

# Locate the theme path under "path to your webroot/ox6-mobile-v2/lib/jqtouch/themes"
# The default theme is named "cupertino". To create your own theme make a copy of this folder and backup the original one
# The folder contains two css files and two folders with images. The file jqt_theme.css contains all styles which belong to the "overall" look of the app. These are styles for lists, buttons, background, toolbars and so on. The file ox_theme.css contains more high level theming styles such as module icons, progress bars, infobox and the way the details in lists are shown (like the appointment lists or mail list). To change the whole look of the app (like colors) you will mainly edit the file jqt_theme.css
# The folders "img" and "external" hold all graphics which are used in the app. To change them, just edit and save them under the same name. Don't change filenames or the theme will be broken. Also keep all file dimensions and file types (*.png, *.jpg). Changing files dimensions will corrupt the theme and layout will be broken.
# 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==

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] 
Product: OX Mobile Web App

The OX Mobile Web App logs all errors to a logfile which can be found under settings -> log.

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-03-21T08:13:35Z

Alexquast: /* Theming */

= Information and Installation of Open-Xchange Mobile Web App (Preview)=

== Description ==

Later this year, Open-Xchange will release Open-Xchange Mobile Web 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 Web App offers online and offline access to appointments, contacts and mails on the road using your smartphone. Optimized for low bandwiths Open-Xchange Mobile Web 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
*Calendar
*Contacts

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

== Features and Functions ==

=== Mail Module ===
*Access to all Open-Xchange standard folder: Inbox, Sent, Trash, Spam and Drafts
*Creation of new e-mails
*Answer, forward and delete e-mails
*Mail attachments (Attachment handling/support is defined by mobile device)

=== Contact Module ===
*Access to all Open-Xchange contact folder and contacts with details
*Creation of e-mail directly from contact module
*Start call directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folder and appointments with details
* Accept/Decline of appointments
* Participants and resources list from all appointments
* Planned: Additional notes for Accept/Decline function, creation of new appointments

=== Persistence of the Mobile Web App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE and EN, other languages can be added.
* Branding options: App name and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile Web App should work on devices running a Webkit based browser. These are mainly the devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend to use Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1, 4.3)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android Froyo 2.2), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|via Opera Mobile
|i.e Nokia N97 (Although there is a built-in Webkit browser running on this device a Symbian bug in the cookie-handling which prevents login to the OX-Server)
|-
|Windows Mobile running Internet Explorer
|no
|
|-
|Windows Phone 7
|not yet
|
|-
|}

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

===Offline Mode details===

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

* The whole application will be cached using the "HTML5 application cache". This will be done on the first visit/start of the app. After this initial download, all graphics, language files, js-files and everything else which is needed to run the app 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.

Note: In case your device has no storage support (like the Nokia N97), a log message will inform you about this. The log can be found under the settings page, hitting the button in the upper right corner showing the exclamation mark symbol.

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download & Documentation==

Please note that everything from this page and beyond is in Preview: This means nothing is final, changes will be made before final release, stability is not guaranteed and nothing from this site should be used in production.

Follow this [http://software.open-xchange.com/OX6/OXtender-unstable/MobileApp/ link] to download the installation package, Release Notes and documentation.

The access data are:
* Username: oxmobileapp
* Password: first$cut

{{InstallPlugin|pluginname=open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2|sopath=OXtender-unstable/MobileApp|reponame=mobilewebapp}}

== Configuration ==

Installation on the Apache or another webserver:
# After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
# Edit the file <code>"ox-access.conf"</code> in directory ox6-mobile-v2
# If your open-xchange server is running on a different host, change localhost to your OX server address, i.e. "<code>https://example.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
# run the command <code>/opt/open-xchange/sbin/update-cache.manifest /var/www/ox6-mobile-v2/cache.manifest.in /var/www/ox6-mobile-v2/cache.manifest /var/www/ox6-mobile-v2/ox-access.conf</code> - path might be different on SLES/RHEL -.
# You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile Web App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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 OX Mobile Web App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile Web App and choose "Add to homescreen". After this, the OX Mobile Web App will place a new app icon on the homescreen.

===Using the offline mode===

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

The OX Mobile Web App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' At the moment the OX Mobile Web App will not detect if internet connection reappears during a run in offline mode. To re-enter online mode just restart the app.

===Known Problems===

The OX Mobile Web App 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. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.

== Deployment as native app ==

The OX Mobile Web App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile Web App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not. These option will not be available for the Preview version of the app.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile Web App comes with the standard name set "OX Mobile Web App". This title is saved in a png file under "/lib/jqtouch/themes/cupertino/external/brand.png". To brand the app with you custom title just replace this file in the standard theme or you own theme. To configure the page title (in html title tag) please use the i18n module:

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the line containing msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
# Do this for all language files
* Note: Do not change the '''msgid''', this must be "OX Mobile". Only change the '''msgstr''' value.

This title will also be the "App title" for the iPhone when the function "Add to homescreen" is used.

== Theming ==

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

# Locate the theme path under "path to your webroot/ox6-mobile-v2/lib/jqtouch/themes"
# The default theme is named "cupertino". To create your own theme make a copy of this folder and backup the original one
# The folder contains two css files and two folders with images. The file jqt_theme.css contains all styles which belong to the "overall" look of the app. These are styles for lists, buttons, background, toolbars and so on. The file ox_theme.css contains more high level theming styles such as module icons, progress bars, infobox and the way the details in lists are shown (like the appointment lists or mail list). To change the whole look of the app (like colors) you will mainly edit the file jqt_theme.css
# The folders "img" and "external" hold all graphics which are used in the app. To change them, just edit and save them under the same name. Don't change filenames or the theme will be broken. Also keep all file dimensions and file types (*.png, *.jpg). Changing files dimensions will corrupt the theme and layout will be broken.
# 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==

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] 
Product: OX Mobile Web App

The OX Mobile Web App logs all errors to a logfile which can be found under settings -> log.

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-03-21T08:12:47Z

Alexquast: /* Theming */

= Information and Installation of Open-Xchange Mobile Web App (Preview)=

== Description ==

Later this year, Open-Xchange will release Open-Xchange Mobile Web 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 Web App offers online and offline access to appointments, contacts and mails on the road using your smartphone. Optimized for low bandwiths Open-Xchange Mobile Web 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
*Calendar
*Contacts

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

== Features and Functions ==

=== Mail Module ===
*Access to all Open-Xchange standard folder: Inbox, Sent, Trash, Spam and Drafts
*Creation of new e-mails
*Answer, forward and delete e-mails
*Mail attachments (Attachment handling/support is defined by mobile device)

=== Contact Module ===
*Access to all Open-Xchange contact folder and contacts with details
*Creation of e-mail directly from contact module
*Start call directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folder and appointments with details
* Accept/Decline of appointments
* Participants and resources list from all appointments
* Planned: Additional notes for Accept/Decline function, creation of new appointments

=== Persistence of the Mobile Web App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE and EN, other languages can be added.
* Branding options: App name and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile Web App should work on devices running a Webkit based browser. These are mainly the devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend to use Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1, 4.3)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android Froyo 2.2), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|via Opera Mobile
|i.e Nokia N97 (Although there is a built-in Webkit browser running on this device a Symbian bug in the cookie-handling which prevents login to the OX-Server)
|-
|Windows Mobile running Internet Explorer
|no
|
|-
|Windows Phone 7
|not yet
|
|-
|}

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

===Offline Mode details===

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

* The whole application will be cached using the "HTML5 application cache". This will be done on the first visit/start of the app. After this initial download, all graphics, language files, js-files and everything else which is needed to run the app 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.

Note: In case your device has no storage support (like the Nokia N97), a log message will inform you about this. The log can be found under the settings page, hitting the button in the upper right corner showing the exclamation mark symbol.

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download & Documentation==

Please note that everything from this page and beyond is in Preview: This means nothing is final, changes will be made before final release, stability is not guaranteed and nothing from this site should be used in production.

Follow this [http://software.open-xchange.com/OX6/OXtender-unstable/MobileApp/ link] to download the installation package, Release Notes and documentation.

The access data are:
* Username: oxmobileapp
* Password: first$cut

{{InstallPlugin|pluginname=open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2|sopath=OXtender-unstable/MobileApp|reponame=mobilewebapp}}

== Configuration ==

Installation on the Apache or another webserver:
# After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
# Edit the file <code>"ox-access.conf"</code> in directory ox6-mobile-v2
# If your open-xchange server is running on a different host, change localhost to your OX server address, i.e. "<code>https://example.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
# run the command <code>/opt/open-xchange/sbin/update-cache.manifest /var/www/ox6-mobile-v2/cache.manifest.in /var/www/ox6-mobile-v2/cache.manifest /var/www/ox6-mobile-v2/ox-access.conf</code> - path might be different on SLES/RHEL -.
# You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile Web App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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 OX Mobile Web App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile Web App and choose "Add to homescreen". After this, the OX Mobile Web App will place a new app icon on the homescreen.

===Using the offline mode===

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

The OX Mobile Web App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' At the moment the OX Mobile Web App will not detect if internet connection reappears during a run in offline mode. To re-enter online mode just restart the app.

===Known Problems===

The OX Mobile Web App 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. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.

== Deployment as native app ==

The OX Mobile Web App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile Web App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not. These option will not be available for the Preview version of the app.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile Web App comes with the standard name set "OX Mobile Web App". This title is saved in a png file under "/lib/jqtouch/themes/cupertino/external/brand.png". To brand the app with you custom title just replace this file in the standard theme or you own theme. To configure the page title (in html title tag) please use the i18n module:

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the line containing msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
# Do this for all language files
* Note: Do not change the '''msgid''', this must be "OX Mobile". Only change the '''msgstr''' value.

This title will also be the "App title" for the iPhone when the function "Add to homescreen" is used.

== Theming ==

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

# Locate the theme path under "path to your webroot/ox6-mobile-v2/lib/jqtouch/themes"
# The default theme is named "cupertino". To create your own theme make a copy of this folder and backup the original one
# The folder contains two css files and two folders with images. The file jqt_theme.css contains all styles which belong to the "overall" look of the app. These are styles for lists, buttons, background, toolbars and so on. The file ox_theme.css contains more high level theming styles such as module icons, progress bars, infobox and the way the details in lists are shown (like the appointment lists or mail list). To change the whole look of the app (like colors) you will mainly edit the file jqt_theme.css
# The two folders "images" and "external" hold all graphics which are used in the app. To change them, just edit and save them under the same name. Don't change filenames or the theme will be broken. Also keep all file dimensions and file types (*.png, *.jpg). Changing files dimensions will corrupt the theme and layout will be broken.
# 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==

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] 
Product: OX Mobile Web App

The OX Mobile Web App logs all errors to a logfile which can be found under settings -> log.

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-03-21T08:11:19Z

Alexquast: /* Theming */

= Information and Installation of Open-Xchange Mobile Web App (Preview)=

== Description ==

Later this year, Open-Xchange will release Open-Xchange Mobile Web 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 Web App offers online and offline access to appointments, contacts and mails on the road using your smartphone. Optimized for low bandwiths Open-Xchange Mobile Web 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
*Calendar
*Contacts

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

== Features and Functions ==

=== Mail Module ===
*Access to all Open-Xchange standard folder: Inbox, Sent, Trash, Spam and Drafts
*Creation of new e-mails
*Answer, forward and delete e-mails
*Mail attachments (Attachment handling/support is defined by mobile device)

=== Contact Module ===
*Access to all Open-Xchange contact folder and contacts with details
*Creation of e-mail directly from contact module
*Start call directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folder and appointments with details
* Accept/Decline of appointments
* Participants and resources list from all appointments
* Planned: Additional notes for Accept/Decline function, creation of new appointments

=== Persistence of the Mobile Web App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE and EN, other languages can be added.
* Branding options: App name and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile Web App should work on devices running a Webkit based browser. These are mainly the devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend to use Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1, 4.3)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android Froyo 2.2), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|via Opera Mobile
|i.e Nokia N97 (Although there is a built-in Webkit browser running on this device a Symbian bug in the cookie-handling which prevents login to the OX-Server)
|-
|Windows Mobile running Internet Explorer
|no
|
|-
|Windows Phone 7
|not yet
|
|-
|}

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

===Offline Mode details===

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

* The whole application will be cached using the "HTML5 application cache". This will be done on the first visit/start of the app. After this initial download, all graphics, language files, js-files and everything else which is needed to run the app 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.

Note: In case your device has no storage support (like the Nokia N97), a log message will inform you about this. The log can be found under the settings page, hitting the button in the upper right corner showing the exclamation mark symbol.

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download & Documentation==

Please note that everything from this page and beyond is in Preview: This means nothing is final, changes will be made before final release, stability is not guaranteed and nothing from this site should be used in production.

Follow this [http://software.open-xchange.com/OX6/OXtender-unstable/MobileApp/ link] to download the installation package, Release Notes and documentation.

The access data are:
* Username: oxmobileapp
* Password: first$cut

{{InstallPlugin|pluginname=open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2|sopath=OXtender-unstable/MobileApp|reponame=mobilewebapp}}

== Configuration ==

Installation on the Apache or another webserver:
# After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
# Edit the file <code>"ox-access.conf"</code> in directory ox6-mobile-v2
# If your open-xchange server is running on a different host, change localhost to your OX server address, i.e. "<code>https://example.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
# run the command <code>/opt/open-xchange/sbin/update-cache.manifest /var/www/ox6-mobile-v2/cache.manifest.in /var/www/ox6-mobile-v2/cache.manifest /var/www/ox6-mobile-v2/ox-access.conf</code> - path might be different on SLES/RHEL -.
# You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile Web App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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 OX Mobile Web App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile Web App and choose "Add to homescreen". After this, the OX Mobile Web App will place a new app icon on the homescreen.

===Using the offline mode===

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

The OX Mobile Web App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' At the moment the OX Mobile Web App will not detect if internet connection reappears during a run in offline mode. To re-enter online mode just restart the app.

===Known Problems===

The OX Mobile Web App 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. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.

== Deployment as native app ==

The OX Mobile Web App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile Web App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not. These option will not be available for the Preview version of the app.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile Web App comes with the standard name set "OX Mobile Web App". This title is saved in a png file under "/lib/jqtouch/themes/cupertino/external/brand.png". To brand the app with you custom title just replace this file in the standard theme or you own theme. To configure the page title (in html title tag) please use the i18n module:

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the line containing msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
# Do this for all language files
* Note: Do not change the '''msgid''', this must be "OX Mobile". Only change the '''msgstr''' value.

This title will also be the "App title" for the iPhone when the function "Add to homescreen" is used.

== Theming ==

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

# Locate the theme path under "path to your webroot/ox-gui-mobile-v2/lib/jqtouch/themes"
# The default theme is named "cupertino". To create your own theme make a copy of this folder and backup the original one
# The folder contains two css files and two folders with images. The file jqt_theme.css contains all styles which belong to the "overall" look of the app. These are styles for lists, buttons, background, toolbars and so on. The file ox_theme.css contains more high level theming styles such as module icons, progress bars, infobox and the way the details in lists are shown (like the appointment lists or mail list). To change the whole look of the app (like colors) you will mainly edit the file jqt_theme.css
# The two folders "images" and "external" hold all graphics which are used in the app. To change them, just edit and save them under the same name. Don't change filenames or the theme will be broken. Also keep all file dimensions and file types (*.png, *.jpg). Changing files dimensions will corrupt the theme and layout will be broken.
# 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==

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] 
Product: OX Mobile Web App

The OX Mobile Web App logs all errors to a logfile which can be found under settings -> log.

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-03-21T07:46:52Z

Alexquast: /* Application name */

= Information and Installation of Open-Xchange Mobile Web App (Preview)=

== Description ==

Later this year, Open-Xchange will release Open-Xchange Mobile Web 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 Web App offers online and offline access to appointments, contacts and mails on the road using your smartphone. Optimized for low bandwiths Open-Xchange Mobile Web 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
*Calendar
*Contacts

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

== Features and Functions ==

=== Mail Module ===
*Access to all Open-Xchange standard folder: Inbox, Sent, Trash, Spam and Drafts
*Creation of new e-mails
*Answer, forward and delete e-mails
*Mail attachments (Attachment handling/support is defined by mobile device)

=== Contact Module ===
*Access to all Open-Xchange contact folder and contacts with details
*Creation of e-mail directly from contact module
*Start call directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folder and appointments with details
* Accept/Decline of appointments
* Participants and resources list from all appointments
* Planned: Additional notes for Accept/Decline function, creation of new appointments

=== Persistence of the Mobile Web App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE and EN, other languages can be added.
* Branding options: App name and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile Web App should work on devices running a Webkit based browser. These are mainly the devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend to use Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1, 4.3)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android Froyo 2.2), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|via Opera Mobile
|i.e Nokia N97 (Although there is a built-in Webkit browser running on this device a Symbian bug in the cookie-handling which prevents login to the OX-Server)
|-
|Windows Mobile running Internet Explorer
|no
|
|-
|Windows Phone 7
|not yet
|
|-
|}

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

===Offline Mode details===

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

* The whole application will be cached using the "HTML5 application cache". This will be done on the first visit/start of the app. After this initial download, all graphics, language files, js-files and everything else which is needed to run the app 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.

Note: In case your device has no storage support (like the Nokia N97), a log message will inform you about this. The log can be found under the settings page, hitting the button in the upper right corner showing the exclamation mark symbol.

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download & Documentation==

Please note that everything from this page and beyond is in Preview: This means nothing is final, changes will be made before final release, stability is not guaranteed and nothing from this site should be used in production.

Follow this [http://software.open-xchange.com/OX6/OXtender-unstable/MobileApp/ link] to download the installation package, Release Notes and documentation.

The access data are:
* Username: oxmobileapp
* Password: first$cut

{{InstallPlugin|pluginname=open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2|sopath=OXtender-unstable/MobileApp|reponame=mobilewebapp}}

== Configuration ==

Installation on the Apache or another webserver:
# After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
# Edit the file <code>"ox-access.conf"</code> in directory ox6-mobile-v2
# If your open-xchange server is running on a different host, change localhost to your OX server address, i.e. "<code>https://example.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
# run the command <code>/opt/open-xchange/sbin/update-cache.manifest /var/www/ox6-mobile-v2/cache.manifest.in /var/www/ox6-mobile-v2/cache.manifest /var/www/ox6-mobile-v2/ox-access.conf</code> - path might be different on SLES/RHEL -.
# You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile Web App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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 OX Mobile Web App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile Web App and choose "Add to homescreen". After this, the OX Mobile Web App will place a new app icon on the homescreen.

===Using the offline mode===

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

The OX Mobile Web App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' At the moment the OX Mobile Web App will not detect if internet connection reappears during a run in offline mode. To re-enter online mode just restart the app.

===Known Problems===

The OX Mobile Web App 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. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.

== Deployment as native app ==

The OX Mobile Web App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile Web App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not. These option will not be available for the Preview version of the app.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile Web App comes with the standard name set "OX Mobile Web App". This title is saved in a png file under "/lib/jqtouch/themes/cupertino/external/brand.png". To brand the app with you custom title just replace this file in the standard theme or you own theme. To configure the page title (in html title tag) please use the i18n module:

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the line containing msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
# Do this for all language files
* Note: Do not change the '''msgid''', this must be "OX Mobile". Only change the '''msgstr''' value.

This title will also be the "App title" for the iPhone when the function "Add to homescreen" is used.

== Theming ==

==Reporting==

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] 
Product: OX Mobile Web App

The OX Mobile Web App logs all errors to a logfile which can be found under settings -> log.

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-03-21T07:46:36Z

Alexquast: /* Branding options */

= Information and Installation of Open-Xchange Mobile Web App (Preview)=

== Description ==

Later this year, Open-Xchange will release Open-Xchange Mobile Web 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 Web App offers online and offline access to appointments, contacts and mails on the road using your smartphone. Optimized for low bandwiths Open-Xchange Mobile Web 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
*Calendar
*Contacts

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

== Features and Functions ==

=== Mail Module ===
*Access to all Open-Xchange standard folder: Inbox, Sent, Trash, Spam and Drafts
*Creation of new e-mails
*Answer, forward and delete e-mails
*Mail attachments (Attachment handling/support is defined by mobile device)

=== Contact Module ===
*Access to all Open-Xchange contact folder and contacts with details
*Creation of e-mail directly from contact module
*Start call directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folder and appointments with details
* Accept/Decline of appointments
* Participants and resources list from all appointments
* Planned: Additional notes for Accept/Decline function, creation of new appointments

=== Persistence of the Mobile Web App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE and EN, other languages can be added.
* Branding options: App name and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile Web App should work on devices running a Webkit based browser. These are mainly the devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend to use Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1, 4.3)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android Froyo 2.2), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|via Opera Mobile
|i.e Nokia N97 (Although there is a built-in Webkit browser running on this device a Symbian bug in the cookie-handling which prevents login to the OX-Server)
|-
|Windows Mobile running Internet Explorer
|no
|
|-
|Windows Phone 7
|not yet
|
|-
|}

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

===Offline Mode details===

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

* The whole application will be cached using the "HTML5 application cache". This will be done on the first visit/start of the app. After this initial download, all graphics, language files, js-files and everything else which is needed to run the app 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.

Note: In case your device has no storage support (like the Nokia N97), a log message will inform you about this. The log can be found under the settings page, hitting the button in the upper right corner showing the exclamation mark symbol.

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download & Documentation==

Please note that everything from this page and beyond is in Preview: This means nothing is final, changes will be made before final release, stability is not guaranteed and nothing from this site should be used in production.

Follow this [http://software.open-xchange.com/OX6/OXtender-unstable/MobileApp/ link] to download the installation package, Release Notes and documentation.

The access data are:
* Username: oxmobileapp
* Password: first$cut

{{InstallPlugin|pluginname=open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2|sopath=OXtender-unstable/MobileApp|reponame=mobilewebapp}}

== Configuration ==

Installation on the Apache or another webserver:
# After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
# Edit the file <code>"ox-access.conf"</code> in directory ox6-mobile-v2
# If your open-xchange server is running on a different host, change localhost to your OX server address, i.e. "<code>https://example.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
# run the command <code>/opt/open-xchange/sbin/update-cache.manifest /var/www/ox6-mobile-v2/cache.manifest.in /var/www/ox6-mobile-v2/cache.manifest /var/www/ox6-mobile-v2/ox-access.conf</code> - path might be different on SLES/RHEL -.
# You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile Web App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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 OX Mobile Web App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile Web App and choose "Add to homescreen". After this, the OX Mobile Web App will place a new app icon on the homescreen.

===Using the offline mode===

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

The OX Mobile Web App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' At the moment the OX Mobile Web App will not detect if internet connection reappears during a run in offline mode. To re-enter online mode just restart the app.

===Known Problems===

The OX Mobile Web App 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. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.

== Deployment as native app ==

The OX Mobile Web App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile Web App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not. These option will not be available for the Preview version of the app.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile Web App comes with the standard name set "OX Mobile Web App". This title is saved in a png file under "/lib/jqtouch/themes/cupertino/external/brand.png". To brand the app with you custom title just replace this file in the standard theme or you own theme. To configure the page title (in html title tag) please use the i18n module:

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the line containing msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
# Do this for all language files
* Note: Do not change the '''msgid''', this must be "OX Mobile". Only change the '''msgstr''' value.

This title will also be the "App title" for the iPhone when the function "Add to homescreen" is used.

== Theming ==

==Reporting==

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] 
Product: OX Mobile Web App

The OX Mobile Web App logs all errors to a logfile which can be found under settings -> log.

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-03-21T07:45:39Z

Alexquast: /* Supported devices */

= Information and Installation of Open-Xchange Mobile Web App (Preview)=

== Description ==

Later this year, Open-Xchange will release Open-Xchange Mobile Web 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 Web App offers online and offline access to appointments, contacts and mails on the road using your smartphone. Optimized for low bandwiths Open-Xchange Mobile Web 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
*Calendar
*Contacts

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

== Features and Functions ==

=== Mail Module ===
*Access to all Open-Xchange standard folder: Inbox, Sent, Trash, Spam and Drafts
*Creation of new e-mails
*Answer, forward and delete e-mails
*Mail attachments (Attachment handling/support is defined by mobile device)

=== Contact Module ===
*Access to all Open-Xchange contact folder and contacts with details
*Creation of e-mail directly from contact module
*Start call directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folder and appointments with details
* Accept/Decline of appointments
* Participants and resources list from all appointments
* Planned: Additional notes for Accept/Decline function, creation of new appointments

=== Persistence of the Mobile Web App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE and EN, other languages can be added.
* Branding options: App name and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile Web App should work on devices running a Webkit based browser. These are mainly the devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend to use Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1, 4.3)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android Froyo 2.2), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|via Opera Mobile
|i.e Nokia N97 (Although there is a built-in Webkit browser running on this device a Symbian bug in the cookie-handling which prevents login to the OX-Server)
|-
|Windows Mobile running Internet Explorer
|no
|
|-
|Windows Phone 7
|not yet
|
|-
|}

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

===Offline Mode details===

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

* The whole application will be cached using the "HTML5 application cache". This will be done on the first visit/start of the app. After this initial download, all graphics, language files, js-files and everything else which is needed to run the app 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.

Note: In case your device has no storage support (like the Nokia N97), a log message will inform you about this. The log can be found under the settings page, hitting the button in the upper right corner showing the exclamation mark symbol.

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download & Documentation==

Please note that everything from this page and beyond is in Preview: This means nothing is final, changes will be made before final release, stability is not guaranteed and nothing from this site should be used in production.

Follow this [http://software.open-xchange.com/OX6/OXtender-unstable/MobileApp/ link] to download the installation package, Release Notes and documentation.

The access data are:
* Username: oxmobileapp
* Password: first$cut

{{InstallPlugin|pluginname=open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2|sopath=OXtender-unstable/MobileApp|reponame=mobilewebapp}}

== Configuration ==

Installation on the Apache or another webserver:
# After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
# Edit the file <code>"ox-access.conf"</code> in directory ox6-mobile-v2
# If your open-xchange server is running on a different host, change localhost to your OX server address, i.e. "<code>https://example.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
# run the command <code>/opt/open-xchange/sbin/update-cache.manifest /var/www/ox6-mobile-v2/cache.manifest.in /var/www/ox6-mobile-v2/cache.manifest /var/www/ox6-mobile-v2/ox-access.conf</code> - path might be different on SLES/RHEL -.
# You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile Web App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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 OX Mobile Web App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile Web App and choose "Add to homescreen". After this, the OX Mobile Web App will place a new app icon on the homescreen.

===Using the offline mode===

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

The OX Mobile Web App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' At the moment the OX Mobile Web App will not detect if internet connection reappears during a run in offline mode. To re-enter online mode just restart the app.

===Known Problems===

The OX Mobile Web App 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. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.

== Deployment as native app ==

The OX Mobile Web App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile Web App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not. These option will not be available for the Preview version of the app.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile Web App comes with the standard name set "OX Mobile Web App". This title is saved in a png file under "/lib/jqtouch/themes/cupertino/external/brand.png". To brand the app with you custom title just replace this file in the standard theme or you own theme. To configure the page title (in html title tag) please use the i18n module:

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the line containing msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
# Do this for all language files
* Note: Do not change the '''msgid''', this must be "OX Mobile". Only change the '''msgstr''' value.

This title will also be the "App title" for the iPhone when the function "Add to homescreen" is used.

==Reporting==

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] 
Product: OX Mobile Web App

The OX Mobile Web App logs all errors to a logfile which can be found under settings -> log.

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-03-21T07:41:41Z

Alexquast: /* Technical overview */

= Information and Installation of Open-Xchange Mobile Web App (Preview)=

== Description ==

Later this year, Open-Xchange will release Open-Xchange Mobile Web 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 Web App offers online and offline access to appointments, contacts and mails on the road using your smartphone. Optimized for low bandwiths Open-Xchange Mobile Web 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
*Calendar
*Contacts

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

== Features and Functions ==

=== Mail Module ===
*Access to all Open-Xchange standard folder: Inbox, Sent, Trash, Spam and Drafts
*Creation of new e-mails
*Answer, forward and delete e-mails
*Mail attachments (Attachment handling/support is defined by mobile device)

=== Contact Module ===
*Access to all Open-Xchange contact folder and contacts with details
*Creation of e-mail directly from contact module
*Start call directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folder and appointments with details
* Accept/Decline of appointments
* Participants and resources list from all appointments
* Planned: Additional notes for Accept/Decline function, creation of new appointments

=== Persistence of the Mobile Web App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE and EN, other languages can be added.
* Branding options: App name and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile Web App should work on devices running a Webkit based browser. These are mainly the devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend to use Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android Froyo 2.2), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|via Opera Mobile
|i.e Nokia N97 (Although there is a built-in Webkit browser running on this device a Symbian bug in the cookie-handling which prevents login to the OX-Server)
|-
|Windows Mobile running Internet Explorer
|no
|
|-
|Windows Phone 7
|no
|
|-
|}

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

===Offline Mode details===

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

* The whole application will be cached using the "HTML5 application cache". This will be done on the first visit/start of the app. After this initial download, all graphics, language files, js-files and everything else which is needed to run the app 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.

Note: In case your device has no storage support (like the Nokia N97), a log message will inform you about this. The log can be found under the settings page, hitting the button in the upper right corner showing the exclamation mark symbol.

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download & Documentation==

Please note that everything from this page and beyond is in Preview: This means nothing is final, changes will be made before final release, stability is not guaranteed and nothing from this site should be used in production.

Follow this [http://software.open-xchange.com/OX6/OXtender-unstable/MobileApp/ link] to download the installation package, Release Notes and documentation.

The access data are:
* Username: oxmobileapp
* Password: first$cut

{{InstallPlugin|pluginname=open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2|sopath=OXtender-unstable/MobileApp|reponame=mobilewebapp}}

== Configuration ==

Installation on the Apache or another webserver:
# After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
# Edit the file <code>"ox-access.conf"</code> in directory ox6-mobile-v2
# If your open-xchange server is running on a different host, change localhost to your OX server address, i.e. "<code>https://example.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
# run the command <code>/opt/open-xchange/sbin/update-cache.manifest /var/www/ox6-mobile-v2/cache.manifest.in /var/www/ox6-mobile-v2/cache.manifest /var/www/ox6-mobile-v2/ox-access.conf</code> - path might be different on SLES/RHEL -.
# You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile Web App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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 OX Mobile Web App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile Web App and choose "Add to homescreen". After this, the OX Mobile Web App will place a new app icon on the homescreen.

===Using the offline mode===

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

The OX Mobile Web App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' At the moment the OX Mobile Web App will not detect if internet connection reappears during a run in offline mode. To re-enter online mode just restart the app.

===Known Problems===

The OX Mobile Web App 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. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.

== Deployment as native app ==

The OX Mobile Web App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile Web App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not. These option will not be available for the Preview version of the app.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile Web App comes with the standard name set "OX Mobile Web App". This title is saved in a png file under "/lib/jqtouch/themes/cupertino/external/brand.png". To brand the app with you custom title just replace this file in the standard theme or you own theme. To configure the page title (in html title tag) please use the i18n module:

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the line containing msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
# Do this for all language files
* Note: Do not change the '''msgid''', this must be "OX Mobile". Only change the '''msgstr''' value.

This title will also be the "App title" for the iPhone when the function "Add to homescreen" is used.

==Reporting==

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] 
Product: OX Mobile Web App

The OX Mobile Web App logs all errors to a logfile which can be found under settings -> log.

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-03-21T07:40:10Z

Alexquast: /* Technical overview */

= Information and Installation of Open-Xchange Mobile Web App (Preview)=

== Description ==

Later this year, Open-Xchange will release Open-Xchange Mobile Web 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 Web App offers online and offline access to appointments, contacts and mails on the road using your smartphone. Optimized for low bandwiths Open-Xchange Mobile Web 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
*Calendar
*Contacts

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

== Features and Functions ==

=== Mail Module ===
*Access to all Open-Xchange standard folder: Inbox, Sent, Trash, Spam and Drafts
*Creation of new e-mails
*Answer, forward and delete e-mails
*Mail attachments (Attachment handling/support is defined by mobile device)

=== Contact Module ===
*Access to all Open-Xchange contact folder and contacts with details
*Creation of e-mail directly from contact module
*Start call directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folder and appointments with details
* Accept/Decline of appointments
* Participants and resources list from all appointments
* Planned: Additional notes for Accept/Decline function, creation of new appointments

=== Persistence of the Mobile Web App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE and EN, other languages can be added.
* Branding options: App name and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile Web App should work on devices running a Webkit based browser. These are mainly the devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend to use Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android Froyo 2.2), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|via Opera Mobile
|i.e Nokia N97 (Although there is a built-in Webkit browser running on this device a Symbian bug in the cookie-handling which prevents login to the OX-Server)
|-
|Windows Mobile running Internet Explorer
|no
|
|-
|Windows Phone 7
|no
|
|-
|}

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

===Offline Mode details===

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

# The whole application will be cached using the "HTML5 application cache". This will be done on the first visit/start of the app. After this initial download, all graphics, language files, js-files and everything else which is needed to run the app 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.

Note: In case your device has no storage support (like the Nokia N97), a log message will inform you about this. The log can be found under the settings page, hitting the button in the upper right corner showing the exclamation mark symbol.

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download & Documentation==

Please note that everything from this page and beyond is in Preview: This means nothing is final, changes will be made before final release, stability is not guaranteed and nothing from this site should be used in production.

Follow this [http://software.open-xchange.com/OX6/OXtender-unstable/MobileApp/ link] to download the installation package, Release Notes and documentation.

The access data are:
* Username: oxmobileapp
* Password: first$cut

{{InstallPlugin|pluginname=open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2|sopath=OXtender-unstable/MobileApp|reponame=mobilewebapp}}

== Configuration ==

Installation on the Apache or another webserver:
# After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
# Edit the file <code>"ox-access.conf"</code> in directory ox6-mobile-v2
# If your open-xchange server is running on a different host, change localhost to your OX server address, i.e. "<code>https://example.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
# run the command <code>/opt/open-xchange/sbin/update-cache.manifest /var/www/ox6-mobile-v2/cache.manifest.in /var/www/ox6-mobile-v2/cache.manifest /var/www/ox6-mobile-v2/ox-access.conf</code> - path might be different on SLES/RHEL -.
# You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile Web App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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 OX Mobile Web App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile Web App and choose "Add to homescreen". After this, the OX Mobile Web App will place a new app icon on the homescreen.

===Using the offline mode===

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

The OX Mobile Web App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' At the moment the OX Mobile Web App will not detect if internet connection reappears during a run in offline mode. To re-enter online mode just restart the app.

===Known Problems===

The OX Mobile Web App 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. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.

== Deployment as native app ==

The OX Mobile Web App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile Web App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not. These option will not be available for the Preview version of the app.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile Web App comes with the standard name set "OX Mobile Web App". This title is saved in a png file under "/lib/jqtouch/themes/cupertino/external/brand.png". To brand the app with you custom title just replace this file in the standard theme or you own theme. To configure the page title (in html title tag) please use the i18n module:

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the line containing msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
# Do this for all language files
* Note: Do not change the '''msgid''', this must be "OX Mobile". Only change the '''msgstr''' value.

This title will also be the "App title" for the iPhone when the function "Add to homescreen" is used.

==Reporting==

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] 
Product: OX Mobile Web App

The OX Mobile Web App logs all errors to a logfile which can be found under settings -> log.

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-03-18T07:21:59Z

Alexquast: /* Reporting */

= Information and Installation of Open-Xchange Mobile Web App (Preview)=

== Description ==

Later this year, Open-Xchange will release Open-Xchange Mobile Web 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 Web App offers online and offline access to appointments, contacts and mails on the road using your smartphone. Optimized for low bandwiths Open-Xchange Mobile Web 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
*Calendar
*Contacts

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

== Features and Functions ==

=== Mail Module ===
*Access to all Open-Xchange standard folder: Inbox, Sent, Trash, Spam and Drafts
*Creation of new e-mails
*Answer, forward and delete e-mails
*Mail attachments (Attachment handling/support is defined by mobile device)

=== Contact Module ===
*Access to all Open-Xchange contact folder and contacts with details
*Creation of e-mail directly from contact module
*Start call directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folder and appointments with details
* Accept/Decline of appointments
* Participants and resources list from all appointments
* Planned: Additional notes for Accept/Decline function, creation of new appointments

=== Persistence of the Mobile Web App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE and EN, other languages can be added.
* Branding options: App name and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile Web App should work on devices running a Webkit based browser. These are mainly the devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend to use Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android Froyo 2.2), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|via Opera Mobile
|i.e Nokia N97 (Although there is a built-in Webkit browser running on this device a Symbian bug in the cookie-handling which prevents login to the OX-Server)
|-
|Windows Mobile running Internet Explorer
|no
|
|-
|Windows Phone 7
|no
|
|-
|}

== Technical overview ==
* Based on HTML5, CSS, Javascript, Frameworks jQuery and jQTouch
* Optimized for Webkit browsers (iPhone, Android, no optimized version for iPad yet)
* Complete offline capability

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download & Documentation==

Please note that everything from this page and beyond is in Preview: This means nothing is final, changes will be made before final release, stability is not guaranteed and nothing from this site should be used in production.

Follow this [http://software.open-xchange.com/OX6/OXtender-unstable/MobileApp/ link] to download the installation package, Release Notes and documentation.

The access data are:
* Username: oxmobileapp
* Password: first$cut

{{InstallPlugin|pluginname=open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2|sopath=OXtender-unstable/MobileApp|reponame=mobilewebapp}}

== Configuration ==

Installation on the Apache or another webserver:
# After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
# Edit the file <code>"ox-access.conf"</code> in directory ox6-mobile-v2
# If your open-xchange server is running on a different host, change localhost to your OX server address, i.e. "<code>https://example.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
# run the command <code>/opt/open-xchange/sbin/update-cache.manifest /var/www/ox6-mobile-v2/cache.manifest.in /var/www/ox6-mobile-v2/cache.manifest /var/www/ox6-mobile-v2/ox-access.conf</code> - path might be different on SLES/RHEL -.
# You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile Web App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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 OX Mobile Web App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile Web App and choose "Add to homescreen". After this, the OX Mobile Web App will place a new app icon on the homescreen.

===Using the offline mode===

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

The OX Mobile Web App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' At the moment the OX Mobile Web App will not detect if internet connection reappears during a run in offline mode. To re-enter online mode just restart the app.

===Known Problems===

The OX Mobile Web App 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. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.

== Deployment as native app ==

The OX Mobile Web App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile Web App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not. These option will not be available for the Preview version of the app.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile Web App comes with the standard name set "OX Mobile Web App". This title is saved in a png file under "/lib/jqtouch/themes/cupertino/external/brand.png". To brand the app with you custom title just replace this file in the standard theme or you own theme. To configure the page title (in html title tag) please use the i18n module:

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the line containing msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
# Do this for all language files
* Note: Do not change the '''msgid''', this must be "OX Mobile". Only change the '''msgstr''' value.

This title will also be the "App title" for the iPhone when the function "Add to homescreen" is used.

==Reporting==

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] 
Product: OX Mobile Web App

The OX Mobile Web App logs all errors to a logfile which can be found under settings -> log.

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-03-15T16:06:26Z

Alexquast: /* Mail Module */

= Information and Installation of Open-Xchange Mobile Web App (Preview)=

== Description ==

Later this year, Open-Xchange will release Open-Xchange Mobile Web 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 Web App offers online and offline access to appointments, contacts and mails on the road using your smartphone. Optimized for low bandwiths Open-Xchange Mobile Web 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
*Calendar
*Contacts

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

== Features and Functions ==

=== Mail Module ===
*Access to all Open-Xchange standard folder: Inbox, Sent, Trash, Spam and Drafts
*Creation of new e-mails
*Answer, forward and delete e-mails
*Mail attachments (Attachment handling/support is defined by mobile device)

=== Contact Module ===
*Access to all Open-Xchange contact folder and contacts with details
*Creation of e-mail directly from contact module
*Start call directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folder and appointments with details
* Accept/Decline of appointments
* Participants and resources list from all appointments
* Planned: Additional notes for Accept/Decline function, creation of new appointments

=== Persistence of the Mobile Web App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE and EN, other languages can be added.
* Branding options: App name and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile Web App should work on devices running a Webkit based browser. These are mainly the devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend to use Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android Froyo 2.2), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|via Opera Mobile
|i.e Nokia N97 (Although there is a built-in Webkit browser running on this device a Symbian bug in the cookie-handling which prevents login to the OX-Server)
|-
|Windows Mobile running Internet Explorer
|no
|
|-
|Windows Phone 7
|no
|
|-
|}

== Technical overview ==
* Based on HTML5, CSS, Javascript, Frameworks jQuery and jQTouch
* Optimized for Webkit browsers (iPhone, Android, no optimized version for iPad yet)
* Complete offline capability

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download & Documentation==

Please note that everything from this page and beyond is in Preview: This means nothing is final, changes will be made before final release, stability is not guaranteed and nothing from this site should be used in production.

Follow this [http://software.open-xchange.com/OX6/OXtender-unstable/MobileWebApp/ link] to download the installation package, Release Notes and documentation.

The access data are:
* Username: oxmobileapp
* Password: first$cut

{{InstallPlugin|pluginname=open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2|sopath=OXtender-unstable/MobileApp|reponame=mobilewebapp}}

== Configuration ==

Installation on the Apache or another webserver:
# After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
# Edit the file <code>"ox-access.conf"</code> in directory ox6-mobile-v2
# If your open-xchange server is running on a different host, change localhost to your OX server address, i.e. "<code>https://example.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
# run the command <code>/opt/open-xchange/sbin/update-cache.manifest /var/www/ox6-mobile-v2/cache.manifest.in /var/www/ox6-mobile-v2/cache.manifest /var/www/ox6-mobile-v2/ox-access.conf</code> - path might be different on SLES/RHEL -.
# You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile Web App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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 OX Mobile Web App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile Web App and choose "Add to homescreen". After this, the OX Mobile Web App will place a new app icon on the homescreen.

===Using the offline mode===

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

The OX Mobile Web App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' At the moment the OX Mobile Web App will not detect if internet connection reappears during a run in offline mode. To re-enter online mode just restart the app.

===Known Problems===

The OX Mobile Web App 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. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.

== Deployment as native app ==

The OX Mobile Web App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile Web App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not. These option will not be available for the Preview version of the app.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile Web App comes with the standard name set "OX Mobile Web App". This title is saved in a png file under "/lib/jqtouch/themes/cupertino/external/brand.png". To brand the app with you custom title just replace this file in the standard theme or you own theme. To configure the page title (in html title tag) please use the i18n module:

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the line containing msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
# Do this for all language files
* Note: Do not change the '''msgid''', this must be "OX Mobile". Only change the '''msgstr''' value.

This title will also be the "App title" for the iPhone when the function "Add to homescreen" is used.

==Reporting==

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] 
Product: OX Mobile Web App

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-03-15T16:04:42Z

Alexquast: /* Application name */

= Information and Installation of Open-Xchange Mobile Web App (Preview)=

== Description ==

Later this year, Open-Xchange will release Open-Xchange Mobile Web 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 Web App offers online and offline access to appointments, contacts and mails on the road using your smartphone. Optimized for low bandwiths Open-Xchange Mobile Web 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
*Calendar
*Contacts

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

== Features and Functions ==

=== Mail Module ===
*Access to all Open-Xchange standard folder: Inbox, Sent, Trash, Spam and Drafts
*Creation of new e-mails
*Answer, forward and delete e-mails

=== Contact Module ===
*Access to all Open-Xchange contact folder and contacts with details
*Creation of e-mail directly from contact module
*Start call directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folder and appointments with details
* Accept/Decline of appointments
* Participants and resources list from all appointments
* Planned: Additional notes for Accept/Decline function, creation of new appointments

=== Persistence of the Mobile Web App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE and EN, other languages can be added.
* Branding options: App name and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile Web App should work on devices running a Webkit based browser. These are mainly the devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend to use Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android Froyo 2.2), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|via Opera Mobile
|i.e Nokia N97 (Although there is a built-in Webkit browser running on this device a Symbian bug in the cookie-handling which prevents login to the OX-Server)
|-
|Windows Mobile running Internet Explorer
|no
|
|-
|Windows Phone 7
|no
|
|-
|}

== Technical overview ==
* Based on HTML5, CSS, Javascript, Frameworks jQuery and jQTouch
* Optimized for Webkit browsers (iPhone, Android, no optimized version for iPad yet)
* Complete offline capability

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download & Documentation==

Please note that everything from this page and beyond is in Preview: This means nothing is final, changes will be made before final release, stability is not guaranteed and nothing from this site should be used in production.

Follow this [http://software.open-xchange.com/OX6/OXtender-unstable/MobileWebApp/ link] to download the installation package, Release Notes and documentation.

The access data are:
* Username: oxmobileapp
* Password: first$cut

{{InstallPlugin|pluginname=open-xchange-gui-mobile-v2-gui open-xchange-gui-mobile-v2|sopath=OXtender-unstable/MobileApp|reponame=mobilewebapp}}

== Configuration ==

Installation on the Apache or another webserver:
# After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
# Edit the file <code>"ox-access.conf"</code> in directory ox6-mobile-v2
# If your open-xchange server is running on a different host, change localhost to your OX server address, i.e. "<code>https://example.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
# run the command <code>/opt/open-xchange/sbin/update-cache.manifest /var/www/ox6-mobile-v2/cache.manifest.in /var/www/ox6-mobile-v2/cache.manifest /var/www/ox6-mobile-v2/ox-access.conf</code> - path might be different on SLES/RHEL -.
# You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile Web App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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 OX Mobile Web App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile Web App and choose "Add to homescreen". After this, the OX Mobile Web App will place a new app icon on the homescreen.

===Using the offline mode===

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

The OX Mobile Web App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' At the moment the OX Mobile Web App will not detect if internet connection reappears during a run in offline mode. To re-enter online mode just restart the app.

===Known Problems===

The OX Mobile Web App 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. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.

== Deployment as native app ==

The OX Mobile Web App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile Web App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not. These option will not be available for the Preview version of the app.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile Web App comes with the standard name set "OX Mobile Web App". This title is saved in a png file under "/lib/jqtouch/themes/cupertino/external/brand.png". To brand the app with you custom title just replace this file in the standard theme or you own theme. To configure the page title (in html title tag) please use the i18n module:

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the line containing msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
# Do this for all language files
* Note: Do not change the '''msgid''', this must be "OX Mobile". Only change the '''msgstr''' value.

This title will also be the "App title" for the iPhone when the function "Add to homescreen" is used.

==Reporting==

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] 
Product: OX Mobile Web App

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-03-10T08:41:10Z

Alexquast: /* Themeability, branding and i18n */

= Information and Installation of Open-Xchange Mobile App (Beta)=

== Description ==

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
*Calendar
*Contacts

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

== Features and Functions ==

=== Mail Module ===
*Access to all Open-Xchange standard folder: Inbox, Sent, Trash, Spam and Drafts
*Creation of new e-mails
*Answer, forward and delete e-mails

=== Contact Module ===
*Access to all Open-Xchange contact folder and contacts with details
*Creation of e-mail directly from contact module
*Start call directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folder and appointments with details
* Accept/Decline of appointments
* Participants and resources list from all appointments
* Planned: Additional notes for Accept/Decline function, creation of new appointments

=== Persistence of the Mobile App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE and EN, other languages can be added.
* Branding options: App name and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile App should work on devices running a Webkit based browser. These are mainly the devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend to use Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android Froyo 2.2), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|via Opera Mobile
|i.e Nokia N97 (Although there is a built-in Webkit browser running on this device a Symbian bug in the cookie-handling which prevents login to the OX-Server)
|-
|Windows Mobile running Internet Explorer
|no
|
|-
|Windows Phone 7
|no
|
|-
|}

== Technical overview ==
* Based on HTML5, CSS, Javascript, Frameworks jQuery and jQTouch
* Optimized for Webkit browsers (iPhone, Android, no optimized version for iPad yet)
* Complete offline capability

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download & Documentation==

Please note that everything from this page and beyond is in Beta: This means nothing is final, changes will be made before final release, stability is not guaranteed and nothing from this site should be used in production.

Follow this [http://software.open-xchange.com/OX6/OXtender-unstable/MobileApp/ link] to download the installation package, Release Notes and documentation.

The access data are:
* Username: oxmobileapp
* Password: first$cut

== Installation and configuration on the Open-Xchange Server==

Installation on the Apache or another webserver:
# 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 rpm based systems you would use the "rpm -Uvh" command.
# After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
# Edit the file <code>"cache.manifest"</code> in directory ox6-mobile-v2
# On the bottom of the file locate the placeholder "yourserver" in the nework directive
# Change placeholder to your OX server address, i.e. "<code>https://myoxserver.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
# You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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.yourserver.com</code> which points to your installation will save users from entering a long URL on their devices.

Like mentioned before, the OX Mobile App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile App and choose "Add to homescreen". After this, the OX Mobile App will place a new app icon on the homescreen.

===Using the offline mode===

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

The OX Mobile App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' At the moment the OX Mobile App will not detect if internet connection reappears during a run in offline mode. To re-enter online mode just restart the app.

===Known Problems===

The OX Mobile App 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. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.

== Deployment as native app ==

The OX Mobile App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not. These option will not be available for the Beta version of the app.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile App comes with the standard name set "OX Mobile App". This title will be set live during start up. To change the title of the app to your needs you will have to edit the provided language files.

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the lines containing msgid "OX Mobile App" and msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
# Do this for all language files
* Note: Do not change the '''msgid''', this must be "OX Mobile App" and "OX Mobile". Only change the '''msgstr''' value.

==Reporting==

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] 
Product: OX Mobile App

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-03-10T08:40:05Z

Alexquast: /* Known Problems */

= Information and Installation of Open-Xchange Mobile App (Beta)=

== Description ==

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
*Calendar
*Contacts

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

== Features and Functions ==

=== Mail Module ===
*Access to all Open-Xchange standard folder: Inbox, Sent, Trash, Spam and Drafts
*Creation of new e-mails
*Answer, forward and delete e-mails

=== Contact Module ===
*Access to all Open-Xchange contact folder and contacts with details
*Creation of e-mail directly from contact module
*Start call directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folder and appointments with details
* Accept/Decline of appointments
* Participants and resources list from all appointments
* Planned: Additional notes for Accept/Decline function, creation of new appointments

=== Persistence of the Mobile App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE and EN, other languages can be added.
* Branding options: App name (via HTML edit) and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile App should work on devices running a Webkit based browser. These are mainly the devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend to use Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android Froyo 2.2), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|via Opera Mobile
|i.e Nokia N97 (Although there is a built-in Webkit browser running on this device a Symbian bug in the cookie-handling which prevents login to the OX-Server)
|-
|Windows Mobile running Internet Explorer
|no
|
|-
|Windows Phone 7
|no
|
|-
|}

== Technical overview ==
* Based on HTML5, CSS, Javascript, Frameworks jQuery and jQTouch
* Optimized for Webkit browsers (iPhone, Android, no optimized version for iPad yet)
* Complete offline capability

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download & Documentation==

Please note that everything from this page and beyond is in Beta: This means nothing is final, changes will be made before final release, stability is not guaranteed and nothing from this site should be used in production.

Follow this [http://software.open-xchange.com/OX6/OXtender-unstable/MobileApp/ link] to download the installation package, Release Notes and documentation.

The access data are:
* Username: oxmobileapp
* Password: first$cut

== Installation and configuration on the Open-Xchange Server==

Installation on the Apache or another webserver:
# 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 rpm based systems you would use the "rpm -Uvh" command.
# After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
# Edit the file <code>"cache.manifest"</code> in directory ox6-mobile-v2
# On the bottom of the file locate the placeholder "yourserver" in the nework directive
# Change placeholder to your OX server address, i.e. "<code>https://myoxserver.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
# You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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.yourserver.com</code> which points to your installation will save users from entering a long URL on their devices.

Like mentioned before, the OX Mobile App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile App and choose "Add to homescreen". After this, the OX Mobile App will place a new app icon on the homescreen.

===Using the offline mode===

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

The OX Mobile App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' At the moment the OX Mobile App will not detect if internet connection reappears during a run in offline mode. To re-enter online mode just restart the app.

===Known Problems===

The OX Mobile App 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. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.

== Deployment as native app ==

The OX Mobile App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not. These option will not be available for the Beta version of the app.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile App comes with the standard name set "OX Mobile App". This title will be set live during start up. To change the title of the app to your needs you will have to edit the provided language files.

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the lines containing msgid "OX Mobile App" and msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
# Do this for all language files
* Note: Do not change the '''msgid''', this must be "OX Mobile App" and "OX Mobile". Only change the '''msgstr''' value.

==Reporting==

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] 
Product: OX Mobile App

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-03-10T08:14:37Z

Alexquast: /* Supported devices */

= Information and Installation of Open-Xchange Mobile App (Beta)=

== Description ==

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
*Calendar
*Contacts

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

== Features and Functions ==

=== Mail Module ===
*Access to all Open-Xchange standard folder: Inbox, Sent, Trash, Spam and Drafts
*Creation of new e-mails
*Answer, forward and delete e-mails

=== Contact Module ===
*Access to all Open-Xchange contact folder and contacts with details
*Creation of e-mail directly from contact module
*Start call directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folder and appointments with details
* Accept/Decline of appointments
* Participants and resources list from all appointments
* Planned: Additional notes for Accept/Decline function, creation of new appointments

=== Persistence of the Mobile App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE and EN, other languages can be added.
* Branding options: App name (via HTML edit) and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile App should work on devices running a Webkit based browser. These are mainly the devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend to use Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android Froyo 2.2), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|via Opera Mobile
|i.e Nokia N97 (Although there is a built-in Webkit browser running on this device a Symbian bug in the cookie-handling which prevents login to the OX-Server)
|-
|Windows Mobile running Internet Explorer
|no
|
|-
|Windows Phone 7
|no
|
|-
|}

== Technical overview ==
* Based on HTML5, CSS, Javascript, Frameworks jQuery and jQTouch
* Optimized for Webkit browsers (iPhone, Android, no optimized version for iPad yet)
* Complete offline capability

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download & Documentation==

Please note that everything from this page and beyond is in Beta: This means nothing is final, changes will be made before final release, stability is not guaranteed and nothing from this site should be used in production.

Follow this [http://software.open-xchange.com/OX6/OXtender-unstable/MobileApp/ link] to download the installation package, Release Notes and documentation.

The access data are:
* Username: oxmobileapp
* Password: first$cut

== Installation and configuration on the Open-Xchange Server==

Installation on the Apache or another webserver:
# 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 rpm based systems you would use the "rpm -Uvh" command.
# After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
# Edit the file <code>"cache.manifest"</code> in directory ox6-mobile-v2
# On the bottom of the file locate the placeholder "yourserver" in the nework directive
# Change placeholder to your OX server address, i.e. "<code>https://myoxserver.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
# You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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.yourserver.com</code> which points to your installation will save users from entering a long URL on their devices.

Like mentioned before, the OX Mobile App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile App and choose "Add to homescreen". After this, the OX Mobile App will place a new app icon on the homescreen.

===Using the offline mode===

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

The OX Mobile App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' At the moment the OX Mobile App will not detect if internet connection reappears during a run in offline mode. To re-enter online mode just restart the app.

===Known Problems===

The OX Mobile App uses a custom, built-in navigation and history. To navigate back you will have to use the build in "back" buttons located on the top-left of the page. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.

== Deployment as native app ==

The OX Mobile App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not. These option will not be available for the Beta version of the app.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile App comes with the standard name set "OX Mobile App". This title will be set live during start up. To change the title of the app to your needs you will have to edit the provided language files.

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the lines containing msgid "OX Mobile App" and msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
# Do this for all language files
* Note: Do not change the '''msgid''', this must be "OX Mobile App" and "OX Mobile". Only change the '''msgstr''' value.

==Reporting==

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] 
Product: OX Mobile App

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-03-09T11:15:08Z

Alexquast: /* Application name */

= Information and Installation of Open-Xchange Mobile App (Beta)=

== Description ==

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
*Calendar
*Contacts

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

== Features and Functions ==

=== Mail Module ===
*Access to all Open-Xchange standard folder: Inbox, Sent, Trash, Spam and Drafts
*Creation of new e-mails
*Answer, forward and delete e-mails

=== Contact Module ===
*Access to all Open-Xchange contact folder and contacts with details
*Creation of e-mail directly from contact module
*Start call directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folder and appointments with details
* Accept/Decline of appointments
* Participants and resources list from all appointments
* Planned: Additional notes for Accept/Decline function, creation of new appointments

=== Persistence of the Mobile App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE and EN, other languages can be added.
* Branding options: App name (via HTML edit) and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile App should work on devices running a Webkit based browser. These are mainly the devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend to use Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android Froyo 2.2), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|via Opera Mobile
|(Although there is a built-in Webkit browser running on this device a Symbian bug in the cookie-handling which prevents login to the OX-Server)
|-
|Windows Mobile running Internet Explorer
|no
|
|-
|Windows Phone 7
|no
|
|-
|}

== Technical overview ==
* Based on HTML5, CSS, Javascript, Frameworks jQuery and jQTouch
* Optimized for Webkit browsers (iPhone, Android, no optimized version for iPad yet)
* Complete offline capability

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download ==

Please note that everything from this page and beyond is in Beta: This means nothing is final, changes will be made before final release, stability is not guaranteed and nothing from this site should be used in production.

Follow this [http://software.open-xchange.com/OX6/OXtender-unstable/MobileApp link] to download the installation package and the Release Notes.

The access data are:
* Username: oxmobileapp
* Password: first$cut

== Installation and configuration on the Open-Xchange Server==

Installation on the Apache or another webserver:
# 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 rpm based systems you would use the "rpm -Uvh" command.
# After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
# Edit the file <code>"cache.manifest"</code> in directory ox6-mobile-v2
# On the bottom of the file locate the placeholder "yourserver" in the nework directive
# Change placeholder to your OX server address, i.e. "<code>https://myoxserver.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
# You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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.yourserver.com</code> which points to your installation will save users from entering a long URL on their devices.

Like mentioned before, the OX Mobile App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile App and choose "Add to homescreen". After this, the OX Mobile App will place a new app icon on the homescreen.

===Using the offline mode===

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

The OX Mobile App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' At the moment the OX Mobile App will not detect if internet connection reappears during a run in offline mode. To re-enter online mode just restart the app.

===Known Problems===

The OX Mobile App uses a custom, built-in navigation and history. To navigate back you will have to use the build in "back" buttons located on the top-left of the page. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.

== Deployment as native app ==

The OX Mobile App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not. These option will not be available for the Beta version of the app.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile App comes with the standard name set "OX Mobile App". This title will be set live during start up. To change the title of the app to your needs you will have to edit the provided language files.

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the lines containing msgid "OX Mobile App" and msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
# Do this for all language files
* Note: Do not change the '''msgid''', this must be "OX Mobile App" and "OX Mobile". Only change the '''msgstr''' value.

==Reporting==

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] 
Product: OX Mobile App

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-03-09T11:14:37Z

Alexquast: /* Known Problems */

= Information and Installation of Open-Xchange Mobile App (Beta)=

== Description ==

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
*Calendar
*Contacts

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

== Features and Functions ==

=== Mail Module ===
*Access to all Open-Xchange standard folder: Inbox, Sent, Trash, Spam and Drafts
*Creation of new e-mails
*Answer, forward and delete e-mails

=== Contact Module ===
*Access to all Open-Xchange contact folder and contacts with details
*Creation of e-mail directly from contact module
*Start call directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folder and appointments with details
* Accept/Decline of appointments
* Participants and resources list from all appointments
* Planned: Additional notes for Accept/Decline function, creation of new appointments

=== Persistence of the Mobile App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE and EN, other languages can be added.
* Branding options: App name (via HTML edit) and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile App should work on devices running a Webkit based browser. These are mainly the devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend to use Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android Froyo 2.2), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|via Opera Mobile
|(Although there is a built-in Webkit browser running on this device a Symbian bug in the cookie-handling which prevents login to the OX-Server)
|-
|Windows Mobile running Internet Explorer
|no
|
|-
|Windows Phone 7
|no
|
|-
|}

== Technical overview ==
* Based on HTML5, CSS, Javascript, Frameworks jQuery and jQTouch
* Optimized for Webkit browsers (iPhone, Android, no optimized version for iPad yet)
* Complete offline capability

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download ==

Please note that everything from this page and beyond is in Beta: This means nothing is final, changes will be made before final release, stability is not guaranteed and nothing from this site should be used in production.

Follow this [http://software.open-xchange.com/OX6/OXtender-unstable/MobileApp link] to download the installation package and the Release Notes.

The access data are:
* Username: oxmobileapp
* Password: first$cut

== Installation and configuration on the Open-Xchange Server==

Installation on the Apache or another webserver:
# 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 rpm based systems you would use the "rpm -Uvh" command.
# After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
# Edit the file <code>"cache.manifest"</code> in directory ox6-mobile-v2
# On the bottom of the file locate the placeholder "yourserver" in the nework directive
# Change placeholder to your OX server address, i.e. "<code>https://myoxserver.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
# You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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.yourserver.com</code> which points to your installation will save users from entering a long URL on their devices.

Like mentioned before, the OX Mobile App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile App and choose "Add to homescreen". After this, the OX Mobile App will place a new app icon on the homescreen.

===Using the offline mode===

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

The OX Mobile App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' At the moment the OX Mobile App will not detect if internet connection reappears during a run in offline mode. To re-enter online mode just restart the app.

===Known Problems===

The OX Mobile App uses a custom, built-in navigation and history. To navigate back you will have to use the build in "back" buttons located on the top-left of the page. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

If you clean the browser cache on your device or reset it to defaults, all local stored data will be flushed.

== Deployment as native app ==

The OX Mobile App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not. These option will not be available for the Beta version of the app.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile App comes with the standard name set "OX Mobile App". This title will be set live during start up. To change the title of the app to your needs you will have to edit the provided language files.

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the lines containing msgid "OX Mobile App" and msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
* Note: Do not change the '''msgid''', this must be "OX Mobile App" and "OX Mobile". Only change the '''msgstr''' value.
# Do this for all language files

==Reporting==

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] 
Product: OX Mobile App

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-03-09T11:12:50Z

Alexquast: /* Running the OX Mobile App on your smartphone */

= Information and Installation of Open-Xchange Mobile App (Beta)=

== Description ==

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
*Calendar
*Contacts

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

== Features and Functions ==

=== Mail Module ===
*Access to all Open-Xchange standard folder: Inbox, Sent, Trash, Spam and Drafts
*Creation of new e-mails
*Answer, forward and delete e-mails

=== Contact Module ===
*Access to all Open-Xchange contact folder and contacts with details
*Creation of e-mail directly from contact module
*Start call directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folder and appointments with details
* Accept/Decline of appointments
* Participants and resources list from all appointments
* Planned: Additional notes for Accept/Decline function, creation of new appointments

=== Persistence of the Mobile App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE and EN, other languages can be added.
* Branding options: App name (via HTML edit) and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile App should work on devices running a Webkit based browser. These are mainly the devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend to use Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android Froyo 2.2), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|via Opera Mobile
|(Although there is a built-in Webkit browser running on this device a Symbian bug in the cookie-handling which prevents login to the OX-Server)
|-
|Windows Mobile running Internet Explorer
|no
|
|-
|Windows Phone 7
|no
|
|-
|}

== Technical overview ==
* Based on HTML5, CSS, Javascript, Frameworks jQuery and jQTouch
* Optimized for Webkit browsers (iPhone, Android, no optimized version for iPad yet)
* Complete offline capability

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download ==

Please note that everything from this page and beyond is in Beta: This means nothing is final, changes will be made before final release, stability is not guaranteed and nothing from this site should be used in production.

Follow this [http://software.open-xchange.com/OX6/OXtender-unstable/MobileApp link] to download the installation package and the Release Notes.

The access data are:
* Username: oxmobileapp
* Password: first$cut

== Installation and configuration on the Open-Xchange Server==

Installation on the Apache or another webserver:
# 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 rpm based systems you would use the "rpm -Uvh" command.
# After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
# Edit the file <code>"cache.manifest"</code> in directory ox6-mobile-v2
# On the bottom of the file locate the placeholder "yourserver" in the nework directive
# Change placeholder to your OX server address, i.e. "<code>https://myoxserver.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
# You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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.yourserver.com</code> which points to your installation will save users from entering a long URL on their devices.

Like mentioned before, the OX Mobile App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile App and choose "Add to homescreen". After this, the OX Mobile App will place a new app icon on the homescreen.

===Using the offline mode===

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

The OX Mobile App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' At the moment the OX Mobile App will not detect if internet connection reappears during a run in offline mode. To re-enter online mode just restart the app.

===Known Problems===

The OX Mobile App uses a custom, built-in navigation and history. To navigate back you will have to use the build in "back" buttons located on the top-left of the page. Do not use browser's back button. This causes the app to jump to the login screen and you will have to reload the app.

If you clean the browser cache on your device or reset it to default, all local stored data will be flushed.

== Deployment as native app ==

The OX Mobile App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not. These option will not be available for the Beta version of the app.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile App comes with the standard name set "OX Mobile App". This title will be set live during start up. To change the title of the app to your needs you will have to edit the provided language files.

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the lines containing msgid "OX Mobile App" and msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
* Note: Do not change the '''msgid''', this must be "OX Mobile App" and "OX Mobile". Only change the '''msgstr''' value.
# Do this for all language files

==Reporting==

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] 
Product: OX Mobile App

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-03-09T11:07:32Z

Alexquast: /* Installation and configuration on the Open-Xchange Server */

= Information and Installation of Open-Xchange Mobile App (Beta)=

== Description ==

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
*Calendar
*Contacts

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

== Features and Functions ==

=== Mail Module ===
*Access to all Open-Xchange standard folder: Inbox, Sent, Trash, Spam and Drafts
*Creation of new e-mails
*Answer, forward and delete e-mails

=== Contact Module ===
*Access to all Open-Xchange contact folder and contacts with details
*Creation of e-mail directly from contact module
*Start call directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folder and appointments with details
* Accept/Decline of appointments
* Participants and resources list from all appointments
* Planned: Additional notes for Accept/Decline function, creation of new appointments

=== Persistence of the Mobile App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE and EN, other languages can be added.
* Branding options: App name (via HTML edit) and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile App should work on devices running a Webkit based browser. These are mainly the devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend to use Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android Froyo 2.2), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|via Opera Mobile
|(Although there is a built-in Webkit browser running on this device a Symbian bug in the cookie-handling which prevents login to the OX-Server)
|-
|Windows Mobile running Internet Explorer
|no
|
|-
|Windows Phone 7
|no
|
|-
|}

== Technical overview ==
* Based on HTML5, CSS, Javascript, Frameworks jQuery and jQTouch
* Optimized for Webkit browsers (iPhone, Android, no optimized version for iPad yet)
* Complete offline capability

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download ==

Please note that everything from this page and beyond is in Beta: This means nothing is final, changes will be made before final release, stability is not guaranteed and nothing from this site should be used in production.

Follow this [http://software.open-xchange.com/OX6/OXtender-unstable/MobileApp link] to download the installation package and the Release Notes.

The access data are:
* Username: oxmobileapp
* Password: first$cut

== Installation and configuration on the Open-Xchange Server==

Installation on the Apache or another webserver:
# 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 rpm based systems you would use the "rpm -Uvh" command.
# After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
# Edit the file <code>"cache.manifest"</code> in directory ox6-mobile-v2
# On the bottom of the file locate the placeholder "yourserver" in the nework directive
# Change placeholder to your OX server address, i.e. "<code>https://myoxserver.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
# You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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.yourserver.com</code> which points to your installation will save users from entering a long URL on their devices.

Like mentioned before, the OX Mobile App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile App and choose "Add to homescreen". After this, the OX Mobile App will place a new app icon on the homescreen.

===Using the offline mode===

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

The OX Mobile App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' At the moment the OX Mobile App will not detect if internet connection reappears during a run in offline mode. To re-enter online mode just restart the app.

== Deployment as native app ==

The OX Mobile App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not. These option will not be available for the Beta version of the app.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile App comes with the standard name set "OX Mobile App". This title will be set live during start up. To change the title of the app to your needs you will have to edit the provided language files.

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the lines containing msgid "OX Mobile App" and msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
* Note: Do not change the '''msgid''', this must be "OX Mobile App" and "OX Mobile". Only change the '''msgstr''' value.
# Do this for all language files

==Reporting==

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] 
Product: OX Mobile App

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-03-09T11:07:08Z

Alexquast: /* Installation and configuration on the Open-Xchange Server */

= Information and Installation of Open-Xchange Mobile App (Beta)=

== Description ==

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
*Calendar
*Contacts

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

== Features and Functions ==

=== Mail Module ===
*Access to all Open-Xchange standard folder: Inbox, Sent, Trash, Spam and Drafts
*Creation of new e-mails
*Answer, forward and delete e-mails

=== Contact Module ===
*Access to all Open-Xchange contact folder and contacts with details
*Creation of e-mail directly from contact module
*Start call directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folder and appointments with details
* Accept/Decline of appointments
* Participants and resources list from all appointments
* Planned: Additional notes for Accept/Decline function, creation of new appointments

=== Persistence of the Mobile App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE and EN, other languages can be added.
* Branding options: App name (via HTML edit) and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile App should work on devices running a Webkit based browser. These are mainly the devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend to use Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android Froyo 2.2), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|via Opera Mobile
|(Although there is a built-in Webkit browser running on this device a Symbian bug in the cookie-handling which prevents login to the OX-Server)
|-
|Windows Mobile running Internet Explorer
|no
|
|-
|Windows Phone 7
|no
|
|-
|}

== Technical overview ==
* Based on HTML5, CSS, Javascript, Frameworks jQuery and jQTouch
* Optimized for Webkit browsers (iPhone, Android, no optimized version for iPad yet)
* Complete offline capability

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download ==

Please note that everything from this page and beyond is in Beta: This means nothing is final, changes will be made before final release, stability is not guaranteed and nothing from this site should be used in production.

Follow this [http://software.open-xchange.com/OX6/OXtender-unstable/MobileApp link] to download the installation package and the Release Notes.

The access data are:
* Username: oxmobileapp
* Password: first$cut

== Installation and configuration on the Open-Xchange Server==

Installation on the Apache or another webserver:
# 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 rpm based systems you would use the "rpm -Uvh" command.
# After installation locate the installed files in your webroot directory, i.e. <code>/var/www/ox6-mobile-v2/</code> on Debian
# Edit the file <code>"cache.manifest"</code> in directory gui-mobile-v2
# On the bottom of the file locate the placeholder "yourserver" in the nework directive
# Change placeholder to your OX server address, i.e. "<code>https://myoxserver.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
# You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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.yourserver.com</code> which points to your installation will save users from entering a long URL on their devices.

Like mentioned before, the OX Mobile App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile App and choose "Add to homescreen". After this, the OX Mobile App will place a new app icon on the homescreen.

===Using the offline mode===

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

The OX Mobile App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' At the moment the OX Mobile App will not detect if internet connection reappears during a run in offline mode. To re-enter online mode just restart the app.

== Deployment as native app ==

The OX Mobile App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not. These option will not be available for the Beta version of the app.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile App comes with the standard name set "OX Mobile App". This title will be set live during start up. To change the title of the app to your needs you will have to edit the provided language files.

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the lines containing msgid "OX Mobile App" and msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
* Note: Do not change the '''msgid''', this must be "OX Mobile App" and "OX Mobile". Only change the '''msgstr''' value.
# Do this for all language files

==Reporting==

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] 
Product: OX Mobile App

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-03-09T11:05:51Z

Alexquast: /* Branding options */

= Information and Installation of Open-Xchange Mobile App (Beta)=

== Description ==

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
*Calendar
*Contacts

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

== Features and Functions ==

=== Mail Module ===
*Access to all Open-Xchange standard folder: Inbox, Sent, Trash, Spam and Drafts
*Creation of new e-mails
*Answer, forward and delete e-mails

=== Contact Module ===
*Access to all Open-Xchange contact folder and contacts with details
*Creation of e-mail directly from contact module
*Start call directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folder and appointments with details
* Accept/Decline of appointments
* Participants and resources list from all appointments
* Planned: Additional notes for Accept/Decline function, creation of new appointments

=== Persistence of the Mobile App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE and EN, other languages can be added.
* Branding options: App name (via HTML edit) and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile App should work on devices running a Webkit based browser. These are mainly the devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend to use Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android Froyo 2.2), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|via Opera Mobile
|(Although there is a built-in Webkit browser running on this device a Symbian bug in the cookie-handling which prevents login to the OX-Server)
|-
|Windows Mobile running Internet Explorer
|no
|
|-
|Windows Phone 7
|no
|
|-
|}

== Technical overview ==
* Based on HTML5, CSS, Javascript, Frameworks jQuery and jQTouch
* Optimized for Webkit browsers (iPhone, Android, no optimized version for iPad yet)
* Complete offline capability

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download ==

Please note that everything from this page and beyond is in Beta: This means nothing is final, changes will be made before final release, stability is not guaranteed and nothing from this site should be used in production.

Follow this [http://software.open-xchange.com/OX6/OXtender-unstable/MobileApp link] to download the installation package and the Release Notes.

The access data are:
* Username: oxmobileapp
* Password: first$cut

== Installation and configuration on the Open-Xchange Server==

Installation on the Apache or another webserver:
# 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 rpm based systems you would use the "rpm -Uvh" command.
# After installation locate the installed files in your webroot directory, i.e. <code>/var/www/gui-mobile-v2/</code> on Debian
# Edit the file <code>"cache.manifest"</code> in directory gui-mobile-v2
# On the bottom of the file locate the placeholder "yourserver" in the nework directive
# Change placeholder to your OX server address, i.e. "<code>https://myoxserver.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
# You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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.yourserver.com</code> which points to your installation will save users from entering a long URL on their devices.

Like mentioned before, the OX Mobile App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile App and choose "Add to homescreen". After this, the OX Mobile App will place a new app icon on the homescreen.

===Using the offline mode===

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

The OX Mobile App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' At the moment the OX Mobile App will not detect if internet connection reappears during a run in offline mode. To re-enter online mode just restart the app.

== Deployment as native app ==

The OX Mobile App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not. These option will not be available for the Beta version of the app.

For more information on native app deployment please contact us directly.

== Branding options ==
=== Application name===
The OX Mobile App comes with the standard name set "OX Mobile App". This title will be set live during start up. To change the title of the app to your needs you will have to edit the provided language files.

# Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
# Change to "lang" folder
# The folder contains all available language files (*.po)
# Open one of the files and locate the lines containing msgid "OX Mobile App" and msgid "OX Mobile"
# Change the corresponding msgstr to your title of the app, i.e. "My App".
* Note: Do not change the '''msgid''', this must be "OX Mobile App" and "OX Mobile". Only change the '''msgstr''' value.
# Do this for all language files

==Reporting==

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] 
Product: OX Mobile App

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-03-09T11:03:07Z

Alexquast: /* Branding options */

= Information and Installation of Open-Xchange Mobile App (Beta)=

== Description ==

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
*Calendar
*Contacts

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

== Features and Functions ==

=== Mail Module ===
*Access to all Open-Xchange standard folder: Inbox, Sent, Trash, Spam and Drafts
*Creation of new e-mails
*Answer, forward and delete e-mails

=== Contact Module ===
*Access to all Open-Xchange contact folder and contacts with details
*Creation of e-mail directly from contact module
*Start call directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folder and appointments with details
* Accept/Decline of appointments
* Participants and resources list from all appointments
* Planned: Additional notes for Accept/Decline function, creation of new appointments

=== Persistence of the Mobile App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE and EN, other languages can be added.
* Branding options: App name (via HTML edit) and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile App should work on devices running a Webkit based browser. These are mainly the devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend to use Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android Froyo 2.2), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|via Opera Mobile
|(Although there is a built-in Webkit browser running on this device a Symbian bug in the cookie-handling which prevents login to the OX-Server)
|-
|Windows Mobile running Internet Explorer
|no
|
|-
|Windows Phone 7
|no
|
|-
|}

== Technical overview ==
* Based on HTML5, CSS, Javascript, Frameworks jQuery and jQTouch
* Optimized for Webkit browsers (iPhone, Android, no optimized version for iPad yet)
* Complete offline capability

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download ==

Please note that everything from this page and beyond is in Beta: This means nothing is final, changes will be made before final release, stability is not guaranteed and nothing from this site should be used in production.

Follow this [http://software.open-xchange.com/OX6/OXtender-unstable/MobileApp link] to download the installation package and the Release Notes.

The access data are:
* Username: oxmobileapp
* Password: first$cut

== Installation and configuration on the Open-Xchange Server==

Installation on the Apache or another webserver:
# 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 rpm based systems you would use the "rpm -Uvh" command.
# After installation locate the installed files in your webroot directory, i.e. <code>/var/www/gui-mobile-v2/</code> on Debian
# Edit the file <code>"cache.manifest"</code> in directory gui-mobile-v2
# On the bottom of the file locate the placeholder "yourserver" in the nework directive
# Change placeholder to your OX server address, i.e. "<code>https://myoxserver.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
# You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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.yourserver.com</code> which points to your installation will save users from entering a long URL on their devices.

Like mentioned before, the OX Mobile App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile App and choose "Add to homescreen". After this, the OX Mobile App will place a new app icon on the homescreen.

===Using the offline mode===

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

The OX Mobile App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' At the moment the OX Mobile App will not detect if internet connection reappears during a run in offline mode. To re-enter online mode just restart the app.

== Deployment as native app ==

The OX Mobile App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not. These option will not be available for the Beta version of the app.

For more information on native app deployment please contact us directly.

== Branding options ==

The OX Mobile App comes with the standard name set "OX Mobile App". This title will be set live during start up. To change the title of the app to your needs you will have to edit the provided language files.

* Locate your installstion directory (i.e. /var/www/ox6-mobile-v2)
* Change to "lang" folder
* The folder contains all available language files (*.po)
* Open one of the files and locate the lines containing msgid "OX Mobile App" and msgid "OX Mobile"
* change the corresponding msgstr to your new title of the app.
* Note: Don't change the msgid, this must be "OX Mobile App" and "OX Mobile". Only change the msgstr value.
* Do this for all language files

==Reporting==

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] 
Product: OX Mobile App

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]

OX6:OX Mobile Web Interface

2011-03-09T10:57:03Z

Alexquast: /* Deployment as native app */

= Information and Installation of Open-Xchange Mobile App (Beta)=

== Description ==

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
*Calendar
*Contacts

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

== Features and Functions ==

=== Mail Module ===
*Access to all Open-Xchange standard folder: Inbox, Sent, Trash, Spam and Drafts
*Creation of new e-mails
*Answer, forward and delete e-mails

=== Contact Module ===
*Access to all Open-Xchange contact folder and contacts with details
*Creation of e-mail directly from contact module
*Start call directly from contact module

=== Calendar Module ===
* Access to all Open-Xchange calendar folder and appointments with details
* Accept/Decline of appointments
* Participants and resources list from all appointments
* Planned: Additional notes for Accept/Decline function, creation of new appointments

=== Persistence of the Mobile App ===
*Offline capability
*All contacts are available offline
*All appointments are available offline
*All mail 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)
*Subscription of contact folders
*Autologin

===Themeability, branding and i18n ===

* i18n for DE and EN, other languages can be added.
* Branding options: App name (via HTML edit) and app icon
* Themeability by CSS

== Supported devices ==

The OX Mobile App should work on devices running a Webkit based browser. These are mainly the devices running iOS, Android and newest generation of BlackBerrys. For devices running Symbian we recommend to use Opera Mobile Browser.

{|border="2" rules="all" align="left">
|-
|'''Device Support'''
| 
| 
|-
|Apple iPhone
|yes (iPhone running iOS 2.0, 2.1, 3.0, 4.0, 4.2.1)
|Official Supported by OX: 2G, 3G, 3GS, 4 and iPod-Touch 3.1.3
|-
|Android
|yes
|Official Supported by OX: Google Nexus One (Android Froyo 2.2), HTC Desire (Sense Android 2.1)
|-
|Nokia/Symbian S60 5th Edition
|via Opera Mobile
|(Although there is a built-in Webkit browser running on this device a Symbian bug in the cookie-handling which prevents login to the OX-Server)
|-
|Windows Mobile running Internet Explorer
|no
|
|-
|Windows Phone 7
|no
|
|-
|}

== Technical overview ==
* Based on HTML5, CSS, Javascript, Frameworks jQuery and jQTouch
* Optimized for Webkit browsers (iPhone, Android, no optimized version for iPad yet)
* Complete offline capability

== Requirements ==

* Open-Xchange Server >= v.6.20
* 1GB RAM

== Download ==

Please note that everything from this page and beyond is in Beta: This means nothing is final, changes will be made before final release, stability is not guaranteed and nothing from this site should be used in production.

Follow this [http://software.open-xchange.com/OX6/OXtender-unstable/MobileApp link] to download the installation package and the Release Notes.

The access data are:
* Username: oxmobileapp
* Password: first$cut

== Installation and configuration on the Open-Xchange Server==

Installation on the Apache or another webserver:
# 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 rpm based systems you would use the "rpm -Uvh" command.
# After installation locate the installed files in your webroot directory, i.e. <code>/var/www/gui-mobile-v2/</code> on Debian
# Edit the file <code>"cache.manifest"</code> in directory gui-mobile-v2
# On the bottom of the file locate the placeholder "yourserver" in the nework directive
# Change placeholder to your OX server address, i.e. "<code>https://myoxserver.com/ajax</code>". '''Note''': We strongly recommend the usage of https, otherwise data will be transmitted unencrypted via client and server
# You also 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)

* For more details and README see the systems documentation directory (/usr/share/doc).

==Running the OX Mobile App on your smartphone==

After installation of the App on your webserver, a client can easily access the app 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.yourserver.com</code> which points to your installation will save users from entering a long URL on their devices.

Like mentioned before, the OX Mobile App is a pure web application. Due to this fact there is no installation or download needed to use this app on a smartphone. Just add a bookmark in your browser to access the app 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 OX Mobile App and choose "Add to homescreen". After this, the OX Mobile App will place a new app icon on the homescreen.

===Using the offline mode===

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

The OX Mobile App detects on startup whether there's an internet connection available or not. If not, the App will start in offline mode. In this case a plane icon is shown in the upper left corner of the main menu. 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.

'''Note:''' At the moment the OX Mobile App will not detect if internet connection reappears during a run in offline mode. To re-enter online mode just restart the app.

== Deployment as native app ==

The OX Mobile App can also be deployed as a native smartphone app. This option is available for Android Systems and later for iOS, too. As Android allows installation of apps from every location you can place an *.apk file on a webserver or in your own Android App-Store. The OX Mobile App will act like any other app on the device and offers the same functionality as the web hosted variant.

Deploying a native iOS App can only be done via the Apple AppStore®. To do so you need to submit your special branded version of the app to Apple. Only Apple decides if the app will be listed in the AppStore or not. These option will not be available for the Beta version of the app.

For more information on native app deployment please contact us directly.

== Branding options ==

==Reporting==

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] 
Product: OX Mobile App

== Please note ==

There may be some issues with checkboxes on Android devices. Sometimes checkboxes and listboxes do not respond to tap actions. If so, please rotate your phone to landscape mode and back. Then, the checkboxes should response again

Please read the SDB article to inform you about the reasons and solution.

[[Category: OX6]]