Inštalácia

Pridajte balík cez Composer. Service provider sa zaregistruje automaticky a balíky, na ktorých Posts stavia — package-toolkit, enums, sluggable, media-library, likes, reports a approvals — sa nainštalujú ako závislosti a tiež sa zaregistrujú samy:

composer require roundly-consulting/posts-for-laravel

Migrácie sa len publikujú: nič sa nenačítava automaticky, takže samotné php artisan migrate nevytvorí žiadne tabuľky, kým ich nepublikujete. Najprv si zvoľte typy kľúčov (pozrite Typy kľúčov) — stĺpec autora aj id príspevkov sa typujú v momente spustenia migrácie:

php artisan vendor:publish --tag="posts-migrations"

# The packages posts builds on are publish-only too:
php artisan vendor:publish --tag="media-migrations"
php artisan vendor:publish --tag="likes-migrations"
php artisan vendor:publish --tag="reports-migrations"
php artisan vendor:publish --tag="approvals-migrations"

# Only if you turn on slug history (posts.slugs.history):
php artisan vendor:publish --tag="sluggable-migrations"

php artisan migrate

Indexy slugov a jazyky

Migrácie príspevkov, kategórií a tagov pridajú na stĺpec slug jeden unikátny index pre každý podporovaný jazyk. Zoznam jazykov poskytuje sluggable-for-laravel — sluggable.locales.supported, jazyky z translatable-for-laravel, ak je nainštalovaný, inak app.locale + app.fallback_locale — preto ho nastavte ešte pred migráciou. Indexy pre neskôr pridané jazyky vytvoríte takto:

php artisan sluggable:indexes "RoundlyConsulting\Posts\Models\Post"
php artisan sluggable:indexes "RoundlyConsulting\Posts\Models\Category"
php artisan sluggable:indexes "RoundlyConsulting\Posts\Models\Tag"

Na SQL Serveri, kde sluggable indexy vytvoriť nevie, sa tento krok preskočí a unikátnosť slugov stráži len aplikácia — inštalácia sa nepreruší. Na PostgreSQL sú preložiteľné stĺpce typu jsonb a indexy slugov sú výrazové indexy nad slug->>'<locale>', takže ich využíva vyhľadávanie podľa slugu aj väzba rôut.

Konfigurácia a šablóny

Oboje je voliteľné. Konfiguráciu publikujte, ak chcete zmeniť predvolené hodnoty, šablóny, ak chcete upraviť vykreslené meta tagy a JSON-LD:

php artisan vendor:publish --tag="posts-config"
php artisan vendor:publish --tag="posts-views"

Balík poskytuje publish tagy posts-config, posts-migrations a posts-views.