2796N/A<!
DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN">
2796N/A<
TITLE>Apache module mod_usertrack</
TITLE>
2796N/A<
H1>Module mod_usertrack</
h1>
2796N/APrevious releases of Apache have included a module which generates a
2796N/A'clickstream' log of user activity on a site, using cookies. This was
2796N/Acalled the "cookies" module, mod_cookies. In Apache 1.2 and later, this module
2796N/Abeen renamed the "user tracking" module, mod_usertrack. This module
2796N/Asimplified and new directives added.
2796N/APreviously, the cookies module (now the user tracking module) did its
2796N/Aown logging, using the <
tt>CookieLog</
tt> directive. In this release,
2796N/Athis module does no logging at all. Instead, a configurable log
2796N/Aformat file should be used to log user click-streams. This is possible
2796N/Abecause the logging module now allows <
a 2796N/Alogged by using the text <
tt>%{cookie}n </
tt>
2796N/Ain the log file format. For example:
2796N/AFor backward compatibility the configurable log module implements the
2796N/Aold <
tt>CookieLog</
tt> directive, but this should be upgrade to the
2796N/Aabove <
tt>CustomLog</
tt> directive.
2796N/A<
li><
a href="#cookieenable">CookieTracking</
a>
2796N/A<
li><
a href="#cookieexpires">CookieExpires</
a>
2796N/A<
a name="cookieexpires"><
h2>CookieTracking</
h2></
A>
2796N/A<
strong>Syntax:</
strong> CookieTracking <
em>on | off</
em><
br>
2796N/A<
strong>Context:</
strong> server config, virtual host, directory,
2796N/A<
strong>Override:</
strong> FileInfo<
br>
2796N/A<
strong>Status:</
strong> optional<
br>
2796N/A<
strong>Module:</
strong> mod_usertrack<
p>
2796N/AWhen the user track module is compiled in, and "CookieTracking on" is
2796N/Aset, Apache will start sending a user-tracking cookie for all new
2796N/Arequests. This directive can be used to turn this behavior on or off
2796N/Aon a per-server or per-directory basis. By default, compiling
2796N/Amod_usertrack will not activate cookies.
2796N/A<
a name="cookieexpires"><
h2>CookieExpires</
h2></
A>
2796N/A<
strong>Syntax:</
strong> CookieExpires <
em>expiry-period</
em><
br>
2796N/A<
strong>Context:</
strong> server config, virtual host<
br>
2796N/A<
strong>Status:</
strong> optional<
br>
2796N/A<
strong>Module:</
strong> mod_usertrack<
p>
2796N/AWhen used, this directive sets an expiry time on the cookie generated
2796N/Aby the usertrack module. The <
i>expiry-period</
i> can be given either
2796N/Aas a number of seconds, or in the format such as "2 weeks 3 days 7
2796N/Ahours". Valid denominations are: years, months, weeks, hours, minutes