Docs ModUserTrack » History » Revision 14
Revision 13 (gstrauss, 2017-02-27 17:30) → Revision 14/15 (gstrauss, 2017-02-27 18:02)
h1. User Tracking Module
{{>toc}}
*Module mod_usertrack*
h2. Description
Clickstream is the series of page visits and associated clicks executed by a website visitor when navigating through the site. Usertrack module sets a cookie on the user's side in order to enable clickstream logging to track user activity.
h2. Installation
In order to use mod_usertrack, you need to load it first. Make sure you have following line inside your configuration file:
<pre>
server.modules = {
...,
"mod_usertrack",
...
}
</pre>
h2. Options
*usertrack.cookie-name*
This option allows the setting of the name of the cookie. The default is 'TRACKID'. Currently it only allows a-z.
e.g.: usertrack.cookie-name = "mycookie"
*usertrack.cookie-attrs*
(since lighttpd 1.4.46)
This option allows the setting *all* of the attributes of the cookie, including Path, Domain, Max-Age, Secure, HttpOnly, SameSite, and more. Setting this will cause usertrack.cookie-domain and usertrack.cookie-max-age to be ignored. This string is included verbatim in the response Cookie header and values should be properly URL-encoded.
e.g.: usertrack.cookie-attrs = "; Path=/; Version=1; Domain=.mydom.com; Max-Age=86400; Secure; HttpOnly, SameSite"
references:
https://en.wikipedia.org/wiki/HTTP_cookie
Secure: http://www.faqs.org/rfcs/rfc2965.html
HttpOnly: https://blog.codinghorror.com/protecting-your-cookies-httponly/
SameSite: https://scotthelme.co.uk/csrf-is-dead/) HttpOnly"
*usertrack.cookie-domain*
(deprecated; subsumed by usertrack.cookie-attrs since lighttpd 1.4.46)
Sets the domain name to which this cookie applies.
e.g.: usertrack.cookie-domain = ".example.com"
*usertrack.cookie-max-age*
(deprecated; subsumed by usertrack.cookie-attrs since lighttpd 1.4.46)
Sets the maximum duration in seconds of the cookie. If not specified it will not add a 'max-age' to the cookie, meaning it will not expire.
e.g.: usertrack.cookie-max-age = 60