How do I make my own splash page to use with the download URL feature in Qcode 2.1.1 and later?

The splash can be generated two ways. 

1.) Default node template

The first way is to use the locally generated default template layout which includes the main logo at the top of the page and then the user login fields below and a status page at the bottom. There is also a new feature avaialble that will allow nodes to download the template to use for their splash screen.

You can adjust the node display name, successful login redirect settings and incude your own logo on the splash page all via the captive portal page which is found under the advanced settings of the Qorvus Qcode software.

You will need to upload your own logo to use with the splash page template.  It must be either a .gif or .jpg format picture.  Upload the file IN BINARY MODE, using an SCP program to the /htdocs/images directory. Afer it is uploaded correctly it will be displayed in the drop down menu in the captive portal page.

Each default template must be setup in the node that it will be running from.

Note: the captive portal page does not properly parse "&" characters because it thinks it is part of the cgi post submission.  Use the splash html insert for simple html tags like tables, images, links, etc.  If you need to add complex html consider doing a downloadable template or edit the /etc/wiana.settings file and add the HTML code at the "SPLASHHTMLINSERT:" variable.

2.) Download template

EVERY LINK IN YOUR TEMPLATE MUST BE AN ABSOLUTE REFERENCE OR IT WILL NOT WORK PROPERLY.
(e.g. src="http:/www.qorvus.com/setup/img.jpg")


If you require more advanced features or if you want to include advertisements you will need to generate your own layout using the guide lines below. The template is treated as a complete, ready to load page.  The only thing the system changes is the $variables described later and it adds the system information to the end of the template.

If you want to allow users to use the splash page to access sign up services, advertiser web sites or anything else without require a user to have a valid login you must include the URL, IP or newtork range in the walled garden settings.

example tempate including embedded livemercial demo from our demo system can be found here:
http://www.qorvus.com/downloads/template.htm


Splash Screen Variables that need to be included in the form section of your template.
1.) $action = defines the action for the form to submit a user login request *(required)

2.) $redirect = the page the user will be redirected to after a successful login. this can be a specific URL or the $redirect variable to send the user to the page requested before the splash page redirect occured. (*required)

examples:

<input type="hidden" name="redirect" value="$redirect"> will take the user to their intial URL after the login.

or

<input type="hidden" name="redirect" value="http://www.qorvus.com/">  will always take the user to www.qorvus.com after the login.

3.) $GatewayName = the name of the node as described in the Nocat gateway name variable defined in the captive portal page of the Qcode software. This is an optional field.

4.) $RemoteMac = the MAC address of the associated laptop (or other) wireless client, This is useful for e.g. the Feeedpro customer management system, and is used to uniquely identify a customer without requiring name & password entry. This is an optional field. (requires Qcode 3.18 or later)

The tags you will need for a registered user login are:

<form method="PUT" action=$action>

Login:<input type="text" name="user">

Password:<input type="password" name="pass">

<input name="mode_login" type=submit id=mode_login value="Login">

<input type="hidden" name="redirect" value="$redirect">

</form>

The tags you will need for a guest login are:

<form method="PUT" action="$action">

<input name="mode_login" type="submit" id=mode_login value="Guest Login">

<input type="hidden" name="redirect" value="$redirect">

</form>


Be sure to add the domain name (www.mydomain.com), IP addresses or IP ranges in 192.168.0.1/24 form to the walled garden so unauthenticaed users can access your images and web server without being logged into the system.

DO NOT INCLUDE ANY http:// or file names in the domain name otherwise the system will not be able to resolve the IP address properly. (e.g. http://www.qorvus.com/splash.htm)