We'd like to offer web apps that are compatible with all major platforms (Windows, MacOS, Linux, ...) and all important browsers (Firefox, Internet Explorer, Chrome, Safari, ...). Please make sure to test your app with all of these, or ask friends to do the testing for you.
Please avoid using technology that requires plug-ins on the client side (Flash, Silverlight, Java, ...). Apps using such technology will be accepted, but they may get lower ratings as they may cause problems on some devices.
You may use any HTML variation, although we recommend using at least HTML 4.x and CSS. Using HTML5 and CSS3 is cool, but it's not required. Use only HTML5 features that are supported by all major browsers.
It's not required that your apps use valid HTML or CSS, nevertheless this is always good to improve compatibility and to avoid problems.
You app can use any language as a default language. The currently used language on oli.education.lu is transmitted to your app using the "app_lang" variable. It is recommended to use this language at startup if it's available.
Apps are displayed within an <iframe> element on oli.education.lu. The Iframe is calling your app using the URL you'll enter later on using the developer tools, plus some input variables.
Currently supported input variables are:
The complete URL called by the Iframe may look as follows:
Please note that we don't offer any application hosting facilities, at least not for now. This means that you'll also need a server or a web hosting service to install your apps.
oli.education.lu apps can be either static HTML files or dynamic "web apps".
If you'd like to go with static HTML files then use your favourite HTML editor or code your HTML files manually if you want. You may also use Javascript to make your web app interactive or more attractive.
You may use Perl, PHP, Python, .Net or any other language to create dynamic web apps.
A web app page could look as follows - this example page is loading two CSS files from ssl.education.lu, these should be used if you'd like to use the look and feel of the oli.education.lu standard apps. You may remove these two lines if you'd like to go with your own design or look and feel.
Please note that all oli.education.lu web apps should use an UTF-8 character encoding. Using a different encoding may work too, but this might cause problems with future API releases.
The standard size for oli.education.lu apps is 920 * 480 pixels. This looks quite good on most desktop computers, laptops and tablets.
Don't create any apps using a width larger than 920 pixels, as these will probably not be approved. Your app height may be higher than 480, the Iframe will then display a scrollbar. Don't forget that the scrollbar will probably reduce your app width by 10 to 20 pixels, so it's good to make sure it also works fine in a 900px Iframe.
Some ad providers, such as Google, do not allow to put ads into Iframes. Putting Google ads inside an app on oli.education.lu would also get you (and maybe even us) into trouble as the maximum allowed number of ads blocks per page could be exceeded. Too many ads or offensive ads inside an app will probably lead to an app disapproval.
Move on to the next page and learn how to publish your app.
continue...
