gopiwik/assets/track.js

7465 lines
297 KiB
JavaScript
Raw Permalink Normal View History

2017-03-03 17:44:22 +01:00
/*!
2021-01-06 17:54:39 +01:00
* Matomo - free/libre analytics platform
2017-03-03 17:44:22 +01:00
*
* JavaScript tracking client
*
2021-01-06 17:54:39 +01:00
* @link https://piwik.org
* @source https://github.com/matomo-org/matomo/blob/master/js/piwik.js
* @license https://piwik.org/free-software/bsd/ BSD-3 Clause (also in js/LICENSE.txt)
2017-03-03 17:44:22 +01:00
* @license magnet:?xt=urn:btih:c80d50af7d3db9be66a4d0a86db0286e4fd33292&dn=bsd-3-clause.txt BSD-3-Clause
*/
// NOTE: if you change this above Piwik comment block, you must also change `$byteStart` in js/tracker.php
// Refer to README.md for build instructions when minifying this file for distribution.
/*
* Browser [In]Compatibility
* - minimum required ECMAScript: ECMA-262, edition 3
*
* Incompatible with these (and earlier) versions of:
* - IE4 - try..catch and for..in introduced in IE5
* - IE5 - named anonymous functions, array.push, encodeURIComponent, decodeURIComponent, and getElementsByTagName introduced in IE5.5
2021-01-06 17:54:39 +01:00
* - IE6 and 7 - window.JSON introduced in IE8
2017-03-03 17:44:22 +01:00
* - Firefox 1.0 and Netscape 8.x - FF1.5 adds array.indexOf, among other things
* - Mozilla 1.7 and Netscape 6.x-7.x
* - Netscape 4.8
* - Opera 6 - Error object (and Presto) introduced in Opera 7
* - Opera 7
*/
/* startjslint */
/*jslint browser:true, plusplus:true, vars:true, nomen:true, evil:true, regexp: false, bitwise: true, white: true */
/*global window */
/*global unescape */
/*global ActiveXObject */
2021-01-06 17:54:39 +01:00
/*global Blob */
/*members Piwik, Matomo, encodeURIComponent, decodeURIComponent, getElementsByTagName,
shift, unshift, piwikAsyncInit, matomoAsyncInit, matomoPluginAsyncInit , frameElement, self, hasFocus,
createElement, appendChild, characterSet, charset, all, piwik_log, AnalyticsTracker,
addEventListener, attachEvent, removeEventListener, detachEvent, disableCookies, setCookieConsentGiven,
areCookiesEnabled, getRememberedCookieConsent, rememberCookieConsentGiven, forgetCookieConsentGiven, requireCookieConsent,
cookie, domain, readyState, documentElement, doScroll, title, text, contentWindow, postMessage,
location, top, onerror, document, referrer, parent, links, href, protocol, name,
performance, mozPerformance, msPerformance, webkitPerformance, timing, connectEnd, requestStart, responseStart,
responseEnd, fetchStart, domInteractive, domLoading, domComplete, loadEventStart, loadEventEnd,
event, which, button, srcElement, type, target, data,
parentNode, tagName, hostname, className,
userAgent, cookieEnabled, sendBeacon, platform, mimeTypes, enabledPlugin, javaEnabled,
serviceWorker, ready, then, sync, register,
XMLHttpRequest, ActiveXObject, open, setRequestHeader, onreadystatechange, send, readyState, status,
getTime, getTimeAlias, setTime, toGMTString, getHours, getMinutes, getSeconds,
toLowerCase, toUpperCase, charAt, indexOf, lastIndexOf, split, slice,
onload, src,
min, round, random, floor,
exec, success, trackerUrl, isSendBeacon, xhr,
res, width, height,
pdf, qt, realp, wma, fla, java, ag, showModalDialog,
maq_initial_value, maq_opted_in, maq_optout_by_default, maq_url,
initialized, hook, getHook, resetUserId, getVisitorId, getVisitorInfo, setUserId, getUserId, setSiteId, getSiteId, setTrackerUrl, getTrackerUrl, appendToTrackingUrl, getRequest, addPlugin,
getAttributionInfo, getAttributionCampaignName, getAttributionCampaignKeyword,
getAttributionReferrerTimestamp, getAttributionReferrerUrl,
setCustomData, getCustomData,
setCustomRequestProcessing,
setCustomVariable, getCustomVariable, deleteCustomVariable, storeCustomVariablesInCookie, setCustomDimension, getCustomDimension,
deleteCustomVariables, deleteCustomDimension, setDownloadExtensions, addDownloadExtensions, removeDownloadExtensions,
setDomains, setIgnoreClasses, setRequestMethod, setRequestContentType, setGenerationTimeMs,
setReferrerUrl, setCustomUrl, setAPIUrl, setDocumentTitle, getPiwikUrl, getMatomoUrl, getCurrentUrl,
setDownloadClasses, setLinkClasses,
setCampaignNameKey, setCampaignKeywordKey,
getConsentRequestsQueue, requireConsent, getRememberedConsent, hasRememberedConsent, isConsentRequired,
setConsentGiven, rememberConsentGiven, forgetConsentGiven, unload, hasConsent,
discardHashTag, alwaysUseSendBeacon, disableAlwaysUseSendBeacon, isUsingAlwaysUseSendBeacon,
setCookieNamePrefix, setCookieDomain, setCookiePath, setSecureCookie, setVisitorIdCookie, getCookieDomain, hasCookies, setSessionCookie,
setVisitorCookieTimeout, setSessionCookieTimeout, setReferralCookieTimeout, getCookie, getCookiePath, getSessionCookieTimeout,
setConversionAttributionFirstReferrer, tracker, request,
disablePerformanceTracking, maq_confirm_opted_in,
doNotTrack, setDoNotTrack, msDoNotTrack, getValuesFromVisitorIdCookie,
enableCrossDomainLinking, disableCrossDomainLinking, isCrossDomainLinkingEnabled, setCrossDomainLinkingTimeout, getCrossDomainLinkingUrlParameter,
addListener, enableLinkTracking, enableJSErrorTracking, setLinkTrackingTimer, getLinkTrackingTimer,
enableHeartBeatTimer, disableHeartBeatTimer, killFrame, redirectFile, setCountPreRendered, setVisitStandardLength,
trackGoal, trackLink, trackPageView, getNumTrackedPageViews, trackRequest, ping, queueRequest, trackSiteSearch, trackEvent,
requests, timeout, enabled, sendRequests, queueRequest, canQueue, pushMultiple, disableQueueRequest,setRequestQueueInterval,interval,getRequestQueue, unsetPageIsUnloading,
setEcommerceView, getEcommerceItems, addEcommerceItem, removeEcommerceItem, clearEcommerceCart, trackEcommerceOrder, trackEcommerceCartUpdate,
deleteCookie, deleteCookies, offsetTop, offsetLeft, offsetHeight, offsetWidth, nodeType, defaultView,
innerHTML, scrollLeft, scrollTop, currentStyle, getComputedStyle, querySelectorAll, splice,
getAttribute, hasAttribute, attributes, nodeName, findContentNodes, findContentNodes, findContentNodesWithinNode,
findPieceNode, findTargetNodeNoDefault, findTargetNode, findContentPiece, children, hasNodeCssClass,
getAttributeValueFromNode, hasNodeAttributeWithValue, hasNodeAttribute, findNodesByTagName, findMultiple,
makeNodesUnique, concat, find, htmlCollectionToArray, offsetParent, value, nodeValue, findNodesHavingAttribute,
findFirstNodeHavingAttribute, findFirstNodeHavingAttributeWithValue, getElementsByClassName,
findNodesHavingCssClass, findFirstNodeHavingClass, isLinkElement, findParentContentNode, removeDomainIfIsInLink,
findContentName, findMediaUrlInNode, toAbsoluteUrl, findContentTarget, getLocation, origin, host, isSameDomain,
search, trim, getBoundingClientRect, bottom, right, left, innerWidth, innerHeight, clientWidth, clientHeight,
isOrWasNodeInViewport, isNodeVisible, buildInteractionRequestParams, buildImpressionRequestParams,
shouldIgnoreInteraction, setHrefAttribute, setAttribute, buildContentBlock, collectContent, setLocation,
CONTENT_ATTR, CONTENT_CLASS, LEGACY_CONTENT_CLASS, CONTENT_NAME_ATTR, CONTENT_PIECE_ATTR, CONTENT_PIECE_CLASS, LEGACY_CONTENT_PIECE_CLASS,
CONTENT_TARGET_ATTR, CONTENT_TARGET_CLASS, LEGACY_CONTENT_TARGET_CLASS, CONTENT_IGNOREINTERACTION_ATTR, CONTENT_IGNOREINTERACTION_CLASS, LEGACY_CONTENT_IGNOREINTERACTION_CLASS,
trackCallbackOnLoad, trackCallbackOnReady, buildContentImpressionsRequests, wasContentImpressionAlreadyTracked,
getQuery, getContent, setVisitorId, getContentImpressionsRequestsFromNodes,
buildContentInteractionRequestNode, buildContentInteractionRequest, buildContentImpressionRequest,
appendContentInteractionToRequestIfPossible, setupInteractionsTracking, trackContentImpressionClickInteraction,
internalIsNodeVisible, clearTrackedContentImpressions, getTrackerUrl, trackAllContentImpressions,
getTrackedContentImpressions, getCurrentlyVisibleContentImpressionsRequestsIfNotTrackedYet,
contentInteractionTrackingSetupDone, contains, match, pathname, piece, trackContentInteractionNode,
trackContentInteractionNode, trackContentImpressionsWithinNode, trackContentImpression,
enableTrackOnlyVisibleContent, trackContentInteraction, clearEnableTrackOnlyVisibleContent, logAllContentBlocksOnPage,
trackVisibleContentImpressions, isTrackOnlyVisibleContentEnabled, port, isUrlToCurrentDomain, matomoTrackers,
isNodeAuthorizedToTriggerInteraction, getConfigDownloadExtensions, disableLinkTracking,
substr, setAnyAttribute, max, abs, childNodes, compareDocumentPosition, body,
getConfigVisitorCookieTimeout, getRemainingVisitorCookieTimeout, getDomains, getConfigCookiePath,
getConfigCookieSameSite, setCookieSameSite,
getConfigIdPageView, newVisitor, uuid, createTs, currentVisitTs,
"", "\b", "\t", "\n", "\f", "\r", "\"", "\\", apply, call, charCodeAt, getUTCDate, getUTCFullYear, getUTCHours,
getUTCMinutes, getUTCMonth, getUTCSeconds, hasOwnProperty, join, lastIndex, length, parse, prototype, push, replace,
sort, slice, stringify, test, toJSON, toString, valueOf, objectToJSON, addTracker, removeAllAsyncTrackersButFirst,
optUserOut, forgetUserOptOut, isUserOptedOut, withCredentials
2017-03-03 17:44:22 +01:00
*/
/*global _paq:true */
/*members push */
/*global Piwik:true */
2021-01-06 17:54:39 +01:00
/*global Matomo:true */
2017-03-03 17:44:22 +01:00
/*members addPlugin, getTracker, getAsyncTracker, getAsyncTrackers, addTracker, trigger, on, off, retryMissedPluginCalls,
2021-01-06 17:54:39 +01:00
DOM, onLoad, onReady, isNodeVisible, isOrWasNodeVisible, JSON */
/*global Matomo_Overlay_Client */
2017-03-03 17:44:22 +01:00
/*global AnalyticsTracker:true */
/*members initialize */
/*global define */
2021-01-06 17:54:39 +01:00
/*global console */
2017-03-03 17:44:22 +01:00
/*members amd */
/*members error */
/*members log */
// asynchronous tracker (or proxy)
if (typeof _paq !== 'object') {
_paq = [];
}
2021-01-06 17:54:39 +01:00
// Matomo singleton and namespace
if (typeof window.Matomo !== 'object') {
window.Matomo = window.Piwik = (function () {
2017-03-03 17:44:22 +01:00
'use strict';
/************************************************************
* Private data
************************************************************/
var expireDateTime,
/* plugins */
plugins = {},
eventHandlers = {},
/* alias frequently used globals for added minification */
documentAlias = document,
navigatorAlias = navigator,
screenAlias = screen,
windowAlias = window,
/* performance timing */
performanceAlias = windowAlias.performance || windowAlias.mozPerformance || windowAlias.msPerformance || windowAlias.webkitPerformance,
/* encode */
encodeWrapper = windowAlias.encodeURIComponent,
/* decode */
decodeWrapper = windowAlias.decodeURIComponent,
/* urldecode */
urldecode = unescape,
/* asynchronous tracker */
asyncTrackers = [],
/* iterator */
iterator,
2021-01-06 17:54:39 +01:00
/* local Matomo */
Matomo,
2017-03-03 17:44:22 +01:00
2021-01-06 17:54:39 +01:00
missedPluginTrackerCalls = [],
coreConsentCounter = 0,
coreHeartBeatCounter = 0,
trackerIdCounter = 0,
isPageUnloading = false;
2017-03-03 17:44:22 +01:00
/************************************************************
* Private methods
************************************************************/
/**
2021-01-06 17:54:39 +01:00
* See https://github.com/matomo-org/matomo/issues/8413
2017-03-03 17:44:22 +01:00
* To prevent Javascript Error: Uncaught URIError: URI malformed when encoding is not UTF-8. Use this method
* instead of decodeWrapper if a text could contain any non UTF-8 encoded characters eg
2021-01-06 17:54:39 +01:00
* a URL like http://apache.matomo/test.html?%F6%E4%FC or a link like
2017-03-03 17:44:22 +01:00
* <a href="test-with-%F6%E4%FC/story/0">(encoded iso-8859-1 URL)</a>
*/
function safeDecodeWrapper(url)
{
try {
return decodeWrapper(url);
} catch (e) {
return unescape(url);
}
}
/*
* Is property defined?
*/
function isDefined(property) {
// workaround https://github.com/douglascrockford/JSLint/commit/24f63ada2f9d7ad65afc90e6d949f631935c2480
var propertyType = typeof property;
return propertyType !== 'undefined';
}
/*
* Is property a function?
*/
function isFunction(property) {
return typeof property === 'function';
}
/*
* Is property an object?
*
* @return bool Returns true if property is null, an Object, or subclass of Object (i.e., an instanceof String, Date, etc.)
*/
function isObject(property) {
return typeof property === 'object';
}
/*
* Is property a string?
*/
function isString(property) {
return typeof property === 'string' || property instanceof String;
}
2021-01-06 17:54:39 +01:00
/*
* Is property a string?
*/
function isNumber(property) {
return typeof property === 'number' || property instanceof Number;
}
/*
* Is property a string?
*/
function isNumberOrHasLength(property) {
return isDefined(property) && (isNumber(property) || (isString(property) && property.length));
}
2017-03-03 17:44:22 +01:00
function isObjectEmpty(property)
{
if (!property) {
return true;
}
var i;
var isEmpty = true;
for (i in property) {
if (Object.prototype.hasOwnProperty.call(property, i)) {
isEmpty = false;
}
}
return isEmpty;
}
/**
* Logs an error in the console.
* Note: it does not generate a JavaScript error, so make sure to also generate an error if needed.
* @param message
*/
function logConsoleError(message) {
2021-01-06 17:54:39 +01:00
// needed to write it this way for jslint
var consoleType = typeof console;
if (consoleType !== 'undefined' && console && console.error) {
2017-03-03 17:44:22 +01:00
console.error(message);
}
}
/*
* apply wrapper
*
* @param array parameterArray An array comprising either:
* [ 'methodName', optional_parameters ]
* or:
* [ functionObject, optional_parameters ]
*/
function apply() {
var i, j, f, parameterArray, trackerCall;
for (i = 0; i < arguments.length; i += 1) {
trackerCall = null;
if (arguments[i] && arguments[i].slice) {
trackerCall = arguments[i].slice();
}
parameterArray = arguments[i];
f = parameterArray.shift();
var fParts, context;
var isStaticPluginCall = isString(f) && f.indexOf('::') > 0;
if (isStaticPluginCall) {
2021-01-06 17:54:39 +01:00
// a static method will not be called on a tracker and is not dependent on the existence of a
2017-03-03 17:44:22 +01:00
// tracker etc
fParts = f.split('::');
context = fParts[0];
f = fParts[1];
2021-01-06 17:54:39 +01:00
if ('object' === typeof Matomo[context] && 'function' === typeof Matomo[context][f]) {
Matomo[context][f].apply(Matomo[context], parameterArray);
2017-03-03 17:44:22 +01:00
} else if (trackerCall) {
// we try to call that method again later as the plugin might not be loaded yet
2021-01-06 17:54:39 +01:00
// a plugin can call "Matomo.retryMissedPluginCalls();" once it has been loaded and then the
// method call to "Matomo[context][f]" may be executed
2017-03-03 17:44:22 +01:00
missedPluginTrackerCalls.push(trackerCall);
}
} else {
for (j = 0; j < asyncTrackers.length; j++) {
if (isString(f)) {
context = asyncTrackers[j];
var isPluginTrackerCall = f.indexOf('.') > 0;
if (isPluginTrackerCall) {
fParts = f.split('.');
if (context && 'object' === typeof context[fParts[0]]) {
context = context[fParts[0]];
f = fParts[1];
} else if (trackerCall) {
// we try to call that method again later as the plugin might not be loaded yet
missedPluginTrackerCalls.push(trackerCall);
break;
}
}
if (context[f]) {
context[f].apply(context, parameterArray);
} else {
2021-01-06 17:54:39 +01:00
var message = 'The method \'' + f + '\' was not found in "_paq" variable. Please have a look at the Matomo tracker documentation: https://developer.matomo.org/api-reference/tracking-javascript';
2017-03-03 17:44:22 +01:00
logConsoleError(message);
if (!isPluginTrackerCall) {
// do not trigger an error if it is a call to a plugin as the plugin may just not be
// loaded yet etc
throw new TypeError(message);
}
}
if (f === 'addTracker') {
// addTracker adds an entry to asyncTrackers and would otherwise result in an endless loop
break;
}
if (f === 'setTrackerUrl' || f === 'setSiteId') {
// these two methods should be only executed on the first tracker
break;
}
} else {
f.apply(asyncTrackers[j], parameterArray);
}
}
}
}
}
/*
* Cross-browser helper function to add event handler
*/
function addEventListener(element, eventType, eventHandler, useCapture) {
if (element.addEventListener) {
element.addEventListener(eventType, eventHandler, useCapture);
return true;
}
if (element.attachEvent) {
return element.attachEvent('on' + eventType, eventHandler);
}
element['on' + eventType] = eventHandler;
}
function trackCallbackOnLoad(callback)
{
if (documentAlias.readyState === 'complete') {
callback();
} else if (windowAlias.addEventListener) {
2021-01-06 17:54:39 +01:00
windowAlias.addEventListener('load', callback, false);
2017-03-03 17:44:22 +01:00
} else if (windowAlias.attachEvent) {
windowAlias.attachEvent('onload', callback);
}
}
function trackCallbackOnReady(callback)
{
var loaded = false;
if (documentAlias.attachEvent) {
loaded = documentAlias.readyState === 'complete';
} else {
loaded = documentAlias.readyState !== 'loading';
}
if (loaded) {
callback();
return;
}
var _timer;
if (documentAlias.addEventListener) {
addEventListener(documentAlias, 'DOMContentLoaded', function ready() {
documentAlias.removeEventListener('DOMContentLoaded', ready, false);
if (!loaded) {
loaded = true;
callback();
}
});
} else if (documentAlias.attachEvent) {
documentAlias.attachEvent('onreadystatechange', function ready() {
if (documentAlias.readyState === 'complete') {
documentAlias.detachEvent('onreadystatechange', ready);
if (!loaded) {
loaded = true;
callback();
}
}
});
if (documentAlias.documentElement.doScroll && windowAlias === windowAlias.top) {
(function ready() {
if (!loaded) {
try {
documentAlias.documentElement.doScroll('left');
} catch (error) {
setTimeout(ready, 0);
return;
}
loaded = true;
callback();
}
}());
}
}
// fallback
addEventListener(windowAlias, 'load', function () {
if (!loaded) {
loaded = true;
callback();
}
}, false);
}
/*
* Call plugin hook methods
*/
function executePluginMethod(methodName, params, callback) {
if (!methodName) {
return '';
}
var result = '',
i,
pluginMethod, value, isFunction;
for (i in plugins) {
if (Object.prototype.hasOwnProperty.call(plugins, i)) {
isFunction = plugins[i] && 'function' === typeof plugins[i][methodName];
if (isFunction) {
pluginMethod = plugins[i][methodName];
value = pluginMethod(params || {}, callback);
if (value) {
result += value;
}
}
}
}
return result;
}
/*
* Handle beforeunload event
*
* Subject to Safari's "Runaway JavaScript Timer" and
* Chrome V8 extension that terminates JS that exhibits
* "slow unload", i.e., calling getTime() > 1000 times
*/
function beforeUnloadHandler() {
var now;
2021-01-06 17:54:39 +01:00
isPageUnloading = true;
2017-03-03 17:44:22 +01:00
executePluginMethod('unload');
2021-01-06 17:54:39 +01:00
now = new Date();
var aliasTime = now.getTimeAlias();
if ((expireDateTime - aliasTime) > 3000) {
expireDateTime = aliasTime + 3000;
}
2017-03-03 17:44:22 +01:00
/*
* Delay/pause (blocks UI)
*/
if (expireDateTime) {
// the things we do for backwards compatibility...
// in ECMA-262 5th ed., we could simply use:
// while (Date.now() < expireDateTime) { }
do {
now = new Date();
} while (now.getTimeAlias() < expireDateTime);
}
}
/*
* Load JavaScript file (asynchronously)
*/
function loadScript(src, onLoad) {
var script = documentAlias.createElement('script');
script.type = 'text/javascript';
script.src = src;
if (script.readyState) {
script.onreadystatechange = function () {
var state = this.readyState;
if (state === 'loaded' || state === 'complete') {
script.onreadystatechange = null;
onLoad();
}
};
} else {
script.onload = onLoad;
}
documentAlias.getElementsByTagName('head')[0].appendChild(script);
}
/*
* Get page referrer
*/
function getReferrer() {
var referrer = '';
try {
referrer = windowAlias.top.document.referrer;
} catch (e) {
if (windowAlias.parent) {
try {
referrer = windowAlias.parent.document.referrer;
} catch (e2) {
referrer = '';
}
}
}
if (referrer === '') {
referrer = documentAlias.referrer;
}
return referrer;
}
/*
* Extract scheme/protocol from URL
*/
function getProtocolScheme(url) {
var e = new RegExp('^([a-z]+):'),
matches = e.exec(url);
return matches ? matches[1] : null;
}
/*
* Extract hostname from URL
*/
function getHostName(url) {
// scheme : // [username [: password] @] hostame [: port] [/ [path] [? query] [# fragment]]
var e = new RegExp('^(?:(?:https?|ftp):)/*(?:[^@]+@)?([^:/#]+)'),
matches = e.exec(url);
return matches ? matches[1] : url;
}
function stringStartsWith(str, prefix) {
str = String(str);
return str.lastIndexOf(prefix, 0) === 0;
}
function stringEndsWith(str, suffix) {
str = String(str);
return str.indexOf(suffix, str.length - suffix.length) !== -1;
}
function stringContains(str, needle) {
str = String(str);
return str.indexOf(needle) !== -1;
}
function removeCharactersFromEndOfString(str, numCharactersToRemove) {
str = String(str);
return str.substr(0, str.length - numCharactersToRemove);
}
/**
* We do not check whether URL contains already url parameter, please use removeUrlParameter() if needed
* before calling this method.
* This method makes sure to append URL parameters before a possible hash. Will escape (encode URI component)
* the set name and value
*/
function addUrlParameter(url, name, value) {
url = String(url);
if (!value) {
value = '';
}
var hashPos = url.indexOf('#');
var urlLength = url.length;
if (hashPos === -1) {
hashPos = urlLength;
}
var baseUrl = url.substr(0, hashPos);
var urlHash = url.substr(hashPos, urlLength - hashPos);
if (baseUrl.indexOf('?') === -1) {
baseUrl += '?';
} else if (!stringEndsWith(baseUrl, '?')) {
baseUrl += '&';
}
// nothing to if ends with ?
return baseUrl + encodeWrapper(name) + '=' + encodeWrapper(value) + urlHash;
}
function removeUrlParameter(url, name) {
url = String(url);
if (url.indexOf('?' + name + '=') === -1 && url.indexOf('&' + name + '=') === -1) {
// nothing to remove, url does not contain this parameter
return url;
}
var searchPos = url.indexOf('?');
if (searchPos === -1) {
// nothing to remove, no query parameters
return url;
}
var queryString = url.substr(searchPos + 1);
var baseUrl = url.substr(0, searchPos);
if (queryString) {
var urlHash = '';
var hashPos = queryString.indexOf('#');
if (hashPos !== -1) {
urlHash = queryString.substr(hashPos + 1);
queryString = queryString.substr(0, hashPos);
}
var param;
var paramsArr = queryString.split('&');
var i = paramsArr.length - 1;
for (i; i >= 0; i--) {
param = paramsArr[i].split('=')[0];
if (param === name) {
paramsArr.splice(i, 1);
}
}
var newQueryString = paramsArr.join('&');
if (newQueryString) {
baseUrl = baseUrl + '?' + newQueryString;
}
if (urlHash) {
baseUrl += '#' + urlHash;
}
}
return baseUrl;
}
/*
* Extract parameter from URL
*/
function getUrlParameter(url, name) {
var regexSearch = "[\\?&#]" + name + "=([^&#]*)";
var regex = new RegExp(regexSearch);
var results = regex.exec(url);
2021-01-06 17:54:39 +01:00
return results ? safeDecodeWrapper(results[1]) : '';
}
function trim(text)
{
if (text && String(text) === text) {
return text.replace(/^\s+|\s+$/g, '');
}
return text;
2017-03-03 17:44:22 +01:00
}
/*
* UTF-8 encoding
*/
function utf8_encode(argString) {
return unescape(encodeWrapper(argString));
}
/************************************************************
* sha1
* - based on sha1 from http://phpjs.org/functions/sha1:512 (MIT / GPL v2)
************************************************************/
function sha1(str) {
// + original by: Webtoolkit.info (http://www.webtoolkit.info/)
// + namespaced by: Michael White (http://getsprink.com)
// + input by: Brett Zamir (http://brett-zamir.me)
// + improved by: Kevin van Zonneveld (http://kevin.vanzonneveld.net)
2021-01-06 17:54:39 +01:00
// + jslinted by: Anthon Pang (https://matomo.org)
2017-03-03 17:44:22 +01:00
var
rotate_left = function (n, s) {
return (n << s) | (n >>> (32 - s));
},
cvt_hex = function (val) {
var strout = '',
i,
v;
for (i = 7; i >= 0; i--) {
v = (val >>> (i * 4)) & 0x0f;
strout += v.toString(16);
}
return strout;
},
blockstart,
i,
j,
W = [],
H0 = 0x67452301,
H1 = 0xEFCDAB89,
H2 = 0x98BADCFE,
H3 = 0x10325476,
H4 = 0xC3D2E1F0,
A,
B,
C,
D,
E,
temp,
str_len,
word_array = [];
str = utf8_encode(str);
str_len = str.length;
for (i = 0; i < str_len - 3; i += 4) {
j = str.charCodeAt(i) << 24 | str.charCodeAt(i + 1) << 16 |
str.charCodeAt(i + 2) << 8 | str.charCodeAt(i + 3);
word_array.push(j);
}
switch (str_len & 3) {
case 0:
i = 0x080000000;
break;
case 1:
i = str.charCodeAt(str_len - 1) << 24 | 0x0800000;
break;
case 2:
i = str.charCodeAt(str_len - 2) << 24 | str.charCodeAt(str_len - 1) << 16 | 0x08000;
break;
case 3:
i = str.charCodeAt(str_len - 3) << 24 | str.charCodeAt(str_len - 2) << 16 | str.charCodeAt(str_len - 1) << 8 | 0x80;
break;
}
word_array.push(i);
while ((word_array.length & 15) !== 14) {
word_array.push(0);
}
word_array.push(str_len >>> 29);
word_array.push((str_len << 3) & 0x0ffffffff);
for (blockstart = 0; blockstart < word_array.length; blockstart += 16) {
for (i = 0; i < 16; i++) {
W[i] = word_array[blockstart + i];
}
for (i = 16; i <= 79; i++) {
W[i] = rotate_left(W[i - 3] ^ W[i - 8] ^ W[i - 14] ^ W[i - 16], 1);
}
A = H0;
B = H1;
C = H2;
D = H3;
E = H4;
for (i = 0; i <= 19; i++) {
temp = (rotate_left(A, 5) + ((B & C) | (~B & D)) + E + W[i] + 0x5A827999) & 0x0ffffffff;
E = D;
D = C;
C = rotate_left(B, 30);
B = A;
A = temp;
}
for (i = 20; i <= 39; i++) {
temp = (rotate_left(A, 5) + (B ^ C ^ D) + E + W[i] + 0x6ED9EBA1) & 0x0ffffffff;
E = D;
D = C;
C = rotate_left(B, 30);
B = A;
A = temp;
}
for (i = 40; i <= 59; i++) {
temp = (rotate_left(A, 5) + ((B & C) | (B & D) | (C & D)) + E + W[i] + 0x8F1BBCDC) & 0x0ffffffff;
E = D;
D = C;
C = rotate_left(B, 30);
B = A;
A = temp;
}
for (i = 60; i <= 79; i++) {
temp = (rotate_left(A, 5) + (B ^ C ^ D) + E + W[i] + 0xCA62C1D6) & 0x0ffffffff;
E = D;
D = C;
C = rotate_left(B, 30);
B = A;
A = temp;
}
H0 = (H0 + A) & 0x0ffffffff;
H1 = (H1 + B) & 0x0ffffffff;
H2 = (H2 + C) & 0x0ffffffff;
H3 = (H3 + D) & 0x0ffffffff;
H4 = (H4 + E) & 0x0ffffffff;
}
temp = cvt_hex(H0) + cvt_hex(H1) + cvt_hex(H2) + cvt_hex(H3) + cvt_hex(H4);
return temp.toLowerCase();
}
/************************************************************
* end sha1
************************************************************/
/*
* Fix-up URL when page rendered from search engine cache or translated page
*/
function urlFixup(hostName, href, referrer) {
if (!hostName) {
hostName = '';
}
if (!href) {
href = '';
}
if (hostName === 'translate.googleusercontent.com') { // Google
if (referrer === '') {
referrer = href;
}
href = getUrlParameter(href, 'u');
hostName = getHostName(href);
} else if (hostName === 'cc.bingj.com' || // Bing
hostName === 'webcache.googleusercontent.com' || // Google
hostName.slice(0, 5) === '74.6.') { // Yahoo (via Inktomi 74.6.0.0/16)
href = documentAlias.links[0].href;
hostName = getHostName(href);
}
return [hostName, href, referrer];
}
/*
* Fix-up domain
*/
function domainFixup(domain) {
var dl = domain.length;
// remove trailing '.'
if (domain.charAt(--dl) === '.') {
domain = domain.slice(0, dl);
}
// remove leading '*'
if (domain.slice(0, 2) === '*.') {
domain = domain.slice(1);
}
if (domain.indexOf('/') !== -1) {
domain = domain.substr(0, domain.indexOf('/'));
}
return domain;
}
/*
* Title fixup
*/
function titleFixup(title) {
title = title && title.text ? title.text : title;
if (!isString(title)) {
var tmp = documentAlias.getElementsByTagName('title');
if (tmp && isDefined(tmp[0])) {
title = tmp[0].text;
}
}
return title;
}
function getChildrenFromNode(node)
{
if (!node) {
return [];
}
if (!isDefined(node.children) && isDefined(node.childNodes)) {
return node.children;
}
if (isDefined(node.children)) {
return node.children;
}
return [];
}
function containsNodeElement(node, containedNode)
{
if (!node || !containedNode) {
return false;
}
if (node.contains) {
return node.contains(containedNode);
}
if (node === containedNode) {
return true;
}
if (node.compareDocumentPosition) {
return !!(node.compareDocumentPosition(containedNode) & 16);
}
return false;
}
// Polyfill for IndexOf for IE6-IE8
function indexOfArray(theArray, searchElement)
{
if (theArray && theArray.indexOf) {
return theArray.indexOf(searchElement);
}
// 1. Let O be the result of calling ToObject passing
// the this value as the argument.
if (!isDefined(theArray) || theArray === null) {
return -1;
}
if (!theArray.length) {
return -1;
}
var len = theArray.length;
if (len === 0) {
return -1;
}
var k = 0;
// 9. Repeat, while k < len
while (k < len) {
// a. Let Pk be ToString(k).
// This is implicit for LHS operands of the in operator
// b. Let kPresent be the result of calling the
// HasProperty internal method of O with argument Pk.
// This step can be combined with c
// c. If kPresent is true, then
// i. Let elementK be the result of calling the Get
// internal method of O with the argument ToString(k).
// ii. Let same be the result of applying the
// Strict Equality Comparison Algorithm to
// searchElement and elementK.
// iii. If same is true, return k.
if (theArray[k] === searchElement) {
return k;
}
k++;
}
return -1;
}
/************************************************************
* Element Visiblility
************************************************************/
/**
* Author: Jason Farrell
* Author URI: http://useallfive.com/
*
* Description: Checks if a DOM element is truly visible.
* Package URL: https://github.com/UseAllFive/true-visibility
* License: MIT (https://github.com/UseAllFive/true-visibility/blob/master/LICENSE.txt)
*/
function isVisible(node) {
if (!node) {
return false;
}
//-- Cross browser method to get style properties:
function _getStyle(el, property) {
if (windowAlias.getComputedStyle) {
return documentAlias.defaultView.getComputedStyle(el,null)[property];
}
if (el.currentStyle) {
return el.currentStyle[property];
}
}
function _elementInDocument(element) {
element = element.parentNode;
while (element) {
if (element === documentAlias) {
return true;
}
element = element.parentNode;
}
return false;
}
/**
* Checks if a DOM element is visible. Takes into
* consideration its parents and overflow.
*
* @param (el) the DOM element to check if is visible
*
* These params are optional that are sent in recursively,
* you typically won't use these:
*
* @param (t) Top corner position number
* @param (r) Right corner position number
* @param (b) Bottom corner position number
* @param (l) Left corner position number
* @param (w) Element width number
* @param (h) Element height number
*/
function _isVisible(el, t, r, b, l, w, h) {
var p = el.parentNode,
VISIBLE_PADDING = 1; // has to be visible at least one px of the element
if (!_elementInDocument(el)) {
return false;
}
//-- Return true for document node
if (9 === p.nodeType) {
return true;
}
//-- Return false if our element is invisible
if (
'0' === _getStyle(el, 'opacity') ||
'none' === _getStyle(el, 'display') ||
'hidden' === _getStyle(el, 'visibility')
) {
return false;
}
if (!isDefined(t) ||
!isDefined(r) ||
!isDefined(b) ||
!isDefined(l) ||
!isDefined(w) ||
!isDefined(h)) {
t = el.offsetTop;
l = el.offsetLeft;
b = t + el.offsetHeight;
r = l + el.offsetWidth;
w = el.offsetWidth;
h = el.offsetHeight;
}
if (node === el && (0 === h || 0 === w) && 'hidden' === _getStyle(el, 'overflow')) {
return false;
}
//-- If we have a parent, let's continue:
if (p) {
//-- Check if the parent can hide its children.
if (('hidden' === _getStyle(p, 'overflow') || 'scroll' === _getStyle(p, 'overflow'))) {
//-- Only check if the offset is different for the parent
if (
//-- If the target element is to the right of the parent elm
l + VISIBLE_PADDING > p.offsetWidth + p.scrollLeft ||
//-- If the target element is to the left of the parent elm
l + w - VISIBLE_PADDING < p.scrollLeft ||
//-- If the target element is under the parent elm
t + VISIBLE_PADDING > p.offsetHeight + p.scrollTop ||
//-- If the target element is above the parent elm
t + h - VISIBLE_PADDING < p.scrollTop
) {
//-- Our target element is out of bounds:
return false;
}
}
//-- Add the offset parent's left/top coords to our element's offset:
if (el.offsetParent === p) {
l += p.offsetLeft;
t += p.offsetTop;
}
//-- Let's recursively check upwards:
return _isVisible(p, t, r, b, l, w, h);
}
return true;
}
return _isVisible(node);
}
/************************************************************
* Query
************************************************************/
var query = {
htmlCollectionToArray: function (foundNodes)
{
var nodes = [], index;
if (!foundNodes || !foundNodes.length) {
return nodes;
}
for (index = 0; index < foundNodes.length; index++) {
nodes.push(foundNodes[index]);
}
return nodes;
},
find: function (selector)
{
// we use querySelectorAll only on document, not on nodes because of its unexpected behavior. See for
// instance http://stackoverflow.com/questions/11503534/jquery-vs-document-queryselectorall and
// http://jsfiddle.net/QdMc5/ and http://ejohn.org/blog/thoughts-on-queryselectorall
if (!document.querySelectorAll || !selector) {
return []; // we do not support all browsers
}
var foundNodes = document.querySelectorAll(selector);
return this.htmlCollectionToArray(foundNodes);
},
findMultiple: function (selectors)
{
if (!selectors || !selectors.length) {
return [];
}
var index, foundNodes;
var nodes = [];
for (index = 0; index < selectors.length; index++) {
foundNodes = this.find(selectors[index]);
nodes = nodes.concat(foundNodes);
}
nodes = this.makeNodesUnique(nodes);
return nodes;
},
findNodesByTagName: function (node, tagName)
{
if (!node || !tagName || !node.getElementsByTagName) {
return [];
}
var foundNodes = node.getElementsByTagName(tagName);
return this.htmlCollectionToArray(foundNodes);
},
makeNodesUnique: function (nodes)
{
var copy = [].concat(nodes);
nodes.sort(function(n1, n2){
if (n1 === n2) {
return 0;
}
var index1 = indexOfArray(copy, n1);
var index2 = indexOfArray(copy, n2);
if (index1 === index2) {
return 0;
}
return index1 > index2 ? -1 : 1;
});
if (nodes.length <= 1) {
return nodes;
}
var index = 0;
var numDuplicates = 0;
var duplicates = [];
var node;
node = nodes[index++];
while (node) {
if (node === nodes[index]) {
numDuplicates = duplicates.push(index);
}
node = nodes[index++] || null;
}
while (numDuplicates--) {
nodes.splice(duplicates[numDuplicates], 1);
}
return nodes;
},
getAttributeValueFromNode: function (node, attributeName)
{
if (!this.hasNodeAttribute(node, attributeName)) {
return;
}
if (node && node.getAttribute) {
return node.getAttribute(attributeName);
}
if (!node || !node.attributes) {
return;
}
var typeOfAttr = (typeof node.attributes[attributeName]);
if ('undefined' === typeOfAttr) {
return;
}
if (node.attributes[attributeName].value) {
return node.attributes[attributeName].value; // nodeValue is deprecated ie Chrome
}
if (node.attributes[attributeName].nodeValue) {
return node.attributes[attributeName].nodeValue;
}
var index;
var attrs = node.attributes;
if (!attrs) {
return;
}
for (index = 0; index < attrs.length; index++) {
if (attrs[index].nodeName === attributeName) {
return attrs[index].nodeValue;
}
}
return null;
},
hasNodeAttributeWithValue: function (node, attributeName)
{
var value = this.getAttributeValueFromNode(node, attributeName);
return !!value;
},
hasNodeAttribute: function (node, attributeName)
{
if (node && node.hasAttribute) {
return node.hasAttribute(attributeName);
}
if (node && node.attributes) {
var typeOfAttr = (typeof node.attributes[attributeName]);
return 'undefined' !== typeOfAttr;
}
return false;
},
hasNodeCssClass: function (node, klassName)
{
if (node && klassName && node.className) {
var classes = typeof node.className === "string" ? node.className.split(' ') : [];
if (-1 !== indexOfArray(classes, klassName)) {
return true;
}
}
return false;
},
findNodesHavingAttribute: function (nodeToSearch, attributeName, nodes)
{
if (!nodes) {
nodes = [];
}
if (!nodeToSearch || !attributeName) {
return nodes;
}
var children = getChildrenFromNode(nodeToSearch);
if (!children || !children.length) {
return nodes;
}
var index, child;
for (index = 0; index < children.length; index++) {
child = children[index];
if (this.hasNodeAttribute(child, attributeName)) {
nodes.push(child);
}
nodes = this.findNodesHavingAttribute(child, attributeName, nodes);
}
return nodes;
},
findFirstNodeHavingAttribute: function (node, attributeName)
{
if (!node || !attributeName) {
return;
}
if (this.hasNodeAttribute(node, attributeName)) {
return node;
}
var nodes = this.findNodesHavingAttribute(node, attributeName);
if (nodes && nodes.length) {
return nodes[0];
}
},
findFirstNodeHavingAttributeWithValue: function (node, attributeName)
{
if (!node || !attributeName) {
return;
}
if (this.hasNodeAttributeWithValue(node, attributeName)) {
return node;
}
var nodes = this.findNodesHavingAttribute(node, attributeName);
if (!nodes || !nodes.length) {
return;
}
var index;
for (index = 0; index < nodes.length; index++) {
if (this.getAttributeValueFromNode(nodes[index], attributeName)) {
return nodes[index];
}
}
},
findNodesHavingCssClass: function (nodeToSearch, className, nodes)
{
if (!nodes) {
nodes = [];
}
if (!nodeToSearch || !className) {
return nodes;
}
if (nodeToSearch.getElementsByClassName) {
var foundNodes = nodeToSearch.getElementsByClassName(className);
return this.htmlCollectionToArray(foundNodes);
}
var children = getChildrenFromNode(nodeToSearch);
if (!children || !children.length) {
return [];
}
var index, child;
for (index = 0; index < children.length; index++) {
child = children[index];
if (this.hasNodeCssClass(child, className)) {
nodes.push(child);
}
nodes = this.findNodesHavingCssClass(child, className, nodes);
}
return nodes;
},
findFirstNodeHavingClass: function (node, className)
{
if (!node || !className) {
return;
}
if (this.hasNodeCssClass(node, className)) {
return node;
}
var nodes = this.findNodesHavingCssClass(node, className);
if (nodes && nodes.length) {
return nodes[0];
}
},
isLinkElement: function (node)
{
if (!node) {
return false;
}
var elementName = String(node.nodeName).toLowerCase();
var linkElementNames = ['a', 'area'];
var pos = indexOfArray(linkElementNames, elementName);
return pos !== -1;
},
setAnyAttribute: function (node, attrName, attrValue)
{
if (!node || !attrName) {
return;
}
if (node.setAttribute) {
node.setAttribute(attrName, attrValue);
} else {
node[attrName] = attrValue;
}
}
};
/************************************************************
* Content Tracking
************************************************************/
var content = {
CONTENT_ATTR: 'data-track-content',
2021-01-06 17:54:39 +01:00
CONTENT_CLASS: 'matomoTrackContent',
LEGACY_CONTENT_CLASS: 'piwikTrackContent',
2017-03-03 17:44:22 +01:00
CONTENT_NAME_ATTR: 'data-content-name',
CONTENT_PIECE_ATTR: 'data-content-piece',
2021-01-06 17:54:39 +01:00
CONTENT_PIECE_CLASS: 'matomoContentPiece',
LEGACY_CONTENT_PIECE_CLASS: 'piwikContentPiece',
2017-03-03 17:44:22 +01:00
CONTENT_TARGET_ATTR: 'data-content-target',
2021-01-06 17:54:39 +01:00
CONTENT_TARGET_CLASS: 'matomoContentTarget',
LEGACY_CONTENT_TARGET_CLASS: 'piwikContentTarget',
2017-03-03 17:44:22 +01:00
CONTENT_IGNOREINTERACTION_ATTR: 'data-content-ignoreinteraction',
2021-01-06 17:54:39 +01:00
CONTENT_IGNOREINTERACTION_CLASS: 'matomoContentIgnoreInteraction',
LEGACY_CONTENT_IGNOREINTERACTION_CLASS: 'piwikContentIgnoreInteraction',
2017-03-03 17:44:22 +01:00
location: undefined,
findContentNodes: function ()
{
var cssSelector = '.' + this.CONTENT_CLASS;
2021-01-06 17:54:39 +01:00
var cssSelector2 = '.' + this.LEGACY_CONTENT_CLASS;
2017-03-03 17:44:22 +01:00
var attrSelector = '[' + this.CONTENT_ATTR + ']';
2021-01-06 17:54:39 +01:00
var contentNodes = query.findMultiple([cssSelector, cssSelector2, attrSelector]);
2017-03-03 17:44:22 +01:00
return contentNodes;
},
findContentNodesWithinNode: function (node)
{
if (!node) {
return [];
}
// NOTE: we do not use query.findMultiple here as querySelectorAll would most likely not deliver the result we want
var nodes1 = query.findNodesHavingCssClass(node, this.CONTENT_CLASS);
2021-01-06 17:54:39 +01:00
nodes1 = query.findNodesHavingCssClass(node, this.LEGACY_CONTENT_CLASS, nodes1);
2017-03-03 17:44:22 +01:00
var nodes2 = query.findNodesHavingAttribute(node, this.CONTENT_ATTR);
if (nodes2 && nodes2.length) {
var index;
for (index = 0; index < nodes2.length; index++) {
nodes1.push(nodes2[index]);
}
}
if (query.hasNodeAttribute(node, this.CONTENT_ATTR)) {
nodes1.push(node);
} else if (query.hasNodeCssClass(node, this.CONTENT_CLASS)) {
nodes1.push(node);
2021-01-06 17:54:39 +01:00
} else if (query.hasNodeCssClass(node, this.LEGACY_CONTENT_CLASS)) {
nodes1.push(node);
2017-03-03 17:44:22 +01:00
}
nodes1 = query.makeNodesUnique(nodes1);
return nodes1;
},
findParentContentNode: function (anyNode)
{
if (!anyNode) {
return;
}
var node = anyNode;
var counter = 0;
while (node && node !== documentAlias && node.parentNode) {
if (query.hasNodeAttribute(node, this.CONTENT_ATTR)) {
return node;
}
if (query.hasNodeCssClass(node, this.CONTENT_CLASS)) {
return node;
}
2021-01-06 17:54:39 +01:00
if (query.hasNodeCssClass(node, this.LEGACY_CONTENT_CLASS)) {
return node;
}
2017-03-03 17:44:22 +01:00
node = node.parentNode;
if (counter > 1000) {
break; // prevent loop, should not happen anyway but better we do this
}
counter++;
}
},
findPieceNode: function (node)
{
var contentPiece;
contentPiece = query.findFirstNodeHavingAttribute(node, this.CONTENT_PIECE_ATTR);
if (!contentPiece) {
contentPiece = query.findFirstNodeHavingClass(node, this.CONTENT_PIECE_CLASS);
}
2021-01-06 17:54:39 +01:00
if (!contentPiece) {
contentPiece = query.findFirstNodeHavingClass(node, this.LEGACY_CONTENT_PIECE_CLASS);
}
2017-03-03 17:44:22 +01:00
if (contentPiece) {
return contentPiece;
}
return node;
},
findTargetNodeNoDefault: function (node)
{
if (!node) {
return;
}
var target = query.findFirstNodeHavingAttributeWithValue(node, this.CONTENT_TARGET_ATTR);
if (target) {
return target;
}
target = query.findFirstNodeHavingAttribute(node, this.CONTENT_TARGET_ATTR);
if (target) {
return target;
}
target = query.findFirstNodeHavingClass(node, this.CONTENT_TARGET_CLASS);
if (target) {
return target;
}
2021-01-06 17:54:39 +01:00
target = query.findFirstNodeHavingClass(node, this.LEGACY_CONTENT_TARGET_CLASS);
if (target) {
return target;
}
2017-03-03 17:44:22 +01:00
},
findTargetNode: function (node)
{
var target = this.findTargetNodeNoDefault(node);
if (target) {
return target;
}
return node;
},
findContentName: function (node)
{
if (!node) {
return;
}
var nameNode = query.findFirstNodeHavingAttributeWithValue(node, this.CONTENT_NAME_ATTR);
if (nameNode) {
return query.getAttributeValueFromNode(nameNode, this.CONTENT_NAME_ATTR);
}
var contentPiece = this.findContentPiece(node);
if (contentPiece) {
return this.removeDomainIfIsInLink(contentPiece);
}
if (query.hasNodeAttributeWithValue(node, 'title')) {
return query.getAttributeValueFromNode(node, 'title');
}
var clickUrlNode = this.findPieceNode(node);
if (query.hasNodeAttributeWithValue(clickUrlNode, 'title')) {
return query.getAttributeValueFromNode(clickUrlNode, 'title');
}
var targetNode = this.findTargetNode(node);
if (query.hasNodeAttributeWithValue(targetNode, 'title')) {
return query.getAttributeValueFromNode(targetNode, 'title');
}
},
findContentPiece: function (node)
{
if (!node) {
return;
}
var nameNode = query.findFirstNodeHavingAttributeWithValue(node, this.CONTENT_PIECE_ATTR);
if (nameNode) {
return query.getAttributeValueFromNode(nameNode, this.CONTENT_PIECE_ATTR);
}
var contentNode = this.findPieceNode(node);
var media = this.findMediaUrlInNode(contentNode);
if (media) {
return this.toAbsoluteUrl(media);
}
},
findContentTarget: function (node)
{
if (!node) {
return;
}
var targetNode = this.findTargetNode(node);
if (query.hasNodeAttributeWithValue(targetNode, this.CONTENT_TARGET_ATTR)) {
return query.getAttributeValueFromNode(targetNode, this.CONTENT_TARGET_ATTR);
}
var href;
if (query.hasNodeAttributeWithValue(targetNode, 'href')) {
href = query.getAttributeValueFromNode(targetNode, 'href');
return this.toAbsoluteUrl(href);
}
var contentNode = this.findPieceNode(node);
if (query.hasNodeAttributeWithValue(contentNode, 'href')) {
href = query.getAttributeValueFromNode(contentNode, 'href');
return this.toAbsoluteUrl(href);
}
},
isSameDomain: function (url)
{
if (!url || !url.indexOf) {
return false;
}
if (0 === url.indexOf(this.getLocation().origin)) {
return true;
}
var posHost = url.indexOf(this.getLocation().host);
if (8 >= posHost && 0 <= posHost) {
return true;
}
return false;
},
removeDomainIfIsInLink: function (text)
{
// we will only remove if domain === location.origin meaning is not an outlink
var regexContainsProtocol = '^https?:\/\/[^\/]+';
var regexReplaceDomain = '^.*\/\/[^\/]+';
if (text &&
text.search &&
-1 !== text.search(new RegExp(regexContainsProtocol))
&& this.isSameDomain(text)) {
text = text.replace(new RegExp(regexReplaceDomain), '');
if (!text) {
text = '/';
}
}
return text;
},
findMediaUrlInNode: function (node)
{
if (!node) {
return;
}
var mediaElements = ['img', 'embed', 'video', 'audio'];
var elementName = node.nodeName.toLowerCase();
if (-1 !== indexOfArray(mediaElements, elementName) &&
query.findFirstNodeHavingAttributeWithValue(node, 'src')) {
var sourceNode = query.findFirstNodeHavingAttributeWithValue(node, 'src');
return query.getAttributeValueFromNode(sourceNode, 'src');
}
if (elementName === 'object' &&
query.hasNodeAttributeWithValue(node, 'data')) {
return query.getAttributeValueFromNode(node, 'data');
}
if (elementName === 'object') {
var params = query.findNodesByTagName(node, 'param');
if (params && params.length) {
var index;
for (index = 0; index < params.length; index++) {
if ('movie' === query.getAttributeValueFromNode(params[index], 'name') &&
query.hasNodeAttributeWithValue(params[index], 'value')) {
return query.getAttributeValueFromNode(params[index], 'value');
}
}
}
var embed = query.findNodesByTagName(node, 'embed');
if (embed && embed.length) {
return this.findMediaUrlInNode(embed[0]);
}
}
},
trim: function (text)
{
2021-01-06 17:54:39 +01:00
return trim(text);
2017-03-03 17:44:22 +01:00
},
isOrWasNodeInViewport: function (node)
{
if (!node || !node.getBoundingClientRect || node.nodeType !== 1) {
return true;
}
var rect = node.getBoundingClientRect();
var html = documentAlias.documentElement || {};
var wasVisible = rect.top < 0;
if (wasVisible && node.offsetTop) {
wasVisible = (node.offsetTop + rect.height) > 0;
}
var docWidth = html.clientWidth; // The clientWidth attribute returns the viewport width excluding the size of a rendered scroll bar
if (windowAlias.innerWidth && docWidth > windowAlias.innerWidth) {
docWidth = windowAlias.innerWidth; // The innerWidth attribute must return the viewport width including the size of a rendered scroll bar
}
var docHeight = html.clientHeight; // The clientWidth attribute returns the viewport width excluding the size of a rendered scroll bar
if (windowAlias.innerHeight && docHeight > windowAlias.innerHeight) {
docHeight = windowAlias.innerHeight; // The innerWidth attribute must return the viewport width including the size of a rendered scroll bar
}
return (
(rect.bottom > 0 || wasVisible) &&
rect.right > 0 &&
rect.left < docWidth &&
((rect.top < docHeight) || wasVisible) // rect.top < 0 we assume user has seen all the ones that are above the current viewport
);
},
isNodeVisible: function (node)
{
var isItVisible = isVisible(node);
var isInViewport = this.isOrWasNodeInViewport(node);
return isItVisible && isInViewport;
},
buildInteractionRequestParams: function (interaction, name, piece, target)
{
var params = '';
if (interaction) {
params += 'c_i='+ encodeWrapper(interaction);
}
if (name) {
if (params) {
params += '&';
}
params += 'c_n='+ encodeWrapper(name);
}
if (piece) {
if (params) {
params += '&';
}
params += 'c_p='+ encodeWrapper(piece);
}
if (target) {
if (params) {
params += '&';
}
params += 'c_t='+ encodeWrapper(target);
}
2021-01-06 17:54:39 +01:00
if (params) {
params += '&ca=1';
}
2017-03-03 17:44:22 +01:00
return params;
},
buildImpressionRequestParams: function (name, piece, target)
{
var params = 'c_n=' + encodeWrapper(name) +
'&c_p=' + encodeWrapper(piece);
if (target) {
params += '&c_t=' + encodeWrapper(target);
}
2021-01-06 17:54:39 +01:00
if (params) {
params += '&ca=1';
}
2017-03-03 17:44:22 +01:00
return params;
},
buildContentBlock: function (node)
{
if (!node) {
return;
}
var name = this.findContentName(node);
var piece = this.findContentPiece(node);
var target = this.findContentTarget(node);
name = this.trim(name);
piece = this.trim(piece);
target = this.trim(target);
return {
name: name || 'Unknown',
piece: piece || 'Unknown',
target: target || ''
};
},
collectContent: function (contentNodes)
{
if (!contentNodes || !contentNodes.length) {
return [];
}
var contents = [];
var index, contentBlock;
for (index = 0; index < contentNodes.length; index++) {
contentBlock = this.buildContentBlock(contentNodes[index]);
if (isDefined(contentBlock)) {
contents.push(contentBlock);
}
}
return contents;
},
setLocation: function (location)
{
this.location = location;
},
getLocation: function ()
{
var locationAlias = this.location || windowAlias.location;
if (!locationAlias.origin) {
locationAlias.origin = locationAlias.protocol + "//" + locationAlias.hostname + (locationAlias.port ? ':' + locationAlias.port: '');
}
return locationAlias;
},
toAbsoluteUrl: function (url)
{
if ((!url || String(url) !== url) && url !== '') {
// we only handle strings
return url;
}
if ('' === url) {
return this.getLocation().href;
}
// Eg //example.com/test.jpg
if (url.search(/^\/\//) !== -1) {
return this.getLocation().protocol + url;
}
// Eg http://example.com/test.jpg
if (url.search(/:\/\//) !== -1) {
return url;
}
// Eg #test.jpg
if (0 === url.indexOf('#')) {
return this.getLocation().origin + this.getLocation().pathname + url;
}
// Eg ?x=5
if (0 === url.indexOf('?')) {
return this.getLocation().origin + this.getLocation().pathname + url;
}
2021-01-06 17:54:39 +01:00
// Eg mailto:x@y.z tel:012345, ... market:... sms:..., javascript:... ecmascript: ... and many more
2017-03-03 17:44:22 +01:00
if (0 === url.search('^[a-zA-Z]{2,11}:')) {
return url;
}
// Eg /test.jpg
if (url.search(/^\//) !== -1) {
return this.getLocation().origin + url;
}
// Eg test.jpg
var regexMatchDir = '(.*\/)';
var base = this.getLocation().origin + this.getLocation().pathname.match(new RegExp(regexMatchDir))[0];
return base + url;
},
isUrlToCurrentDomain: function (url) {
var absoluteUrl = this.toAbsoluteUrl(url);
if (!absoluteUrl) {
return false;
}
var origin = this.getLocation().origin;
if (origin === absoluteUrl) {
return true;
}
if (0 === String(absoluteUrl).indexOf(origin)) {
if (':' === String(absoluteUrl).substr(origin.length, 1)) {
return false; // url has port whereas origin has not => different URL
}
return true;
}
return false;
},
setHrefAttribute: function (node, url)
{
if (!node || !url) {
return;
}
query.setAnyAttribute(node, 'href', url);
},
shouldIgnoreInteraction: function (targetNode)
{
2021-01-06 17:54:39 +01:00
if (query.hasNodeAttribute(targetNode, this.CONTENT_IGNOREINTERACTION_ATTR)) {
return true;
}
if (query.hasNodeCssClass(targetNode, this.CONTENT_IGNOREINTERACTION_CLASS)) {
return true;
}
if (query.hasNodeCssClass(targetNode, this.LEGACY_CONTENT_IGNOREINTERACTION_CLASS)) {
return true;
}
return false;
2017-03-03 17:44:22 +01:00
}
};
/************************************************************
* Page Overlay
************************************************************/
2021-01-06 17:54:39 +01:00
function getMatomoUrlForOverlay(trackerUrl, apiUrl) {
2017-03-03 17:44:22 +01:00
if (apiUrl) {
return apiUrl;
}
2021-01-06 17:54:39 +01:00
trackerUrl = content.toAbsoluteUrl(trackerUrl);
2017-03-03 17:44:22 +01:00
// if eg http://www.example.com/js/tracker.php?version=232323 => http://www.example.com/js/tracker.php
if (stringContains(trackerUrl, '?')) {
var posQuery = trackerUrl.indexOf('?');
trackerUrl = trackerUrl.slice(0, posQuery);
}
2021-01-06 17:54:39 +01:00
if (stringEndsWith(trackerUrl, 'matomo.php')) {
// if eg without domain or path "matomo.php" => ''
trackerUrl = removeCharactersFromEndOfString(trackerUrl, 'matomo.php'.length);
} else if (stringEndsWith(trackerUrl, 'piwik.php')) {
2017-03-03 17:44:22 +01:00
// if eg without domain or path "piwik.php" => ''
trackerUrl = removeCharactersFromEndOfString(trackerUrl, 'piwik.php'.length);
} else if (stringEndsWith(trackerUrl, '.php')) {
2021-01-06 17:54:39 +01:00
// if eg http://www.example.com/js/matomo.php => http://www.example.com/js/
2017-03-03 17:44:22 +01:00
// or if eg http://www.example.com/tracker.php => http://www.example.com/
var lastSlash = trackerUrl.lastIndexOf('/');
var includeLastSlash = 1;
trackerUrl = trackerUrl.slice(0, lastSlash + includeLastSlash);
}
2021-01-06 17:54:39 +01:00
// if eg http://www.example.com/js/ => http://www.example.com/ (when not minified Matomo JS loaded)
2017-03-03 17:44:22 +01:00
if (stringEndsWith(trackerUrl, '/js/')) {
trackerUrl = removeCharactersFromEndOfString(trackerUrl, 'js/'.length);
}
// http://www.example.com/
return trackerUrl;
}
/*
* Check whether this is a page overlay session
*
* @return boolean
*
* {@internal side-effect: modifies window.name }}
*/
function isOverlaySession(configTrackerSiteId) {
2021-01-06 17:54:39 +01:00
var windowName = 'Matomo_Overlay';
2017-03-03 17:44:22 +01:00
2021-01-06 17:54:39 +01:00
// check whether we were redirected from the matomo overlay plugin
2017-03-03 17:44:22 +01:00
var referrerRegExp = new RegExp('index\\.php\\?module=Overlay&action=startOverlaySession'
+ '&idSite=([0-9]+)&period=([^&]+)&date=([^&]+)(&segment=.*)?$');
var match = referrerRegExp.exec(documentAlias.referrer);
if (match) {
// check idsite
var idsite = match[1];
if (idsite !== String(configTrackerSiteId)) {
return false;
}
// store overlay session info in window name
var period = match[2],
date = match[3],
segment = match[4];
if (!segment) {
segment = '';
} else if (segment.indexOf('&segment=') === 0) {
segment = segment.substr('&segment='.length);
}
windowAlias.name = windowName + '###' + period + '###' + date + '###' + segment;
}
// retrieve and check data from window name
var windowNameParts = windowAlias.name.split('###');
return windowNameParts.length === 4 && windowNameParts[0] === windowName;
}
/*
* Inject the script needed for page overlay
*/
function injectOverlayScripts(configTrackerUrl, configApiUrl, configTrackerSiteId) {
var windowNameParts = windowAlias.name.split('###'),
period = windowNameParts[1],
date = windowNameParts[2],
segment = windowNameParts[3],
2021-01-06 17:54:39 +01:00
matomoUrl = getMatomoUrlForOverlay(configTrackerUrl, configApiUrl);
2017-03-03 17:44:22 +01:00
loadScript(
2021-01-06 17:54:39 +01:00
matomoUrl + 'plugins/Overlay/client/client.js?v=1',
2017-03-03 17:44:22 +01:00
function () {
2021-01-06 17:54:39 +01:00
Matomo_Overlay_Client.initialize(matomoUrl, configTrackerSiteId, period, date, segment);
2017-03-03 17:44:22 +01:00
}
);
}
function isInsideAnIframe () {
var frameElement;
try {
// If the parent window has another origin, then accessing frameElement
// throws an Error in IE. see issue #10105.
frameElement = windowAlias.frameElement;
} catch(e) {
// When there was an Error, then we know we are inside an iframe.
return true;
}
if (isDefined(frameElement)) {
return (frameElement && String(frameElement.nodeName).toLowerCase() === 'iframe') ? true : false;
}
try {
return windowAlias.self !== windowAlias.top;
} catch (e2) {
return true;
}
}
/************************************************************
* End Page Overlay
************************************************************/
/*
2021-01-06 17:54:39 +01:00
* Matomo Tracker class
2017-03-03 17:44:22 +01:00
*
* trackerUrl and trackerSiteId are optional arguments to the constructor
*
* See: Tracker.setTrackerUrl() and Tracker.setSiteId()
*/
function Tracker(trackerUrl, siteId) {
/************************************************************
* Private members
************************************************************/
var
/*<DEBUG>*/
/*
* registered test hooks
*/
registeredHooks = {},
/*</DEBUG>*/
trackerInstance = this,
2021-01-06 17:54:39 +01:00
// constants
CONSENT_COOKIE_NAME = 'mtm_consent',
COOKIE_CONSENT_COOKIE_NAME = 'mtm_cookie_consent',
CONSENT_REMOVED_COOKIE_NAME = 'mtm_consent_removed',
2017-03-03 17:44:22 +01:00
// Current URL and Referrer URL
locationArray = urlFixup(documentAlias.domain, windowAlias.location.href, getReferrer()),
domainAlias = domainFixup(locationArray[0]),
locationHrefAlias = safeDecodeWrapper(locationArray[1]),
configReferrerUrl = safeDecodeWrapper(locationArray[2]),
enableJSErrorTracking = false,
defaultRequestMethod = 'GET',
// Request method (GET or POST)
configRequestMethod = defaultRequestMethod,
defaultRequestContentType = 'application/x-www-form-urlencoded; charset=UTF-8',
// Request Content-Type header value; applicable when POST request method is used for submitting tracking events
configRequestContentType = defaultRequestContentType,
// Tracker URL
configTrackerUrl = trackerUrl || '',
// API URL (only set if it differs from the Tracker URL)
configApiUrl = '',
// This string is appended to the Tracker URL Request (eg. to send data that is not handled by the existing setters/getters)
configAppendToTrackingUrl = '',
// Site ID
configTrackerSiteId = siteId || '',
// User ID
configUserId = '',
// Visitor UUID
visitorUUID = '',
// Document URL
configCustomUrl,
// Document title
configTitle = '',
// Extensions to be treated as download links
2021-01-06 17:54:39 +01:00
configDownloadExtensions = ['7z','aac','apk','arc','arj','asf','asx','avi','azw3','bin','csv','deb','dmg','doc','docx','epub','exe','flv','gif','gz','gzip','hqx','ibooks','jar','jpg','jpeg','js','mobi','mp2','mp3','mp4','mpg','mpeg','mov','movie','msi','msp','odb','odf','odg','ods','odt','ogg','ogv','pdf','phps','png','ppt','pptx','qt','qtm','ra','ram','rar','rpm','rtf','sea','sit','tar','tbz','tbz2','bz','bz2','tgz','torrent','txt','wav','wma','wmv','wpd','xls','xlsx','xml','z','zip'],
2017-03-03 17:44:22 +01:00
// Hosts or alias(es) to not treat as outlinks
configHostsAlias = [domainAlias],
// HTML anchor element classes to not track
configIgnoreClasses = [],
// HTML anchor element classes to treat as downloads
configDownloadClasses = [],
// HTML anchor element classes to treat at outlinks
configLinkClasses = [],
// Maximum delay to wait for web bug image to be fetched (in milliseconds)
configTrackerPause = 500,
2021-01-06 17:54:39 +01:00
// If enabled, always use sendBeacon if the browser supports it
configAlwaysUseSendBeacon = true,
2017-03-03 17:44:22 +01:00
// Minimum visit time after initial page view (in milliseconds)
configMinimumVisitTime,
// Recurring heart beat after initial ping (in milliseconds)
configHeartBeatDelay,
// alias to circumvent circular function dependency (JSLint requires this)
heartBeatPingIfActivityAlias,
// Disallow hash tags in URL
configDiscardHashTag,
// Custom data
configCustomData,
// Campaign names
2021-01-06 17:54:39 +01:00
configCampaignNameParameters = [ 'pk_campaign', 'mtm_campaign', 'piwik_campaign', 'matomo_campaign', 'utm_campaign', 'utm_source', 'utm_medium' ],
2017-03-03 17:44:22 +01:00
// Campaign keywords
2021-01-06 17:54:39 +01:00
configCampaignKeywordParameters = [ 'pk_kwd', 'mtm_kwd', 'piwik_kwd', 'matomo_kwd', 'utm_term' ],
2017-03-03 17:44:22 +01:00
// First-party cookie name prefix
configCookieNamePrefix = '_pk_',
// the URL parameter that will store the visitorId if cross domain linking is enabled
// pk_vid = visitor ID
// first part of this URL parameter will be 16 char visitor Id.
// The second part is the 10 char current timestamp and the third and last part will be a 6 characters deviceId
// timestamp is needed to prevent reusing the visitorId when the URL is shared. The visitorId will be
// only reused if the timestamp is less than 45 seconds old.
// deviceId parameter is needed to prevent reusing the visitorId when the URL is shared. The visitorId
// will be only reused if the device is still the same when opening the link.
// VDI = visitor device identifier
configVisitorIdUrlParameter = 'pk_vid',
2021-01-06 17:54:39 +01:00
// Cross domain linking, the visitor ID is transmitted only in the 180 seconds following the click.
configVisitorIdUrlParameterTimeoutInSeconds = 180,
2017-03-03 17:44:22 +01:00
// First-party cookie domain
// User agent defaults to origin hostname
configCookieDomain,
// First-party cookie path
// Default is user agent defined.
configCookiePath,
2021-01-06 17:54:39 +01:00
// Whether to use "Secure" cookies that only work over SSL
configCookieIsSecure = false,
// Set SameSite attribute for cookies
configCookieSameSite = 'Lax',
2017-03-03 17:44:22 +01:00
// First-party cookies are disabled
configCookiesDisabled = false,
// Do Not Track
configDoNotTrack,
// Count sites which are pre-rendered
configCountPreRendered,
// Do we attribute the conversion to the first referrer or the most recent referrer?
configConversionAttributionFirstReferrer,
// Life of the visitor cookie (in milliseconds)
configVisitorCookieTimeout = 33955200000, // 13 months (365 days + 28days)
// Life of the session cookie (in milliseconds)
configSessionCookieTimeout = 1800000, // 30 minutes
// Life of the referral cookie (in milliseconds)
configReferralCookieTimeout = 15768000000, // 6 months
// Is performance tracking enabled
configPerformanceTrackingEnabled = true,
2021-01-06 17:54:39 +01:00
// will be set to true automatically once the onload event has finished
performanceAvailable = false,
// indicates if performance metrics for the page view have been sent with a request
performanceTracked = false,
2017-03-03 17:44:22 +01:00
// Whether Custom Variables scope "visit" should be stored in a cookie during the time of the visit
configStoreCustomVariablesInCookie = false,
// Custom Variables read from cookie, scope "visit"
customVariables = false,
configCustomRequestContentProcessing,
// Custom Variables, scope "page"
customVariablesPage = {},
// Custom Variables, scope "event"
customVariablesEvent = {},
// Custom Dimensions (can be any scope)
customDimensions = {},
// Custom Variables names and values are each truncated before being sent in the request or recorded in the cookie
customVariableMaximumLength = 200,
2021-01-06 17:54:39 +01:00
// Ecommerce product view
ecommerceProductView = {},
2017-03-03 17:44:22 +01:00
// Ecommerce items
ecommerceItems = {},
// Browser features via client-side data collection
browserFeatures = {},
// Keeps track of previously tracked content impressions
trackedContentImpressions = [],
isTrackOnlyVisibleContentEnabled = false,
// Guard to prevent empty visits see #6415. If there is a new visitor and the first 2 (or 3 or 4)
// tracking requests are at nearly same time (eg trackPageView and trackContentImpression) 2 or more
// visits will be created
timeNextTrackingRequestCanBeExecutedImmediately = false,
// Guard against installing the link tracker more than once per Tracker instance
linkTrackingInstalled = false,
linkTrackingEnabled = false,
crossDomainTrackingEnabled = false,
// Guard against installing the activity tracker more than once per Tracker instance
heartBeatSetUp = false,
// bool used to detect whether this browser window had focus at least once. So far we cannot really
2021-01-06 17:54:39 +01:00
// detect this 100% correct for an iframe so whenever Matomo is loaded inside an iframe we presume
2017-03-03 17:44:22 +01:00
// the window had focus at least once.
hadWindowFocusAtLeastOnce = isInsideAnIframe(),
2021-01-06 17:54:39 +01:00
timeWindowLastFocused = null,
2017-03-03 17:44:22 +01:00
2021-01-06 17:54:39 +01:00
// Timestamp of last tracker request sent to Matomo
2017-03-03 17:44:22 +01:00
lastTrackerRequestTime = null,
// Internal state of the pseudo click handler
lastButton,
lastTarget,
// Hash function
hash = sha1,
// Domain hash value
domainHash,
2021-01-06 17:54:39 +01:00
configIdPageView,
// we measure how many pageviews have been tracked so plugins can use it to eg detect if a
// pageview was already tracked or not
numTrackedPageviews = 0,
configCookiesToDelete = ['id', 'ses', 'cvar', 'ref'],
// whether requireConsent() was called or not
configConsentRequired = false,
// we always have the concept of consent. by default consent is assumed unless the end user removes it,
// or unless a matomo user explicitly requires consent (via requireConsent())
configHasConsent = null, // initialized below
// holds all pending tracking requests that have not been tracked because we need consent
consentRequestsQueue = [],
// a unique ID for this tracker during this request
uniqueTrackerId = trackerIdCounter++,
// whether a tracking request has been sent yet during this page view
hasSentTrackingRequestYet = false;
2017-03-03 17:44:22 +01:00
// Document title
try {
configTitle = documentAlias.title;
} catch(e) {
configTitle = '';
}
/*
* Set cookie value
*/
2021-01-06 17:54:39 +01:00
function setCookie(cookieName, value, msToExpire, path, domain, isSecure, sameSite) {
if (configCookiesDisabled && cookieName !== CONSENT_REMOVED_COOKIE_NAME) {
2017-03-03 17:44:22 +01:00
return;
}
var expiryDate;
// relative time to expire in milliseconds
if (msToExpire) {
expiryDate = new Date();
expiryDate.setTime(expiryDate.getTime() + msToExpire);
}
2021-01-06 17:54:39 +01:00
if (!sameSite) {
sameSite = 'Lax';
}
2017-03-03 17:44:22 +01:00
documentAlias.cookie = cookieName + '=' + encodeWrapper(value) +
(msToExpire ? ';expires=' + expiryDate.toGMTString() : '') +
';path=' + (path || '/') +
(domain ? ';domain=' + domain : '') +
2021-01-06 17:54:39 +01:00
(isSecure ? ';secure' : '') +
';SameSite=' + sameSite;
2017-03-03 17:44:22 +01:00
}
/*
* Get cookie value
*/
function getCookie(cookieName) {
if (configCookiesDisabled) {
return 0;
}
var cookiePattern = new RegExp('(^|;)[ ]*' + cookieName + '=([^;]*)'),
cookieMatch = cookiePattern.exec(documentAlias.cookie);
return cookieMatch ? decodeWrapper(cookieMatch[2]) : 0;
}
2021-01-06 17:54:39 +01:00
configHasConsent = !getCookie(CONSENT_REMOVED_COOKIE_NAME);
2017-03-03 17:44:22 +01:00
/*
* Removes hash tag from the URL
*
* URLs are purified before being recorded in the cookie,
* or before being sent as GET parameters
*/
function purify(url) {
var targetPattern;
2021-01-06 17:54:39 +01:00
// we need to remove this parameter here, they wouldn't be removed in Matomo tracker otherwise eg
2017-03-03 17:44:22 +01:00
// for outlinks or referrers
url = removeUrlParameter(url, configVisitorIdUrlParameter);
if (configDiscardHashTag) {
targetPattern = new RegExp('#.*');
return url.replace(targetPattern, '');
}
return url;
}
/*
* Resolve relative reference
*
* Note: not as described in rfc3986 section 5.2
*/
function resolveRelativeReference(baseUrl, url) {
var protocol = getProtocolScheme(url),
i;
if (protocol) {
return url;
}
if (url.slice(0, 1) === '/') {
return getProtocolScheme(baseUrl) + '://' + getHostName(baseUrl) + url;
}
baseUrl = purify(baseUrl);
i = baseUrl.indexOf('?');
if (i >= 0) {
baseUrl = baseUrl.slice(0, i);
}
i = baseUrl.lastIndexOf('/');
if (i !== baseUrl.length - 1) {
baseUrl = baseUrl.slice(0, i + 1);
}
return baseUrl + url;
}
function isSameHost (hostName, alias) {
var offset;
hostName = String(hostName).toLowerCase();
alias = String(alias).toLowerCase();
if (hostName === alias) {
return true;
}
if (alias.slice(0, 1) === '.') {
if (hostName === alias.slice(1)) {
return true;
}
offset = hostName.length - alias.length;
if ((offset > 0) && (hostName.slice(offset) === alias)) {
return true;
}
}
return false;
}
/*
* Extract pathname from URL. element.pathname is actually supported by pretty much all browsers including
* IE6 apart from some rare very old ones
*/
function getPathName(url) {
var parser = document.createElement('a');
if (url.indexOf('//') !== 0 && url.indexOf('http') !== 0) {
if (url.indexOf('*') === 0) {
url = url.substr(1);
}
if (url.indexOf('.') === 0) {
url = url.substr(1);
}
url = 'http://' + url;
}
parser.href = content.toAbsoluteUrl(url);
if (parser.pathname) {
return parser.pathname;
}
return '';
}
function isSitePath (path, pathAlias)
{
if(!stringStartsWith(pathAlias, '/')) {
pathAlias = '/' + pathAlias;
}
if(!stringStartsWith(path, '/')) {
path = '/' + path;
}
var matchesAnyPath = (pathAlias === '/' || pathAlias === '/*');
if (matchesAnyPath) {
return true;
}
if (path === pathAlias) {
return true;
}
pathAlias = String(pathAlias).toLowerCase();
path = String(path).toLowerCase();
// wildcard path support
if(stringEndsWith(pathAlias, '*')) {
// remove the final '*' before comparing
pathAlias = pathAlias.slice(0, -1);
// Note: this is almost duplicated from just few lines above
matchesAnyPath = (!pathAlias || pathAlias === '/');
if (matchesAnyPath) {
return true;
}
if (path === pathAlias) {
return true;
}
// wildcard match
return path.indexOf(pathAlias) === 0;
}
// we need to append slashes so /foobarbaz won't match a site /foobar
if (!stringEndsWith(path, '/')) {
path += '/';
}
if (!stringEndsWith(pathAlias, '/')) {
pathAlias += '/';
}
return path.indexOf(pathAlias) === 0;
}
/**
* Whether the specified domain name and path belong to any of the alias domains (eg. set via setDomains).
*
* Note: this function is used to determine whether a click on a URL will be considered an "Outlink".
*
* @param host
* @param path
* @returns {boolean}
*/
function isSiteHostPath(host, path)
{
var i,
alias,
configAlias,
aliasHost,
aliasPath;
for (i = 0; i < configHostsAlias.length; i++) {
aliasHost = domainFixup(configHostsAlias[i]);
aliasPath = getPathName(configHostsAlias[i]);
if (isSameHost(host, aliasHost) && isSitePath(path, aliasPath)) {
return true;
}
}
return false;
}
/*
* Is the host local? (i.e., not an outlink)
*/
function isSiteHostName(hostName) {
var i,
alias,
offset;
for (i = 0; i < configHostsAlias.length; i++) {
alias = domainFixup(configHostsAlias[i].toLowerCase());
if (hostName === alias) {
return true;
}
if (alias.slice(0, 1) === '.') {
if (hostName === alias.slice(1)) {
return true;
}
offset = hostName.length - alias.length;
if ((offset > 0) && (hostName.slice(offset) === alias)) {
return true;
}
}
}
return false;
}
/*
2021-01-06 17:54:39 +01:00
* Send image request to Matomo server using GET.
2017-03-03 17:44:22 +01:00
* The infamous web bug (or beacon) is a transparent, single pixel (1x1) image
*/
function getImage(request, callback) {
2021-01-06 17:54:39 +01:00
// make sure to actually load an image so callback gets invoked
request = request.replace("send_image=0","send_image=1");
2017-03-03 17:44:22 +01:00
2021-01-06 17:54:39 +01:00
var image = new Image(1, 1);
2017-03-03 17:44:22 +01:00
image.onload = function () {
iterator = 0; // To avoid JSLint warning of empty block
2021-01-06 17:54:39 +01:00
if (typeof callback === 'function') {
callback({request: request, trackerUrl: configTrackerUrl, success: true});
}
};
image.onerror = function () {
if (typeof callback === 'function') {
callback({request: request, trackerUrl: configTrackerUrl, success: false});
}
2017-03-03 17:44:22 +01:00
};
image.src = configTrackerUrl + (configTrackerUrl.indexOf('?') < 0 ? '?' : '&') + request;
}
2021-01-06 17:54:39 +01:00
function shouldForcePost(request)
{
if (configRequestMethod === 'POST') {
return true;
2017-03-03 17:44:22 +01:00
}
2021-01-06 17:54:39 +01:00
// we force long single request urls and bulk requests over post
return request && (request.length > 2000 || request.indexOf('{"requests"') === 0);
}
2017-03-03 17:44:22 +01:00
2021-01-06 17:54:39 +01:00
function supportsSendBeacon()
{
return 'object' === typeof navigatorAlias
&& 'function' === typeof navigatorAlias.sendBeacon
&& 'function' === typeof Blob;
}
2017-03-03 17:44:22 +01:00
2021-01-06 17:54:39 +01:00
function sendPostRequestViaSendBeacon(request, callback, fallbackToGet)
{
var isSupported = supportsSendBeacon();
2017-03-03 17:44:22 +01:00
2021-01-06 17:54:39 +01:00
if (!isSupported) {
return false;
2017-03-03 17:44:22 +01:00
}
2021-01-06 17:54:39 +01:00
var headers = {type: 'application/x-www-form-urlencoded; charset=UTF-8'};
var success = false;
2017-03-03 17:44:22 +01:00
2021-01-06 17:54:39 +01:00
var url = configTrackerUrl;
2017-03-03 17:44:22 +01:00
2021-01-06 17:54:39 +01:00
try {
var blob = new Blob([request], headers);
if (fallbackToGet && !shouldForcePost(request)) {
blob = new Blob([], headers);
url = url + (url.indexOf('?') < 0 ? '?' : '&') + request;
}
success = navigatorAlias.sendBeacon(url, blob);
// returns true if the user agent is able to successfully queue the data for transfer,
// Otherwise it returns false and we need to try the regular way
} catch (e) {
return false;
}
if (success && typeof callback === 'function') {
callback({request: request, trackerUrl: configTrackerUrl, success: true, isSendBeacon: true});
2017-03-03 17:44:22 +01:00
}
2021-01-06 17:54:39 +01:00
return success;
2017-03-03 17:44:22 +01:00
}
/*
2021-01-06 17:54:39 +01:00
* POST request to Matomo server using XMLHttpRequest.
2017-03-03 17:44:22 +01:00
*/
2021-01-06 17:54:39 +01:00
function sendXmlHttpRequest(request, callback, fallbackToGet) {
if (!isDefined(fallbackToGet) || null === fallbackToGet) {
fallbackToGet = true;
2017-03-03 17:44:22 +01:00
}
2021-01-06 17:54:39 +01:00
if (isPageUnloading && sendPostRequestViaSendBeacon(request, callback, fallbackToGet)) {
return;
}
2017-03-03 17:44:22 +01:00
2021-01-06 17:54:39 +01:00
setTimeout(function () {
// we execute it with a little delay in case the unload event occurred just after sending this request
// this is to avoid the following behaviour: Eg on form submit a tracking request is sent via POST
// in this method. Then a few ms later the browser wants to navigate to the new page and the unload
// event occurs and the browser cancels the just triggered POST request. This causes or fallback
// method to be triggered and we execute the same request again (either as fallbackGet or sendBeacon).
// The problem is that we do not know whether the initial POST request was already fully transferred
// to the server or not when the onreadystatechange callback is executed and we might execute the
// same request a second time. To avoid this, we delay the actual execution of this POST request just
// by 50ms which gives it usually enough time to detect the unload event in most cases.
2017-03-03 17:44:22 +01:00
2021-01-06 17:54:39 +01:00
if (isPageUnloading && sendPostRequestViaSendBeacon(request, callback, fallbackToGet)) {
2017-03-03 17:44:22 +01:00
return;
}
2021-01-06 17:54:39 +01:00
var sentViaBeacon;
2017-03-03 17:44:22 +01:00
2021-01-06 17:54:39 +01:00
try {
// we use the progid Microsoft.XMLHTTP because
// IE5.5 included MSXML 2.5; the progid MSXML2.XMLHTTP
// is pinned to MSXML2.XMLHTTP.3.0
var xhr = windowAlias.XMLHttpRequest
? new windowAlias.XMLHttpRequest()
: windowAlias.ActiveXObject
? new ActiveXObject('Microsoft.XMLHTTP')
: null;
xhr.open('POST', configTrackerUrl, true);
// fallback on error
xhr.onreadystatechange = function () {
if (this.readyState === 4 && !(this.status >= 200 && this.status < 300)) {
var sentViaBeacon = isPageUnloading && sendPostRequestViaSendBeacon(request, callback, fallbackToGet);
if (!sentViaBeacon && fallbackToGet) {
getImage(request, callback);
} else if (typeof callback === 'function') {
callback({request: request, trackerUrl: configTrackerUrl, success: false, xhr: this});
}
} else {
if (this.readyState === 4 && (typeof callback === 'function')) {
callback({request: request, trackerUrl: configTrackerUrl, success: true, xhr: this});
}
}
};
xhr.setRequestHeader('Content-Type', configRequestContentType);
xhr.withCredentials = true;
xhr.send(request);
} catch (e) {
sentViaBeacon = isPageUnloading && sendPostRequestViaSendBeacon(request, callback, fallbackToGet);
if (!sentViaBeacon && fallbackToGet) {
getImage(request, callback);
} else if (typeof callback === 'function') {
callback({request: request, trackerUrl: configTrackerUrl, success: false});
}
2017-03-03 17:44:22 +01:00
}
2021-01-06 17:54:39 +01:00
}, 50);
2017-03-03 17:44:22 +01:00
}
2021-01-06 17:54:39 +01:00
function setExpireDateTime(delay) {
var now = new Date();
var time = now.getTime() + delay;
2017-03-03 17:44:22 +01:00
2021-01-06 17:54:39 +01:00
if (!expireDateTime || time > expireDateTime) {
expireDateTime = time;
}
2017-03-03 17:44:22 +01:00
}
function heartBeatOnFocus() {
hadWindowFocusAtLeastOnce = true;
2021-01-06 17:54:39 +01:00
timeWindowLastFocused = new Date().getTime();
}
2017-03-03 17:44:22 +01:00
2021-01-06 17:54:39 +01:00
function hadWindowMinimalFocusToConsiderViewed() {
// we ping on blur or unload only if user was active for more than configHeartBeatDelay seconds on
// the page otherwise we can assume user was not really on the page and for example only switching
// through tabs
var now = new Date().getTime();
return !timeWindowLastFocused || (now - timeWindowLastFocused) > configHeartBeatDelay;
2017-03-03 17:44:22 +01:00
}
function heartBeatOnBlur() {
2021-01-06 17:54:39 +01:00
if (hadWindowMinimalFocusToConsiderViewed()) {
heartBeatPingIfActivityAlias();
}
2017-03-03 17:44:22 +01:00
}
/*
* Setup event handlers and timeout for initial heart beat.
*/
function setUpHeartBeat() {
if (heartBeatSetUp
|| !configHeartBeatDelay
) {
return;
}
heartBeatSetUp = true;
addEventListener(windowAlias, 'focus', heartBeatOnFocus);
addEventListener(windowAlias, 'blur', heartBeatOnBlur);
2021-01-06 17:54:39 +01:00
// when using multiple trackers then we need to add this event for each tracker
coreHeartBeatCounter++;
Matomo.addPlugin('HeartBeat' + coreHeartBeatCounter, {
unload: function () {
// we can't remove the unload plugin event when disabling heart beat timer but we at least
// check if it is still enabled... note: when enabling heart beat, then disabling, then
// enabling then this could trigger two requests under circumstances maybe. it's edge case though
// we only send the heartbeat if onunload the user spent at least 15seconds since last focus
// or the configured heatbeat timer
if (heartBeatSetUp && hadWindowMinimalFocusToConsiderViewed()) {
heartBeatPingIfActivityAlias();
}
}
});
2017-03-03 17:44:22 +01:00
}
function makeSureThereIsAGapAfterFirstTrackingRequestToPreventMultipleVisitorCreation(callback)
{
var now = new Date();
var timeNow = now.getTime();
lastTrackerRequestTime = timeNow;
if (timeNextTrackingRequestCanBeExecutedImmediately && timeNow < timeNextTrackingRequestCanBeExecutedImmediately) {
// we are in the time frame shortly after the first request. we have to delay this request a bit to make sure
// a visitor has been created meanwhile.
var timeToWait = timeNextTrackingRequestCanBeExecutedImmediately - timeNow;
setTimeout(callback, timeToWait);
setExpireDateTime(timeToWait + 50); // set timeout is not necessarily executed at timeToWait so delay a bit more
timeNextTrackingRequestCanBeExecutedImmediately += 50; // delay next tracking request by further 50ms to next execute them at same time
return;
}
if (timeNextTrackingRequestCanBeExecutedImmediately === false) {
// it is the first request, we want to execute this one directly and delay all the next one(s) within a delay.
// All requests after this delay can be executed as usual again
var delayInMs = 800;
timeNextTrackingRequestCanBeExecutedImmediately = timeNow + delayInMs;
}
callback();
}
2021-01-06 17:54:39 +01:00
/*
* Check first-party cookies and update the <code>configHasConsent</code> value. Ensures that any
* change to the user opt-in/out status in another browser window will be respected.
*/
function refreshConsentStatus() {
if (getCookie(CONSENT_REMOVED_COOKIE_NAME)) {
configHasConsent = false;
} else if (getCookie(CONSENT_COOKIE_NAME)) {
configHasConsent = true;
}
}
2017-03-03 17:44:22 +01:00
/*
* Send request
*/
function sendRequest(request, delay, callback) {
2021-01-06 17:54:39 +01:00
refreshConsentStatus();
if (!configHasConsent) {
consentRequestsQueue.push(request);
return;
}
hasSentTrackingRequestYet = true;
2017-03-03 17:44:22 +01:00
if (!configDoNotTrack && request) {
2021-01-06 17:54:39 +01:00
if (configConsentRequired && configHasConsent) { // send a consent=1 when explicit consent is given for the apache logs
request += '&consent=1';
}
2017-03-03 17:44:22 +01:00
makeSureThereIsAGapAfterFirstTrackingRequestToPreventMultipleVisitorCreation(function () {
2021-01-06 17:54:39 +01:00
if (configAlwaysUseSendBeacon && sendPostRequestViaSendBeacon(request, callback, true)) {
setExpireDateTime(100);
return;
}
if (shouldForcePost(request)) {
2017-03-03 17:44:22 +01:00
sendXmlHttpRequest(request, callback);
} else {
getImage(request, callback);
}
setExpireDateTime(delay);
});
}
if (!heartBeatSetUp) {
setUpHeartBeat(); // setup window events too, but only once
}
}
function canSendBulkRequest(requests)
{
if (configDoNotTrack) {
return false;
}
return (requests && requests.length);
}
2021-01-06 17:54:39 +01:00
function arrayChunk(theArray, chunkSize)
{
if (!chunkSize || chunkSize >= theArray.length) {
return [theArray];
}
var index = 0;
var arrLength = theArray.length;
var chunks = [];
for (index; index < arrLength; index += chunkSize) {
chunks.push(theArray.slice(index, index + chunkSize));
}
return chunks;
}
2017-03-03 17:44:22 +01:00
/*
* Send requests using bulk
*/
function sendBulkRequest(requests, delay)
{
if (!canSendBulkRequest(requests)) {
return;
}
2021-01-06 17:54:39 +01:00
if (!configHasConsent) {
consentRequestsQueue.push(requests);
return;
}
hasSentTrackingRequestYet = true;
2017-03-03 17:44:22 +01:00
makeSureThereIsAGapAfterFirstTrackingRequestToPreventMultipleVisitorCreation(function () {
2021-01-06 17:54:39 +01:00
var chunks = arrayChunk(requests, 50);
var i = 0, bulk;
for (i; i < chunks.length; i++) {
bulk = '{"requests":["?' + chunks[i].join('","?') + '"]}';
if (configAlwaysUseSendBeacon && sendPostRequestViaSendBeacon(bulk, null, false)) {
// makes sure to load the next page faster by not waiting as long
// we apply this once we know send beacon works
setExpireDateTime(100);
} else {
sendXmlHttpRequest(bulk, null, false);
}
}
2017-03-03 17:44:22 +01:00
setExpireDateTime(delay);
});
}
/*
* Get cookie name with prefix and domain hash
*/
function getCookieName(baseName) {
2021-01-06 17:54:39 +01:00
// NOTE: If the cookie name is changed, we must also update the MatomoTracker.php which
2017-03-03 17:44:22 +01:00
// will attempt to discover first party cookies. eg. See the PHP Client method getVisitorId()
return configCookieNamePrefix + baseName + '.' + configTrackerSiteId + '.' + domainHash;
}
2021-01-06 17:54:39 +01:00
function deleteCookie(cookieName, path, domain) {
setCookie(cookieName, '', -86400, path, domain);
}
2017-03-03 17:44:22 +01:00
/*
* Does browser have cookies enabled (for this site)?
*/
function hasCookies() {
if (configCookiesDisabled) {
return '0';
}
2021-01-06 17:54:39 +01:00
if(!isDefined(windowAlias.showModalDialog) && isDefined(navigatorAlias.cookieEnabled)) {
return navigatorAlias.cookieEnabled ? '1' : '0';
2017-03-03 17:44:22 +01:00
}
2021-01-06 17:54:39 +01:00
// for IE we want to actually set the cookie to avoid trigger a warning eg in IE see #11507
var testCookieName = configCookieNamePrefix + 'testcookie';
setCookie(testCookieName, '1', undefined, configCookiePath, configCookieDomain, configCookieIsSecure, configCookieSameSite);
var hasCookie = getCookie(testCookieName) === '1' ? '1' : '0';
deleteCookie(testCookieName);
return hasCookie;
2017-03-03 17:44:22 +01:00
}
/*
* Update domain hash
*/
function updateDomainHash() {
domainHash = hash((configCookieDomain || domainAlias) + (configCookiePath || '/')).slice(0, 4); // 4 hexits = 16 bits
}
2021-01-06 17:54:39 +01:00
/*
* Browser features (plugins, resolution, cookies)
*/
function detectBrowserFeatures() {
if (isDefined(browserFeatures.res)) {
return browserFeatures;
}
var i,
mimeType,
pluginMap = {
// document types
pdf: 'application/pdf',
// media players
qt: 'video/quicktime',
realp: 'audio/x-pn-realaudio-plugin',
wma: 'application/x-mplayer2',
// interactive multimedia
fla: 'application/x-shockwave-flash',
// RIA
java: 'application/x-java-vm',
ag: 'application/x-silverlight'
};
// detect browser features except IE < 11 (IE 11 user agent is no longer MSIE)
if (!((new RegExp('MSIE')).test(navigatorAlias.userAgent))) {
// general plugin detection
if (navigatorAlias.mimeTypes && navigatorAlias.mimeTypes.length) {
for (i in pluginMap) {
if (Object.prototype.hasOwnProperty.call(pluginMap, i)) {
mimeType = navigatorAlias.mimeTypes[pluginMap[i]];
browserFeatures[i] = (mimeType && mimeType.enabledPlugin) ? '1' : '0';
}
}
}
// Safari and Opera
// IE6/IE7 navigator.javaEnabled can't be aliased, so test directly
// on Edge navigator.javaEnabled() always returns `true`, so ignore it
if (!((new RegExp('Edge[ /](\\d+[\\.\\d]+)')).test(navigatorAlias.userAgent)) &&
typeof navigator.javaEnabled !== 'unknown' &&
isDefined(navigatorAlias.javaEnabled) &&
navigatorAlias.javaEnabled()) {
browserFeatures.java = '1';
}
if (!isDefined(windowAlias.showModalDialog) && isDefined(navigatorAlias.cookieEnabled)) {
browserFeatures.cookie = navigatorAlias.cookieEnabled ? '1' : '0';
} else {
// Eg IE11 ... prevent error when cookieEnabled is requested within modal dialog. see #11507
browserFeatures.cookie = hasCookies();
}
}
var width = parseInt(screenAlias.width, 10);
var height = parseInt(screenAlias.height, 10);
browserFeatures.res = parseInt(width, 10) + 'x' + parseInt(height, 10);
return browserFeatures;
}
2017-03-03 17:44:22 +01:00
/*
* Inits the custom variables object
*/
function getCustomVariablesFromCookie() {
var cookieName = getCookieName('cvar'),
cookie = getCookie(cookieName);
2021-01-06 17:54:39 +01:00
if (cookie && cookie.length) {
cookie = windowAlias.JSON.parse(cookie);
2017-03-03 17:44:22 +01:00
if (isObject(cookie)) {
return cookie;
}
}
return {};
}
/*
* Lazy loads the custom variables from the cookie, only once during this page view
*/
function loadCustomVariables() {
if (customVariables === false) {
customVariables = getCustomVariablesFromCookie();
}
}
/*
* Generate a pseudo-unique ID to fingerprint this user
* 16 hexits = 64 bits
* note: this isn't a RFC4122-compliant UUID
*/
function generateRandomUuid() {
2021-01-06 17:54:39 +01:00
var browserFeatures = detectBrowserFeatures();
2017-03-03 17:44:22 +01:00
return hash(
(navigatorAlias.userAgent || '') +
(navigatorAlias.platform || '') +
2021-01-06 17:54:39 +01:00
windowAlias.JSON.stringify(browserFeatures) +
2017-03-03 17:44:22 +01:00
(new Date()).getTime() +
Math.random()
).slice(0, 16);
}
function generateBrowserSpecificId() {
2021-01-06 17:54:39 +01:00
var browserFeatures = detectBrowserFeatures();
2017-03-03 17:44:22 +01:00
return hash(
(navigatorAlias.userAgent || '') +
(navigatorAlias.platform || '') +
2021-01-06 17:54:39 +01:00
windowAlias.JSON.stringify(browserFeatures)).slice(0, 6);
2017-03-03 17:44:22 +01:00
}
function getCurrentTimestampInSeconds()
{
return Math.floor((new Date()).getTime() / 1000);
}
function makeCrossDomainDeviceId()
{
var timestamp = getCurrentTimestampInSeconds();
var browserId = generateBrowserSpecificId();
var deviceId = String(timestamp) + browserId;
return deviceId;
}
function isSameCrossDomainDevice(deviceIdFromUrl)
{
deviceIdFromUrl = String(deviceIdFromUrl);
var thisBrowserId = generateBrowserSpecificId();
var lengthBrowserId = thisBrowserId.length;
var browserIdInUrl = deviceIdFromUrl.substr(-1 * lengthBrowserId, lengthBrowserId);
var timestampInUrl = parseInt(deviceIdFromUrl.substr(0, deviceIdFromUrl.length - lengthBrowserId), 10);
if (timestampInUrl && browserIdInUrl && browserIdInUrl === thisBrowserId) {
// we only reuse visitorId when used on same device / browser
var currentTimestampInSeconds = getCurrentTimestampInSeconds();
2021-01-06 17:54:39 +01:00
if (configVisitorIdUrlParameterTimeoutInSeconds <= 0) {
return true;
}
2017-03-03 17:44:22 +01:00
if (currentTimestampInSeconds >= timestampInUrl
2021-01-06 17:54:39 +01:00
&& currentTimestampInSeconds <= (timestampInUrl + configVisitorIdUrlParameterTimeoutInSeconds)) {
// we only use visitorId if it was generated max 180 seconds ago
2017-03-03 17:44:22 +01:00
return true;
}
}
return false;
}
function getVisitorIdFromUrl(url) {
if (!crossDomainTrackingEnabled) {
return '';
}
// problem different timezone or when the time on the computer is not set correctly it may re-use
// the same visitorId again. therefore we also have a factor like hashed user agent to reduce possible
// activation of a visitorId on other device
var visitorIdParam = getUrlParameter(url, configVisitorIdUrlParameter);
if (!visitorIdParam) {
return '';
}
visitorIdParam = String(visitorIdParam);
var pattern = new RegExp("^[a-zA-Z0-9]+$");
if (visitorIdParam.length === 32 && pattern.test(visitorIdParam)) {
var visitorDevice = visitorIdParam.substr(16, 32);
if (isSameCrossDomainDevice(visitorDevice)) {
var visitorId = visitorIdParam.substr(0, 16);
return visitorId;
}
}
return '';
}
/*
* Load visitor ID cookie
*/
function loadVisitorIdCookie() {
if (!visitorUUID) {
// we are using locationHrefAlias and not currentUrl on purpose to for sure get the passed URL parameters
// from original URL
visitorUUID = getVisitorIdFromUrl(locationHrefAlias);
}
var now = new Date(),
nowTs = Math.round(now.getTime() / 1000),
visitorIdCookieName = getCookieName('id'),
id = getCookie(visitorIdCookieName),
cookieValue,
uuid;
// Visitor ID cookie found
if (id) {
cookieValue = id.split('.');
// returning visitor flag
cookieValue.unshift('0');
if(visitorUUID.length) {
cookieValue[1] = visitorUUID;
}
return cookieValue;
}
if(visitorUUID.length) {
uuid = visitorUUID;
} else if ('0' === hasCookies()){
uuid = '';
} else {
uuid = generateRandomUuid();
}
// No visitor ID cookie, let's create a new one
cookieValue = [
// new visitor
'1',
// uuid
uuid,
// creation timestamp - seconds since Unix epoch
2021-01-06 17:54:39 +01:00
nowTs
2017-03-03 17:44:22 +01:00
];
return cookieValue;
}
/**
* Loads the Visitor ID cookie and returns a named array of values
*/
function getValuesFromVisitorIdCookie() {
var cookieVisitorIdValue = loadVisitorIdCookie(),
newVisitor = cookieVisitorIdValue[0],
uuid = cookieVisitorIdValue[1],
2021-01-06 17:54:39 +01:00
createTs = cookieVisitorIdValue[2];
2017-03-03 17:44:22 +01:00
return {
newVisitor: newVisitor,
uuid: uuid,
2021-01-06 17:54:39 +01:00
createTs: createTs
2017-03-03 17:44:22 +01:00
};
}
function getRemainingVisitorCookieTimeout() {
var now = new Date(),
nowTs = now.getTime(),
cookieCreatedTs = getValuesFromVisitorIdCookie().createTs;
var createTs = parseInt(cookieCreatedTs, 10);
var originalTimeout = (createTs * 1000) + configVisitorCookieTimeout - nowTs;
return originalTimeout;
}
/*
* Sets the Visitor ID cookie
*/
function setVisitorIdCookie(visitorIdCookieValues) {
if(!configTrackerSiteId) {
// when called before Site ID was set
return;
}
var now = new Date(),
nowTs = Math.round(now.getTime() / 1000);
if(!isDefined(visitorIdCookieValues)) {
visitorIdCookieValues = getValuesFromVisitorIdCookie();
}
var cookieValue = visitorIdCookieValues.uuid + '.' +
2021-01-06 17:54:39 +01:00
visitorIdCookieValues.createTs + '.';
2017-03-03 17:44:22 +01:00
2021-01-06 17:54:39 +01:00
setCookie(getCookieName('id'), cookieValue, getRemainingVisitorCookieTimeout(), configCookiePath, configCookieDomain, configCookieIsSecure, configCookieSameSite);
2017-03-03 17:44:22 +01:00
}
/*
* Loads the referrer attribution information
*
* @returns array
* 0: campaign name
* 1: campaign keyword
* 2: timestamp
* 3: raw URL
*/
function loadReferrerAttributionCookie() {
// NOTE: if the format of the cookie changes,
// we must also update JS tests, PHP tracker, System tests,
// and notify other tracking clients (eg. Java) of the changes
var cookie = getCookie(getCookieName('ref'));
if (cookie.length) {
try {
2021-01-06 17:54:39 +01:00
cookie = windowAlias.JSON.parse(cookie);
2017-03-03 17:44:22 +01:00
if (isObject(cookie)) {
return cookie;
}
} catch (ignore) {
// Pre 1.3, this cookie was not JSON encoded
}
}
return [
'',
'',
0,
''
];
}
function isPossibleToSetCookieOnDomain(domainToTest)
{
var valueToSet = 'testvalue';
2021-01-06 17:54:39 +01:00
setCookie('test', valueToSet, 10000, null, domainToTest, configCookieIsSecure, configCookieSameSite);
2017-03-03 17:44:22 +01:00
if (getCookie('test') === valueToSet) {
deleteCookie('test', null, domainToTest);
return true;
}
return false;
}
function deleteCookies() {
var savedConfigCookiesDisabled = configCookiesDisabled;
// Temporarily allow cookies just to delete the existing ones
configCookiesDisabled = false;
var index, cookieName;
2021-01-06 17:54:39 +01:00
for (index = 0; index < configCookiesToDelete.length; index++) {
cookieName = getCookieName(configCookiesToDelete[index]);
if (cookieName !== CONSENT_REMOVED_COOKIE_NAME && cookieName !== CONSENT_COOKIE_NAME && 0 !== getCookie(cookieName)) {
2017-03-03 17:44:22 +01:00
deleteCookie(cookieName, configCookiePath, configCookieDomain);
}
}
configCookiesDisabled = savedConfigCookiesDisabled;
}
function setSiteId(siteId) {
configTrackerSiteId = siteId;
}
function sortObjectByKeys(value) {
if (!value || !isObject(value)) {
return;
}
// Object.keys(value) is not supported by all browsers, we get the keys manually
var keys = [];
var key;
for (key in value) {
if (Object.prototype.hasOwnProperty.call(value, key)) {
keys.push(key);
}
}
var normalized = {};
keys.sort();
var len = keys.length;
var i;
for (i = 0; i < len; i++) {
normalized[keys[i]] = value[keys[i]];
}
return normalized;
}
/**
* Creates the session cookie
*/
function setSessionCookie() {
2021-01-06 17:54:39 +01:00
setCookie(getCookieName('ses'), '1', configSessionCookieTimeout, configCookiePath, configCookieDomain, configCookieIsSecure, configCookieSameSite);
2017-03-03 17:44:22 +01:00
}
function generateUniqueId() {
var id = '';
var chars = 'abcdefghijklmnopqrstuvwxyz0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ';
var charLen = chars.length;
var i;
for (i = 0; i < 6; i++) {
id += chars.charAt(Math.floor(Math.random() * charLen));
}
return id;
}
2021-01-06 17:54:39 +01:00
function appendAvailablePerformanceMetrics(request) {
// note: there might be negative values because of browser bugs see https://github.com/matomo-org/matomo/pull/16516 in this case we ignore the values
var timings = '';
if (performanceAlias && performanceAlias.timing && performanceAlias
&& performanceAlias.timing.connectEnd && performanceAlias.timing.fetchStart) {
if (performanceAlias.timing.connectEnd < performanceAlias.timing.fetchStart) {
return;
}
timings += '&pf_net=' + (performanceAlias.timing.connectEnd - performanceAlias.timing.fetchStart);
}
if (performanceAlias && performanceAlias.timing && performanceAlias
&& performanceAlias.timing.responseStart && performanceAlias.timing.requestStart) {
if (performanceAlias.timing.responseStart < performanceAlias.timing.requestStart) {
return;
}
timings += '&pf_srv=' + (performanceAlias.timing.responseStart - performanceAlias.timing.requestStart);
}
if (performanceAlias && performanceAlias.timing && performanceAlias
&& performanceAlias.timing.responseStart && performanceAlias.timing.responseEnd) {
if (performanceAlias.timing.responseEnd < performanceAlias.timing.responseStart) {
return;
}
timings += '&pf_tfr=' + (performanceAlias.timing.responseEnd - performanceAlias.timing.responseStart);
}
if (performanceAlias && performanceAlias.timing && performanceAlias
&& performanceAlias.timing.domInteractive && performanceAlias.timing.domLoading) {
if (performanceAlias.timing.domInteractive < performanceAlias.timing.domLoading) {
return;
}
timings += '&pf_dm1=' + (performanceAlias.timing.domInteractive - performanceAlias.timing.domLoading);
}
if (performanceAlias && performanceAlias.timing && performanceAlias
&& performanceAlias.timing.domComplete && performanceAlias.timing.domInteractive) {
if (performanceAlias.timing.domComplete < performanceAlias.timing.domInteractive) {
return;
}
timings += '&pf_dm2=' + (performanceAlias.timing.domComplete - performanceAlias.timing.domInteractive);
}
if (performanceAlias && performanceAlias.timing && performanceAlias
&& performanceAlias.timing.loadEventEnd && performanceAlias.timing.loadEventStart) {
if (performanceAlias.timing.loadEventEnd < performanceAlias.timing.loadEventStart) {
return;
}
timings += '&pf_onl=' + (performanceAlias.timing.loadEventEnd - performanceAlias.timing.loadEventStart);
}
return request + timings;
}
2017-03-03 17:44:22 +01:00
/**
2021-01-06 17:54:39 +01:00
* Returns the URL to call matomo.php,
2017-03-03 17:44:22 +01:00
* with the standard parameters (plugins, resolution, url, referrer, etc.).
* Sends the pageview and browser settings with every request in case of race conditions.
*/
2021-01-06 17:54:39 +01:00
function getRequest(request, customData, pluginMethod) {
2017-03-03 17:44:22 +01:00
var i,
now = new Date(),
nowTs = Math.round(now.getTime() / 1000),
referralTs,
referralUrl,
referralUrlMaxLength = 1024,
currentReferrerHostName,
originalReferrerHostName,
customVariablesCopy = customVariables,
cookieSessionName = getCookieName('ses'),
cookieReferrerName = getCookieName('ref'),
cookieCustomVariablesName = getCookieName('cvar'),
cookieSessionValue = getCookie(cookieSessionName),
attributionCookie = loadReferrerAttributionCookie(),
currentUrl = configCustomUrl || locationHrefAlias,
campaignNameDetected,
campaignKeywordDetected;
if (configCookiesDisabled) {
deleteCookies();
}
if (configDoNotTrack) {
return '';
}
var cookieVisitorIdValues = getValuesFromVisitorIdCookie();
// send charset if document charset is not utf-8. sometimes encoding
// of urls will be the same as this and not utf-8, which will cause problems
2021-01-06 17:54:39 +01:00
// do not send charset if it is utf8 since it's assumed by default in Matomo
2017-03-03 17:44:22 +01:00
var charSet = documentAlias.characterSet || documentAlias.charset;
if (!charSet || charSet.toLowerCase() === 'utf-8') {
charSet = null;
}
campaignNameDetected = attributionCookie[0];
campaignKeywordDetected = attributionCookie[1];
referralTs = attributionCookie[2];
referralUrl = attributionCookie[3];
if (!cookieSessionValue) {
// cookie 'ses' was not found: we consider this the start of a 'session'
// Detect the campaign information from the current URL
// Only if campaign wasn't previously set
// Or if it was set but we must attribute to the most recent one
// Note: we are working on the currentUrl before purify() since we can parse the campaign parameters in the hash tag
if (!configConversionAttributionFirstReferrer
|| !campaignNameDetected.length) {
for (i in configCampaignNameParameters) {
if (Object.prototype.hasOwnProperty.call(configCampaignNameParameters, i)) {
campaignNameDetected = getUrlParameter(currentUrl, configCampaignNameParameters[i]);
if (campaignNameDetected.length) {
break;
}
}
}
for (i in configCampaignKeywordParameters) {
if (Object.prototype.hasOwnProperty.call(configCampaignKeywordParameters, i)) {
campaignKeywordDetected = getUrlParameter(currentUrl, configCampaignKeywordParameters[i]);
if (campaignKeywordDetected.length) {
break;
}
}
}
}
// Store the referrer URL and time in the cookie;
// referral URL depends on the first or last referrer attribution
currentReferrerHostName = getHostName(configReferrerUrl);
originalReferrerHostName = referralUrl.length ? getHostName(referralUrl) : '';
if (currentReferrerHostName.length && // there is a referrer
!isSiteHostName(currentReferrerHostName) && // domain is not the current domain
(!configConversionAttributionFirstReferrer || // attribute to last known referrer
2021-01-06 17:54:39 +01:00
!originalReferrerHostName.length || // previously empty
isSiteHostName(originalReferrerHostName))) { // previously set but in current domain
2017-03-03 17:44:22 +01:00
referralUrl = configReferrerUrl;
}
// Set the referral cookie if we have either a Referrer URL, or detected a Campaign (or both)
if (referralUrl.length
|| campaignNameDetected.length) {
referralTs = nowTs;
attributionCookie = [
campaignNameDetected,
campaignKeywordDetected,
referralTs,
purify(referralUrl.slice(0, referralUrlMaxLength))
];
2021-01-06 17:54:39 +01:00
setCookie(cookieReferrerName, windowAlias.JSON.stringify(attributionCookie), configReferralCookieTimeout, configCookiePath, configCookieDomain, configCookieIsSecure, configCookieSameSite);
2017-03-03 17:44:22 +01:00
}
}
// build out the rest of the request
request += '&idsite=' + configTrackerSiteId +
'&rec=1' +
'&r=' + String(Math.random()).slice(2, 8) + // keep the string to a minimum
'&h=' + now.getHours() + '&m=' + now.getMinutes() + '&s=' + now.getSeconds() +
'&url=' + encodeWrapper(purify(currentUrl)) +
(configReferrerUrl.length ? '&urlref=' + encodeWrapper(purify(configReferrerUrl)) : '') +
((configUserId && configUserId.length) ? '&uid=' + encodeWrapper(configUserId) : '') +
2021-01-06 17:54:39 +01:00
'&_id=' + cookieVisitorIdValues.uuid +
2017-03-03 17:44:22 +01:00
'&_idn=' + cookieVisitorIdValues.newVisitor + // currently unused
(campaignNameDetected.length ? '&_rcn=' + encodeWrapper(campaignNameDetected) : '') +
(campaignKeywordDetected.length ? '&_rck=' + encodeWrapper(campaignKeywordDetected) : '') +
'&_refts=' + referralTs +
(String(referralUrl).length ? '&_ref=' + encodeWrapper(purify(referralUrl.slice(0, referralUrlMaxLength))) : '') +
(charSet ? '&cs=' + encodeWrapper(charSet) : '') +
'&send_image=0';
2021-01-06 17:54:39 +01:00
var browserFeatures = detectBrowserFeatures();
2017-03-03 17:44:22 +01:00
// browser features
for (i in browserFeatures) {
if (Object.prototype.hasOwnProperty.call(browserFeatures, i)) {
request += '&' + i + '=' + browserFeatures[i];
}
}
var customDimensionIdsAlreadyHandled = [];
if (customData) {
for (i in customData) {
if (Object.prototype.hasOwnProperty.call(customData, i) && /^dimension\d+$/.test(i)) {
var index = i.replace('dimension', '');
customDimensionIdsAlreadyHandled.push(parseInt(index, 10));
customDimensionIdsAlreadyHandled.push(String(index));
2021-01-06 17:54:39 +01:00
request += '&' + i + '=' + encodeWrapper(customData[i]);
2017-03-03 17:44:22 +01:00
delete customData[i];
}
}
}
if (customData && isObjectEmpty(customData)) {
customData = null;
// we deleted all keys from custom data
}
2021-01-06 17:54:39 +01:00
// product page view
for (i in ecommerceProductView) {
if (Object.prototype.hasOwnProperty.call(ecommerceProductView, i)) {
request += '&' + i + '=' + encodeWrapper(ecommerceProductView[i]);
}
}
2017-03-03 17:44:22 +01:00
// custom dimensions
for (i in customDimensions) {
if (Object.prototype.hasOwnProperty.call(customDimensions, i)) {
var isNotSetYet = (-1 === indexOfArray(customDimensionIdsAlreadyHandled, i));
if (isNotSetYet) {
2021-01-06 17:54:39 +01:00
request += '&dimension' + i + '=' + encodeWrapper(customDimensions[i]);
2017-03-03 17:44:22 +01:00
}
}
}
// custom data
if (customData) {
2021-01-06 17:54:39 +01:00
request += '&data=' + encodeWrapper(windowAlias.JSON.stringify(customData));
2017-03-03 17:44:22 +01:00
} else if (configCustomData) {
2021-01-06 17:54:39 +01:00
request += '&data=' + encodeWrapper(windowAlias.JSON.stringify(configCustomData));
2017-03-03 17:44:22 +01:00
}
// Custom Variables, scope "page"
function appendCustomVariablesToRequest(customVariables, parameterName) {
2021-01-06 17:54:39 +01:00
var customVariablesStringified = windowAlias.JSON.stringify(customVariables);
2017-03-03 17:44:22 +01:00
if (customVariablesStringified.length > 2) {
return '&' + parameterName + '=' + encodeWrapper(customVariablesStringified);
}
return '';
}
var sortedCustomVarPage = sortObjectByKeys(customVariablesPage);
var sortedCustomVarEvent = sortObjectByKeys(customVariablesEvent);
request += appendCustomVariablesToRequest(sortedCustomVarPage, 'cvar');
request += appendCustomVariablesToRequest(sortedCustomVarEvent, 'e_cvar');
// Custom Variables, scope "visit"
if (customVariables) {
request += appendCustomVariablesToRequest(customVariables, '_cvar');
// Don't save deleted custom variables in the cookie
for (i in customVariablesCopy) {
if (Object.prototype.hasOwnProperty.call(customVariablesCopy, i)) {
if (customVariables[i][0] === '' || customVariables[i][1] === '') {
delete customVariables[i];
}
}
}
if (configStoreCustomVariablesInCookie) {
2021-01-06 17:54:39 +01:00
setCookie(cookieCustomVariablesName, windowAlias.JSON.stringify(customVariables), configSessionCookieTimeout, configCookiePath, configCookieDomain, configCookieIsSecure, configCookieSameSite);
2017-03-03 17:44:22 +01:00
}
}
// performance tracking
2021-01-06 17:54:39 +01:00
if (configPerformanceTrackingEnabled && performanceAvailable && !performanceTracked) {
request = appendAvailablePerformanceMetrics(request);
performanceTracked = true;
2017-03-03 17:44:22 +01:00
}
if (configIdPageView) {
request += '&pv_id=' + configIdPageView;
}
// update cookies
setVisitorIdCookie(cookieVisitorIdValues);
setSessionCookie();
// tracker plugin hook
request += executePluginMethod(pluginMethod, {tracker: trackerInstance, request: request});
if (configAppendToTrackingUrl.length) {
request += '&' + configAppendToTrackingUrl;
}
if (isFunction(configCustomRequestContentProcessing)) {
request = configCustomRequestContentProcessing(request);
}
return request;
}
/*
* If there was user activity since the last check, and it's been configHeartBeatDelay seconds
* since the last tracker, send a ping request (the heartbeat timeout will be reset by sendRequest).
*/
heartBeatPingIfActivityAlias = function heartBeatPingIfActivity() {
var now = new Date();
2021-01-06 17:54:39 +01:00
now = now.getTime();
if (!lastTrackerRequestTime) {
return false; // no tracking request was ever sent so lets not send heartbeat now
}
if (lastTrackerRequestTime + configHeartBeatDelay <= now) {
trackerInstance.ping();
2017-03-03 17:44:22 +01:00
return true;
}
return false;
};
function logEcommerce(orderId, grandTotal, subTotal, tax, shipping, discount) {
var request = 'idgoal=0',
now = new Date(),
items = [],
sku,
isEcommerceOrder = String(orderId).length;
if (isEcommerceOrder) {
request += '&ec_id=' + encodeWrapper(orderId);
}
request += '&revenue=' + grandTotal;
if (String(subTotal).length) {
request += '&ec_st=' + subTotal;
}
if (String(tax).length) {
request += '&ec_tx=' + tax;
}
if (String(shipping).length) {
request += '&ec_sh=' + shipping;
}
if (String(discount).length) {
request += '&ec_dt=' + discount;
}
if (ecommerceItems) {
// Removing the SKU index in the array before JSON encoding
for (sku in ecommerceItems) {
if (Object.prototype.hasOwnProperty.call(ecommerceItems, sku)) {
// Ensure name and category default to healthy value
if (!isDefined(ecommerceItems[sku][1])) {
ecommerceItems[sku][1] = "";
}
if (!isDefined(ecommerceItems[sku][2])) {
ecommerceItems[sku][2] = "";
}
// Set price to zero
if (!isDefined(ecommerceItems[sku][3])
|| String(ecommerceItems[sku][3]).length === 0) {
ecommerceItems[sku][3] = 0;
}
// Set quantity to 1
if (!isDefined(ecommerceItems[sku][4])
|| String(ecommerceItems[sku][4]).length === 0) {
ecommerceItems[sku][4] = 1;
}
items.push(ecommerceItems[sku]);
}
}
2021-01-06 17:54:39 +01:00
request += '&ec_items=' + encodeWrapper(windowAlias.JSON.stringify(items));
2017-03-03 17:44:22 +01:00
}
2021-01-06 17:54:39 +01:00
request = getRequest(request, configCustomData, 'ecommerce');
2017-03-03 17:44:22 +01:00
sendRequest(request, configTrackerPause);
if (isEcommerceOrder) {
ecommerceItems = {};
}
}
function logEcommerceOrder(orderId, grandTotal, subTotal, tax, shipping, discount) {
if (String(orderId).length
&& isDefined(grandTotal)) {
logEcommerce(orderId, grandTotal, subTotal, tax, shipping, discount);
}
}
function logEcommerceCartUpdate(grandTotal) {
if (isDefined(grandTotal)) {
logEcommerce("", grandTotal, "", "", "", "");
}
}
/*
* Log the page view / visit
*/
function logPageView(customTitle, customData, callback) {
configIdPageView = generateUniqueId();
var request = getRequest('action_name=' + encodeWrapper(titleFixup(customTitle || configTitle)), customData, 'log');
2021-01-06 17:54:39 +01:00
// append already available performance metrics if they were not already tracked (or appended)
if (!performanceTracked) {
request = appendAvailablePerformanceMetrics(request);
}
2017-03-03 17:44:22 +01:00
sendRequest(request, configTrackerPause, callback);
}
/*
* Construct regular expression of classes
*/
function getClassesRegExp(configClasses, defaultClass) {
var i,
2021-01-06 17:54:39 +01:00
classesRegExp = '(^| )(piwik[_-]' + defaultClass + '|matomo[_-]' + defaultClass;
2017-03-03 17:44:22 +01:00
if (configClasses) {
for (i = 0; i < configClasses.length; i++) {
classesRegExp += '|' + configClasses[i];
}
}
classesRegExp += ')( |$)';
return new RegExp(classesRegExp);
}
function startsUrlWithTrackerUrl(url) {
return (configTrackerUrl && url && 0 === String(url).indexOf(configTrackerUrl));
}
/*
* Link or Download?
*/
function getLinkType(className, href, isInLink, hasDownloadAttribute) {
if (startsUrlWithTrackerUrl(href)) {
return 0;
}
// does class indicate whether it is an (explicit/forced) outlink or a download?
var downloadPattern = getClassesRegExp(configDownloadClasses, 'download'),
linkPattern = getClassesRegExp(configLinkClasses, 'link'),
// does file extension indicate that it is a download?
downloadExtensionsPattern = new RegExp('\\.(' + configDownloadExtensions.join('|') + ')([?&#]|$)', 'i');
if (linkPattern.test(className)) {
return 'link';
}
if (hasDownloadAttribute || downloadPattern.test(className) || downloadExtensionsPattern.test(href)) {
return 'download';
}
if (isInLink) {
return 0;
}
return 'link';
}
function getSourceElement(sourceElement)
{
var parentElement;
parentElement = sourceElement.parentNode;
while (parentElement !== null &&
/* buggy IE5.5 */
isDefined(parentElement)) {
if (query.isLinkElement(sourceElement)) {
break;
}
sourceElement = parentElement;
parentElement = sourceElement.parentNode;
}
return sourceElement;
}
function getLinkIfShouldBeProcessed(sourceElement)
{
sourceElement = getSourceElement(sourceElement);
if (!query.hasNodeAttribute(sourceElement, 'href')) {
return;
}
if (!isDefined(sourceElement.href)) {
return;
}
var href = query.getAttributeValueFromNode(sourceElement, 'href');
var originalSourcePath = sourceElement.pathname || getPathName(sourceElement.href);
// browsers, such as Safari, don't downcase hostname and href
var originalSourceHostName = sourceElement.hostname || getHostName(sourceElement.href);
var sourceHostName = originalSourceHostName.toLowerCase();
var sourceHref = sourceElement.href.replace(originalSourceHostName, sourceHostName);
// browsers, such as Safari, don't downcase hostname and href
var scriptProtocol = new RegExp('^(javascript|vbscript|jscript|mocha|livescript|ecmascript|mailto|tel):', 'i');
if (!scriptProtocol.test(sourceHref)) {
// track outlinks and all downloads
var linkType = getLinkType(sourceElement.className, sourceHref, isSiteHostPath(sourceHostName, originalSourcePath), query.hasNodeAttribute(sourceElement, 'download'));
if (linkType) {
return {
type: linkType,
href: sourceHref
};
}
}
}
function buildContentInteractionRequest(interaction, name, piece, target)
{
var params = content.buildInteractionRequestParams(interaction, name, piece, target);
if (!params) {
return;
}
return getRequest(params, null, 'contentInteraction');
}
function isNodeAuthorizedToTriggerInteraction(contentNode, interactedNode)
{
if (!contentNode || !interactedNode) {
return false;
}
var targetNode = content.findTargetNode(contentNode);
if (content.shouldIgnoreInteraction(targetNode)) {
// interaction should be ignored
return false;
}
targetNode = content.findTargetNodeNoDefault(contentNode);
if (targetNode && !containsNodeElement(targetNode, interactedNode)) {
/**
* There is a target node defined but the clicked element is not within the target node. example:
* <div data-track-content><a href="Y" data-content-target>Y</a><img src=""/><a href="Z">Z</a></div>
*
* The user clicked in this case on link Z and not on target Y
*/
return false;
}
return true;
}
function getContentInteractionToRequestIfPossible (anyNode, interaction, fallbackTarget)
{
if (!anyNode) {
return;
}
var contentNode = content.findParentContentNode(anyNode);
if (!contentNode) {
// we are not within a content block
return;
}
if (!isNodeAuthorizedToTriggerInteraction(contentNode, anyNode)) {
return;
}
var contentBlock = content.buildContentBlock(contentNode);
if (!contentBlock) {
return;
}
if (!contentBlock.target && fallbackTarget) {
contentBlock.target = fallbackTarget;
}
return content.buildInteractionRequestParams(interaction, contentBlock.name, contentBlock.piece, contentBlock.target);
}
function wasContentImpressionAlreadyTracked(contentBlock)
{
if (!trackedContentImpressions || !trackedContentImpressions.length) {
return false;
}
var index, trackedContent;
for (index = 0; index < trackedContentImpressions.length; index++) {
trackedContent = trackedContentImpressions[index];
if (trackedContent &&
trackedContent.name === contentBlock.name &&
trackedContent.piece === contentBlock.piece &&
trackedContent.target === contentBlock.target) {
return true;
}
}
return false;
}
function trackContentImpressionClickInteraction (targetNode)
{
return function (event) {
if (!targetNode) {
return;
}
var contentBlock = content.findParentContentNode(targetNode);
var interactedElement;
if (event) {
interactedElement = event.target || event.srcElement;
}
if (!interactedElement) {
interactedElement = targetNode;
}
if (!isNodeAuthorizedToTriggerInteraction(contentBlock, interactedElement)) {
return;
}
2021-01-06 17:54:39 +01:00
if (!contentBlock) {
return false;
2017-03-03 17:44:22 +01:00
}
2021-01-06 17:54:39 +01:00
var theTargetNode = content.findTargetNode(contentBlock);
2017-03-03 17:44:22 +01:00
2021-01-06 17:54:39 +01:00
if (!theTargetNode || content.shouldIgnoreInteraction(theTargetNode)) {
return false;
2017-03-03 17:44:22 +01:00
}
2021-01-06 17:54:39 +01:00
var link = getLinkIfShouldBeProcessed(theTargetNode);
2017-03-03 17:44:22 +01:00
2021-01-06 17:54:39 +01:00
if (linkTrackingEnabled && link && link.type) {
return link.type; // will be handled via outlink or download.
2017-03-03 17:44:22 +01:00
}
2021-01-06 17:54:39 +01:00
return trackerInstance.trackContentInteractionNode(interactedElement, 'click');
2017-03-03 17:44:22 +01:00
};
}
function setupInteractionsTracking(contentNodes)
{
if (!contentNodes || !contentNodes.length) {
return;
}
var index, targetNode;
for (index = 0; index < contentNodes.length; index++) {
targetNode = content.findTargetNode(contentNodes[index]);
if (targetNode && !targetNode.contentInteractionTrackingSetupDone) {
targetNode.contentInteractionTrackingSetupDone = true;
addEventListener(targetNode, 'click', trackContentImpressionClickInteraction(targetNode));
}
}
}
/*
* Log all content pieces
*/
function buildContentImpressionsRequests(contents, contentNodes)
{
if (!contents || !contents.length) {
return [];
}
var index, request;
for (index = 0; index < contents.length; index++) {
if (wasContentImpressionAlreadyTracked(contents[index])) {
contents.splice(index, 1);
index--;
} else {
trackedContentImpressions.push(contents[index]);
}
}
if (!contents || !contents.length) {
return [];
}
setupInteractionsTracking(contentNodes);
var requests = [];
for (index = 0; index < contents.length; index++) {
request = getRequest(
content.buildImpressionRequestParams(contents[index].name, contents[index].piece, contents[index].target),
undefined,
'contentImpressions'
);
if (request) {
requests.push(request);
}
}
return requests;
}
/*
* Log all content pieces
*/
function getContentImpressionsRequestsFromNodes(contentNodes)
{
var contents = content.collectContent(contentNodes);
return buildContentImpressionsRequests(contents, contentNodes);
}
/*
* Log currently visible content pieces
*/
function getCurrentlyVisibleContentImpressionsRequestsIfNotTrackedYet(contentNodes)
{
if (!contentNodes || !contentNodes.length) {
return [];
}
var index;
for (index = 0; index < contentNodes.length; index++) {
if (!content.isNodeVisible(contentNodes[index])) {
contentNodes.splice(index, 1);
index--;
}
}
if (!contentNodes || !contentNodes.length) {
return [];
}
return getContentImpressionsRequestsFromNodes(contentNodes);
}
function buildContentImpressionRequest(contentName, contentPiece, contentTarget)
{
var params = content.buildImpressionRequestParams(contentName, contentPiece, contentTarget);
return getRequest(params, null, 'contentImpression');
}
function buildContentInteractionRequestNode(node, contentInteraction)
{
if (!node) {
return;
}
var contentNode = content.findParentContentNode(node);
var contentBlock = content.buildContentBlock(contentNode);
if (!contentBlock) {
return;
}
if (!contentInteraction) {
contentInteraction = 'Unknown';
}
return buildContentInteractionRequest(contentInteraction, contentBlock.name, contentBlock.piece, contentBlock.target);
}
function buildEventRequest(category, action, name, value)
{
return 'e_c=' + encodeWrapper(category)
+ '&e_a=' + encodeWrapper(action)
+ (isDefined(name) ? '&e_n=' + encodeWrapper(name) : '')
2021-01-06 17:54:39 +01:00
+ (isDefined(value) ? '&e_v=' + encodeWrapper(value) : '')
+ '&ca=1';
2017-03-03 17:44:22 +01:00
}
/*
* Log the event
*/
function logEvent(category, action, name, value, customData, callback)
{
// Category and Action are required parameters
2021-01-06 17:54:39 +01:00
if (!isNumberOrHasLength(category) || !isNumberOrHasLength(action)) {
logConsoleError('Error while logging event: Parameters `category` and `action` must not be empty or filled with whitespaces');
2017-03-03 17:44:22 +01:00
return false;
}
var request = getRequest(
buildEventRequest(category, action, name, value),
customData,
'event'
);
sendRequest(request, configTrackerPause, callback);
}
/*
* Log the site search request
*/
function logSiteSearch(keyword, category, resultsCount, customData) {
var request = getRequest('search=' + encodeWrapper(keyword)
+ (category ? '&search_cat=' + encodeWrapper(category) : '')
+ (isDefined(resultsCount) ? '&search_count=' + resultsCount : ''), customData, 'sitesearch');
sendRequest(request, configTrackerPause);
}
/*
* Log the goal with the server
*/
2021-01-06 17:54:39 +01:00
function logGoal(idGoal, customRevenue, customData, callback) {
2017-03-03 17:44:22 +01:00
var request = getRequest('idgoal=' + idGoal + (customRevenue ? '&revenue=' + customRevenue : ''), customData, 'goal');
2021-01-06 17:54:39 +01:00
sendRequest(request, configTrackerPause, callback);
2017-03-03 17:44:22 +01:00
}
/*
* Log the link or click with the server
*/
function logLink(url, linkType, customData, callback, sourceElement) {
var linkParams = linkType + '=' + encodeWrapper(purify(url));
var interaction = getContentInteractionToRequestIfPossible(sourceElement, 'click', url);
if (interaction) {
linkParams += '&' + interaction;
}
var request = getRequest(linkParams, customData, 'link');
sendRequest(request, configTrackerPause, callback);
}
/*
* Browser prefix
*/
function prefixPropertyName(prefix, propertyName) {
if (prefix !== '') {
return prefix + propertyName.charAt(0).toUpperCase() + propertyName.slice(1);
}
return propertyName;
}
/*
* Check for pre-rendered web pages, and log the page view/link/goal
* according to the configuration and/or visibility
*
* @see http://dvcs.w3.org/hg/webperf/raw-file/tip/specs/PageVisibility/Overview.html
*/
function trackCallback(callback) {
var isPreRendered,
i,
// Chrome 13, IE10, FF10
prefixes = ['', 'webkit', 'ms', 'moz'],
prefix;
if (!configCountPreRendered) {
for (i = 0; i < prefixes.length; i++) {
prefix = prefixes[i];
// does this browser support the page visibility API?
if (Object.prototype.hasOwnProperty.call(documentAlias, prefixPropertyName(prefix, 'hidden'))) {
// if pre-rendered, then defer callback until page visibility changes
if (documentAlias[prefixPropertyName(prefix, 'visibilityState')] === 'prerender') {
isPreRendered = true;
}
break;
}
}
}
if (isPreRendered) {
// note: the event name doesn't follow the same naming convention as vendor properties
addEventListener(documentAlias, prefix + 'visibilitychange', function ready() {
documentAlias.removeEventListener(prefix + 'visibilitychange', ready, false);
callback();
});
return;
}
// configCountPreRendered === true || isPreRendered === false
callback();
}
2021-01-06 17:54:39 +01:00
function getCrossDomainVisitorId()
{
var visitorId = trackerInstance.getVisitorId();
var deviceId = makeCrossDomainDeviceId();
return visitorId + deviceId;
}
2017-03-03 17:44:22 +01:00
function replaceHrefForCrossDomainLink(element)
{
if (!element) {
return;
}
if (!query.hasNodeAttribute(element, 'href')) {
return;
}
var link = query.getAttributeValueFromNode(element, 'href');
if (!link || startsUrlWithTrackerUrl(link)) {
return;
}
2021-01-06 17:54:39 +01:00
if (!trackerInstance.getVisitorId()) {
return; // cookies are disabled.
}
2017-03-03 17:44:22 +01:00
// we need to remove the parameter and add it again if needed to make sure we have latest timestamp
// and visitorId (eg userId might be set etc)
link = removeUrlParameter(link, configVisitorIdUrlParameter);
2021-01-06 17:54:39 +01:00
var crossDomainVisitorId = getCrossDomainVisitorId();
2017-03-03 17:44:22 +01:00
2021-01-06 17:54:39 +01:00
link = addUrlParameter(link, configVisitorIdUrlParameter, crossDomainVisitorId);
2017-03-03 17:44:22 +01:00
query.setAnyAttribute(element, 'href', link);
}
2021-01-06 17:54:39 +01:00
function isLinkToDifferentDomainButSameMatomoWebsite(element)
2017-03-03 17:44:22 +01:00
{
var targetLink = query.getAttributeValueFromNode(element, 'href');
if (!targetLink) {
return false;
}
targetLink = String(targetLink);
var isOutlink = targetLink.indexOf('//') === 0
|| targetLink.indexOf('http://') === 0
|| targetLink.indexOf('https://') === 0;
if (!isOutlink) {
return false;
}
var originalSourcePath = element.pathname || getPathName(element.href);
var originalSourceHostName = (element.hostname || getHostName(element.href)).toLowerCase();
if (isSiteHostPath(originalSourceHostName, originalSourcePath)) {
// we could also check against config cookie domain but this would require that other website
// sets actually same cookie domain and we cannot rely on it.
if (!isSameHost(domainAlias, domainFixup(originalSourceHostName))) {
return true;
}
return false;
}
return false;
}
/*
* Process clicks
*/
function processClick(sourceElement) {
var link = getLinkIfShouldBeProcessed(sourceElement);
// not a link to same domain or the same website (as set in setDomains())
if (link && link.type) {
link.href = safeDecodeWrapper(link.href);
logLink(link.href, link.type, undefined, null, sourceElement);
return;
}
// a link to same domain or the same website (as set in setDomains())
if (crossDomainTrackingEnabled) {
// in case the clicked element is within the <a> (for example there is a <div> within the <a>) this will get the actual <a> link element
sourceElement = getSourceElement(sourceElement);
2021-01-06 17:54:39 +01:00
if(isLinkToDifferentDomainButSameMatomoWebsite(sourceElement)) {
2017-03-03 17:44:22 +01:00
replaceHrefForCrossDomainLink(sourceElement);
}
}
}
function isIE8orOlder()
{
return documentAlias.all && !documentAlias.addEventListener;
}
function getKeyCodeFromEvent(event)
{
// event.which is deprecated https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/which
var which = event.which;
/**
1 : Left mouse button
2 : Wheel button or middle button
3 : Right mouse button
*/
var typeOfEventButton = (typeof event.button);
if (!which && typeOfEventButton !== 'undefined' ) {
/**
-1: No button pressed
0 : Main button pressed, usually the left button
1 : Auxiliary button pressed, usually the wheel button or themiddle button (if present)
2 : Secondary button pressed, usually the right button
3 : Fourth button, typically the Browser Back button
4 : Fifth button, typically the Browser Forward button
IE8 and earlier has different values:
1 : Left mouse button
2 : Right mouse button
4 : Wheel button or middle button
For a left-hand configured mouse, the return values are reversed. We do not take care of that.
*/
if (isIE8orOlder()) {
if (event.button & 1) {
which = 1;
} else if (event.button & 2) {
which = 3;
} else if (event.button & 4) {
which = 2;
}
} else {
if (event.button === 0 || event.button === '0') {
which = 1;
} else if (event.button & 1) {
which = 2;
} else if (event.button & 2) {
which = 3;
}
}
}
return which;
}
function getNameOfClickedButton(event)
{
switch (getKeyCodeFromEvent(event)) {
case 1:
return 'left';
case 2:
return 'middle';
case 3:
return 'right';
}
}
function getTargetElementFromEvent(event)
{
return event.target || event.srcElement;
}
/*
* Handle click event
*/
function clickHandler(enable) {
return function (event) {
event = event || windowAlias.event;
var button = getNameOfClickedButton(event);
var target = getTargetElementFromEvent(event);
if (event.type === 'click') {
var ignoreClick = false;
if (enable && button === 'middle') {
// if enabled, we track middle clicks via mouseup
// some browsers (eg chrome) trigger click and mousedown/up events when middle is clicked,
// whereas some do not. This way we make "sure" to track them only once, either in click
// (default) or in mouseup (if enable == true)
ignoreClick = true;
}
if (target && !ignoreClick) {
processClick(target);
}
} else if (event.type === 'mousedown') {
if (button === 'middle' && target) {
lastButton = button;
lastTarget = target;
} else {
lastButton = lastTarget = null;
}
} else if (event.type === 'mouseup') {
if (button === lastButton && target === lastTarget) {
processClick(target);
}
lastButton = lastTarget = null;
} else if (event.type === 'contextmenu') {
processClick(target);
}
};
}
/*
* Add click listener to a DOM element
*/
function addClickListener(element, enable) {
var enableType = typeof enable;
if (enableType === 'undefined') {
enable = true;
}
addEventListener(element, 'click', clickHandler(enable), false);
if (enable) {
addEventListener(element, 'mouseup', clickHandler(enable), false);
addEventListener(element, 'mousedown', clickHandler(enable), false);
addEventListener(element, 'contextmenu', clickHandler(enable), false);
}
}
/*
* Add click handlers to anchor and AREA elements, except those to be ignored
*/
function addClickListeners(enable, trackerInstance) {
linkTrackingInstalled = true;
// iterate through anchor elements with href and AREA elements
var i,
ignorePattern = getClassesRegExp(configIgnoreClasses, 'ignore'),
linkElements = documentAlias.links,
linkElement = null, trackerType = null;
if (linkElements) {
for (i = 0; i < linkElements.length; i++) {
linkElement = linkElements[i];
if (!ignorePattern.test(linkElement.className)) {
2021-01-06 17:54:39 +01:00
trackerType = typeof linkElement.matomoTrackers;
2017-03-03 17:44:22 +01:00
if ('undefined' === trackerType) {
2021-01-06 17:54:39 +01:00
linkElement.matomoTrackers = [];
2017-03-03 17:44:22 +01:00
}
2021-01-06 17:54:39 +01:00
if (-1 === indexOfArray(linkElement.matomoTrackers, trackerInstance)) {
2017-03-03 17:44:22 +01:00
// we make sure to setup link only once for each tracker
2021-01-06 17:54:39 +01:00
linkElement.matomoTrackers.push(trackerInstance);
2017-03-03 17:44:22 +01:00
addClickListener(linkElement, enable);
}
}
}
}
}
2021-01-06 17:54:39 +01:00
function enableTrackOnlyVisibleContent (checkOnScroll, timeIntervalInMs, tracker) {
2017-03-03 17:44:22 +01:00
if (isTrackOnlyVisibleContentEnabled) {
// already enabled, do not register intervals again
return true;
}
isTrackOnlyVisibleContentEnabled = true;
var didScroll = false;
var events, index;
function setDidScroll() { didScroll = true; }
trackCallbackOnLoad(function () {
function checkContent(intervalInMs) {
setTimeout(function () {
if (!isTrackOnlyVisibleContentEnabled) {
return; // the tests stopped tracking only visible content
}
didScroll = false;
tracker.trackVisibleContentImpressions();
checkContent(intervalInMs);
}, intervalInMs);
}
function checkContentIfDidScroll(intervalInMs) {
setTimeout(function () {
if (!isTrackOnlyVisibleContentEnabled) {
return; // the tests stopped tracking only visible content
}
if (didScroll) {
didScroll = false;
tracker.trackVisibleContentImpressions();
}
checkContentIfDidScroll(intervalInMs);
}, intervalInMs);
}
2021-01-06 17:54:39 +01:00
if (checkOnScroll) {
2017-03-03 17:44:22 +01:00
// scroll event is executed after each pixel, so we make sure not to
// execute event too often. otherwise FPS goes down a lot!
events = ['scroll', 'resize'];
for (index = 0; index < events.length; index++) {
if (documentAlias.addEventListener) {
2021-01-06 17:54:39 +01:00
documentAlias.addEventListener(events[index], setDidScroll, false);
2017-03-03 17:44:22 +01:00
} else {
windowAlias.attachEvent('on' + events[index], setDidScroll);
}
}
checkContentIfDidScroll(100);
}
if (timeIntervalInMs && timeIntervalInMs > 0) {
timeIntervalInMs = parseInt(timeIntervalInMs, 10);
checkContent(timeIntervalInMs);
}
});
}
2021-01-06 17:54:39 +01:00
/*<DEBUG>*/
2017-03-03 17:44:22 +01:00
/*
2021-01-06 17:54:39 +01:00
* Register a test hook. Using eval() permits access to otherwise
* privileged members.
2017-03-03 17:44:22 +01:00
*/
2021-01-06 17:54:39 +01:00
function registerHook(hookName, userHook) {
var hookObj = null;
2017-03-03 17:44:22 +01:00
if (isString(hookName) && !isDefined(registeredHooks[hookName]) && userHook) {
if (isObject(userHook)) {
hookObj = userHook;
} else if (isString(userHook)) {
try {
eval('hookObj =' + userHook);
} catch (ignore) { }
}
registeredHooks[hookName] = hookObj;
}
return hookObj;
}
2021-01-06 17:54:39 +01:00
2017-03-03 17:44:22 +01:00
/*</DEBUG>*/
2021-01-06 17:54:39 +01:00
var requestQueue = {
enabled: true,
requests: [],
timeout: null,
interval: 2500,
sendRequests: function () {
var requestsToTrack = this.requests;
this.requests = [];
if (requestsToTrack.length === 1) {
sendRequest(requestsToTrack[0], configTrackerPause);
} else {
sendBulkRequest(requestsToTrack, configTrackerPause);
}
},
canQueue: function () {
return !isPageUnloading && this.enabled;
},
pushMultiple: function (requests) {
if (!this.canQueue()) {
sendBulkRequest(requests, configTrackerPause);
return;
}
var i;
for (i = 0; i < requests.length; i++) {
this.push(requests[i]);
}
},
push: function (requestUrl) {
if (!requestUrl) {
return;
}
if (!this.canQueue()) {
// we don't queue as we need to ensure the request will be sent when the page is unloading...
sendRequest(requestUrl, configTrackerPause);
return;
}
requestQueue.requests.push(requestUrl);
if (this.timeout) {
clearTimeout(this.timeout);
this.timeout = null;
}
// we always extend by another 2.5 seconds after receiving a tracking request
this.timeout = setTimeout(function () {
requestQueue.timeout = null;
requestQueue.sendRequests();
}, requestQueue.interval);
var trackerQueueId = 'RequestQueue' + uniqueTrackerId;
if (!Object.prototype.hasOwnProperty.call(plugins, trackerQueueId)) {
// we setup one unload handler per tracker...
// Matomo.addPlugin might not be defined at this point, we add the plugin directly also to make
// JSLint happy.
plugins[trackerQueueId] = {
unload: function () {
if (requestQueue.timeout) {
clearTimeout(requestQueue.timeout);
}
requestQueue.sendRequests();
}
};
}
}
};
2017-03-03 17:44:22 +01:00
/************************************************************
* Constructor
************************************************************/
/*
* initialize tracker
*/
updateDomainHash();
setVisitorIdCookie();
/*<DEBUG>*/
/*
* initialize test plugin
*/
executePluginMethod('run', null, registerHook);
/*</DEBUG>*/
/************************************************************
* Public data and methods
************************************************************/
/*<DEBUG>*/
/*
* Test hook accessors
*/
this.hook = registeredHooks;
this.getHook = function (hookName) {
return registeredHooks[hookName];
};
this.getQuery = function () {
return query;
};
this.getContent = function () {
return content;
};
2021-01-06 17:54:39 +01:00
this.isUsingAlwaysUseSendBeacon = function () {
return configAlwaysUseSendBeacon;
};
2017-03-03 17:44:22 +01:00
this.buildContentImpressionRequest = buildContentImpressionRequest;
this.buildContentInteractionRequest = buildContentInteractionRequest;
this.buildContentInteractionRequestNode = buildContentInteractionRequestNode;
this.getContentImpressionsRequestsFromNodes = getContentImpressionsRequestsFromNodes;
this.getCurrentlyVisibleContentImpressionsRequestsIfNotTrackedYet = getCurrentlyVisibleContentImpressionsRequestsIfNotTrackedYet;
this.trackCallbackOnLoad = trackCallbackOnLoad;
this.trackCallbackOnReady = trackCallbackOnReady;
this.buildContentImpressionsRequests = buildContentImpressionsRequests;
this.wasContentImpressionAlreadyTracked = wasContentImpressionAlreadyTracked;
this.appendContentInteractionToRequestIfPossible = getContentInteractionToRequestIfPossible;
this.setupInteractionsTracking = setupInteractionsTracking;
this.trackContentImpressionClickInteraction = trackContentImpressionClickInteraction;
this.internalIsNodeVisible = isVisible;
this.isNodeAuthorizedToTriggerInteraction = isNodeAuthorizedToTriggerInteraction;
this.getDomains = function () {
return configHostsAlias;
};
this.getConfigIdPageView = function () {
return configIdPageView;
};
this.getConfigDownloadExtensions = function () {
return configDownloadExtensions;
};
this.enableTrackOnlyVisibleContent = function (checkOnScroll, timeIntervalInMs) {
return enableTrackOnlyVisibleContent(checkOnScroll, timeIntervalInMs, this);
};
this.clearTrackedContentImpressions = function () {
trackedContentImpressions = [];
};
this.getTrackedContentImpressions = function () {
return trackedContentImpressions;
};
this.clearEnableTrackOnlyVisibleContent = function () {
isTrackOnlyVisibleContentEnabled = false;
};
this.disableLinkTracking = function () {
linkTrackingInstalled = false;
linkTrackingEnabled = false;
};
this.getConfigVisitorCookieTimeout = function () {
return configVisitorCookieTimeout;
};
2021-01-06 17:54:39 +01:00
this.getConfigCookieSameSite = function () {
return configCookieSameSite;
};
2017-03-03 17:44:22 +01:00
this.removeAllAsyncTrackersButFirst = function () {
var firstTracker = asyncTrackers[0];
asyncTrackers = [firstTracker];
};
2021-01-06 17:54:39 +01:00
this.getConsentRequestsQueue = function () {
return consentRequestsQueue;
};
this.getRequestQueue = function () {
return requestQueue;
};
this.unsetPageIsUnloading = function () {
isPageUnloading = false;
};
2017-03-03 17:44:22 +01:00
this.getRemainingVisitorCookieTimeout = getRemainingVisitorCookieTimeout;
/*</DEBUG>*/
2021-01-06 17:54:39 +01:00
this.hasConsent = function () {
return configHasConsent;
};
2017-03-03 17:44:22 +01:00
/**
* Get visitor ID (from first party cookie)
*
* @return string Visitor ID in hexits (or empty string, if not yet known)
*/
this.getVisitorId = function () {
return getValuesFromVisitorIdCookie().uuid;
};
/**
* Get the visitor information (from first party cookie)
*
* @return array
*/
this.getVisitorInfo = function () {
// Note: in a new method, we could return also return getValuesFromVisitorIdCookie()
// which returns named parameters rather than returning integer indexed array
return loadVisitorIdCookie();
};
/**
* Get the Attribution information, which is an array that contains
* the Referrer used to reach the site as well as the campaign name and keyword
* It is useful only when used in conjunction with Tracker API function setAttributionInfo()
* To access specific data point, you should use the other functions getAttributionReferrer* and getAttributionCampaign*
*
* @return array Attribution array, Example use:
2021-01-06 17:54:39 +01:00
* 1) Call windowAlias.JSON.stringify(matomoTracker.getAttributionInfo())
2017-03-03 17:44:22 +01:00
* 2) Pass this json encoded string to the Tracking API (php or java client): setAttributionInfo()
*/
this.getAttributionInfo = function () {
return loadReferrerAttributionCookie();
};
/**
* Get the Campaign name that was parsed from the landing page URL when the visitor
* landed on the site originally
*
* @return string
*/
this.getAttributionCampaignName = function () {
return loadReferrerAttributionCookie()[0];
};
/**
* Get the Campaign keyword that was parsed from the landing page URL when the visitor
* landed on the site originally
*
* @return string
*/
this.getAttributionCampaignKeyword = function () {
return loadReferrerAttributionCookie()[1];
};
/**
* Get the time at which the referrer (used for Goal Attribution) was detected
*
* @return int Timestamp or 0 if no referrer currently set
*/
this.getAttributionReferrerTimestamp = function () {
return loadReferrerAttributionCookie()[2];
};
/**
* Get the full referrer URL that will be used for Goal Attribution
*
* @return string Raw URL, or empty string '' if no referrer currently set
*/
this.getAttributionReferrerUrl = function () {
return loadReferrerAttributionCookie()[3];
};
/**
2021-01-06 17:54:39 +01:00
* Specify the Matomo tracking URL
2017-03-03 17:44:22 +01:00
*
* @param string trackerUrl
*/
this.setTrackerUrl = function (trackerUrl) {
configTrackerUrl = trackerUrl;
};
/**
2021-01-06 17:54:39 +01:00
* Returns the Matomo tracking URL
2017-03-03 17:44:22 +01:00
* @returns string
*/
this.getTrackerUrl = function () {
return configTrackerUrl;
};
/**
2021-01-06 17:54:39 +01:00
* Returns the Matomo server URL.
*
* @returns string
*/
this.getMatomoUrl = function () {
return getMatomoUrlForOverlay(this.getTrackerUrl(), configApiUrl);
};
/**
* Returns the Matomo server URL.
* @deprecated since Matomo 4.0.0 use `getMatomoUrl()` instead.
* @returns string
*/
this.getPiwikUrl = function () {
return this.getMatomoUrl();
};
/**
* Adds a new tracker. All sent requests will be also sent to the given siteId and matomoUrl.
2017-03-03 17:44:22 +01:00
*
2021-01-06 17:54:39 +01:00
* @param string matomoUrl The tracker URL of the current tracker instance
2017-03-03 17:44:22 +01:00
* @param int|string siteId
* @return Tracker
*/
2021-01-06 17:54:39 +01:00
this.addTracker = function (matomoUrl, siteId) {
if (!isDefined(matomoUrl) || null === matomoUrl) {
matomoUrl = this.getTrackerUrl();
2017-03-03 17:44:22 +01:00
}
2021-01-06 17:54:39 +01:00
var tracker = new Tracker(matomoUrl, siteId);
2017-03-03 17:44:22 +01:00
asyncTrackers.push(tracker);
2021-01-06 17:54:39 +01:00
Matomo.trigger('TrackerAdded', [this]);
2017-03-03 17:44:22 +01:00
return tracker;
};
/**
* Returns the site ID
*
* @returns int
*/
this.getSiteId = function() {
return configTrackerSiteId;
};
/**
* Specify the site ID
*
* @param int|string siteId
*/
this.setSiteId = function (siteId) {
setSiteId(siteId);
};
2021-01-06 17:54:39 +01:00
/**
* Clears the User ID
*/
this.resetUserId = function() {
configUserId = '';
};
2017-03-03 17:44:22 +01:00
/**
* Sets a User ID to this user (such as an email address or a username)
*
* @param string User ID
*/
this.setUserId = function (userId) {
2021-01-06 17:54:39 +01:00
if (isNumberOrHasLength(userId)) {
configUserId = userId;
}
};
/**
* Sets a Visitor ID to this visitor. Should be a 16 digit hex string.
* The visitorId won't be persisted in a cookie or something similar and needs to be set every time.
*
* @param string User ID
*/
this.setVisitorId = function (visitorId) {
var validation = /[0-9A-Fa-f]{16}/g;
if (isString(visitorId) && validation.test(visitorId)) {
visitorUUID = visitorId;
} else {
logConsoleError('Invalid visitorId set' + visitorId);
2017-03-03 17:44:22 +01:00
}
};
/**
* Gets the User ID if set.
*
* @returns string User ID
*/
this.getUserId = function() {
return configUserId;
};
/**
* Pass custom data to the server
*
* Examples:
* tracker.setCustomData(object);
* tracker.setCustomData(key, value);
*
* @param mixed key_or_obj
* @param mixed opt_value
*/
this.setCustomData = function (key_or_obj, opt_value) {
if (isObject(key_or_obj)) {
configCustomData = key_or_obj;
} else {
if (!configCustomData) {
configCustomData = {};
}
configCustomData[key_or_obj] = opt_value;
}
};
/**
* Get custom data
*
* @return mixed
*/
this.getCustomData = function () {
return configCustomData;
};
/**
* Configure function with custom request content processing logic.
* It gets called after request content in form of query parameters string has been prepared and before request content gets sent.
*
* Examples:
* tracker.setCustomRequestProcessing(function(request){
* var pairs = request.split('&');
* var result = {};
* pairs.forEach(function(pair) {
* pair = pair.split('=');
* result[pair[0]] = decodeURIComponent(pair[1] || '');
* });
* return JSON.stringify(result);
* });
*
* @param function customRequestContentProcessingLogic
*/
this.setCustomRequestProcessing = function (customRequestContentProcessingLogic) {
configCustomRequestContentProcessing = customRequestContentProcessingLogic;
};
/**
2021-01-06 17:54:39 +01:00
* Appends the specified query string to the matomo.php?... Tracking API URL
2017-03-03 17:44:22 +01:00
*
* @param string queryString eg. 'lat=140&long=100'
*/
this.appendToTrackingUrl = function (queryString) {
configAppendToTrackingUrl = queryString;
};
/**
* Returns the query string for the current HTTP Tracking API request.
2021-01-06 17:54:39 +01:00
* Matomo would prepend the hostname and path to Matomo: http://example.org/matomo/matomo.php?
2017-03-03 17:44:22 +01:00
* prior to sending the request.
*
* @param request eg. "param=value&param2=value2"
*/
this.getRequest = function (request) {
return getRequest(request);
};
/**
* Add plugin defined by a name and a callback function.
* The callback function will be called whenever a tracking request is sent.
* This can be used to append data to the tracking request, or execute other custom logic.
*
* @param string pluginName
* @param Object pluginObj
*/
this.addPlugin = function (pluginName, pluginObj) {
plugins[pluginName] = pluginObj;
};
/**
* Set Custom Dimensions. Set Custom Dimensions will not be cleared after a tracked pageview and will
* be sent along all following tracking requests. It is possible to remove/clear a value via `deleteCustomDimension`.
*
* @param int index A Custom Dimension index
* @param string value
*/
this.setCustomDimension = function (customDimensionId, value) {
customDimensionId = parseInt(customDimensionId, 10);
if (customDimensionId > 0) {
if (!isDefined(value)) {
value = '';
}
if (!isString(value)) {
value = String(value);
}
customDimensions[customDimensionId] = value;
}
};
/**
* Get a stored value for a specific Custom Dimension index.
*
* @param int index A Custom Dimension index
*/
this.getCustomDimension = function (customDimensionId) {
customDimensionId = parseInt(customDimensionId, 10);
if (customDimensionId > 0 && Object.prototype.hasOwnProperty.call(customDimensions, customDimensionId)) {
return customDimensions[customDimensionId];
}
};
/**
* Delete a custom dimension.
*
* @param int index Custom dimension Id
*/
this.deleteCustomDimension = function (customDimensionId) {
customDimensionId = parseInt(customDimensionId, 10);
if (customDimensionId > 0) {
delete customDimensions[customDimensionId];
}
};
/**
* Set custom variable within this visit
*
* @param int index Custom variable slot ID from 1-5
* @param string name
* @param string value
* @param string scope Scope of Custom Variable:
* - "visit" will store the name/value in the visit and will persist it in the cookie for the duration of the visit,
* - "page" will store the name/value in the next page view tracked.
* - "event" will store the name/value in the next event tracked.
*/
this.setCustomVariable = function (index, name, value, scope) {
var toRecord;
if (!isDefined(scope)) {
scope = 'visit';
}
if (!isDefined(name)) {
return;
}
if (!isDefined(value)) {
value = "";
}
if (index > 0) {
name = !isString(name) ? String(name) : name;
value = !isString(value) ? String(value) : value;
toRecord = [name.slice(0, customVariableMaximumLength), value.slice(0, customVariableMaximumLength)];
// numeric scope is there for GA compatibility
if (scope === 'visit' || scope === 2) {
loadCustomVariables();
customVariables[index] = toRecord;
} else if (scope === 'page' || scope === 3) {
customVariablesPage[index] = toRecord;
} else if (scope === 'event') { /* GA does not have 'event' scope but we do */
customVariablesEvent[index] = toRecord;
}
}
};
/**
* Get custom variable
*
* @param int index Custom variable slot ID from 1-5
* @param string scope Scope of Custom Variable: "visit" or "page" or "event"
*/
this.getCustomVariable = function (index, scope) {
var cvar;
if (!isDefined(scope)) {
scope = "visit";
}
if (scope === "page" || scope === 3) {
cvar = customVariablesPage[index];
} else if (scope === "event") {
cvar = customVariablesEvent[index];
} else if (scope === "visit" || scope === 2) {
loadCustomVariables();
cvar = customVariables[index];
}
if (!isDefined(cvar)
|| (cvar && cvar[0] === '')) {
return false;
}
return cvar;
};
/**
* Delete custom variable
*
* @param int index Custom variable slot ID from 1-5
* @param string scope
*/
this.deleteCustomVariable = function (index, scope) {
// Only delete if it was there already
if (this.getCustomVariable(index, scope)) {
this.setCustomVariable(index, '', '', scope);
}
};
/**
* Deletes all custom variables for a certain scope.
*
* @param string scope
*/
this.deleteCustomVariables = function (scope) {
if (scope === "page" || scope === 3) {
customVariablesPage = {};
} else if (scope === "event") {
customVariablesEvent = {};
} else if (scope === "visit" || scope === 2) {
customVariables = {};
}
};
/**
* When called then the Custom Variables of scope "visit" will be stored (persisted) in a first party cookie
* for the duration of the visit. This is useful if you want to call getCustomVariable later in the visit.
*
* By default, Custom Variables of scope "visit" are not stored on the visitor's computer.
*/
this.storeCustomVariablesInCookie = function () {
configStoreCustomVariablesInCookie = true;
};
/**
* Set delay for link tracking (in milliseconds)
*
* @param int delay
*/
this.setLinkTrackingTimer = function (delay) {
configTrackerPause = delay;
};
/**
* Get delay for link tracking (in milliseconds)
*
* @param int delay
*/
this.getLinkTrackingTimer = function () {
return configTrackerPause;
};
/**
* Set list of file extensions to be recognized as downloads
*
* @param string|array extensions
*/
this.setDownloadExtensions = function (extensions) {
if(isString(extensions)) {
extensions = extensions.split('|');
}
configDownloadExtensions = extensions;
};
/**
* Specify additional file extensions to be recognized as downloads
*
* @param string|array extensions for example 'custom' or ['custom1','custom2','custom3']
*/
this.addDownloadExtensions = function (extensions) {
var i;
if(isString(extensions)) {
extensions = extensions.split('|');
}
for (i=0; i < extensions.length; i++) {
configDownloadExtensions.push(extensions[i]);
}
};
/**
* Removes specified file extensions from the list of recognized downloads
*
* @param string|array extensions for example 'custom' or ['custom1','custom2','custom3']
*/
this.removeDownloadExtensions = function (extensions) {
var i, newExtensions = [];
if(isString(extensions)) {
extensions = extensions.split('|');
}
for (i=0; i < configDownloadExtensions.length; i++) {
if (indexOfArray(extensions, configDownloadExtensions[i]) === -1) {
newExtensions.push(configDownloadExtensions[i]);
}
}
configDownloadExtensions = newExtensions;
};
/**
2021-01-06 17:54:39 +01:00
* Set array of domains to be treated as local. Also supports path, eg '.matomo.org/subsite1'. In this
* case all links that don't go to '*.matomo.org/subsite1/ *' would be treated as outlinks.
* For example a link to 'matomo.org/' or 'matomo.org/subsite2' both would be treated as outlinks.
2017-03-03 17:44:22 +01:00
*
2021-01-06 17:54:39 +01:00
* Also supports page wildcard, eg 'matomo.org/index*'. In this case all links
* that don't go to matomo.org/index* would be treated as outlinks.
2017-03-03 17:44:22 +01:00
*
* The current domain will be added automatically if no given host alias contains a path and if no host
* alias is already given for the current host alias. Say you are on "example.org" and set
* "hostAlias = ['example.com', 'example.org/test']" then the current "example.org" domain will not be
* added as there is already a more restrictive hostAlias 'example.org/test' given. We also do not add
* it automatically if there was any other host specifying any path like
* "['example.com', 'example2.com/test']". In this case we would also not add the current
* domain "example.org" automatically as the "path" feature is used. As soon as someone uses the path
2021-01-06 17:54:39 +01:00
* feature, for Matomo JS Tracker to work correctly in all cases, one needs to specify all hosts
2017-03-03 17:44:22 +01:00
* manually.
*
* @param string|array hostsAlias
*/
this.setDomains = function (hostsAlias) {
configHostsAlias = isString(hostsAlias) ? [hostsAlias] : hostsAlias;
var hasDomainAliasAlready = false, i = 0, alias;
for (i; i < configHostsAlias.length; i++) {
alias = String(configHostsAlias[i]);
if (isSameHost(domainAlias, domainFixup(alias))) {
hasDomainAliasAlready = true;
break;
}
var pathName = getPathName(alias);
if (pathName && pathName !== '/' && pathName !== '/*') {
hasDomainAliasAlready = true;
break;
}
}
// The current domain will be added automatically if no given host alias contains a path
// and if no host alias is already given for the current host alias.
if (!hasDomainAliasAlready) {
/**
2021-01-06 17:54:39 +01:00
* eg if domainAlias = 'matomo.org' and someone set hostsAlias = ['matomo.org/foo'] then we should
* not add matomo.org as it would increase the allowed scope.
2017-03-03 17:44:22 +01:00
*/
configHostsAlias.push(domainAlias);
}
};
/**
* Enables cross domain linking. By default, the visitor ID that identifies a unique visitor is stored in
* the browser's first party cookies. This means the cookie can only be accessed by pages on the same domain.
* If you own multiple domains and would like to track all the actions and pageviews of a specific visitor
* into the same visit, you may enable cross domain linking. Whenever a user clicks on a link it will append
* a URL parameter pk_vid to the clicked URL which consists of these parts: 16 char visitorId, a 10 character
* current timestamp and the last 6 characters are an id based on the userAgent to identify the users device).
* This way the current visitorId is forwarded to the page of the different domain.
*
2021-01-06 17:54:39 +01:00
* On the different domain, the Matomo tracker will recognize the set visitorId from the URL parameter and
2017-03-03 17:44:22 +01:00
* reuse this parameter if the page was loaded within 45 seconds. If cross domain linking was not enabled,
* it would create a new visit on that page because we wouldn't be able to access the previously created
* cookie. By enabling cross domain linking you can track several different domains into one website and
* won't lose for example the original referrer.
*
* To make cross domain linking work you need to set which domains should be considered as your domains by
* calling the method "setDomains()" first. We will add the URL parameter to links that go to a
* different domain but only if the domain was previously set with "setDomains()" to make sure not to append
* the URL parameters when a link actually goes to a third-party URL.
*/
this.enableCrossDomainLinking = function () {
crossDomainTrackingEnabled = true;
};
/**
* Disable cross domain linking if it was previously enabled. See enableCrossDomainLinking();
*/
this.disableCrossDomainLinking = function () {
crossDomainTrackingEnabled = false;
};
/**
* Detect whether cross domain linking is enabled or not. See enableCrossDomainLinking();
* @returns bool
*/
this.isCrossDomainLinkingEnabled = function () {
return crossDomainTrackingEnabled;
};
2021-01-06 17:54:39 +01:00
/**
* By default, the two visits across domains will be linked together
* when the link is click and the page is loaded within 180 seconds.
* @param timeout in seconds
*/
this.setCrossDomainLinkingTimeout = function (timeout) {
configVisitorIdUrlParameterTimeoutInSeconds = timeout;
};
/**
* Returns the query parameter appended to link URLs so cross domain visits
* can be detected.
*
* If your application creates links dynamically, then you'll have to add this
* query parameter manually to those links (since the JavaScript tracker cannot
* detect when those links are added).
*
* Eg:
*
* var url = 'http://myotherdomain.com/?' + matomoTracker.getCrossDomainLinkingUrlParameter();
* $element.append('<a href="' + url + '"/>');
*/
this.getCrossDomainLinkingUrlParameter = function () {
return encodeWrapper(configVisitorIdUrlParameter) + '=' + encodeWrapper(getCrossDomainVisitorId());
};
2017-03-03 17:44:22 +01:00
/**
* Set array of classes to be ignored if present in link
*
* @param string|array ignoreClasses
*/
this.setIgnoreClasses = function (ignoreClasses) {
configIgnoreClasses = isString(ignoreClasses) ? [ignoreClasses] : ignoreClasses;
};
/**
2021-01-06 17:54:39 +01:00
* Set request method. If you specify GET then it will automatically disable sendBeacon.
2017-03-03 17:44:22 +01:00
*
* @param string method GET or POST; default is GET
*/
this.setRequestMethod = function (method) {
2021-01-06 17:54:39 +01:00
if (method) {
configRequestMethod = String(method).toUpperCase();
} else {
configRequestMethod = defaultRequestMethod;
}
if (configRequestMethod === 'GET') {
// send beacon always sends a POST request so we have to disable it to make GET work
this.disableAlwaysUseSendBeacon();
}
2017-03-03 17:44:22 +01:00
};
/**
* Set request Content-Type header value, applicable when POST request method is used for submitting tracking events.
* See XMLHttpRequest Level 2 spec, section 4.7.2 for invalid headers
* @link http://dvcs.w3.org/hg/xhr/raw-file/tip/Overview.html
*
* @param string requestContentType; default is 'application/x-www-form-urlencoded; charset=UTF-8'
*/
this.setRequestContentType = function (requestContentType) {
configRequestContentType = requestContentType || defaultRequestContentType;
};
2021-01-06 17:54:39 +01:00
/**
* Removed since Matomo 4
* @param generationTime
*/
this.setGenerationTimeMs = function(generationTime) {
logConsoleError('setGenerationTimeMs is no longer supported since Matomo 4. The call will be ignored. There is currently no replacement yet.');
};
2017-03-03 17:44:22 +01:00
/**
* Override referrer
*
* @param string url
*/
this.setReferrerUrl = function (url) {
configReferrerUrl = url;
};
/**
* Override url
*
* @param string url
*/
this.setCustomUrl = function (url) {
configCustomUrl = resolveRelativeReference(locationHrefAlias, url);
};
2021-01-06 17:54:39 +01:00
/**
* Returns the current url of the page that is currently being visited. If a custom URL was set, the
* previously defined custom URL will be returned.
*/
this.getCurrentUrl = function () {
return configCustomUrl || locationHrefAlias;
};
2017-03-03 17:44:22 +01:00
/**
* Override document.title
*
* @param string title
*/
this.setDocumentTitle = function (title) {
configTitle = title;
};
/**
2021-01-06 17:54:39 +01:00
* Set the URL of the Matomo API. It is used for Page Overlay.
2017-03-03 17:44:22 +01:00
* This method should only be called when the API URL differs from the tracker URL.
*
* @param string apiUrl
*/
this.setAPIUrl = function (apiUrl) {
configApiUrl = apiUrl;
};
/**
* Set array of classes to be treated as downloads
*
* @param string|array downloadClasses
*/
this.setDownloadClasses = function (downloadClasses) {
configDownloadClasses = isString(downloadClasses) ? [downloadClasses] : downloadClasses;
};
/**
* Set array of classes to be treated as outlinks
*
* @param string|array linkClasses
*/
this.setLinkClasses = function (linkClasses) {
configLinkClasses = isString(linkClasses) ? [linkClasses] : linkClasses;
};
/**
* Set array of campaign name parameters
*
2021-01-06 17:54:39 +01:00
* @see https://matomo.org/faq/how-to/#faq_120
2017-03-03 17:44:22 +01:00
* @param string|array campaignNames
*/
this.setCampaignNameKey = function (campaignNames) {
configCampaignNameParameters = isString(campaignNames) ? [campaignNames] : campaignNames;
};
/**
* Set array of campaign keyword parameters
*
2021-01-06 17:54:39 +01:00
* @see https://matomo.org/faq/how-to/#faq_120
2017-03-03 17:44:22 +01:00
* @param string|array campaignKeywords
*/
this.setCampaignKeywordKey = function (campaignKeywords) {
configCampaignKeywordParameters = isString(campaignKeywords) ? [campaignKeywords] : campaignKeywords;
};
/**
* Strip hash tag (or anchor) from URL
2021-01-06 17:54:39 +01:00
* Note: this can be done in the Matomo>Settings>Websites on a per-website basis
2017-03-03 17:44:22 +01:00
*
* @deprecated
* @param bool enableFilter
*/
this.discardHashTag = function (enableFilter) {
configDiscardHashTag = enableFilter;
};
/**
* Set first-party cookie name prefix
*
* @param string cookieNamePrefix
*/
this.setCookieNamePrefix = function (cookieNamePrefix) {
configCookieNamePrefix = cookieNamePrefix;
// Re-init the Custom Variables cookie
2021-01-06 17:54:39 +01:00
if (customVariables) {
customVariables = getCustomVariablesFromCookie();
}
2017-03-03 17:44:22 +01:00
};
/**
* Set first-party cookie domain
*
* @param string domain
*/
this.setCookieDomain = function (domain) {
var domainFixed = domainFixup(domain);
if (isPossibleToSetCookieOnDomain(domainFixed)) {
configCookieDomain = domainFixed;
updateDomainHash();
}
};
/**
2021-01-06 17:54:39 +01:00
* Get first-party cookie domain
*/
this.getCookieDomain = function () {
return configCookieDomain;
};
/**
* Detect if cookies are enabled and supported by browser.
*/
this.hasCookies = function () {
return '1' === hasCookies();
};
/**
* Set a first-party cookie for the duration of the session.
*
* @param string cookieName
* @param string cookieValue
* @param int msToExpire Defaults to session cookie timeout
*/
this.setSessionCookie = function (cookieName, cookieValue, msToExpire) {
if (!cookieName) {
throw new Error('Missing cookie name');
}
if (!isDefined(msToExpire)) {
msToExpire = configSessionCookieTimeout;
}
configCookiesToDelete.push(cookieName);
setCookie(getCookieName(cookieName), cookieValue, msToExpire, configCookiePath, configCookieDomain, configCookieIsSecure, configCookieSameSite);
};
/**
* Get first-party cookie value.
*
* Returns null if cookies are disabled or if no cookie could be found for this name.
*
* @param string cookieName
*/
this.getCookie = function (cookieName) {
var cookieValue = getCookie(getCookieName(cookieName));
if (cookieValue === 0) {
return null;
}
return cookieValue;
};
/**
* Set first-party cookie path.
2017-03-03 17:44:22 +01:00
*
* @param string domain
*/
this.setCookiePath = function (path) {
configCookiePath = path;
updateDomainHash();
};
2021-01-06 17:54:39 +01:00
/**
* Get first-party cookie path.
*
* @param string domain
*/
this.getCookiePath = function (path) {
return configCookiePath;
};
2017-03-03 17:44:22 +01:00
/**
* Set visitor cookie timeout (in seconds)
* Defaults to 13 months (timeout=33955200)
*
* @param int timeout
*/
this.setVisitorCookieTimeout = function (timeout) {
configVisitorCookieTimeout = timeout * 1000;
};
/**
* Set session cookie timeout (in seconds).
* Defaults to 30 minutes (timeout=1800)
*
* @param int timeout
*/
this.setSessionCookieTimeout = function (timeout) {
configSessionCookieTimeout = timeout * 1000;
};
2021-01-06 17:54:39 +01:00
/**
* Get session cookie timeout (in seconds).
*/
this.getSessionCookieTimeout = function () {
return configSessionCookieTimeout;
};
2017-03-03 17:44:22 +01:00
/**
* Set referral cookie timeout (in seconds).
* Defaults to 6 months (15768000000)
*
* @param int timeout
*/
this.setReferralCookieTimeout = function (timeout) {
configReferralCookieTimeout = timeout * 1000;
};
/**
* Set conversion attribution to first referrer and campaign
*
* @param bool if true, use first referrer (and first campaign)
* if false, use the last referrer (or campaign)
*/
this.setConversionAttributionFirstReferrer = function (enable) {
configConversionAttributionFirstReferrer = enable;
};
2021-01-06 17:54:39 +01:00
/**
* Enable the Secure cookie flag on all first party cookies.
* This should be used when your website is only available under HTTPS
* so that all tracking cookies are always sent over secure connection.
*
* Warning: If your site is available under http and https,
* setting this might lead to duplicate or incomplete visits.
*
* @param bool
*/
this.setSecureCookie = function (enable) {
if(enable && location.protocol !== 'https:') {
logConsoleError("Error in setSecureCookie: You cannot use `Secure` on http.");
return;
}
configCookieIsSecure = enable;
};
/**
* Set the SameSite attribute for cookies to a custom value.
* You might want to use this if your site is running in an iframe since
* then it will only be able to access the cookies if SameSite is set to 'None'.
*
*
* Warning:
* Sets CookieIsSecure to true on None, because None will only work with Secure; cookies
* If your site is available under http and https,
* using "None" might lead to duplicate or incomplete visits.
*
* @param string either Lax, None or Strict
*/
this.setCookieSameSite = function (sameSite) {
sameSite = String(sameSite);
sameSite = sameSite.charAt(0).toUpperCase() + sameSite.toLowerCase().slice(1);
if (sameSite !== 'None' && sameSite !== 'Lax' && sameSite !== 'Strict') {
logConsoleError('Ignored value for sameSite. Please use either Lax, None, or Strict.');
return;
}
if (sameSite === 'None') {
if (location.protocol === 'https:') {
this.setSecureCookie(true);
} else {
logConsoleError('sameSite=None cannot be used on http, reverted to sameSite=Lax.');
sameSite = 'Lax';
}
}
configCookieSameSite = sameSite;
};
2017-03-03 17:44:22 +01:00
/**
* Disables all cookies from being set
*
* Existing cookies will be deleted on the next call to track
*/
this.disableCookies = function () {
configCookiesDisabled = true;
if (configTrackerSiteId) {
deleteCookies();
}
};
2021-01-06 17:54:39 +01:00
/**
* Detects if cookies are enabled or not
* @returns {boolean}
*/
this.areCookiesEnabled = function () {
return !configCookiesDisabled;
};
/**
* Enables cookies if they were disabled previously.
*/
this.setCookieConsentGiven = function () {
if (configCookiesDisabled && !configDoNotTrack) {
configCookiesDisabled = false;
if (configTrackerSiteId && hasSentTrackingRequestYet) {
setVisitorIdCookie();
// sets attribution cookie, and updates visitorId in the backend
// because hasSentTrackingRequestYet=true we assume there might not be another tracking
// request within this page view so we trigger one ourselves.
// if no tracking request has been sent yet, we don't set the attribution cookie cause Matomo
// sets the cookie only when there is a tracking request. It'll be set if the user sends
// a tracking request afterwards
var request = getRequest('ping=1', null, 'ping');
sendRequest(request, configTrackerPause);
}
}
};
/**
* When called, no cookies will be set until you have called `setCookieConsentGiven()`
* unless consent was given previously AND you called {@link rememberCookieConsentGiven()} when the user
* gave consent.
*
* This may be useful when you want to implement for example a popup to ask for cookie consent.
* Once the user has given consent, you should call {@link setCookieConsentGiven()}
* or {@link rememberCookieConsentGiven()}.
*
* If you require tracking consent for example because you are tracking personal data and GDPR applies to you,
* then have a look at `_paq.push(['requireConsent'])` instead.
*
* If the user has already given consent in the past, you can either decide to not call `requireCookieConsent` at all
* or call `_paq.push(['setCookieConsentGiven'])` on each page view at any time after calling `requireCookieConsent`.
*
* When the user gives you the consent to set cookies, you can also call `_paq.push(['rememberCookieConsentGiven', optionalTimeoutInHours])`
* and for the duration while the cookie consent is remembered, any call to `requireCoookieConsent` will be automatically ignored
* until you call `forgetCookieConsentGiven`.
* `forgetCookieConsentGiven` needs to be called when the user removes consent for using cookies. This means if you call `rememberCookieConsentGiven` at the
* time the user gives you consent, you do not need to ever call `_paq.push(['setCookieConsentGiven'])` as the consent
* will be detected automatically through cookies.
*/
this.requireCookieConsent = function() {
if (this.getRememberedCookieConsent()) {
return false;
}
this.disableCookies();
return true;
};
/**
* If the user has given cookie consent previously and this consent was remembered, it will return the number
* in milliseconds since 1970/01/01 which is the date when the user has given cookie consent. Please note that
* the returned time depends on the users local time which may not always be correct.
*
* @returns number|string
*/
this.getRememberedCookieConsent = function () {
return getCookie(COOKIE_CONSENT_COOKIE_NAME);
};
/**
* Calling this method will remove any previously given cookie consent and it disables cookies for subsequent
* page views. You may call this method if the user removes cookie consent manually, or if you
* want to re-ask for cookie consent after a specific time period.
*/
this.forgetCookieConsentGiven = function () {
deleteCookie(COOKIE_CONSENT_COOKIE_NAME, configCookiePath, configCookieDomain);
this.disableCookies();
};
/**
* Calling this method will remember that the user has given cookie consent across multiple requests by setting
* a cookie named "mtm_cookie_consent". You can optionally define the lifetime of that cookie in hours
* using a parameter.
*
* When you call this method, we imply that the user has given cookie consent for this page view, and will also
* imply consent for all future page views unless the cookie expires or the user
* deletes all her or his cookies. Remembering cookie consent means even if you call {@link disableCookies()},
* then cookies will still be enabled and it won't disable cookies since the user has given consent for cookies.
*
* Please note that this feature requires you to set the `cookieDomain` and `cookiePath` correctly. Please
* also note that when you call this method, consent will be implied for all sites that match the configured
* cookieDomain and cookiePath. Depending on your website structure, you may need to restrict or widen the
* scope of the cookie domain/path to ensure the consent is applied to the sites you want.
*
* @param int hoursToExpire After how many hours the cookie consent should expire. By default the consent is valid
* for 30 years unless cookies are deleted by the user or the browser prior to this
*/
this.rememberCookieConsentGiven = function (hoursToExpire) {
if (hoursToExpire) {
hoursToExpire = hoursToExpire * 60 * 60 * 1000;
} else {
hoursToExpire = 30 * 365 * 24 * 60 * 60 * 1000;
}
this.setCookieConsentGiven();
var now = new Date().getTime();
setCookie(COOKIE_CONSENT_COOKIE_NAME, now, hoursToExpire, configCookiePath, configCookieDomain, configCookieIsSecure, configCookieSameSite);
};
2017-03-03 17:44:22 +01:00
/**
* One off cookies clearing. Useful to call this when you know for sure a new visitor is using the same browser,
* it maybe helps to "reset" tracking cookies to prevent data reuse for different users.
*/
this.deleteCookies = function () {
deleteCookies();
};
/**
* Handle do-not-track requests
*
* @param bool enable If true, don't track if user agent sends 'do-not-track' header
*/
this.setDoNotTrack = function (enable) {
var dnt = navigatorAlias.doNotTrack || navigatorAlias.msDoNotTrack;
configDoNotTrack = enable && (dnt === 'yes' || dnt === '1');
// do not track also disables cookies and deletes existing cookies
if (configDoNotTrack) {
this.disableCookies();
}
};
2021-01-06 17:54:39 +01:00
/**
* Enables send beacon usage instead of regular XHR which reduces the link tracking time to a minimum
* of 100ms instead of 500ms (default). This means when a user clicks for example on an outlink, the
* navigation to this page will happen 400ms faster.
* In case you are setting a callback method when issuing a tracking request, the callback method will
* be executed as soon as the tracking request was sent through "sendBeacon" and not after the tracking
* request finished as it is not possible to find out when the request finished.
* Send beacon will only be used if the browser actually supports it.
*/
this.alwaysUseSendBeacon = function () {
configAlwaysUseSendBeacon = true;
};
/**
* Disables send beacon usage instead and instead enables using regular XHR when possible. This makes
* callbacks work and also tracking requests will appear in the browser developer tools console.
*/
this.disableAlwaysUseSendBeacon = function () {
configAlwaysUseSendBeacon = false;
};
2017-03-03 17:44:22 +01:00
/**
* Add click listener to a specific link element.
2021-01-06 17:54:39 +01:00
* When clicked, Matomo will log the click automatically.
2017-03-03 17:44:22 +01:00
*
* @param DOMElement element
* @param bool enable If false, do not use pseudo click-handler (middle click + context menu)
*/
this.addListener = function (element, enable) {
addClickListener(element, enable);
};
/**
* Install link tracker.
*
* If you change the DOM of your website or web application you need to make sure to call this method
2021-01-06 17:54:39 +01:00
* again so Matomo can detect links that were added newly.
2017-03-03 17:44:22 +01:00
*
* The default behaviour is to use actual click events. However, some browsers
* (e.g., Firefox, Opera, and Konqueror) don't generate click events for the middle mouse button.
*
* To capture more "clicks", the pseudo click-handler uses mousedown + mouseup events.
* This is not industry standard and is vulnerable to false positives (e.g., drag events).
*
* There is a Safari/Chrome/Webkit bug that prevents tracking requests from being sent
* by either click handler. The workaround is to set a target attribute (which can't
* be "_self", "_top", or "_parent").
*
* @see https://bugs.webkit.org/show_bug.cgi?id=54783
*
* @param bool enable Defaults to true.
* * If "true", use pseudo click-handler (treat middle click and open contextmenu as
* left click). A right click (or any click that opens the context menu) on a link
* will be tracked as clicked even if "Open in new tab" is not selected.
* * If "false" (default), nothing will be tracked on open context menu or middle click.
* The context menu is usually opened to open a link / download in a new tab
* therefore you can get more accurate results by treat it as a click but it can lead
* to wrong click numbers.
*/
this.enableLinkTracking = function (enable) {
linkTrackingEnabled = true;
var self = this;
trackCallback(function () {
trackCallbackOnReady(function () {
addClickListeners(enable, self);
});
2021-01-06 17:54:39 +01:00
trackCallbackOnLoad(function () {
addClickListeners(enable, self);
});
2017-03-03 17:44:22 +01:00
});
};
/**
* Enable tracking of uncatched JavaScript errors
*
* If enabled, uncaught JavaScript Errors will be tracked as an event by defining a
* window.onerror handler. If a window.onerror handler is already defined we will make
* sure to call this previously registered error handler after tracking the error.
*
* By default we return false in the window.onerror handler to make sure the error still
* appears in the browser's console etc. Note: Some older browsers might behave differently
* so it could happen that an actual JavaScript error will be suppressed.
* If a window.onerror handler was registered we will return the result of this handler.
*
* Make sure not to overwrite the window.onerror handler after enabling the JS error
* tracking as the error tracking won't work otherwise. To capture all JS errors we
2021-01-06 17:54:39 +01:00
* recommend to include the Matomo JavaScript tracker in the HTML as early as possible.
2017-03-03 17:44:22 +01:00
* If possible directly in <head></head> before loading any other JavaScript.
*/
this.enableJSErrorTracking = function () {
if (enableJSErrorTracking) {
return;
}
enableJSErrorTracking = true;
var onError = windowAlias.onerror;
windowAlias.onerror = function (message, url, linenumber, column, error) {
trackCallback(function () {
var category = 'JavaScript Errors';
var action = url + ':' + linenumber;
if (column) {
action += ':' + column;
}
logEvent(category, action, message);
});
if (onError) {
return onError(message, url, linenumber, column, error);
}
return false;
};
};
/**
* Disable automatic performance tracking
*/
this.disablePerformanceTracking = function () {
configPerformanceTrackingEnabled = false;
};
/**
* Set heartbeat (in seconds)
*
2021-01-06 17:54:39 +01:00
* @param int heartBeatDelayInSeconds Defaults to 15s. Cannot be lower than 5.
2017-03-03 17:44:22 +01:00
*/
this.enableHeartBeatTimer = function (heartBeatDelayInSeconds) {
2021-01-06 17:54:39 +01:00
heartBeatDelayInSeconds = Math.max(heartBeatDelayInSeconds || 15, 5);
configHeartBeatDelay = heartBeatDelayInSeconds * 1000;
2017-03-03 17:44:22 +01:00
// if a tracking request has already been sent, start the heart beat timeout
if (lastTrackerRequestTime !== null) {
setUpHeartBeat();
}
};
/**
* Disable heartbeat if it was previously activated.
*/
this.disableHeartBeatTimer = function () {
if (configHeartBeatDelay || heartBeatSetUp) {
if (windowAlias.removeEventListener) {
2021-01-06 17:54:39 +01:00
windowAlias.removeEventListener('focus', heartBeatOnFocus);
windowAlias.removeEventListener('blur', heartBeatOnBlur);
2017-03-03 17:44:22 +01:00
} else if (windowAlias.detachEvent) {
windowAlias.detachEvent('onfocus', heartBeatOnFocus);
windowAlias.detachEvent('onblur', heartBeatOnBlur);
}
}
configHeartBeatDelay = null;
heartBeatSetUp = false;
};
/**
* Frame buster
*/
this.killFrame = function () {
if (windowAlias.location !== windowAlias.top.location) {
windowAlias.top.location = windowAlias.location;
}
};
/**
* Redirect if browsing offline (aka file: buster)
*
* @param string url Redirect to this URL
*/
this.redirectFile = function (url) {
if (windowAlias.location.protocol === 'file:') {
windowAlias.location = url;
}
};
/**
* Count sites in pre-rendered state
*
* @param bool enable If true, track when in pre-rendered state
*/
this.setCountPreRendered = function (enable) {
configCountPreRendered = enable;
};
/**
* Trigger a goal
*
* @param int|string idGoal
* @param int|float customRevenue
* @param mixed customData
2021-01-06 17:54:39 +01:00
* @param function callback
2017-03-03 17:44:22 +01:00
*/
2021-01-06 17:54:39 +01:00
this.trackGoal = function (idGoal, customRevenue, customData, callback) {
2017-03-03 17:44:22 +01:00
trackCallback(function () {
2021-01-06 17:54:39 +01:00
logGoal(idGoal, customRevenue, customData, callback);
2017-03-03 17:44:22 +01:00
});
};
/**
* Manually log a click from your own code
*
* @param string sourceUrl
* @param string linkType
* @param mixed customData
* @param function callback
*/
this.trackLink = function (sourceUrl, linkType, customData, callback) {
trackCallback(function () {
logLink(sourceUrl, linkType, customData, callback);
});
};
2021-01-06 17:54:39 +01:00
/**
* Get the number of page views that have been tracked so far within the currently loaded page.
*/
this.getNumTrackedPageViews = function () {
return numTrackedPageviews;
};
2017-03-03 17:44:22 +01:00
/**
* Log visit to this page
*
* @param string customTitle
* @param mixed customData
* @param function callback
*/
this.trackPageView = function (customTitle, customData, callback) {
trackedContentImpressions = [];
2021-01-06 17:54:39 +01:00
consentRequestsQueue = [];
2017-03-03 17:44:22 +01:00
if (isOverlaySession(configTrackerSiteId)) {
trackCallback(function () {
injectOverlayScripts(configTrackerUrl, configApiUrl, configTrackerSiteId);
});
} else {
trackCallback(function () {
2021-01-06 17:54:39 +01:00
numTrackedPageviews++;
2017-03-03 17:44:22 +01:00
logPageView(customTitle, customData, callback);
});
}
};
/**
* Scans the entire DOM for all content blocks and tracks all impressions once the DOM ready event has
* been triggered.
*
* If you only want to track visible content impressions have a look at `trackVisibleContentImpressions()`.
* We do not track an impression of the same content block twice if you call this method multiple times
* unless `trackPageView()` is called meanwhile. This is useful for single page applications.
*/
this.trackAllContentImpressions = function () {
if (isOverlaySession(configTrackerSiteId)) {
return;
}
trackCallback(function () {
trackCallbackOnReady(function () {
// we have to wait till DOM ready
var contentNodes = content.findContentNodes();
var requests = getContentImpressionsRequestsFromNodes(contentNodes);
2021-01-06 17:54:39 +01:00
requestQueue.pushMultiple(requests);
2017-03-03 17:44:22 +01:00
});
});
};
/**
* Scans the entire DOM for all content blocks as soon as the page is loaded. It tracks an impression
* only if a content block is actually visible. Meaning it is not hidden and the content is or was at
* some point in the viewport.
*
* If you want to track all content blocks have a look at `trackAllContentImpressions()`.
* We do not track an impression of the same content block twice if you call this method multiple times
* unless `trackPageView()` is called meanwhile. This is useful for single page applications.
*
* Once you have called this method you can no longer change `checkOnScroll` or `timeIntervalInMs`.
*
* If you do want to only track visible content blocks but not want us to perform any automatic checks
* as they can slow down your frames per second you can call `trackVisibleContentImpressions()` or
* `trackContentImpressionsWithinNode()` manually at any time to rescan the entire DOM for newly
* visible content blocks.
* o Call `trackVisibleContentImpressions(false, 0)` to initially track only visible content impressions
* o Call `trackVisibleContentImpressions()` at any time again to rescan the entire DOM for newly visible content blocks or
* o Call `trackContentImpressionsWithinNode(node)` at any time to rescan only a part of the DOM for newly visible content blocks
*
* @param boolean [checkOnScroll=true] Optional, you can disable rescanning the entire DOM automatically
* after each scroll event by passing the value `false`. If enabled,
* we check whether a previously hidden content blocks became visible
* after a scroll and if so track the impression.
* Note: If a content block is placed within a scrollable element
* (`overflow: scroll`), we can currently not detect when this block
* becomes visible.
* @param integer [timeIntervalInMs=750] Optional, you can define an interval to rescan the entire DOM
* for new impressions every X milliseconds by passing
* for instance `timeIntervalInMs=500` (rescan DOM every 500ms).
* Rescanning the entire DOM and detecting the visible state of content
* blocks can take a while depending on the browser and amount of content.
* In case your frames per second goes down you might want to increase
* this value or disable it by passing the value `0`.
*/
2021-01-06 17:54:39 +01:00
this.trackVisibleContentImpressions = function (checkOnScroll, timeIntervalInMs) {
2017-03-03 17:44:22 +01:00
if (isOverlaySession(configTrackerSiteId)) {
return;
}
2021-01-06 17:54:39 +01:00
if (!isDefined(checkOnScroll)) {
checkOnScroll = true;
2017-03-03 17:44:22 +01:00
}
if (!isDefined(timeIntervalInMs)) {
timeIntervalInMs = 750;
}
2021-01-06 17:54:39 +01:00
enableTrackOnlyVisibleContent(checkOnScroll, timeIntervalInMs, this);
2017-03-03 17:44:22 +01:00
trackCallback(function () {
trackCallbackOnLoad(function () {
// we have to wait till CSS parsed and applied
var contentNodes = content.findContentNodes();
var requests = getCurrentlyVisibleContentImpressionsRequestsIfNotTrackedYet(contentNodes);
2021-01-06 17:54:39 +01:00
requestQueue.pushMultiple(requests);
2017-03-03 17:44:22 +01:00
});
});
};
/**
* Tracks a content impression using the specified values. You should not call this method too often
* as each call causes an XHR tracking request and can slow down your site or your server.
*
* @param string contentName For instance "Ad Sale".
* @param string [contentPiece='Unknown'] For instance a path to an image or the text of a text ad.
* @param string [contentTarget] For instance the URL of a landing page.
*/
this.trackContentImpression = function (contentName, contentPiece, contentTarget) {
if (isOverlaySession(configTrackerSiteId)) {
return;
}
2021-01-06 17:54:39 +01:00
contentName = trim(contentName);
contentPiece = trim(contentPiece);
contentTarget = trim(contentTarget);
2017-03-03 17:44:22 +01:00
if (!contentName) {
return;
}
contentPiece = contentPiece || 'Unknown';
trackCallback(function () {
var request = buildContentImpressionRequest(contentName, contentPiece, contentTarget);
2021-01-06 17:54:39 +01:00
requestQueue.push(request);
2017-03-03 17:44:22 +01:00
});
};
/**
* Scans the given DOM node and its children for content blocks and tracks an impression for them if
* no impression was already tracked for it. If you have called `trackVisibleContentImpressions()`
* upfront only visible content blocks will be tracked. You can use this method if you, for instance,
* dynamically add an element using JavaScript to your DOM after we have tracked the initial impressions.
*
* @param Element domNode
*/
this.trackContentImpressionsWithinNode = function (domNode) {
if (isOverlaySession(configTrackerSiteId) || !domNode) {
return;
}
trackCallback(function () {
if (isTrackOnlyVisibleContentEnabled) {
trackCallbackOnLoad(function () {
// we have to wait till CSS parsed and applied
var contentNodes = content.findContentNodesWithinNode(domNode);
var requests = getCurrentlyVisibleContentImpressionsRequestsIfNotTrackedYet(contentNodes);
2021-01-06 17:54:39 +01:00
requestQueue.pushMultiple(requests);
2017-03-03 17:44:22 +01:00
});
} else {
trackCallbackOnReady(function () {
// we have to wait till DOM ready
var contentNodes = content.findContentNodesWithinNode(domNode);
var requests = getContentImpressionsRequestsFromNodes(contentNodes);
2021-01-06 17:54:39 +01:00
requestQueue.pushMultiple(requests);
2017-03-03 17:44:22 +01:00
});
}
});
};
/**
* Tracks a content interaction using the specified values. You should use this method only in conjunction
* with `trackContentImpression()`. The specified `contentName` and `contentPiece` has to be exactly the
* same as the ones that were used in `trackContentImpression()`. Otherwise the interaction will not count.
*
* @param string contentInteraction The type of interaction that happened. For instance 'click' or 'submit'.
* @param string contentName The name of the content. For instance "Ad Sale".
* @param string [contentPiece='Unknown'] The actual content. For instance a path to an image or the text of a text ad.
* @param string [contentTarget] For instance the URL of a landing page.
*/
this.trackContentInteraction = function (contentInteraction, contentName, contentPiece, contentTarget) {
if (isOverlaySession(configTrackerSiteId)) {
return;
}
2021-01-06 17:54:39 +01:00
contentInteraction = trim(contentInteraction);
contentName = trim(contentName);
contentPiece = trim(contentPiece);
contentTarget = trim(contentTarget);
2017-03-03 17:44:22 +01:00
if (!contentInteraction || !contentName) {
return;
}
contentPiece = contentPiece || 'Unknown';
trackCallback(function () {
var request = buildContentInteractionRequest(contentInteraction, contentName, contentPiece, contentTarget);
2021-01-06 17:54:39 +01:00
if (request) {
requestQueue.push(request);
}
2017-03-03 17:44:22 +01:00
});
};
/**
* Tracks an interaction with the given DOM node / content block.
*
* By default we track interactions on click but sometimes you might want to track interactions yourself.
* For instance you might want to track an interaction manually on a double click or a form submit.
* Make sure to disable the automatic interaction tracking in this case by specifying either the CSS
2021-01-06 17:54:39 +01:00
* class `matomoContentIgnoreInteraction` or the attribute `data-content-ignoreinteraction`.
2017-03-03 17:44:22 +01:00
*
* @param Element domNode This element itself or any of its parent elements has to be a content block
2021-01-06 17:54:39 +01:00
* element. Meaning one of those has to have a `matomoTrackContent` CSS class or
2017-03-03 17:44:22 +01:00
* a `data-track-content` attribute.
* @param string [contentInteraction='Unknown] The name of the interaction that happened. For instance
* 'click', 'formSubmit', 'DblClick', ...
*/
this.trackContentInteractionNode = function (domNode, contentInteraction) {
if (isOverlaySession(configTrackerSiteId) || !domNode) {
return;
}
2021-01-06 17:54:39 +01:00
var theRequest = null;
2017-03-03 17:44:22 +01:00
trackCallback(function () {
2021-01-06 17:54:39 +01:00
theRequest = buildContentInteractionRequestNode(domNode, contentInteraction);
if (theRequest) {
requestQueue.push(theRequest);
}
2017-03-03 17:44:22 +01:00
});
2021-01-06 17:54:39 +01:00
//note: return value is only for tests... will only work if dom is already ready...
return theRequest;
2017-03-03 17:44:22 +01:00
};
/**
* Useful to debug content tracking. This method will log all detected content blocks to console
* (if the browser supports the console). It will list the detected name, piece, and target of each
* content block.
*/
this.logAllContentBlocksOnPage = function () {
var contentNodes = content.findContentNodes();
var contents = content.collectContent(contentNodes);
2021-01-06 17:54:39 +01:00
// needed to write it this way for jslint
var consoleType = typeof console;
if (consoleType !== 'undefined' && console && console.log) {
2017-03-03 17:44:22 +01:00
console.log(contents);
}
};
/**
* Records an event
*
* @param string category The Event Category (Videos, Music, Games...)
* @param string action The Event's Action (Play, Pause, Duration, Add Playlist, Downloaded, Clicked...)
* @param string name (optional) The Event's object Name (a particular Movie name, or Song name, or File name...)
* @param float value (optional) The Event's value
* @param function callback
* @param mixed customData
*/
this.trackEvent = function (category, action, name, value, customData, callback) {
trackCallback(function () {
logEvent(category, action, name, value, customData, callback);
});
};
/**
* Log special pageview: Internal search
*
* @param string keyword
* @param string category
* @param int resultsCount
* @param mixed customData
*/
this.trackSiteSearch = function (keyword, category, resultsCount, customData) {
2021-01-06 17:54:39 +01:00
trackedContentImpressions = [];
2017-03-03 17:44:22 +01:00
trackCallback(function () {
logSiteSearch(keyword, category, resultsCount, customData);
});
};
/**
* Used to record that the current page view is an item (product) page view, or a Ecommerce Category page view.
* This must be called before trackPageView() on the product/category page.
*
* On a category page, you can set the parameter category, and set the other parameters to empty string or false
*
2021-01-06 17:54:39 +01:00
* Tracking Product/Category page views will allow Matomo to report on Product & Categories
2017-03-03 17:44:22 +01:00
* conversion rates (Conversion rate = Ecommerce orders containing this product or category / Visits to the product or category)
*
* @param string sku Item's SKU code being viewed
* @param string name Item's Name being viewed
* @param string category Category page being viewed. On an Item's page, this is the item's category
2021-01-06 17:54:39 +01:00
* @param float price Item's display price, not use in standard Matomo reports, but output in API product reports.
2017-03-03 17:44:22 +01:00
*/
this.setEcommerceView = function (sku, name, category, price) {
2021-01-06 17:54:39 +01:00
ecommerceProductView = {};
if (isNumberOrHasLength(category)) {
category = String(category);
}
if (!isDefined(category) || category === null || category === false || !category.length) {
2017-03-03 17:44:22 +01:00
category = "";
} else if (category instanceof Array) {
2021-01-06 17:54:39 +01:00
category = windowAlias.JSON.stringify(category);
2017-03-03 17:44:22 +01:00
}
2021-01-06 17:54:39 +01:00
var param = '_pkc';
ecommerceProductView[param] = category;
2017-03-03 17:44:22 +01:00
2021-01-06 17:54:39 +01:00
if (isDefined(price) && price !== null && price !== false && String(price).length) {
param = '_pkp';
ecommerceProductView[param] = price;
2017-03-03 17:44:22 +01:00
}
// On a category page, do not track Product name not defined
2021-01-06 17:54:39 +01:00
if (!isNumberOrHasLength(sku) && !isNumberOrHasLength(name)) {
2017-03-03 17:44:22 +01:00
return;
}
2021-01-06 17:54:39 +01:00
if (isNumberOrHasLength(sku)) {
param = '_pks';
ecommerceProductView[param] = sku;
2017-03-03 17:44:22 +01:00
}
2021-01-06 17:54:39 +01:00
if (!isNumberOrHasLength(name)) {
2017-03-03 17:44:22 +01:00
name = "";
}
2021-01-06 17:54:39 +01:00
param = '_pkn';
ecommerceProductView[param] = name;
};
/**
* Returns the list of ecommerce items that will be sent when a cart update or order is tracked.
* The returned value is read-only, modifications will not change what will be tracked. Use
* addEcommerceItem/removeEcommerceItem/clearEcommerceCart to modify what items will be tracked.
*
* Note: the cart will be cleared after an order.
*
* @returns array
*/
this.getEcommerceItems = function () {
return JSON.parse(JSON.stringify(ecommerceItems));
2017-03-03 17:44:22 +01:00
};
/**
* Adds an item (product) that is in the current Cart or in the Ecommerce order.
* This function is called for every item (product) in the Cart or the Order.
* The only required parameter is sku.
* The items are deleted from this JavaScript object when the Ecommerce order is tracked via the method trackEcommerceOrder.
*
2021-01-06 17:54:39 +01:00
* If there is already a saved item for the given sku, it will be updated with the
* new information.
*
2017-03-03 17:44:22 +01:00
* @param string sku (required) Item's SKU Code. This is the unique identifier for the product.
* @param string name (optional) Item's name
* @param string name (optional) Item's category, or array of up to 5 categories
* @param float price (optional) Item's price. If not specified, will default to 0
* @param float quantity (optional) Item's quantity. If not specified, will default to 1
*/
this.addEcommerceItem = function (sku, name, category, price, quantity) {
2021-01-06 17:54:39 +01:00
if (isNumberOrHasLength(sku)) {
ecommerceItems[sku] = [ String(sku), name, category, price, quantity ];
}
};
/**
* Removes a single ecommerce item by SKU from the current cart.
*
* @param string sku (required) Item's SKU Code. This is the unique identifier for the product.
*/
this.removeEcommerceItem = function (sku) {
if (isNumberOrHasLength(sku)) {
sku = String(sku);
delete ecommerceItems[sku];
2017-03-03 17:44:22 +01:00
}
};
2021-01-06 17:54:39 +01:00
/**
* Clears the current cart, removing all saved ecommerce items. Call this method to manually clear
* the cart before sending an ecommerce order.
*/
this.clearEcommerceCart = function () {
ecommerceItems = {};
};
2017-03-03 17:44:22 +01:00
/**
* Tracks an Ecommerce order.
* If the Ecommerce order contains items (products), you must call first the addEcommerceItem() for each item in the order.
2021-01-06 17:54:39 +01:00
* All revenues (grandTotal, subTotal, tax, shipping, discount) will be individually summed and reported in Matomo reports.
2017-03-03 17:44:22 +01:00
* Parameters orderId and grandTotal are required. For others, you can set to false if you don't need to specify them.
* After calling this method, items added to the cart will be removed from this JavaScript object.
*
* @param string|int orderId (required) Unique Order ID.
* This will be used to count this order only once in the event the order page is reloaded several times.
2021-01-06 17:54:39 +01:00
* orderId must be unique for each transaction, even on different days, or the transaction will not be recorded by Matomo.
2017-03-03 17:44:22 +01:00
* @param float grandTotal (required) Grand Total revenue of the transaction (including tax, shipping, etc.)
* @param float subTotal (optional) Sub total amount, typically the sum of items prices for all items in this order (before Tax and Shipping costs are applied)
* @param float tax (optional) Tax amount for this order
* @param float shipping (optional) Shipping amount for this order
* @param float discount (optional) Discounted amount in this order
*/
this.trackEcommerceOrder = function (orderId, grandTotal, subTotal, tax, shipping, discount) {
logEcommerceOrder(orderId, grandTotal, subTotal, tax, shipping, discount);
};
/**
* Tracks a Cart Update (add item, remove item, update item).
* On every Cart update, you must call addEcommerceItem() for each item (product) in the cart, including the items that haven't been updated since the last cart update.
* Then you can call this function with the Cart grandTotal (typically the sum of all items' prices)
* Calling this method does not remove from this JavaScript object the items that were added to the cart via addEcommerceItem
*
* @param float grandTotal (required) Items (products) amount in the Cart
*/
this.trackEcommerceCartUpdate = function (grandTotal) {
logEcommerceCartUpdate(grandTotal);
};
/**
* Sends a tracking request with custom request parameters.
2021-01-06 17:54:39 +01:00
* Matomo will prepend the hostname and path to Matomo, as well as all other needed tracking request
2017-03-03 17:44:22 +01:00
* parameters prior to sending the request. Useful eg if you track custom dimensions via a plugin.
*
* @param request eg. "param=value&param2=value2"
* @param customData
* @param callback
* @param pluginMethod
*/
this.trackRequest = function (request, customData, callback, pluginMethod) {
trackCallback(function () {
var fullRequest = getRequest(request, customData, pluginMethod);
sendRequest(fullRequest, configTrackerPause, callback);
});
};
2021-01-06 17:54:39 +01:00
/**
* Sends a ping request.
*
* Ping requests do not track new actions. If they are sent within the standard visit length, they will
* extend the existing visit and the current last action for the visit. If after the standard visit
* length, ping requests will create a new visit using the last action in the last known visit.
*/
this.ping = function () {
this.trackRequest('ping=1', null, null, 'ping');
};
/**
* Disables sending requests queued
*/
this.disableQueueRequest = function () {
requestQueue.enabled = false;
};
/**
* Defines after how many ms a queued requests will be executed after the request was queued initially.
* The higher the value the more tracking requests can be send together at once.
*/
this.setRequestQueueInterval = function (interval) {
if (interval < 1000) {
throw new Error('Request queue interval needs to be at least 1000ms');
}
requestQueue.interval = interval;
};
/**
* Won't send the tracking request directly but wait for a short time to possibly send this tracking request
* along with other tracking requests in one go. This can reduce the number of requests send to your server.
* If the page unloads (user navigates to another page or closes the browser), then all remaining queued
* requests will be sent immediately so that no tracking request gets lost.
* Note: Any queued request may not be possible to be replayed in case a POST request is sent. Only queue
* requests that don't have to be replayed.
*
* @param request eg. "param=value&param2=value2"
*/
this.queueRequest = function (request) {
trackCallback(function () {
var fullRequest = getRequest(request);
requestQueue.push(fullRequest);
});
};
/**
* Returns whether consent is required or not.
*
* @returns boolean
*/
this.isConsentRequired = function()
{
return configConsentRequired;
};
/**
* If the user has given consent previously and this consent was remembered, it will return the number
* in milliseconds since 1970/01/01 which is the date when the user has given consent. Please note that
* the returned time depends on the users local time which may not always be correct.
*
* @returns number|string
*/
this.getRememberedConsent = function () {
var value = getCookie(CONSENT_COOKIE_NAME);
if (getCookie(CONSENT_REMOVED_COOKIE_NAME)) {
// if for some reason the consent_removed cookie is also set with the consent cookie, the
// consent_removed cookie overrides the consent one, and we make sure to delete the consent
// cookie.
if (value) {
deleteCookie(CONSENT_COOKIE_NAME, configCookiePath, configCookieDomain);
}
return null;
}
if (!value || value === 0) {
return null;
}
return value;
};
/**
* Detects whether the user has given consent previously.
*
* @returns bool
*/
this.hasRememberedConsent = function () {
return !!this.getRememberedConsent();
};
/**
* When called, no tracking request will be sent to the Matomo server until you have called `setConsentGiven()`
* unless consent was given previously AND you called {@link rememberConsentGiven()} when the user gave her
* or his consent.
*
* This may be useful when you want to implement for example a popup to ask for consent before tracking the user.
* Once the user has given consent, you should call {@link setConsentGiven()} or {@link rememberConsentGiven()}.
*
* If you require consent for tracking personal data for example, you should first call
* `_paq.push(['requireConsent'])`.
*
* If the user has already given consent in the past, you can either decide to not call `requireConsent` at all
* or call `_paq.push(['setConsentGiven'])` on each page view at any time after calling `requireConsent`.
*
* When the user gives you the consent to track data, you can also call `_paq.push(['rememberConsentGiven', optionalTimeoutInHours])`
* and for the duration while the consent is remembered, any call to `requireConsent` will be automatically ignored until you call `forgetConsentGiven`.
* `forgetConsentGiven` needs to be called when the user removes consent for tracking. This means if you call `rememberConsentGiven` at the
* time the user gives you consent, you do not need to ever call `_paq.push(['setConsentGiven'])`.
*/
this.requireConsent = function () {
configConsentRequired = true;
configHasConsent = this.hasRememberedConsent();
if (!configHasConsent) {
// we won't call this.disableCookies() since we don't want to delete any cookies just yet
// user might call `setConsentGiven` next
configCookiesDisabled = true;
}
// Matomo.addPlugin might not be defined at this point, we add the plugin directly also to make JSLint happy
// We also want to make sure to define an unload listener for each tracker, not only one tracker.
coreConsentCounter++;
plugins['CoreConsent' + coreConsentCounter] = {
unload: function () {
if (!configHasConsent) {
// we want to make sure to remove all previously set cookies again
deleteCookies();
}
}
};
};
/**
* Call this method once the user has given consent. This will cause all tracking requests from this
* page view to be sent. Please note that the given consent won't be remembered across page views. If you
* want to remember consent across page views, call {@link rememberConsentGiven()} instead.
*
* It will also automatically enable cookies if they were disabled previously.
*
* @param bool [setCookieConsent=true] Internal parameter. Defines whether cookies should be enabled or not.
*/
this.setConsentGiven = function (setCookieConsent) {
configHasConsent = true;
deleteCookie(CONSENT_REMOVED_COOKIE_NAME, configCookiePath, configCookieDomain);
var i, requestType;
for (i = 0; i < consentRequestsQueue.length; i++) {
requestType = typeof consentRequestsQueue[i];
if (requestType === 'string') {
sendRequest(consentRequestsQueue[i], configTrackerPause);
} else if (requestType === 'object') {
sendBulkRequest(consentRequestsQueue[i], configTrackerPause);
}
}
consentRequestsQueue = [];
// we need to enable cookies after sending the previous requests as it will make sure that we send
// a ping request if needed. Cookies are only set once we call `getRequest`. Above only calls sendRequest
// meaning no cookies will be created unless we called enableCookies after at least one request has been sent.
// this will cause a ping request to be sent that sets the cookies and also updates the newly generated visitorId
// on the server.
// If the user calls setConsentGiven before sending any tracking request (which usually is the case) then
// nothing will need to be done as it only enables cookies and the next tracking request will set the cookies
// etc.
if (!isDefined(setCookieConsent) || setCookieConsent) {
this.setCookieConsentGiven();
}
};
/**
* Calling this method will remember that the user has given consent across multiple requests by setting
* a cookie. You can optionally define the lifetime of that cookie in hours using a parameter.
*
* When you call this method, we imply that the user has given consent for this page view, and will also
* imply consent for all future page views unless the cookie expires (if timeout defined) or the user
* deletes all her or his cookies. This means even if you call {@link requireConsent()}, then all requests
* will still be tracked.
*
* Please note that this feature requires you to set the `cookieDomain` and `cookiePath` correctly and requires
* that you do not disable cookies. Please also note that when you call this method, consent will be implied
* for all sites that match the configured cookieDomain and cookiePath. Depending on your website structure,
* you may need to restrict or widen the scope of the cookie domain/path to ensure the consent is applied
* to the sites you want.
*
* @param int hoursToExpire After how many hours the consent should expire. By default the consent is valid
* for 30 years unless cookies are deleted by the user or the browser prior to this
*/
this.rememberConsentGiven = function (hoursToExpire) {
if (hoursToExpire) {
hoursToExpire = hoursToExpire * 60 * 60 * 1000;
} else {
hoursToExpire = 30 * 365 * 24 * 60 * 60 * 1000;
}
var setCookieConsent = true;
// we currently always enable cookies if we remember consent cause we don't store across requests whether
// cookies should be automatically enabled or not.
this.setConsentGiven(setCookieConsent);
var now = new Date().getTime();
setCookie(CONSENT_COOKIE_NAME, now, hoursToExpire, configCookiePath, configCookieDomain, configCookieIsSecure, configCookieSameSite);
};
/**
* Calling this method will remove any previously given consent and during this page view no request
* will be sent anymore ({@link requireConsent()}) will be called automatically to ensure the removed
* consent will be enforced. You may call this method if the user removes consent manually, or if you
* want to re-ask for consent after a specific time period.
*/
this.forgetConsentGiven = function () {
var thirtyYears = 30 * 365 * 24 * 60 * 60 * 1000;
deleteCookie(CONSENT_COOKIE_NAME, configCookiePath, configCookieDomain);
setCookie(CONSENT_REMOVED_COOKIE_NAME, new Date().getTime(), thirtyYears, configCookiePath, configCookieDomain, configCookieIsSecure, configCookieSameSite);
this.forgetCookieConsentGiven();
this.requireConsent();
};
/**
* Returns true if user is opted out, false if otherwise.
*
* @returns {boolean}
*/
this.isUserOptedOut = function () {
return !configHasConsent;
};
/**
* Alias for forgetConsentGiven(). After calling this function, the user will no longer be tracked,
* (even if they come back to the site).
*/
this.optUserOut = this.forgetConsentGiven;
/**
* Alias for rememberConsentGiven(). After calling this function, the current user will be tracked.
*/
this.forgetUserOptOut = function () {
// we can't automatically enable cookies here as we don't know if user actually gave consent for cookies
this.setConsentGiven(false);
};
/**
* Mark performance metrics as available, once onload event has finished
*/
trackCallbackOnLoad(function(){
setTimeout(function(){
performanceAvailable = true;
}, 0);
});
Matomo.trigger('TrackerSetup', [this]);
2017-03-03 17:44:22 +01:00
}
function TrackerProxy() {
return {
push: apply
};
}
/**
* Applies the given methods in the given order if they are present in paq.
*
* @param {Array} paq
* @param {Array} methodsToApply an array containing method names in the order that they should be applied
* eg ['setSiteId', 'setTrackerUrl']
* @returns {Array} the modified paq array with the methods that were already applied set to undefined
*/
function applyMethodsInOrder(paq, methodsToApply)
{
var appliedMethods = {};
var index, iterator;
for (index = 0; index < methodsToApply.length; index++) {
var methodNameToApply = methodsToApply[index];
appliedMethods[methodNameToApply] = 1;
for (iterator = 0; iterator < paq.length; iterator++) {
if (paq[iterator] && paq[iterator][0]) {
var methodName = paq[iterator][0];
if (methodNameToApply === methodName) {
apply(paq[iterator]);
delete paq[iterator];
2021-01-06 17:54:39 +01:00
if (appliedMethods[methodName] > 1
&& methodName !== "addTracker") {
logConsoleError('The method ' + methodName + ' is registered more than once in "_paq" variable. Only the last call has an effect. Please have a look at the multiple Matomo trackers documentation: https://developer.matomo.org/guides/tracking-javascript-guide#multiple-piwik-trackers');
2017-03-03 17:44:22 +01:00
}
appliedMethods[methodName]++;
}
}
}
}
return paq;
}
/************************************************************
* Constructor
************************************************************/
2021-01-06 17:54:39 +01:00
var applyFirst = ['addTracker', 'forgetCookieConsentGiven', 'requireCookieConsent', 'disableCookies', 'setTrackerUrl', 'setAPIUrl', 'enableCrossDomainLinking', 'setCrossDomainLinkingTimeout', 'setSessionCookieTimeout', 'setVisitorCookieTimeout', 'setCookieNamePrefix', 'setCookieSameSite', 'setSecureCookie', 'setCookiePath', 'setCookieDomain', 'setDomains', 'setUserId', 'setVisitorId', 'setSiteId', 'alwaysUseSendBeacon', 'enableLinkTracking', 'setCookieConsentGiven', 'requireConsent', 'setConsentGiven', 'disablePerformanceTracking'];
2017-03-03 17:44:22 +01:00
2021-01-06 17:54:39 +01:00
function createFirstTracker(matomoUrl, siteId)
2017-03-03 17:44:22 +01:00
{
2021-01-06 17:54:39 +01:00
var tracker = new Tracker(matomoUrl, siteId);
2017-03-03 17:44:22 +01:00
asyncTrackers.push(tracker);
_paq = applyMethodsInOrder(_paq, applyFirst);
// apply the queue of actions
for (iterator = 0; iterator < _paq.length; iterator++) {
if (_paq[iterator]) {
apply(_paq[iterator]);
}
}
// replace initialization array with proxy object
_paq = new TrackerProxy();
2021-01-06 17:54:39 +01:00
Matomo.trigger('TrackerAdded', [tracker]);
2017-03-03 17:44:22 +01:00
return tracker;
}
/************************************************************
* Proxy object
* - this allows the caller to continue push()'ing to _paq
* after the Tracker has been initialized and loaded
************************************************************/
2021-01-06 17:54:39 +01:00
// initialize the Matomo singleton
2017-03-03 17:44:22 +01:00
addEventListener(windowAlias, 'beforeunload', beforeUnloadHandler, false);
2021-01-06 17:54:39 +01:00
addEventListener(windowAlias, 'online', function () {
if (isDefined(navigatorAlias.serviceWorker) && isDefined(navigatorAlias.serviceWorker.ready)) {
navigatorAlias.serviceWorker.ready.then(function(swRegistration) {
return swRegistration.sync.register('matomoSync');
});
}
}, false);
addEventListener(windowAlias,'message', function(e) {
if (!e || !e.origin) {
return;
}
var tracker, i, matomoHost;
var originHost = getHostName(e.origin);
var trackers = Matomo.getAsyncTrackers();
for (i = 0; i < trackers.length; i++) {
matomoHost = getHostName(trackers[i].getMatomoUrl());
// find the matching tracker
if (matomoHost === originHost) {
tracker = trackers[i];
break;
}
}
if (!tracker) {
// no matching tracker
// Don't accept the message unless it came from the expected origin
return;
}
var data = null;
try {
data = JSON.parse(e.data);
} catch (ex) {
return;
}
if (!data) {
return;
}
function postMessageToCorrectFrame(postMessage){
// Find the iframe with the right URL to send it back to
var iframes = documentAlias.getElementsByTagName('iframe');
for (i = 0; i < iframes.length; i++) {
var iframe = iframes[i];
var iframeHost = getHostName(iframe.src);
if (iframe.contentWindow && isDefined(iframe.contentWindow.postMessage) && iframeHost === originHost) {
var jsonMessage = JSON.stringify(postMessage);
iframe.contentWindow.postMessage(jsonMessage, '*');
}
}
}
// This listener can process two kinds of messages
// 1) maq_initial_value => sent by optout iframe when it finishes loading. Passes the value of the third
// party opt-out cookie (if set) - we need to use this and any first-party cookies that are present to
// initialise the configHasConsent value and send back the result so that the display can be updated.
// 2) maq_opted_in => sent by optout iframe when the user changes their optout setting. We need to update
// our first-party cookie.
if (isDefined(data.maq_initial_value)) {
// Make a message to tell the optout iframe about the current state
postMessageToCorrectFrame({
maq_opted_in: data.maq_initial_value && tracker.hasConsent(),
maq_url: tracker.getMatomoUrl(),
maq_optout_by_default: tracker.isConsentRequired()
});
} else if (isDefined(data.maq_opted_in)) {
// perform the opt in or opt out...
trackers = Matomo.getAsyncTrackers();
for (i = 0; i < trackers.length; i++) {
tracker = trackers[i];
if (data.maq_opted_in) {
tracker.rememberConsentGiven();
} else {
tracker.forgetConsentGiven();
}
}
// Make a message to tell the optout iframe about the current state
postMessageToCorrectFrame({
maq_confirm_opted_in: tracker.hasConsent(),
maq_url: tracker.getMatomoUrl(),
maq_optout_by_default: tracker.isConsentRequired()
});
}
}, false);
2017-03-03 17:44:22 +01:00
Date.prototype.getTimeAlias = Date.prototype.getTime;
/************************************************************
* Public data and methods
************************************************************/
2021-01-06 17:54:39 +01:00
Matomo = {
2017-03-03 17:44:22 +01:00
initialized: false,
2021-01-06 17:54:39 +01:00
JSON: windowAlias.JSON,
2017-03-03 17:44:22 +01:00
/**
* DOM Document related methods
*/
DOM: {
/**
* Adds an event listener to the given element.
* @param element
* @param eventType
* @param eventHandler
* @param useCapture Optional
*/
addEventListener: function (element, eventType, eventHandler, useCapture) {
var captureType = typeof useCapture;
if (captureType === 'undefined') {
useCapture = false;
}
addEventListener(element, eventType, eventHandler, useCapture);
},
/**
* Specify a function to execute when the DOM is fully loaded.
*
* If the DOM is already loaded, the function will be executed immediately.
*
* @param function callback
*/
onLoad: trackCallbackOnLoad,
/**
* Specify a function to execute when the DOM is ready.
*
* If the DOM is already ready, the function will be executed immediately.
*
* @param function callback
*/
onReady: trackCallbackOnReady,
/**
* Detect whether a node is visible right now.
*/
isNodeVisible: isVisible,
/**
* Detect whether a node has been visible at some point
*/
isOrWasNodeVisible: content.isNodeVisible
},
/**
* Listen to an event and invoke the handler when a the event is triggered.
*
* @param string event
* @param function handler
*/
on: function (event, handler) {
if (!eventHandlers[event]) {
eventHandlers[event] = [];
}
eventHandlers[event].push(handler);
},
/**
* Remove a handler to no longer listen to the event. Must pass the same handler that was used when
* attaching the event via ".on".
* @param string event
* @param function handler
*/
off: function (event, handler) {
if (!eventHandlers[event]) {
return;
}
var i = 0;
for (i; i < eventHandlers[event].length; i++) {
if (eventHandlers[event][i] === handler) {
eventHandlers[event].splice(i, 1);
}
}
},
/**
* Triggers the given event and passes the parameters to all handlers.
*
* @param string event
* @param Array extraParameters
* @param Object context If given the handler will be executed in this context
*/
trigger: function (event, extraParameters, context) {
if (!eventHandlers[event]) {
return;
}
var i = 0;
for (i; i < eventHandlers[event].length; i++) {
eventHandlers[event][i].apply(context || windowAlias, extraParameters);
}
},
/**
* Add plugin
*
* @param string pluginName
* @param Object pluginObj
*/
addPlugin: function (pluginName, pluginObj) {
plugins[pluginName] = pluginObj;
},
/**
* Get Tracker (factory method)
*
2021-01-06 17:54:39 +01:00
* @param string matomoUrl
2017-03-03 17:44:22 +01:00
* @param int|string siteId
* @return Tracker
*/
2021-01-06 17:54:39 +01:00
getTracker: function (matomoUrl, siteId) {
2017-03-03 17:44:22 +01:00
if (!isDefined(siteId)) {
siteId = this.getAsyncTracker().getSiteId();
}
2021-01-06 17:54:39 +01:00
if (!isDefined(matomoUrl)) {
matomoUrl = this.getAsyncTracker().getTrackerUrl();
2017-03-03 17:44:22 +01:00
}
2021-01-06 17:54:39 +01:00
return new Tracker(matomoUrl, siteId);
2017-03-03 17:44:22 +01:00
},
/**
* Get all created async trackers
*
* @return Tracker[]
*/
getAsyncTrackers: function () {
return asyncTrackers;
},
/**
2021-01-06 17:54:39 +01:00
* Adds a new tracker. All sent requests will be also sent to the given siteId and matomoUrl.
* If matomoUrl is not set, current url will be used.
2017-03-03 17:44:22 +01:00
*
2021-01-06 17:54:39 +01:00
* @param null|string matomoUrl If null, will reuse the same tracker URL of the current tracker instance
2017-03-03 17:44:22 +01:00
* @param int|string siteId
* @return Tracker
*/
2021-01-06 17:54:39 +01:00
addTracker: function (matomoUrl, siteId) {
var tracker;
2017-03-03 17:44:22 +01:00
if (!asyncTrackers.length) {
2021-01-06 17:54:39 +01:00
tracker = createFirstTracker(matomoUrl, siteId);
2017-03-03 17:44:22 +01:00
} else {
2021-01-06 17:54:39 +01:00
tracker = asyncTrackers[0].addTracker(matomoUrl, siteId);
2017-03-03 17:44:22 +01:00
}
2021-01-06 17:54:39 +01:00
return tracker;
2017-03-03 17:44:22 +01:00
},
/**
* Get internal asynchronous tracker object.
*
2021-01-06 17:54:39 +01:00
* If no parameters are given, it returns the internal asynchronous tracker object. If a matomoUrl and idSite
2017-03-03 17:44:22 +01:00
* is given, it will try to find an optional
*
2021-01-06 17:54:39 +01:00
* @param string matomoUrl
2017-03-03 17:44:22 +01:00
* @param int|string siteId
* @return Tracker
*/
2021-01-06 17:54:39 +01:00
getAsyncTracker: function (matomoUrl, siteId) {
2017-03-03 17:44:22 +01:00
var firstTracker;
if (asyncTrackers && asyncTrackers.length && asyncTrackers[0]) {
firstTracker = asyncTrackers[0];
} else {
2021-01-06 17:54:39 +01:00
return createFirstTracker(matomoUrl, siteId);
2017-03-03 17:44:22 +01:00
}
2021-01-06 17:54:39 +01:00
if (!siteId && !matomoUrl) {
// for BC and by default we just return the initially created tracker
2017-03-03 17:44:22 +01:00
return firstTracker;
}
// we look for another tracker created via `addTracker` method
if ((!isDefined(siteId) || null === siteId) && firstTracker) {
siteId = firstTracker.getSiteId();
}
2021-01-06 17:54:39 +01:00
if ((!isDefined(matomoUrl) || null === matomoUrl) && firstTracker) {
matomoUrl = firstTracker.getTrackerUrl();
2017-03-03 17:44:22 +01:00
}
var tracker, i = 0;
for (i; i < asyncTrackers.length; i++) {
tracker = asyncTrackers[i];
if (tracker
&& String(tracker.getSiteId()) === String(siteId)
2021-01-06 17:54:39 +01:00
&& tracker.getTrackerUrl() === matomoUrl) {
2017-03-03 17:44:22 +01:00
return tracker;
}
}
},
/**
* When calling plugin methods via "_paq.push(['...'])" and the plugin is loaded separately because
2021-01-06 17:54:39 +01:00
* matomo.js is not writable then there is a chance that first matomo.js is loaded and later the plugin.
2017-03-03 17:44:22 +01:00
* In this case we would have already executed all "_paq.push" methods and they would not have succeeded
* because the plugin will be loaded only later. In this case, once a plugin is loaded, it should call
2021-01-06 17:54:39 +01:00
* "Matomo.retryMissedPluginCalls()" so they will be executed after all.
2017-03-03 17:44:22 +01:00
*/
retryMissedPluginCalls: function () {
var missedCalls = missedPluginTrackerCalls;
missedPluginTrackerCalls = [];
var i = 0;
for (i; i < missedCalls.length; i++) {
apply(missedCalls[i]);
}
}
2021-01-06 17:54:39 +01:00
};
// Expose Matomo as an AMD module
2017-03-03 17:44:22 +01:00
if (typeof define === 'function' && define.amd) {
2021-01-06 17:54:39 +01:00
define('piwik', [], function () { return Matomo; });
define('matomo', [], function () { return Matomo; });
2017-03-03 17:44:22 +01:00
}
2021-01-06 17:54:39 +01:00
return Matomo;
2017-03-03 17:44:22 +01:00
}());
}
/*!! pluginTrackerHook */
(function () {
'use strict';
function hasPaqConfiguration()
{
if ('object' !== typeof _paq) {
return false;
}
// needed to write it this way for jslint
var lengthType = typeof _paq.length;
if ('undefined' === lengthType) {
return false;
}
return !!_paq.length;
}
if (window
2021-01-06 17:54:39 +01:00
&& 'object' === typeof window.matomoPluginAsyncInit
&& window.matomoPluginAsyncInit.length) {
2017-03-03 17:44:22 +01:00
var i = 0;
2021-01-06 17:54:39 +01:00
for (i; i < window.matomoPluginAsyncInit.length; i++) {
if (typeof window.matomoPluginAsyncInit[i] === 'function') {
window.matomoPluginAsyncInit[i]();
2017-03-03 17:44:22 +01:00
}
}
}
if (window && window.piwikAsyncInit) {
window.piwikAsyncInit();
}
2021-01-06 17:54:39 +01:00
if (window && window.matomoAsyncInit) {
window.matomoAsyncInit();
}
if (!window.Matomo.getAsyncTrackers().length) {
// we only create an initial tracker when no other async tracker has been created yet in matomoAsyncInit()
2017-03-03 17:44:22 +01:00
if (hasPaqConfiguration()) {
// we only create an initial tracker if there is a configuration for it via _paq. Otherwise
2021-01-06 17:54:39 +01:00
// Matomo.getAsyncTrackers() would return unconfigured trackers
window.Matomo.addTracker();
2017-03-03 17:44:22 +01:00
} else {
_paq = {push: function (args) {
2021-01-06 17:54:39 +01:00
// needed to write it this way for jslint
var consoleType = typeof console;
if (consoleType !== 'undefined' && console && console.error) {
console.error('_paq.push() was used but Matomo tracker was not initialized before the matomo.js file was loaded. Make sure to configure the tracker via _paq.push before loading matomo.js. Alternatively, you can create a tracker via Matomo.addTracker() manually and then use _paq.push but it may not fully work as tracker methods may not be executed in the correct order.', args);
}
}};
2017-03-03 17:44:22 +01:00
}
}
2021-01-06 17:54:39 +01:00
window.Matomo.trigger('MatomoInitialized', []);
window.Matomo.initialized = true;
2017-03-03 17:44:22 +01:00
}());
/*jslint sloppy: true */
(function () {
2021-01-06 17:54:39 +01:00
var jsTrackerType = (typeof window.AnalyticsTracker);
2017-03-03 17:44:22 +01:00
if (jsTrackerType === 'undefined') {
2021-01-06 17:54:39 +01:00
window.AnalyticsTracker = window.Matomo;
2017-03-03 17:44:22 +01:00
}
}());
/*jslint sloppy: false */
/************************************************************
* Deprecated functionality below
* Legacy piwik.js compatibility ftw
************************************************************/
/*
2021-01-06 17:54:39 +01:00
* Matomo globals
2017-03-03 17:44:22 +01:00
*
* var piwik_install_tracker, piwik_tracker_pause, piwik_download_extensions, piwik_hosts_alias, piwik_ignore_classes;
*/
/*global piwik_log:true */
/*global piwik_track:true */
/**
* Track page visit
*
* @param string documentTitle
* @param int|string siteId
2021-01-06 17:54:39 +01:00
* @param string matomoUrl
2017-03-03 17:44:22 +01:00
* @param mixed customData
*/
2021-01-06 17:54:39 +01:00
if (typeof window.piwik_log !== 'function') {
window.piwik_log = function (documentTitle, siteId, matomoUrl, customData) {
2017-03-03 17:44:22 +01:00
'use strict';
function getOption(optionName) {
try {
if (window['piwik_' + optionName]) {
return window['piwik_' + optionName];
}
} catch (ignore) { }
return; // undefined
}
// instantiate the tracker
var option,
2021-01-06 17:54:39 +01:00
matomoTracker = window.Matomo.getTracker(matomoUrl, siteId);
2017-03-03 17:44:22 +01:00
// initialize tracker
2021-01-06 17:54:39 +01:00
matomoTracker.setDocumentTitle(documentTitle);
matomoTracker.setCustomData(customData);
2017-03-03 17:44:22 +01:00
2021-01-06 17:54:39 +01:00
// handle Matomo globals
2017-03-03 17:44:22 +01:00
option = getOption('tracker_pause');
if (option) {
2021-01-06 17:54:39 +01:00
matomoTracker.setLinkTrackingTimer(option);
2017-03-03 17:44:22 +01:00
}
option = getOption('download_extensions');
if (option) {
2021-01-06 17:54:39 +01:00
matomoTracker.setDownloadExtensions(option);
2017-03-03 17:44:22 +01:00
}
option = getOption('hosts_alias');
if (option) {
2021-01-06 17:54:39 +01:00
matomoTracker.setDomains(option);
2017-03-03 17:44:22 +01:00
}
option = getOption('ignore_classes');
if (option) {
2021-01-06 17:54:39 +01:00
matomoTracker.setIgnoreClasses(option);
2017-03-03 17:44:22 +01:00
}
// track this page view
2021-01-06 17:54:39 +01:00
matomoTracker.trackPageView();
2017-03-03 17:44:22 +01:00
// default is to install the link tracker
if (getOption('install_tracker')) {
/**
* Track click manually (function is defined below)
*
* @param string sourceUrl
* @param int|string siteId
2021-01-06 17:54:39 +01:00
* @param string matomoUrl
2017-03-03 17:44:22 +01:00
* @param string linkType
*/
2021-01-06 17:54:39 +01:00
piwik_track = function (sourceUrl, siteId, matomoUrl, linkType) {
matomoTracker.setSiteId(siteId);
matomoTracker.setTrackerUrl(matomoUrl);
matomoTracker.trackLink(sourceUrl, linkType);
2017-03-03 17:44:22 +01:00
};
// set-up link tracking
2021-01-06 17:54:39 +01:00
matomoTracker.enableLinkTracking();
2017-03-03 17:44:22 +01:00
}
};
}
/*! @license-end */