Sledovací skript

Oficiálny hosťovaný skript Plausible vložíte do layoutu direktívou @plausibleScript alebo komponentom <x-plausible-script>. Balík neobsahuje žiadny JavaScript — iba vypíše štandardný tag script zostavený z konfigurácie (script.domain a script.src):

{{-- uses script.domain (or falls back to site) --}}
@plausibleScript

{{-- or override the domain --}}
@plausibleScript('my-site.com')

{{-- component form --}}
<x-plausible-script />
<x-plausible-script domain="my-site.com" />

Každý z tvarov vykreslí:

<script defer data-domain="my-site.com" src="https://plausible.io/js/script.js"></script>

Doménou je explicitný argument, inak script.domain, inak predvolený web. Ak nie je nastavené nič z toho, nevykreslí sa nič — tag teda môže zostať v layoute aj pre lokálne prostredia. Hodnoty sa escapujú pre HTML.

Mimo Blade

V Inertii, obyčajnej PHP šablóne či JSON odpovedi si rovnakú značku vypýtajte od fasády. Direktíva aj komponent vykresľujú Plausible::script(), takže prebindovanie manažéra zmení všetky tri:

use RoundlyConsulting\Plausible\Facades\Plausible;

Plausible::script();                // HtmlString; empty when no domain is configured
Plausible::script('my-site.com');   // explicit domain

Úprava markupu

Plausible::script() vykresľuje šablónu plausible::components.script s premennými $domain a $src. Publikujte ju a upravte resources/views/vendor/plausible/components/script.blade.php — zmena sa prejaví všade, napríklad pridaný atribút data-api pre proxy. Bez domény sa nevykreslí nič.

php artisan vendor:publish --tag="plausible-views"

{{-- resources/views/vendor/plausible/components/script.blade.php --}}
{{-- Variables: $domain (the data-domain) and $src (plausible.script.src) --}}
<script defer data-domain="{{ $domain }}" src="{{ $src }}"></script>

Self-hosted alebo variant skriptu

Nasmerujte script.src na vlastnú self-hosted inštanciu alebo na variant skriptu Plausible:

PLAUSIBLE_SCRIPT_DOMAIN=my-site.com
PLAUSIBLE_SCRIPT_SRC=https://analytics.example.com/js/script.tagged-events.js