Open source
Reviews for Laravel
composer require roundly-consulting/reviews-for-laravelPrehľad
Kompletný systém recenzií a hodnotení pre Laravel. Recenziu môže napísať akýkoľvek Eloquent model a hodnotiť sa dá akýkoľvek model — zákazníci hodnotia produkty, hostitelia hostí, firmy používateľov. Zvládne hviezdičkové hodnotenia, životný cyklus moderovania s vymeniteľným automatickým moderátorom, overené recenzie, hlasy užitočnosti, odpovede vlastníka, galérie fotografií, priebežné či cachované agregáty, udalosti aj plnohodnotné nástroje na testovanie — všetko za jednou fasádou Reviews. Licencia MIT a natívne riešenie: jedinými závislosťami sú Laravel a tri balíky Roundly (media library, enums a package toolkit), ktoré sa nainštalujú automaticky.
Čo získate
Ktokoľvek hodnotí čokoľvek
Polymorfný autor aj predmet — zákazníci hodnotia produkty, hostitelia hostí, firmy používateľov.
Hviezdičky a agregáty
Konfigurovateľná stupnica s priebežným priemerom, počtom, rozdelením a DTO RatingSummary — alebo cachované stĺpce pre vyťažené stránky.
Životný cyklus moderovania
Čakajúce, schválené a zamietnuté recenzie s dôvodom, automatické schvaľovanie, opätovné moderovanie po úprave a vymeniteľný automatický moderátor.
Fotografie k recenziám
Responzívna galéria ku každej recenzii cez Media Library for Laravel — verejné URL alebo súkromné fotografie len cez podpísané URL.
Dôvera a zapojenie
Príznak overeného nákupu, hlasy užitočnosti s triedením podľa užitočnosti a odpovede vlastníka, ktoré neovplyvnia skóre.
Fasáda, DI alebo akcie
Volajte fasádu Reviews, injektujte ReviewsManager alebo spustite akciu — rovnaký kód, s deviatimi doménovými udalosťami, JSON resource a makrami.
Pripravené na testy
Zaznamenávajúci Reviews::fake(), ktorý operácie naďalej vykonáva, desať asercií zámeru, Pest matchery, trait pre testy a továrne.
Dokumentácia
Inštalácia
Inštalácia cez Composer, publikovanie migrácií pre recenzie a médiá, voliteľne konfigurácia, preklady a resources.
Konfigurácia
Každý konfiguračný kľúč a jeho predvolená hodnota — modely, typ kľúča, stupnica, moderovanie, agregáty a fotografie.
Databázová schéma a typy kľúčov
Tabuľky reviews a review_votes, ich stĺpce a indexy a to, ako key_type podporuje modely s UUID a ULID.
Príprava modelov
Pridajte HasReviews predmetom, CanReview autorom a CanVoteOnReviews hlasujúcim — každý model môže mať akúkoľvek rolu.
Fasáda Reviews
Každá operácia s recenziami na jednej fasáde — handly for($subject), query() nad všetkými recenziami a ploché operácie pre moderovanie, hlasy a overenie.
DI a akcie
Namiesto fasády injektujte ReviewsManager alebo spustite akciu za každou operáciou — CreateReview, ApproveReview, VoteOnReview a ďalšie.
Vytváranie recenzií
Recenzie cez plynulú fasádu — hodnotenie, text, metadáta, vynútené schválenie, overenie — a čo všetko sa validuje.
Fotografie k recenziám
Galérie fotografií k recenziám z uploadov, draftov, diskov či URL a responzívne obrázky cez Media Library.
Súkromné fotografie a úložisko
Fotografie mimo verejného úložiska — súkromné disky, krátkodobé podpísané URL a podpísaný srcset pre každú čítaciu metódu.
Životný cyklus moderovania
Stavy pending, approved a rejected — schvaľovanie a zamietanie s dôvodom, fronta na moderovanie a enum stavu.
Automatické moderovanie
Preverujte nové aj upravené recenzie vstavaným filtrom zakázaných slov alebo vlastným ReviewModerator — schváliť, zamietnuť, ponechať.
Úprava a mazanie
Úprava recenzií cez UpdateReviewData, opätovné moderovanie po úprave, mäkké mazanie, obnova a trvalé zmazanie.
Hodnotenia a agregáty
Priemerné hodnotenie, počty, rozdelenie hviezdičiek a DTO RatingSummary — priebežné agregáty len zo schválených recenzií.
Cachované agregáty
Uložte reviews_count a reviews_avg do tabuľky predmetu, nechajte ich automaticky aktualizovať a prepočítajte cez reviews:recount.
Dopytovanie recenzií
Query scopes pre stav, hodnotenie, autora, predmet, overenie, odpovede a užitočnosť, plus vyhľadávanie podľa autora.
Overené recenzie
Označte overené nákupy či recenzentov pri vytvorení, cez Reviews::verify() alebo úpravou a filtrujte overené a neoverené recenzie.
Hlasy užitočnosti
Akýkoľvek model môže označiť recenziu za užitočnú či neužitočnú — jeden hlas, otočenie pri opakovaní, počty a triedenie.
Odpovede vlastníka
Verejne odpovedzte na recenziu — odpovede sú naviazané na recenziu, hneď schválené a nikdy neovplyvnia hodnotenie.
Udalosti
Deväť udalostí pre vytvorenie, schválenie, zamietnutie, úpravu, zmazanie, odpoveď, hlas, jeho stiahnutie a overenie.
JSON resource
ReviewResource a ReviewCollection poskytujú rozumný tvar verejného API — publikujte ich a upravte polia podľa seba.
Vlastné modely a makrá
Nahraďte model Review či ReviewVote vlastným, zaregistrujte vlastné operácie fasády ako makrá a ovládajte alias fasády.
Testovanie
Reviews::fake() zaznamená každú zmenu z akejkoľvek cesty a pritom ju vykoná — desať asercií, Pest matchery, trait pre testy a továrne.
Požiadavky
PHP 8.4+, Laravel 12 alebo 13 a balíky media library, enums a package toolkit od Roundly — nainštalujú sa automaticky.
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.