== Intro ==
Due to our strict constrains with regards to captive portals (low-memory, no-login needed, auto-update of content) we decided to make our own. The software we build WLPortal is based around 5 components: 
 1. {{{pf}}} or {{{ipfw}}} firewall rules in the FreeBSD kernel.
 1. {{{thttpd}}} instance serving the captive portal CGI.
 1. The CGI script itself.
 1. The template files for making the entrance pretty.
 1. {{{crontab}}} entry to cleanup stale entries.

== Workflow ==
 1. The User get deflected to the Captive Portal by the {{{firewall}}} if it tries to reach an external site.
 1. The User reads the welcome pages and clicks OK.
 1. The MAC/IP of the device of the user gets whitelisted in the {{{firewalll}}}.
 1. The User get redirected to the specified website (http://wirelessleiden.nl by default).
 1. The {{{crontab}}} entry deletes the user if he/she has been idle too long.

== Template configurations ==
Important: this only holds true for nodes build in the {{{iris-releng-9.0-ileiden}}} branch, build after {{{r10249 | rick | 2012-03-19 19:06:36 +0100 (Mon, 19 Mar 2012)}}}

Warning: Make sure to only alter the cosmetics of the file and not the technical structure of the forms or submit url.

You can edit the config file at {{{/usr/local/etc/wlportal/login.tmpl}}}, please do mind that this file get lost after an reboot. If you like to store the edited file on a persistent place, make sure to place it at {{{/cfg/local/wlportal/login.tmpl}}}.