Login page template

A login page template contains access information and forms that are required for users to log in to your network through a hotspot. Login pages are written in HTML and contain variables that are replaced during page generation. You can also create conditional blocks that are rendered only if the specified conditions are met. Refer to the login page template in Wireless > Hotspot settings for usage examples.

Table 1. Variables
Name Definition
<?admin_message?> “For administrative questions please contact:”
<?admin_contact?> Send notifications to email address as defined in Administration > Notification settings.
<?asset_path?> Directory in which images and stylesheets are stored for full customization. Example:<img src="<?asset_path?>/logo.png">.
<?company_logo?> Company logo to be used in basic customization as defined in Wireless > Hotspots.
<?company_text?> Default company text as defined in Wireless > Hotspots.
<?error?> Error returned when attempting to log in
<?location?> URL the user requested
<?location_host?> Hostname of the URL the user requested
<?login_form?> Login form suitable for the hotspot type, for example, user name and password text boxes, a token text box, or an “Accept” check box.
<?maclimit?> Number of devices allowed per voucher as defined in Wireless > Hotspots.
<?numdevices?> Number of devices used by the voucher as defined in the template.
<?redirect_host?> Redirect URL as defined in Wireless > Hotspots.
<?terms?> Terms of use as defined in Wireless > Hotspots.
<?time_total?> Total time quota allowed by the voucher as defined in Wireless > Hotspot voucher definition.
<?timeend?> Validity period specified by the voucher as defined in Wireless > Hotspot voucher definition.
<?traffic_total?> Total data volume allowed by the voucher as defined in Wireless > Hotspot voucher definition.
Table 2. Conditional blocks
Name Definition
<?if_loggedin?> Section is displayed when the user has successfully logged in.
<?if_notloggedin?> Section is displayed when the user has not yet logged in, for example, because terms of use have to be accepted or because an error occurred.
<?if_authtype_password?> Section is displayed when hotspot type is “Password of the day”.
<?if_authtype_disclaimer?> Section is displayed when hotspot type is “Terms of use acceptance”.
<?if_authtype_token?> Section is displayed when hotspot type is “Voucher”.
<?if_location?> Section is displayed when the user has been redirected.
<?if_redirect_url?> Section is displayed when Redirect to URL after login is on.
<?if_not_redirect_url?> Section is displayed when Redirect to URL after login is off.
<?if_timelimit?> Section is displayed when a validity period is set for a voucher.
<?if_trafficlimit?> Section is displayed when a data volume is set for a voucher.
<?if_timequota?> Section is displayed when a time quota is set for a voucher.
<?if_maclimit?> Section is displayed when a Devices per voucher value is specified.
<?if_terms?> Section is displayed when Terms of use is turned on and terms are defined.
<?if_error?> Section is displayed when an error occurred while trying to log in.

Custom login forms

You can create a login form instead of using the pre-defined <?login_form?> variable.

Enclose the form in the following tags:

<form action="?action=login" method="POST">  ...  </form>

For a “Terms of acceptance” hotspot, add an accept check box:

<input type="checkbox" name="accept" value="true">

For a “Password of the day” or voucher hotspot, add a token text box:

<input type="text" name="token">

Add a means to submit the form, for example, a login button:

<input type="submit" name="login" value="Login">