Konfigurácia

Publikovaný config/appointments.php v plnom znení:

use RoundlyConsulting\Appointments\Models\Appointment;
use RoundlyConsulting\Appointments\Models\Participant;
use RoundlyConsulting\Appointments\Reviews\DatabaseVerifiedAttendanceResolver;

return [
    'model' => Appointment::class,
    'participant' => Participant::class,

    // bigint | uuid | ulid — the key type of the polymorphic participant column
    'key_type' => env('APPOINTMENTS_KEY_TYPE', 'bigint'),

    'table_names' => [
        'appointments' => 'appointments',
        'participants' => 'appointment_participants',
    ],

    'timezone' => null,
    'default_duration_minutes' => 60,
    'prevent_conflicts' => false,

    'recurrence' => [
        'max_occurrences' => 365,
    ],

    'reviews' => [
        'verified_attendance_resolver' => DatabaseVerifiedAttendanceResolver::class,
        'require_verified_attendance' => false,
    ],

    'approvals' => [
        'enforce_transitions' => false,
    ],
];

Všetky kľúče

Kľúče typu bool prijímajú aj reťazce v štýle env — true/1/on/yes a false/0/off/no — a kľúče typu int celočíselné reťazce ('45'). Nenastavený kľúč (chýbajúci, null alebo prázdny: '' či len medzery) znamená predvolenú hodnotu. Čokoľvek iné — preklep v prepínači ('disabled'), trvanie či strop, ktoré nie je celé číslo v rozsahu ('an hour', 0), nereťazcový názov tabuľky, neznáme pásmo, resolver, ktorý nie je VerifiedAttendanceResolver — vyhodí InvalidConfigurationException s názvom kľúča, namiesto aby sa potichu použila predvolená hodnota.

Prostredie (env)

Cez env sa nastavuje iba typ kľúča účastníkov. Určuje typ stĺpca v databáze, preto ho nastavte ešte pred publikovaním a spustením migrácií:

# bigint | uuid | ulid — set before you publish and run the migrations
APPOINTMENTS_KEY_TYPE=bigint

Príkaz about

php artisan about --only=appointments vypíše výsledné nastavenie:

• Model a Participant model — krátke názvy tried použitých modelov.
• Appointments table a Participants table — nakonfigurované názvy tabuliek.
• Default timezone — SET alebo APP DEFAULT. Vypíše sa len to, či je pásmo nastavené, nikdy nie jeho hodnota.
• Default duration — napr. 60 min — a Max occurrences, strop opakovaní.
• Prevent conflicts, Require verified attendance a Approval transitions — ON alebo OFF.
• Attendance resolver — názov triedy naviazaného resolvera hodnotení.

Chybný názov tabuľky, pásmo, predvolené trvanie, strop výskytov či resolver sa zobrazí ako INVALID, takže about sa vypíše aj pri zle nastavenej aplikácii, kým skutočné čítanie konfigurácie vyhodí výnimku.