Whitelabel
Whitelabeling the Open-Xchange Gui
Introduction
Within many environments, it is needed that the OX GUI, especially the LOGIN page is branded to the customers/resellers corporate identity or domain.
There are 2 ways of achieving this:
- Create a vhost/domain for every customer/reseller like "reseller.domain.com" and copy the whole OX GUI to that new vhost. After that is done, you have to modify the "default" theme of the OX GUI. The drawback of that solution is, that you now have multiple copies of the OX GUI, which is very bad regarding seamless updates/upgrades. After each update, you have to copy the GUI again for every domain/reseller you have created a vhost for.
- Use mod_rewrite to let apache do the work for you based on the domain, the user entered in this browser.
Here are 2 screenshots of same docroot but with different themes/login pages.
We have implemented 3 different types how to process the upsell an user is requesting in the hosters backend:
- Show the Upsell Layer window and trigger the upgrade via a generated email to an email address after user clicked "buy" or "trial".
In this email there is the information which user from which contaxt wants to upgrade to which package. After receiving the email the hoster's sales team can put the customer into billing.
- Show the Upsell Layer window and open a configurable URL including all needed parameters after the user clicked "buy" or "trial.
This is the perfect automated way if the hoster wants to have a full automated upsell which he can easily integrate into his existing provisioning & billing system.
- Directly display a configurable URL/Online SHOP (systemwide or/and per context configurable) within the upsell Layer window instead of standard OX upsell content.
This is the perfect automated way for all hosters which have an online shop in place and wants to use it for the upsell, too.
The upsell layer has full i18n (EN and DE are included) support integrated and offers following components for advertisement:
- Text
- Video
- Screenshots
to promote a certain feature for Open-Xchange.
The important part of the upsell layer is the ability to pass all needed parameters from users session like username,id,cid etc. + the feature he wants to buy, to a third party online shop system or send these parameters via email in machine readable (configurable) format to a dedicated mailsystem which can process it via procmail or similar to trigger the upgrade process via the Open-Xchange API´s (SOAP,RMI,CLT).
Configuration
- You have to modify the ox specific vhost of your apache so that the vhost inherits also "mod_rewrite" configurations:
RewriteEngine On RewriteOptions Inherit
On Debian lenny you have to add the above 2 lines to the "<VirtualHost>" section of file:
/etc/apache2/sites-available/default