PHPackages                             firelink/tracker-proxy - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. firelink/tracker-proxy

ActiveLibrary

firelink/tracker-proxy
======================

Fork for matomo-org/tracker-proxy with composer.json

1.1.0(5y ago)025.5k↓83.3%PHP

Since Sep 28Pushed 5y agoCompare

[ Source](https://github.com/firelink-media/tracker-proxy)[ Packagist](https://packagist.org/packages/firelink/tracker-proxy)[ RSS](/packages/firelink-tracker-proxy/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)DependenciesVersions (2)Used By (0)

Matomo Tracker Proxy
====================

[](#matomo-tracker-proxy)

[![Build Status](https://camo.githubusercontent.com/c3b2e2ca1044cc9b21fc44426d7d63dbaa7227f8dc16819e5dbb71ce884beee3/68747470733a2f2f7472617669732d63692e6f72672f6d61746f6d6f2d6f72672f747261636b65722d70726f78792e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/matomo-org/tracker-proxy)

This script allows to track websites with Matomo **without revealing the Matomo server URL**.

This is useful for users who track multiple websites on the same Matomo server, but don't want to show the Matomo server URL in the source code of all tracked websites.

Requirements
------------

[](#requirements)

To run this properly you will need:

- latest version of Matomo installed on a server
- one or several website(s) to track with this Matomo, for example
- the website to track must run on a server with PHP 5.3 or higher
- PHP must have either the CURL extension enabled or `allow_url_fopen=On`

Installation
------------

[](#installation)

### 1. Create a user in Matomo

[](#1-create-a-user-in-matomo)

In your Matomo server:

- login as Super user
- create a user, set the login for example: "UserTrackingAPI"
- assign this user *admin* permission on all websites you wish to track
- copy the `token_auth` for this user: you will use it later

### 2. Install the proxy

[](#2-install-the-proxy)

You need to install the proxy on the server where your websites are hosted. You can do it both ways:

- download the files manually
- or install the whole repository with git

#### Manual download of `matomo.php`

[](#manual-download-of-matomophp)

- download [`matomo.php`](https://raw.githubusercontent.com/matomo-org/tracker-proxy/master/matomo.php), download [`piwik.php`](https://raw.githubusercontent.com/matomo-org/tracker-proxy/master/piwik.php), [`proxy.php`](https://raw.githubusercontent.com/matomo-org/tracker-proxy/master/proxy.php), [`matomo-proxy.php`](https://raw.githubusercontent.com/matomo-org/tracker-proxy/master/matomo-proxy.php) & [`plugins/HeatmapSessionRecording/configs.php`](https://raw.githubusercontent.com/matomo-org/tracker-proxy/master/plugins/HeatmapSessionRecording/configs.php)to your website root directory, for example at , , ,  &
- edit the file to set the configuration variables:
    - `$MATOMO_URL` should contain the URL to your Matomo server
    - `$PROXY_URL` should contain the URL to the tracker-proxy server
    - `$TOKEN_AUTH` should contain the `token_auth`

#### With git

[](#with-git)

- clone the repository: `git clone https://github.com/matomo-org/tracker-proxy.git matomo` into your website root directory (for example at )
- copy the configuration template: `cp config.php.example config.php`
- change the configuration in the newly created `config.php`:
    - `$MATOMO_URL` should contain the URL to your Matomo server
    - `$PROXY_URL` should contain the URL to the tracker-proxy server
    - `$TOKEN_AUTH` should contain the `token_auth`

By using git you will later be able to update by simply running `git pull`.

Be aware that with this method, `matomo.php` and other files are in a `matomo/` subdirectory. Keep that in mind when applying the instructions for the next step.

### 3. Use the proxy in the Javascript tracker

[](#3-use-the-proxy-in-the-javascript-tracker)

The proxy file () will be called by the Matomo Javascript tracker instead of calling directly the (secret) Matomo server ().

To achieve this, change the Matomo Javascript Code that is in the footer of your pages:

- go to *Matomo > Settings > Websites > Show Javascript Tracking Code*.
- copy the Javascript snippet and change the last lines to the following:

    ```
    [...]
    (function() {
        var u="//trackedsite.com/";
        _paq.push(["setTrackerUrl", u+"matomo.php"]);
        _paq.push(["setSiteId", "trackedsite-id"]);
        var d=document, g=d.createElement("script"), s=d.getElementsByTagName("script")[0];
        g.type="text/javascript"; g.async=true; g.defer=true; g.src=u+"matomo.php"; s.parentNode.insertBefore(g,s);
    })();

    ```

    What has changed in this code snippet compared to the normal Matomo code?

    - the secret Matomo URL is now replaced by your website URL (the proxy)
    - `matomo.js` becomes `matomo.php` (or `matomo/matomo.php` if you used the *git* method): matomo.php is the proxy script
    - the `` part of the code at the end is removed, since it is not currently used by Matomo, and it contains the (secret) Matomo URL which you want to hide
    - make sure to replace `trackedsite-id` with your idsite
- paste the modified Matomo Javascript code in the pages you wish to track.

This modified Javascript code will then track visits/pages/conversions by calling `trackedsite.com/matomo.php`, which will then automatically call your (hidden) Matomo Server URL.

At this stage, example.com should be tracked by your Matomo without showing the Matomo server URL. Repeat the step 3. for each website you wish to track in Matomo.

### 4. (optional) Use the proxy with Matomo's Opt Out form

[](#4-optional-use-the-proxy-with-matomos-opt-out-form)

The tracker-proxy also supports proxying the matomo opt out form. To use this, change the URL used in the opt out iframe to use the tracker proxy's `matomo-proxy.php` file.

*Note: you can get the opt out iframe from inside the Administration > Privacy > Users opt-out page in your Matomo instance.*

Configuration
-------------

[](#configuration)

### Timeout

[](#timeout)

By default, the `matomo.php` proxy will wait 5 seconds for the Matomo server to return the response. You may change this timeout by editing the `$timeout` value in `config.php`.

### User-Agent

[](#user-agent)

By default, the `matomo.php` proxy will contact your Matomo server with the User-Agent of the client requesting `matomo.php`. You may force the proxy script to use a particular User-Agent by editing the `$user_agent` value in `config.php`.

Contributing
------------

[](#contributing)

If you have found a bug, you are welcome to submit a pull request.

### Running the tests

[](#running-the-tests)

Before running the tests, create a config.php file w/ the following contents in the root repository directory:

```