Open source
Events for Laravel
composer require roundly-consulting/events-for-laravelPrehľad
Organizujte skutočné podujatia v akejkoľvek Laravel aplikácii: opakovane použiteľné miesta konania s hľadaním v okolí, typy vstupeniek s cenou v Money, RSVP s čakacou listinou bez súbehov, check-in pri vstupe cez QR kód, spoluorganizátori a podujatia len na pozvanie — každý čas sa ukladá v UTC a číta v časovom pásme konkrétneho podujatia. Kalendárové súbory a feedy, schema.org JSON-LD, notifikácie a pripomienky v angličtine a slovenčine aj voliteľné JSON API sú za jednou fasádou Events. Balík je headless, s licenciou MIT a stojí len na oficiálnych komponentoch Laravelu a vlastných balíkoch Roundly pre štítky, stavy, polohu, peniaze, slugy, preklady, médiá, QR kódy a kryptografiu — bez externej platformy na podujatia.
Čo získate
Miesta konania a hľadanie v okolí
Opakovane použiteľné miesta konania s adresou, súradnicami a časovým pásmom, voliteľné geokódovanie a jedna presná vzdialenosť po hlavnej kružnici v SQL aj PHP.
Správny čas všade
Okamihy uložené v UTC, zadaný čas čítaný v časovom pásme podujatia, odmietnuté časy v medzere pri prechode na letný čas a celodenné festivaly, ktoré si udržia svoje dátumy.
Typy vstupeniek a napojenie na platby
Bezplatné aj platené typy vstupeniek s cenou v Money, kapacitou, obdobím predaja a limitmi skupiny. Platené miesta sa rezervujú, kým platbu vyberie váš vlastný checkout.
RSVP s čakacou listinou bez súbehov
Zúčastním sa, mám záujem alebo nezúčastním sa, hostia v rámci RSVP a čakacia listina podľa poradia bez predbiehania — presná aj pri súbežných požiadavkách na MySQL a PostgreSQL.
Check-in pri vstupe cez QR
Neuhádnuteľné šifrované kódy, QR kód, ktorý sa nikdy neukladá do cache, idempotentné skenovanie, okno check-inu, ručný check-in a výmena kódu jedným krokom.
Súkromné podujatia a spoluorganizátori
Verejné podujatia, podujatia len cez odkaz aj len na pozvanie, spoluorganizátori, prevod podujatia a tímy ako organizátori — jedno pravidlo viditeľnosti pre zoznamy, stránky, feedy aj notifikácie.
Kalendáre, vyhľadávače a notifikácie
Súbory a feedy .ics, schema.org JSON-LD, notifikácie a pripomienky vo fronte v angličtine a slovenčine a voliteľné JSON API.
Fasáda, DI alebo akcie
Jedna fasáda Events, injektovateľný manažér alebo jednoúčelové akcie — a nahrávací fake, ktorý každé volanie aj tak vykoná.
Dokumentácia
Príklady použitia
Kde sa balík uplatní — komunitné platformy, kluby a priestory, konferencie, predaj vstupeniek cez vlastný checkout, súkromné podujatia a podujatia v okolí.
Inštalácia
Inštalácia cez Composer, events:install a migrácie, typy kľúčov a názvy tabuliek, traity modelov a naplánovanie dvoch sweepov.
Konfigurácia
Každý konfiguračný kľúč s premennou prostredia a predvolenou hodnotou — kľúče, tabuľky, modely, platby, check-in, plagáty, URL, API a notifikácie.
Modely a schéma
Sedem tabuliek a sedem modelov, čo číta model Event, jeho query scopes, enumy, DTO a kontrakty a výmena modelu.
Fasáda Events
Prehľad fasády Events — make(), handle for($event) a jeho pod-handle, miesta konania, RSVP, pozvánky, buildery a traity modelov.
DI a akcie
Bez fasády: injektujte EventsManager alebo zavolajte niektorú zo 49 jednoúčelových akcií — každá signatúra execute() s cestou cez fasádu.
Vytváranie a úprava podujatí
Vytvárajte a zverejňujte podujatia cez builder alebo CreateEventData, potom ich upravujte, hľadajte, nastavujte plagáty, prevádzajte, mažte a obnovujte.
Čas a časové pásma
Ukladanie v UTC, zadávanie miestneho času v pásme podujatia, prechody na letný a zimný čas, trvanie, dvere, celodenné podujatia a časové scopes.
Stavy a životný cyklus
Šesť stavov nad lifecycle-for-laravel — zverejnenie, odloženie, presun, zrušenie, ukončenie a prechod online —, guardy, fázy a vlastný workflow.
Miesta konania a hľadanie v okolí
Opakovane použiteľné miesta konania s adresou, súradnicami a pásmom, kto ich smie upravovať, voliteľné geokódovanie a presná vzdialenosť v SQL.
Typy vstupeniek a platby
Typy vstupeniek s cenou v Money, kapacitou, obdobím predaja a limitmi skupiny — plus rezervácie miest, váš collector platieb, webhook a vrátenie peňazí.
RSVP a čakacia listina
Zúčastním sa, mám záujem či nie, hostia a limity skupiny, kapacita pri súbežných požiadavkách, čakacia listina a nástroje správcov.
Check-in pri vstupe
Neuhádnuteľné šifrované kódy a QR bez cache, skenovanie s podujatím aj bez neho, odmietnutia, okno, ručný check-in a výmena kódu.
Organizátori, spoluorganizátori a pozvánky
Používatelia a tímy ako organizátori, kto podujatie spravuje, spoluorganizátori, prevod podujatia a podujatia na pozvanie s jednorazovými tokenmi.
Kategórie a štítky
Jeden kurátorovaný strom kategórií a voľné štítky cez tags-for-laravel — naplnenie, označovanie, filtre, súkromné štítky, rozsahy a prepísania.
Súkromie a oprávnenia
Kto podujatie vidí, čo ktoré miesto skrýva, oprávnenia EventPolicy, pravidlá pre miesta konania a upozornenie na IP návštevníka pri hľadaní v okolí.
Kalendáre, feedy a JSON-LD
Súbory .ics pre podujatie aj zoznam, verejné a osobné feedy, schema.org JSON-LD cez @eventJsonLd a šablóny URL za každým odkazom.
JSON API
Voliteľné JSON API — 49 rout, telá požiadaviek, filtre a radenie, resources podľa roly, referenčné resources, chyby a limity požiadaviek.
Notifikácie a pripomienky
Deväť notifikácií vo fronte po commite v angličtine a slovenčine — príjemcovia a kontroly pri doručení, obsah, výmena, tiché zápisy a pripomienky.
Doménové udalosti
42 doménových udalostí po commite pre podujatia, miesta, typy vstupeniek, RSVP, rezervácie, platby, check-in, spoluorganizátorov a pozvánky.
Výnimky
Každá EventsException s kódom a HTTP stavom, chyby, ktoré API preberá z tags, lifecycle a media-library, a chyby konfigurácie.
Artisan príkazy
events:install, events:doctor a jeho kontroly, events:sweep, events:repair a events:geocode — plus riadky plánovača a ekvivalenty v PHP.
Recepty
Hostia bez účtu, tímy ako organizátori cez teams-for-laravel, vlastné polia, diskusia pod podujatím, recenzie po podujatí a pomer prebookovania.
Testovanie
Events::fake() zaznamená každú operáciu a aj tak ju vykoná — všetky dvojice asercií, zaznamenané operácie, Pest očakávania, factories a úskalia.
Požiadavky
PHP 8.4, Laravel 12 alebo 13, MySQL 8 alebo PostgreSQL, rozšírenia PHP, ktoré potrebujú závislosti, a balíky Roundly, na ktorých stavia.
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.