Inštalácia

Pridajte balík. Service provider sa načíta automaticky a alias fasády Contacts sa zaregistruje za vás:

composer require roundly-consulting/contacts-for-laravel

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

Migrácie je potrebné publikovať — balík ich za vás nikdy nespustí. contacts-migrations publikuje dva súbory v tomto poradí: create_contacts_table a update_contacts_table_with_one_primary_per_kind s indexom jedného primárneho kontaktu (pozrite Databázová schéma). Inštalácia, ktorá už create_contacts_table publikovala, spustí ten istý príkaz na publikovanie znova: publikovanú kópiu balík rozpozná, pridá len nový súbor a php artisan migrate ho spustí.

Každá migrácia vznikne ako súbor s časovou pečiatkou, ktorý patrí vám. Opätovné publikovanie neupravenej kópie (s --force) ju prepíše na mieste namiesto vytvorenia druhej; kópiu, ktorú ste upravili — ani inú migráciu s rovnakým názvom — nikdy neprepíše: migrácia balíka sa publikuje vedľa nej s novou časovou pečiatkou a o tom, ktorú si ponecháte, rozhodnete vy.

Sprievodné migrácie

Composer automaticky nainštaluje addresses-for-laravel a connections-for-laravel. Každý Contact cez ne nesie adresár štruktúrovaných adries a hrany vzťahov a pri zmazaní kontaktu sa upracú obe — publikujte a spustite preto aj ich migrácie:

php artisan vendor:publish --tag="addresses-migrations"
php artisan vendor:publish --tag="connections-migrations"
php artisan migrate

Konfigurácia a preklady

Obe sú voliteľné — každý konfiguračný kľúč má predvolenú hodnotu a popisy typov aj chybové hlásenia sú súčasťou balíka v angličtine a slovenčine. Publikujte ich len vtedy, keď ich chcete prepísať alebo pridať ďalší jazyk do lang/vendor/contacts/<locale>:

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

Publish tagy sú contacts-migrations, contacts-config a contacts-translations.