Continuum

Real-time visitor tracking add-on.

Con­tinuum is a real-time vis­it­or track­ing add-on that logs vis­its and oth­er actions on your web­site, col­lect­ing data about each user and their nav­ig­a­tion pat­terns which can be lit­er­ally viewed in real-time, as well as viewed at any time in the future.

Continuum 1

Install­a­tion #

Down­load and unzip Con­tinuum, then fol­low the simple steps below:

  1. Upload the system/expressionengine/third_party/continuum folder
  2. Upload the themes/third_party/continuum folder
  3. Install the Con­tinuum mod­ule (Con­trol Pan­el > Add-Ons > Mod­ules > Install)
  4. Open the Con­tinuum set­tings (Con­trol Pan­el > Add-Ons > Mod­ules > Con­tinuum) and enable logging

Updat­ing #

Down­load and unzip the latest ver­sion of Con­tinuum, then fol­low the steps below:

  1. Over­write the system/expressionengine/third_party/continuum folder
  2. Over­write the themes/third_party/continuum folder

Set­tings #

For secur­ity pur­poses log­ging is dis­abled by default. You can enable it on the set­tings page as well as change the fol­low­ing settings:

Log­ging
Wheth­er Con­tinuum should log actions

Log Anonym­ous Users
Wheth­er Con­tinuum should log actions by anonym­ous (not logged in) users

Max­im­um Num­ber of Logged Actions to keep
The max­im­um num­ber of logged actions that should be kept in the data­base (leave blank for no maximum)

Max­im­um Age of Logged Actions to keep
The max­im­um age of logged actions that should be kept in the data­base (in days, leave blank for no maximum)

Settings

Log­ging #

Con­tinuum works by log­ging vis­its and oth­er actions on your web­site. It col­lects data about each user and their nav­ig­a­tion pat­terns which can be lit­er­ally viewed in real-time, as well as viewed at any time in the future.

Logging

Pre­cau­tions have been put in place to avoid log­ging vis­its by web crawl­ers and bots. Vis­its that are determ­ined as being bounces (no activ­ity after 3 minutes) are also removed.

Pri­vacy #

Con­tinuum saves the fol­low­ing data about your site users in the data­base. It also sets a cook­ie on their browser. Please ensure that this does not con­flict with your site’s pri­vacy policy before using Continuum.

Mem­ber ID
If the user is a mem­ber of the site then their ID is stored

IP Address
The IP address of the user

Indi­vidu­al Actions
The type of actions that the user per­formed (land­ing, vis­it, exit, etc.) as well as the url and timestamp of each action

Time of First Visit
A timestamp of the first time the user vis­ited the site

Time of Last Visit
A timestamp of the last time the user vis­ited the site

Tem­plate Tags #

A tem­plate tag allows you to log actions from with­in your templates:

{exp:continuum:log}
Use this single tag to log an action (notes is opti

{exp:continuum:log action="Add to Cart" notes="Product xyz"}

Developers #

Con­tinuum was developed to be a pro­gress­ive add-on which means that it can be exten­ded eas­ily and in many ways by oth­er third-party add-ons.

Progressive

Lib­rary #

Con­tinuum abstracts its main func­tions into a lib­rary which can be called by oth­er add-ons. To call the lib­rary use the fol­low­ing code:

// load continuum library
$this->EE->load->add_package_path(PATH_THIRD.'continuum/');
$this->EE->load->library('Continuum_lib');
$this->EE->load->remove_package_path(PATH_THIRD.'continuum/');

You can then call the avail­able meth­ods as follows:

// log an action
$this->EE->continuum_lib->log_activity($action, $notes);

// call clean up routine
$this->EE->continuum_lib->clean_up();

Exten­sion Hooks #

The fol­low­ing exten­sion hooks are available:

continuum_log_activity_start
Allows com­plete rewrite of activ­ity log­ging routine

continuum_log_activity
Allows you to modi­fy log data before insert­ing in database

continuum_log_activity_end
Allows addi­tion­al pro­cessing at end of log­ging routine

continuum_clean_up_start
Allows com­plete rewrite of clean up routine

continuum_clean_up_end
Allows addi­tion­al pro­cessing at end of clean up routine

Action #

The Con­tinuum mod­ule has an ACTion that can be used to log form sub­mis­sions. Use the fol­low­ing code to retrieve the AID:

$action_id = $this->EE->functions->fetch_action_id('Continuum', 'log_activity');