# Integrating Matomo Analytics with BookStack

### Overview

Once Matomo is installed, you must link it to BookStack to begin capturing visitor data, page views, and search trends. This is done by injecting a small JavaScript snippet into the BookStack header.

### 1. Retrieve Tracking Code from Matomo

1. Log in to your **Matomo** dashboard (e.g., http://192.168.0.152:8484).
2. Click the **Gear Icon** (Administration) in the top right.
3. On the left sidebar, navigate to **Websites > Tracking Code**.
4. Ensure the correct website (e.g., "BookStack") is selected in the dropdown.
5. In the **JavaScript Tracking Code** section, copy the entire block of code.

### 2. Apply Code to BookStack

1. Open your **BookStack** instance and log in as an **Administrator**.
2. Go to **Settings** (Gear icon in top navigation).
3. Select **Customization** from the left-hand menu.
4. Find the section labeled **Custom HTML Head Content**.
5. Paste your copied Matomo script directly into the text area.
6. Scroll to the bottom and click **Save Settings**.

```
<!-- Matomo Tracking Script Example -->
<script>
  var _paq = window._paq = window._paq || [];
  _paq.push(['trackPageView']);
  _paq.push(['enableLinkTracking']);
  (function() {
    var u="//YOUR_SERVER_IP:8484/";
    _paq.push(['setTrackerUrl', u+'matomo.php']);
    _paq.push(['setSiteId', '1']);
    var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0];
    g.async=true; g.src=u+'matomo.js'; s.parentNode.insertBefore(g,s);
  })();
</script>
```

### 3. Verification

- Open your BookStack homepage in a new tab.
- Navigate to the **Dashboard** in Matomo.
- Check the **Visits in Real-time** widget; your activity should appear within seconds.

*Note: If you use an ad-blocker, you may need to disable it for your local domain to see your own tracking data.*