---
title: "Enumy — Plausible for Laravel | Roundly"
description: "Typovo bezpečné metriky, obdobia, intervaly, vlastnosti, dimenzie, operátory a typy cieľov s pomocníkmi z enums-for-laravel."
url: https://roundly-consulting.com/sk/open-source/navody/plausible-for-laravel/enumy
language: sk
---

[Všetky balíky](https://roundly-consulting.com/sk/open-source.md)

[Plausible for Laravel](https://roundly-consulting.com/sk/open-source/navody/plausible-for-laravel.md)

# Enumy

Typovo bezpečné a ľahko objaviteľné parametre sú v RoundlyConsulting\\Plausible\\Enums. Všade, kde sa prijíma enum, funguje aj zodpovedajúci reťazec:

| Enum | Použitie | Hodnoty |
| --- | --- | --- |
| `Metric` | metrics() pri každom terminálnom volaní | visitors, visits, pageviews, views\_per\_visit, bounce\_rate, visit\_duration, events, scroll\_depth, conversion\_rate, group\_conversion\_rate, total\_revenue, average\_revenue, time\_on\_page, exit\_rate, percentage |
| `Period` | period() a rozsah dátumov vo v2 | day, 7d, 30d, month, 6mo, 12mo, year, all, custom — all iba pre run() |
| `Interval` | interval() pre časové rady a rozpady | minute, hour, date, week, month — timeseries() vo v1 prijme iba date a month |
| `Property` | v1 breakdown(), property(), cursor() | event:name, event:page, event:hostname, event:goal, visit:source, visit:referrer, visit:utm\_medium, visit:utm\_source, visit:utm\_campaign, visit:utm\_content, visit:utm\_term, visit:device, visit:browser, visit:browser\_version, visit:os, visit:os\_version, visit:country, visit:region, visit:city, visit:entry\_page, visit:exit\_page |
| `Dimension` | v2 dimensions() a where() | všetky hodnoty Property, navyše visit:channel a časové úseky time:hour, time:day, time:week, time:month |
| `FilterOperator` | where() / orWhere() | is, is\_not, contains, contains\_not, matches, matches\_not, and, or, not, has\_done, has\_not\_done |
| `GoalType` | CreateGoalRequest | event, page |

Pre vlastnú vlastnosť udalosti použite Property::custom('plan') alebo Dimension::custom('plan') — obe vrátia reťazec event:props:plan.

## Pomocníci

Vďaka enums-for-laravel má každý enum rozhranie Helpers — values(), labels(), options(), toOptions(), validationRule(), vyhľadanie podľa názvu a popisu a pomocníkov is()/when\*. Hodí sa pre dashboardy, výberové polia a validáciu zvoleného parametra:

```php
use RoundlyConsulting\Plausible\Enums\Dimension;
use RoundlyConsulting\Plausible\Enums\Metric;
use RoundlyConsulting\Plausible\Enums\Period;
use RoundlyConsulting\Plausible\Enums\Property;

Metric::values();              // 'visitors', 'visits', 'pageviews', … — the raw wire keys
Metric::validationRule();      // 'in:visitors,visits,pageviews,…' for request validation
Period::toOptions();           // ['day' => 'Day', '7d' => 'Seven Days', …] for a <select>
Period::options();             // list of {value, label, name} DTOs for JS/Inertia
Period::fromName('SixMonths'); // Period::SixMonths

Period::SevenDays->readable();      // 'Seven Days'
Dimension::EventName->readable();   // 'Event Name'
Metric::ViewsPerVisit->readable();  // 'Views Per Visit'

Property::custom('plan');      // 'event:props:plan'
Dimension::custom('plan');     // 'event:props:plan'
```

## Validácia vstupu

```php
use RoundlyConsulting\Plausible\Enums\Metric;
use RoundlyConsulting\Plausible\Enums\Period;

$validated = $request->validate([
    'metric' => ['required', Metric::validationRule()],
    'period' => ['required', Period::validationRule()],
]);

$result = Plausible::stats()
    ->query()
    ->metrics(Metric::from($validated['metric']))
    ->period(Period::from($validated['period']))
    ->aggregate();
```

## Popisy a hodnoty v API

value, values(), validationRule() a custom() vždy vracajú surové reťazce API. Líši sa len zobrazovaný popis: Metric, Interval, GoalType a FilterOperator ho odvodzujú z hodnoty (views\_per\_visit → Views Per Visit), zatiaľ čo Period, Dimension a Property — ktorých hodnoty sú skratky ako 7d alebo tokeny ns:field ako event:name — z názvu prípadu (SevenDays → Seven Days).

## 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 kryptomien](https://roundly-consulting.com/sk/podporte-nas.md)

Odoslaním daru súhlasíte s našimi [podmienkami prijímania darov](https://roundly-consulting.com/sk/podmienky-darov.md).

[Podporte našu open-source prácu (otvorí sa v novej karte)](https://donate.stripe.com/dRmeVe8FX5PF1Qd9pXcEw00) [Pridajte sa k nám na Patreone (otvorí sa v novej karte)](https://www.patreon.com/cw/roundly)

## 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.

[Ponuka do 48 hodín](https://roundly-consulting.com/sk/kontakt.md) [Prezrieť všetky balíky](https://roundly-consulting.com/sk/open-source/navody/plausible-for-laravel.md)