Administrator Manual
With the “Custom Apps” you can deliver to users additional and customised contents to enhance the experience.
Examples of applications include: advertisements; promotions; price lists and menus for restaurants, bars, etc.; reservations; promotion of events; useful information; message boards; tourist promotions; places of interest; web sites in general; games; chats; etc. In practice, it breaks with the traditional, old-fashioned login page. There are static and dynamic contents that make the potentialities of the Welcome Portal be unlimited.
Customised applications (available only if you have enabled the module Welcome Portal), allow you to develop applications of two types, described below, integrated into the Welcome Portal and available to users through the “app bar” (the bottom bar with icons and descriptions).
Applications can be of the following types:
| Type | Description |
| Internal | In this case, you can define, in addition to various details described below, the HTML, CSS and JavaScript. |
| External | The app is contained in an external server and only a URL in indicated in the configuration. The URL will be accessible by users after the refresh of the “ Walled Garden” that will be made as defined in the configuration of the gateways. |
By clicking on the context properties button of the App, you expand the context dropdown menu with a range of options grouped by: edit.
To add a new App, select “ app” and press “Add custom app” in the command bar. While to modify an App, press the context button of the App and select “ Edit”. In both cases, a page appears that allows you to manage the following fields:
| bbbccc |
| Field | Description |
| Code | Custom app code. |
| Title | Title of the application that appears under the icon of the app bar of the Welcome Portal. Do not exceed 20 characters. |
| Type | It can be an external application (URL to the external web server) or internal (HTML, CSS and JavaScript can be inserted). |
| URL | URL of the external application. Specify also the “http://” or “https://”. You can use the following variables:
%CurrLang%: passes the current language of the Welcome Portal. Warning! Some sites (e.g. www.google.com) do not allow inclusion because they use the “Access-Control-Allow-Origin”. If they are to be included in an App, you must request the site manager to add the HSNM domain in the Access-Control-Allow-Origin. Important! For the “Mixed Content” limitations defined in the browsers, if HTTPS is used for the Welcome Portal, even the Apps must be displayed in HTTPS. In other words, an insecure page cannot be hosted on a secure page. Important! Some websites may not be included due to “‘X-Frame-Options’-type limitations to ‘sameorigin’”. In practice, the administrator of the site to host, decides whether it is possible to include the site in another site. If you do not have permissions in the browser inspector, an error will be displayed and the site will not appear. An example is www.google.com. |
| Icon | Icon that appears in the Welcome Portal for the application. The recommended size is 128 x 128 pixels. The recommended format is: png |
| Delete/Choose File | Allows you to delete or upload an image.
Available only if the user has permissions to write the custom images. |
| Visibility | Defines when to show the application. |
| Display Type | Defines where the App has to be displayed. Possible options are:
Warning! If the CNA is active and “New Tab” option has been defined, it always opens the App in the CAN abandoning the Welcome Portal. |
| Only for this Browser | The application is visible and executable only for the indicated browser type. |
| Browser Version | The application is visible and executable only for the above-mentioned browser with version greater than or equal to the one specified in this field. |
| Disable | In enabled, it hides the App. |
| Notes | Notes for the App. |
| Field | Description |
| Head | Contents of the HTML header (without the “<head>” tag).
The field is available only for internal-type applications. |
| Field | Description |
| HTML | Insert the HTML code for the custom App (without the “<body>” tag). It is possible to use variables to insert customised images using the command “(%CustomImage:ImageID%);”. You can use the following variables:
%CurrLang%: passes the current language of the Welcome Portal. The field is available only for internal-type applications. |
| Field | Description |
| CSS | Enter the CSS code for the custom App. It is possible to use variables to insert customised images using the command “(%CustomImage:ImageID%);”. The field is available only for internal-type applications. |
| Field | Description |
| JavaScript | Enter the JavaScript code for the custom application.
The field is available only for internal-type applications. You can use the following variables:
%CurrLang%: passes the current language of the Welcome Portal. |
Warning! Any external App URL is automatically added to the “Walled Gardens”. If the external App requires or refers to other external URLs, those must be added manually in the “ Walled Garden“.