README.md


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

# Piwik/Matomo for your Cloud
![GitHub All Releases](https://img.shields.io/github/downloads/sualko/cloud_piwik/total.svg)
[![GitHub license](https://img.shields.io/github/license/sualko/cloud_piwik.svg)](https://github.com/sualko/cloud_piwik/blob/master/LICENSE)

Track [Nextcloud](https://nextcloud.com) users with [Piwik/Matomo](https://matomo.org).

## Requirements
- Nextcloud >= 19
- Working Piwik/Matomo installation (tested with 2.14.3)
- Empty custom variable slots on index 1, 2 and 3

## What will be tracked?
- Normal Piwik/Matomo stuff (url, page title, browser, ...)
- User ID aka Nextcloud user
- App in first custom variable
- Share ID in second custom variable (<code>index.php/s/SHARE_ID</code>)
- Share ID + folder or file name in third custom variable

## What will not be tracked?
- Download
- Outlink

## Installation
- Download and extract to <code>CLOUD_DIR/apps/piwik/</code>
- Enable app
- If needed create a new site in your Piwik/Matomo installation
- Insert Piwik/Matomo site id and url on the cloud admin page (e.g. site id: <code>1</code>, url: <code>//domain.tld/piwik/</code>)
- If Piwik/Matomo is hosted under a different domain as your cloud you maybe need to use one of two possible proxy methods:
 - Add <code>RewriteRule "^piwik/(.*)$" "http://piwik.tld/$1" [P]</code> to your <code>.htaccess</code>
 - a2enmod proxy
 - Add <code>ProxyPass /piwik/ http://piwik.tld/</code> to your apache VirtualHost section

## Publishing a new version
1. bump version in `package.json`
2. `yarn release:build`
3. `yarn release:sign`
4. `yarn release:publish`