# 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 (index.php/s/SHARE_ID
)
- Share ID + folder or file name in third custom variable
## What will not be tracked?
- Download
- Outlink
## Installation
- Download and extract to CLOUD_DIR/apps/piwik/
- 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: 1
, url: //domain.tld/piwik/
)
- If Piwik/Matomo is hosted under a different domain as your cloud you maybe need to use one of two possible proxy methods:
- Add RewriteRule "^piwik/(.*)$" "http://piwik.tld/$1" [P]
to your .htaccess
- a2enmod proxy
- Add ProxyPass /piwik/ http://piwik.tld/
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`