# Kapcsolat beállítása

> A Matomo-példány összekötése a MainWP Dashboarddal: URL, API-token, jelentési időszak, szinkronizálás és HTTPS.

## Kapcsolat létrehozása

1. A MainWP Dashboardon lépj a **Webhelyek → Analitika → Matomo** oldalra, és nyisd meg a **Beállítások** fület.
2. A **Matomo-kapcsolat** szakaszban írd be a **Matomo URL** mezőbe azt a címet, amelyen a Matomót megnyitod. Ha a Matomo almappában van, add meg az almappát is, például `https://example.com/matomo/`. Egyébként a gyökércím elég, például `https://analytics.example.com`.
3. Az **API-token** mezőbe illeszd be a Matomo API-tokent.
4. Az **Adatok és jelentések** szakaszban válaszd ki a **Jelentési időszak** és a **Szinkronizálás gyakorisága** értékét, és add meg a **Kapcsolódási időkorlát (másodpercben)** értékét 1 és 30 között.
5. Ha azt szeretnéd, hogy a MainWP magától megkeresse a webhelyekhez illő Matomo-tulajdonokat, kapcsold be a **Tulajdonok automatikus hozzárendelése a webhelyekhez** kapcsolót.
6. Kattints a **Beállítások mentése** gombra. A MainWP ellenőrzi a kapcsolatot, és betölti a tokennel elérhető tulajdonokat. Ha hibaüzenetet látsz, javítsd, mielőtt továbbmész.

![A Matomo beállítások oldala](./kepek/beallitasok.webp)

*A Matomo beállítások oldala* (https://minta-bolt.hu/wp-admin/admin.php?page=Extensions-Mainwp-Piwik-Extension&tab=settings)

A képen a kapcsolat és az adatok mezői láthatók, még kitöltés előtt.

| Beállítás | Mit csinál | Alapérték |
|---|---|---|
| **Matomo URL** | A Matomo-példány alap URL-címe. | üres |
| **API-token** | A Matomo-hitelesítési token. Mentés után üres marad. | üres |
| **Jelentési időszak** | Az adatok időszaka: **Hét** vagy **Hónap**. | **Hét** |
| **Szinkronizálás gyakorisága** | Milyen gyakran frissíti az adatokat a Matomóból: **Óránként**, **3 óránként**, **9 óránként**, **15 óránként**, **18 óránként** vagy **24 óránként**. | **9 óránként** |
| **Kapcsolódási időkorlát (másodpercben)** | A kapcsolódás időkorlátja, 1 és 30 között. | 10 |
| **Tulajdonok automatikus hozzárendelése a webhelyekhez** | A MainWP magától párosítja a Matomo-tulajdonokat a webhelyekkel. | kikapcsolva |

## Az URL szabályai

A MainWP az URL egy egységesített változatát menti. Ezek a címek elfogadottak:

```
https://analytics.example.com
https://example.com/matomo/
https://example.com/matomo/index.php
https://example.com:8443/stats/
```

A záró `index.php` lekerül, így a `https://example.com/matomo/index.php` címből `https://example.com/matomo/` lesz. A cím HTTPS-t használjon, és ne legyen benne lekérdezési karakterlánc, töredék (#), felhasználónév vagy jelszó. A `http://analytics.example.com` például nem támogatott.

A MainWP elutasítja a címet, és a meglévő beállítást megtartja, ha:

- az almappa neve az ASCII-betűken, számokon és a `.`, `_`, `~`, `-` jeleken kívül mást is tartalmaz,
- az almappa neve üres (két perjel egymás után), `.` vagy `..`, vagy `%` kódot tartalmaz,
- az `index.php` nem a cím végén áll,
- a kiszolgálónév nem támogatott karaktert tartalmaz, például aláhúzást vagy nem ASCII betűt (nemzetközi domainnévnél az `xn--` alakot add meg),
- a port 1 és 65535 között nincs, vagy a cím hosszabb 2048 karakternél.

## A mentett API-token

Mentés után az **API-token** mező üres marad. A mentett tokent a MainWP védetten, az általános beállításoktól külön tárolja, és nem jeleníti meg.

- Ha ugyanarra a Matomo-telepítésre mentesz újra, hagyd üresen a mezőt, és a mentett token megmarad. A kiszolgáló, a port és az almappa ehhez nem változhat. Ha csak a `http://` címet cseréled `https://` címre, a token megmarad.
- Új token beillesztésével lecserélheted a régit.
- Ha a kiszolgálót, a portot vagy az almappát módosítod, az új telepítéshez új token kell. A MainWP a régi tokent nem küldi el másik címre.
- Két Matomo-telepítés ugyanazon a kiszolgálón, de különböző almappában (például `/matomo/` és `/stats/`) két külön kapcsolat: külön tokennel, külön webhely-hozzárendeléssel és külön gyorsítótárazott adatokkal.

Ha a MainWP azt írja, hogy a mentett kapcsolat nem ellenőrizhető, vagy a hitelesítő adatok helyreállítása szükséges, ellenőrizd a Matomo URL-t, illeszd be az aktuális API-tokent, és kattints a **Beállítások mentése** gombra.

## HTTPS és tanúsítványellenőrzés

A bővítmény mindig ellenőrzi a TLS-tanúsítványt. A régi `mainwp_piwik_sslVerifyCertificate` beállítás már nem kapcsolja ki az ellenőrzést. Használj érvényes tanúsítványt, és ha tanúsítvány- vagy bizalmi lánc hibát kapsz, a Matomo kiszolgálóján javítsd, mielőtt újra próbálkozol.