Installation

1. Insert reservation form component to your page.
2. Be sure you have jQuery loaded!

Configuration

You can set time slot length (default: 15 minutes) and reservation length, which means how much time one reservation takes (default: 2 hours).

If you have reservations at 13.10.2016 at 11:00 and also at 13:00, both with 2 hours length, all time slots from 09:15 to 14:45 will be booked (with 15 minutes slot length).

------------ 11:00 ------------- 13:00 --------------

Because nearest previous reservation can be done at 09:00 (with 2 hours lengths till 11:00) and next reservation at 15:00.

Returning Customers

Plugin allow you to mark returning customers:

• set amount of previous reservations at Backend > Settings > Misc > Reservations
• at reservations listing, click at the list settings (the hamburger at the right corner) and check Returning
• it shows star at customers with more then <your-threshold> non-canceled reservations

Units, capacity, prices

If you need to manage your units (cars, teachers, tables), with some capacity (4 seats, group of 10 people), with some price - you should definitely check reservations units plugin.

Backend calendar

Looking for backend calendar to see your reservations visually? Take a look at backend calendar plugin.

Override configurations

When you want to override default plugin's config.php, which is placed at plugin's folder /config, just create file:

/config/vojtasvoboda/reservations/config.php

And override values you want to change. Example of this file:

<?php return [
    'formats' => [
        'date' => 'd.m.Y H:i:s',
    ],
];

Extending plugin

If you want to extend some plugin and don't know how, check Brands extending examples repository, where you can find many examples which can be applied on every plugin including this one.

Public facade

For other plugins you can use plugin's facade vojtasvoboda.reservations.facade with some public methods as follows:

$facade = App::make('vojtasvoboda.reservations.facade');
$facade->storeReservation(array $data);
$facade->getReservations();
$facede->getActiveReservations();
$facade->getReservedDates();
$facade->isDateAvailable(\Carbon\Carbon $date);

Override seeding

For override seeding just copy seed files from plugin's folder /updates/sources and copy them to:

/resources/vojtasvoboda/reservations/updates/sources/

For example:

/resources/vojtasvoboda/reservations/updates/sources/statuses.yaml

This file will be load with first migration, or you can force refreshing migrations with this command:

php artisan plugin:refresh VojtaSvoboda.Reservations

Unit tests

Just run phpunit in the plugin directory. For running plugin's unit tests with project tests, add this to your project phpunit.xml file:

<testsuites>
    <testsuite name="Reservation Tests">
        <directory>./plugins/vojtasvoboda/reservations/tests</directory>
    </testsuite>
</testsuites>

Receiving "Class 'PluginTestCase' not found" error? Just type composer dumpautoload at your project root.

Code check

License

Reservations plugin is open-sourced software licensed under the MIT license same as OctoberCMS platform.

Icon made by Freepik from www.flaticon.com.