Open source
Advertisements for Laravel
composer require roundly-consulting/advertisements-for-laravelPrehľad
Natívny reklamný engine pre Laravel. Obsahuje model Advertisement so životným cyklom koncept → naplánovaná → zverejnená → expirovaná → archivovaná, vnorené kategórie a umiestnenia (reklamné zóny), názvy pre každý jazyk a meranie zobrazení a klikov s mierou prekliku — zapisované priamo alebo cez frontu. Zvyšok dodávajú štyri sesterské balíky Roundly: obrázkové kreatívy pre každé umiestnenie so záložnou textovou reklamou, geografické cielenie a reporty podľa krajín, slugy pre každý jazyk s históriou a presmerovaniami 301 a presné ceny Money. Licencia MIT a žiadne externé závislosti okrem Laravelu a vlastných balíkov Roundly.
Čo získate
Celý životný cyklus reklamy
Koncept, naplánovanie, zverejnenie, expirácia a archivácia jedným volaním — každý prechod spustí udalosť a stav sa pri každom čítaní prepočíta z dátumov.
Umiestnenia a servírovanie
Modelujte reklamné zóny, priraďujte reklamy cez model, id alebo slug a získajte aktívnu či náhodnú reklamu pre zónu jedným volaním.
Meranie zobrazení a klikov
Denormalizované počítadlá a miera prekliku, kontext požiadavky v každom zázname, zápis priamo alebo cez frontu.
Kreatívy so záložnou textovou reklamou
Responzívny obrázok v rozmeroch každého umiestnenia; ak chýba, vykreslí sa upraviteľná textová reklama, takže žiadny slot nezostane prázdny.
Geografické cielenie a reporty
Povoľte alebo zablokujte krajiny, cieľte na okruh okolo bodu a rozdeľte zobrazenia a kliky podľa krajín.
Presné ceny v Money
Money v najmenších jednotkách meny v stĺpci decimal(38,0) — žiadne floaty, zápisy chránené pred miešaním mien a číselné radenie.
Fasáda, DI alebo akcie
Jedna fasáda Advertisements, injektovateľný manažér a jednoúčelové akcie — plus zaznamenávajúci fake s asertom pre každú operáciu.
Dokumentácia
Inštalácia
Inštalácia cez Composer, publikovanie a spustenie migrácií (plus vždy media-library a pre históriu slugov aj sluggable), voliteľne konfigurácia a view.
Konfigurácia
Každý konfiguračný kľúč s predvolenou hodnotou a env premennou — modely, typ kľúča autora, mena, jazyk, história slugov, meranie, kreatívy a geo.
Rýchly štart
Vytvorte reklamu, priraďte ju k umiestneniu, zverejnite ju a potom ju servírujte, vykreslite a merajte — celý postup cez fasádu Advertisements.
Fasáda Advertisements
Celé API na jednej fasáde — prechody životného cyklu, servírovanie, vykreslenie a handle for($ad) pre umiestnenia a meranie.
DI a akcie
Injektujte AdvertisementManager s rovnakým API bez statických volaní alebo volajte jednoúčelovú akciu za každou metódou fasády.
Vytváranie a úprava reklám
Vytvárajte reklamy z DTO AdvertisementData alebo presných tovární fromMinor() / fromDecimal(), priamo z požiadaviek, a upravujte len zadané polia.
Životný cyklus a stav
Zverejnenie hneď či naplánované, stiahnutie, expirácia, archivácia a soft delete — každý prechod spustí udalosť a stav sa prepočíta pri čítaní.
Dopytové scopy
Reťazte scopy published, active, scheduled, expired, draft, archived, autora, umiestnenia, kategórie a geo — alebo začnite z fasády.
Ceny
Ceny sú presné hodnoty Money v stĺpci decimal(38,0) v najmenších jednotkách — žiadne floaty, bezpečné zápisy mien, číselné radenie a API resources.
Umiestnenia
Modelujte reklamné zóny ako bočný panel či slot vo feede, priraďujte reklamy cez model, id alebo slug a získajte aktívnu či náhodnú reklamu.
Meranie zobrazení a klikov
Zaznamenávajte zobrazenia a kliky živých reklám priamo alebo cez frontu, s transakčnými počítadlami, CTR, kontextom a reportmi podľa krajín.
Kreatívy
Priraďte obrázkovú kreatívu ku každému umiestneniu, získajte variant display v rozmeroch zóny a vykreslite responzívny <img> alebo textovú reklamu.
Geografické cielenie
Obmedzte reklamy na povolené či zablokované krajiny alebo okruh okolo bodu a každému divákovi servírujte len reklamy zodpovedajúce jeho polohe.
Preklady
Názov, popis a slug sú JSON mapy podľa jazykov s čítaním v aktívnom jazyku, nastaviteľným záložným jazykom a bez externej závislosti.
Kategórie
Usporiadajte reklamy do stromu vnorených kategórií a filtrujte podľa jednej kategórie samostatne alebo spolu so všetkými vnorenými.
Slugy a routovanie
Slugy reklám pre každý jazyk s jedinečnosťou vynútenou databázou, route binding v akomkoľvek jazyku, voliteľné 301 zo starých slugov a validácia.
Udalosti
Každé vytvorenie, úprava a prechod životného cyklu spustí udalosť s reklamou; zobrazenia a kliky spustia udalosť so záznamom merania.
Vlastné modely
Nasmerujte štyri konfiguračné kľúče modelov na vlastné podtriedy a pridajte polia či logiku so zachovaním všetkých scopov, relácií a castov.
Artisan príkazy
Prerezávajte expirované reklamy cez model:prune, skontrolujte nastavenie cez about a pridajte indexy slugov pre jazyk cez sluggable:indexes.
Testovanie
Advertisements::fake() zaznamená každý prechod, zmenu umiestnení aj meranie s assertom pre každé, plus továrne a simulácia geolokácie.
Výnimky
Základná výnimka balíka, InvalidTargeting, AdvertisementNotActive a AdvertisementNotInPlacement, plus výnimky z balíkov money, sluggable a toolkit.
Požiadavky
PHP 8.4+ s ext-bcmath, Laravel 12 alebo 13 a šesť balíkov Roundly, ktoré nainštaluje Composer; gd alebo imagick pre varianty kreatív.
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.