Trafic AI

Instalare pe WordPress

Pluginul Survelium pentru WordPress — instalare, cache, WP-Cron și verificare.

Pluginul vede boții AI pe server și oamenii veniți din asistenți, și ne trimite datele din WP-Cron, la 5 minute.

Cerințe: PHP 8.1 sau mai nou, WordPress 6.0 sau mai nou.

Instalare

Creează o cheie în Survelium → Setări brand → Integrări → Creează cheia. Începe cu svk_ și apare o singură dată; copiaz-o.
Descarcă pluginul: fișierul survelium-agent-analytics-x.y.z.zip din ultima versiune. Nu „Source code”: acela nu are folderul vendor și nu merge.
În WordPress: Modules → Adaugă → Încarcă modul (Plugins → Add New → Upload Plugin), alege zip-ul și activează-l.
Setări → Survelium: lipește cheia, salvează, apoi apasă Send now. „Sent.” înseamnă că am primit datele.

Cheia poate sta și în wp-config.php, unde are prioritate față de pagina de setări:

define('SURVELIUM_INGEST_KEY', 'svk_...');

Cache-ul de pagini. Paginile servite din cache nu rulează PHP, deci pluginul nu vede boții care le citesc.
- LiteSpeed (pluginul LiteSpeed Cache, majoritatea hostingurilor partajate): rezolvat. Pluginul scrie un bloc la începutul .htaccess prin care boții AI și vizitatorii din asistenți ocolesc cache-ul. În tabelul de status apare „Active”. Blocul se scoate la dezactivare.
- WP Rocket, W3 Total Cache, Cloudflare „cache everything”, Varnish: exclude manual din cache user agent-ii boților AI (lista). Altfel apar doar paginile necacheuite.
WP-Cron rulează. Dacă ai DISABLE_WP_CRON, cheamă wp-cron.php dintr-un cron real. Tabelul de status arată „overdue” când trimiterea s-a oprit.
În spatele Cloudflare sau al unui proxy, IP-urile boților sunt ale proxy-ului și nu pot fi verificate, decât dacă numești antetul cu IP-ul real:
```
define('SURVELIUM_IP_HEADER', 'HTTP_CF_CONNECTING_IP');
```
Pune-l doar dacă proxy-ul setează mereu antetul acela.

La fiecare afișare de pagină din front-end (nu admin, AJAX, REST sau cron), după ce pagina a plecat, pluginul verifică boții AI și asistenții. Ce se potrivește intră într-un tabel din baza ta de date (cel mult 20 000 de rânduri).
Totalul zilnic: oamenii văd des pagini din cache, așa că îi numără un script de o linie din subsolul paginii, care doar adaugă 1 (nu trimite nimic despre vizitator). Boții AI se adaugă din PHP. Dacă oprești scriptul, PHP numără tot, dar paginile din cache lipsesc din total.
Dacă nu ne poate trimite datele, le păstrează și reîncearcă. O cheie revocată sau un plan fără Trafic AI oprește trimiterea fără să piardă date; salvarea setărilor o repornește.

Setare	Implicit
Cheia	—	Fără cheie nu se înregistrează nimic.
Ce raportează	boții AI și vizitatorii din asistenți	Sau doar boții AI.
Afișări de pagină	pornit	Scriptul din subsol pentru totalul zilnic.
Cache de pagini	pornit	Blocul LiteSpeed din `.htaccess`.
Căi ignorate	`/wp-admin`, `/wp-login.php`, `/wp-cron.php`, `/xmlrpc.php`, `/wp-json`	Nici raportate, nici numărate.

Setări brand → Integrări arată „Conectat · ultimele date …” la câteva minute după Send now.
Boții apar în Trafic AI → Boți AI pe măsură ce vin; pe un site mic poate dura o zi.

Module → Dezactivează → Șterge scoate tabelele, setările și blocul din .htaccess.