Inštalácia

Pridajte balík. Service provider sa zaregistruje automaticky a spolu s ním sa nainštalujú aj jeho dve závislosti od Roundly — package-toolkit-for-laravel a money-for-laravel:

composer require roundly-consulting/credits-for-laravel

php artisan vendor:publish --tag="credits-migrations"
php artisan migrate

Migrácia len cez publikovanie

Balík svoju migráciu sám nenačítava. Publikovanie skopíruje migráciu credits do vášho database/migrations, kde ju vlastníte vy — samotné php artisan migrate pred publikovaním preto nevytvorí nič. Súbor dostane aktuálnu časovú pečiatku, takže sa spustí po vašich tabuľkách; opätovné publikovanie prepíše ten istý súbor.

Migrácia vytvorí dve tabuľky: credits, samotnú knihu pohybov, a credit_locks, jeden malý riadok na vlastníka, ktorý zoraďuje súbežné zmeny (pozrite Ochrana pred prečerpaním).

Ak vaše modely s kreditmi používajú kľúče UUID alebo ULID, nastavte CREDITS_KEY_TYPE ešte pred migráciou — pozrite si Typy kľúčov a schéma.

Migrácia len dopredu

Ako každá migrácia balíkov od Roundly nemá down(): php artisan migrate:rollback obe tabuľky nezmaže a nasledujúce migrate potom zlyhá na „table already exists“. Publikovaná kópia patrí vám — pri odinštalovaní zmažte credits a credit_locks vo vlastnej migrácii alebo do svojej kópie doplňte down().

Konfigurácia a preklady

Konfiguračný súbor je voliteľný — balík funguje bez akejkoľvek konfigurácie. Publikujte ho, len ak chcete zmeniť predvolenú hodnotu:

php artisan vendor:publish --tag="credits-config"

Texty výnimiek sa dajú preložiť. Publikujte ich do lang/vendor/credits, ak ich chcete upraviť alebo pridať jazyky:

php artisan vendor:publish --tag="credits-translations"

Balík vystavuje presne tri publish tagy: credits-migrations, credits-config a credits-translations.

Ďalšie kroky

• Pridajte modelu rozhranie Creditable a trait HasCredits.
• Pripisujte a odpisujte kredity cez modifyCredits().
• Rozdeľte kredity do pomenovaných skupín, ak sa rôzne druhy nesmú navzájom miešať.