PHPackages                             vojtasvoboda/oc-reservations-plugin - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. vojtasvoboda/oc-reservations-plugin

ActiveOctober-plugin

vojtasvoboda/oc-reservations-plugin
===================================

Reservations plugin for OctoberCMS

1.1.10(4y ago)2116314[6 issues](https://github.com/vojtasvoboda/oc-reservations-plugin/issues)MITPHPPHP >=5.4

Since Oct 14Pushed 4y ago4 watchersCompare

[ Source](https://github.com/vojtasvoboda/oc-reservations-plugin)[ Packagist](https://packagist.org/packages/vojtasvoboda/oc-reservations-plugin)[ Docs](https://github.com/vojtasvoboda/oc-reservations-plugin)[ RSS](/packages/vojtasvoboda-oc-reservations-plugin/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (1)Versions (27)Used By (0)

Reservations plugin for OctoberCMS
==================================

[](#reservations-plugin-for-octobercms)

[![Build Status](https://camo.githubusercontent.com/1a68ef769a8153282b602c51d101dfe3aa898cf6a321005c5e0bd24952602309/68747470733a2f2f7472617669732d63692e6f72672f766f6a746173766f626f64612f6f632d7265736572766174696f6e732d706c7567696e2e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/vojtasvoboda/oc-reservations-plugin)[![Codacy](https://camo.githubusercontent.com/726e2574a2f2c45da7ce22bc5c46b19fe01ca7a65fec95fc19da4b7dfef5f976/68747470733a2f2f696d672e736869656c64732e696f2f636f646163792f64343634323031383563393034366462383230386162313664333538613064332e737667)](https://www.codacy.com/app/vojtasvoboda/oc-reservations-plugin)[![Code Coverage](https://camo.githubusercontent.com/31f343d3c40299f4d64ff7e63aecddbfeaf5715662b701592b527f577ecdca60/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f766f6a746173766f626f64612f6f632d7265736572766174696f6e732d706c7567696e2f6261646765732f636f7665726167652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/vojtasvoboda/oc-reservations-plugin/?branch=master)[![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](https://github.com/vojtasvoboda/oc-reservations-plugin/blob/master/LICENSE)

Provide reservation form with reservations management. You should also check related plugin: [backend calendar](http://octobercms.com/plugin/vojtasvoboda-reservationscalendar).

Key features:

- reservations have **coloured statuses**, **bulk actions** and **fulltext search** to save your time
- nice and clean **dashboard widget**
- reservations **export** with status filtering
- reservation can be created directly from the backend
- returning customers function

Technical features:

- shipped with **translations** and covered by **unit tests**
- reservation form has **CSRF protection** and **multiple bots submissions protection**
- reservation form has **AJAX sending** and also non-JS fallback
- overloadable **data seeding** for statuses

No other plugin dependencies. Tested with the latest stable OctoberCMS build 420 (with Laravel 5.5).

Installation
------------

[](#installation)

1. Install plugin [VojtaSvoboda.Reservations](http://octobercms.com/plugin/vojtasvoboda-reservations)
2. Insert reservation form component to your page. Be sure you have jQuery loaded!

Returning Customers
-------------------

[](#returning-customers)

Plugin allow you to mark returning customers:

- set amount of previous reservations at **Backend > Settings > Reservations > 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 non-canceled reservations

Admin confirmation
------------------

[](#admin-confirmation)

By default, plugin sends confirmation email to customer. But you can also turn on sending confirmation to different user (your customer, system administrator, etc). Follow these steps to turn this feature on:

- set admin email and name at **Backend > Settings > Reservations > Reservations** at **Admin confirmation** tab
- turn the admin confirmation by switch
- system will send special template 'reservation-admin', so feel free edit content of template at **Backend > Settings > Mail > Mail templates**

Backend calendar
----------------

[](#backend-calendar)

Looking for backend calendar to see your reservations visually? Take a look at [backend calendar](http://octobercms.com/plugin/vojtasvoboda-reservationscalendar) plugin.

Public facade
-------------

[](#public-facade)

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->getReservationsByInterval(\Carbon\Carbon $from, \Carbon\Carbon $to);
$facade->isDateAvailable(\Carbon\Carbon $date);

```

Configuration
-------------

[](#configuration)

You can find some plugin configuration at the CMS backend (datetime format, reservation length, time slot length, etc). But you can also set some values at plugin's config file. Config values are used when Settings value can not be found (and also because of backward compatibility with users using older version of plugin).

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:

```