Fasáda Plausible
Používajte fasádu Plausible — registruje sa automaticky a je odporúčaným vstupným bodom:
use RoundlyConsulting\Plausible\Facades\Plausible;
Plausible::stats()->for('my-site.com')->last7Days()->aggregate();
Plausible::stats()->query()->last7Days()->aggregate(); // query() = the PLAUSIBLE_SITE default
Plausible::events()->fromRequest(request())->event('Signup', url: url('/register'));
Plausible::script(); // the <script> tag, for any viewCelý rozsah fasády
Fasáda sprístupňuje jedného klienta pre každú oblasť API, k tomu značku sledovacieho skriptu a dvoch pomocníkov na kontrolu stavu:
use RoundlyConsulting\Plausible\Facades\Plausible;
// One resource client per API area
Plausible::stats(); // StatsRepository — the query API
Plausible::events(); // EventsRepository — event ingestion
Plausible::sites(); // SitesRepository — site provisioning
Plausible::goals(); // GoalsRepository — goal provisioning
Plausible::sharedLinks(); // SharedLinksRepository — shared dashboard links
// Plus three helpers
Plausible::script('my-site.com'); // HtmlString — the tracking-script tag
Plausible::ping(); // bool — reachable AND the key is accepted
Plausible::health('my-site.com'); // HealthResult — configuration and connectivity, never throws| Metóda | Vracia | Účel |
|---|---|---|
stats() | StatsRepository | Realtime, súhrnné, časové a rozpadové dotazy a endpoint Stats v2. |
events() | EventsRepository | Zobrazenia stránok a vlastné udalosti, synchrónne, cez frontu alebo v dávke. |
sites() | SitesRepository | Vytvorenie, načítanie, zoznam, úprava a zmazanie webov. |
goals() | GoalsRepository | Vytvorenie, zoznam a zmazanie konverzných cieľov. |
sharedLinks() | SharedLinksRepository | Zdieľateľné odkazy na dashboard — nájde existujúci alebo vytvorí nový. |
script(?$domain) | HtmlString | Značka hosťovaného sledovacieho skriptu — pozri Sledovací skript. |
ping(?$site) | bool | Či je Plausible dostupné a prijíma kľúč — voliteľne overené voči webu. |
health(?$site) | HealthResult | Konfigurácia, dostupnosť a prijatie kľúča bez vyhodenia výnimky — pozri Kontrola stavu. |
fake() | PlausibleFake | Nahradí klienta zaznamenávajúcim fake — pozri Testovanie. |
Požiadavky na Stats a Sites API idú na nakonfigurovanú url s API kľúčom ako Bearer tokenom; zaznamenané udalosti idú do Events API bez autentifikácie a kľúč nikdy nenesú. Každá požiadavka používa nastavený časový limit a voliteľné opakovania retry.* a prechádza limiterom svojej oblasti.
Prejavte lásku k open source
Tento balík je zadarmo pod licenciou MIT. Ak vám šetrí čas, jednorazový príspevok alebo členstvo na Patreone nám pomôže ho ďalej udržiavať, testovať a dokumentovať.
Ďalšie spôsoby podpory vrátane kryptomienOdoslaním daru súhlasíte s našimi podmienkami prijímania darov.
Chcete to zabudovať do svojho produktu?
Naše balíky integrujeme do zákazkových Laravel a AI riešení. Napíšte nám, na čom pracujete, a ozveme sa do 48 hodín.