Inštalácia

Pridajte balík, potom publikujte a spustite jeho migrácie. Service provider sa zaregistruje automaticky cez package discovery — bez manuálnej registrácie:

composer require roundly-consulting/comments-for-laravel

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

Migrácie sa len publikujú — z balíka sa nič nenačítava, takže bez publikovania php artisan migrate tabuľky nevytvorí. Publikovanie skopíruje dve migrácie, každú s časovou značkou okamihu publikovania: create_comments_table, ktorá vytvorí tabuľky comments, comment_mentions a comment_locks, a add_meta_to_comments_table, ktorá pridá stĺpec meta s povolenou hodnotou null (pozrite Metaúdaje komentárov). Už publikovaný súbor sa rozpozná podľa obsahu, preto opätovné publikovanie s --force prepíše ten istý súbor namiesto pridania druhej kópie.

Ak komentované modely používajú kľúče UUID alebo ULID, nastavte COMMENTS_KEY_TYPE ešte pred migráciou — pozrite si Konfiguráciu.

Tabuľky sesterských balíkov

Likes, Reports, Approvals a Media Library for Laravel sa inštalujú ako povinné závislosti a majú vlastné migrácie. Publikujte a spustite aj tie, aby páčiky, nahlásenia a prílohy komentárov mali kde byť uložené:

php artisan vendor:publish --tag="likes-migrations"
php artisan vendor:publish --tag="reports-migrations"
php artisan vendor:publish --tag="approvals-migrations"
php artisan vendor:publish --tag="media-migrations"
php artisan migrate

Prechod z verzie 1.0

Verzia 1.1.0 pridáva jednu migráciu, pre stĺpec meta. Migrácie publikujte znova a spustite migrate:

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

Už publikovaný create_comments_table sa rozpozná podľa obsahu a zostane na svojom mieste; pribudne len add_meta_to_comments_table s novšou časovou značkou. Ak ste svoju publikovanú kópiu create_comments_table upravili, publikovanie ju už nerozpozná a pridá druhú kópiu — tú pred migrovaním zmažte. Kým migráciu nespustíte, všetko, čo meta nepoužíva, funguje ďalej: komentár zapísaný bez metaúdajov sa na tento stĺpec vôbec neodvoláva.

Prechod na verziu 1.2

Verzia 1.2.0 nepridáva žiadnu migráciu. author.type v CommentResource je teraz krátky názov triedy autora (User), nikdy nie uložený actor_type — v aplikácii bez morph mapy to bol celý názov triedy (App\Models\User), ktorý dostal každý klient API. Klientov, ktorí sa riadili starou hodnotou, treba upraviť; iný tvar autora dosiahnete výmenou comments.resources.author — pozrite API resources.

Konfigurácia a preklady

Konfiguračný súbor je voliteľný — každý kľúč má predvolenú hodnotu. Publikujte ho, len ak chcete niečo zmeniť. Hlášky sú k dispozícii v angličtine a slovenčine a načítajú sa v mennom priestore comments:: aj bez publikovania — jazykové súbory publikujte, len ak chcete hlášky preformulovať alebo pridať ďalší jazyk:

php artisan vendor:publish --tag="comments-config"
php artisan vendor:publish --tag="comments-translations"

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

Kontrola aktívneho nastavenia

Balík hlási svoju aktívnu konfiguráciu do príkazu about v Laraveli — model, schvaľovanie, limity dĺžky a hĺbky, veľkosť blocklistu (len počet, nikdy samotné výrazy), autorizáciu, automatické moderovanie a vložené médiá:

php artisan about --only=comments