matomo.md

# Matomo

Matomo is implemented on ecolyo to anonymously track user's navigation and their devices so we understand better how our users use the app.

## Hosting

Matomo is hosted on [statweb.com](https://statweb.grandlyon.com/) where two projects are available :

- PROD for live ecolyo apps
- REC for every alpha instance

## Local testing

### Matomo server

Matomo is disabled by default on local development to optimize performances. To develop specific features related to matomo without having to deploy to alpha, follow theses instructions.

```bash
cd docker
docker-compose -f docker-compose.matomo.yml up -d
```

Now visit matomo at [localhost://9800/index.php](http://localhost:9800/index.php) and follow the given instructions to setup your matomo.

On step 5, create a super user with the credentials you want, for example

:::note

root
Testtest1

:::

On step6, enter dummy values and select a time zone.

Once you finish the setup and access the server, you should see a warning telling you that matomo has not been configured with the correct port. To fix this problem follow these instructions.

```sh
docker ps
# copy container id of matomo

docker exec -it [containerID] bash

# Install vi
apt-get update
apt-get install vim

# Edit config.ini.php
vi config/config.ini.php
```

and under "[General]" add the port **9800** to the following line :

```sh
trusted_hosts[] = "localhost:9800"
```

After reloading, you should be able to login. We need to make one last change for our app to send data to our matomo server.

### Ecolyo app

In the file
src/targets/browser/**index.tsx** at line 66 comment the dev condition that is preventing the tracker from being initialized.

```ts title="src/targets/browser/index.tsx"
  if (
    window.Piwik
    // && !isDev
  ) {
```

When you navigate inside the Ecolyo app, in the network tab you should see requests to our matomo server 🎉🎉🎉