OctoberCMS Booking is a plugin that let you create rooms, publish on the front end and add booking form if you want.
Installation
You have to install the Rainlab.Translate plugin first
Use Tiipiik.Booking to search and install the plugin.
Configuration
You must configure the room page slug in Settings to have automated generation of rooms slugs in the RoomList component.
The following options are available.
- Rooms can be managed via the Booking > Rooms menu.
- Bookings can be managed via the Booking > Booking menu.
The plugin uses 3 Components (Booking form component can not be alone, it requires the roomDetails component):
- Room list,
- Room details,
- Bookiing form with calendar for available dates,
Bookings are stored in database and you can see and modify them in the backend.
You could set multiple rooms, or just one and describe options in the long description field.
Languages :
- English
- French
- Polish, thanks to @gzysiol
- Russian, thanks to @maximlit
Todo list:
display room name instead of it's id,add localisation,- add more flexibility,
- add ability to use the bookingForm component alone, by disabling the calendar,
- return an error when trying to book a room that is not available.
- Manage date formats from component BookingForm
OctoberCMS Booking does not supply payments for booked rooms (not yet).
Issues / PRs
Please report any issues at https://github.com/tiipiik/OctoberCMS-RoomBooking Pull Requests on GitHub are very welcome !
Like this plugin?
If you like this plugin or if you use some of my plugins, you can help me to make new plugins and provide plugins support and further development. Make donation with PayPal or give this plugin a Like. :)
The roomList component is not always required. If you have just one room, you could directly display the room details and/or the form. Form is not required at all, you can just display room details, but form could not be displayed alone, due to the calendar for available dates.
Displaying a list of room
The plugin includes a component roomList that displays a list of room. Add the component to your page and render it with the component tag: {% component 'room_list' %} Displaying room details
Use this component to display details of a room: {% component 'room_details' %} Displaying booking form
Use this component to display form to book a room (for now requires to be on the page Rooms details): {% component 'booking_form' %} This component additionnaly displays a calendar with availables dates for the room it as associated to, based on booking already stored in database.
Example page structure
rooms.html (could be any other page name - displays a list of all rooms) title = "Rooms" url = "/rooms" layout = "default"
[room_list]
roomsPerPage = "10"
pageParam = ":page"
roomPage = "rooms"
roomPageIdParam = ":slug"
noRoomsMessage = "No rooms found"
==
{% component 'room_list' %}
rooms/bridal-suite.html (room details and booking form) title = "Room Details" url = "/rooms/:slug" layout = "default"
[room]
idParam = ":slug"
[booking_form]
redirect = "plugins"
==
{% component 'room' %}
{% component 'booking_form' %}
-
Rainer Kraft
Found the plugin useful on 28 Jun, 2020
A very useful plugin, but there still is something, that I wish for. You can book days, that are already booked. How do you check this?
-
| 1.1.15 |
Workaround for amount and total_nights, thanks to @mabasic Jul 26, 2018 |
|---|---|
| 1.1.14 |
Fixed wrong bookedDates, thanks to @mabasic Jan 19, 2018 |
| 1.1.13 |
Fix error on booked dates, thanks to @mabasic Jan 04, 2018 |
| 1.1.12 |
Fix error on sending notification when no e-mail was provided. Dec 08, 2015 |
| 1.1.11 |
Added e-mail notifications Dec 04, 2015 |
| 1.1.10 |
Correct/Fix total nights, thanks to @m.paniez9292 Nov 26, 2015 |
| 1.1.9 |
Markdown editor replaced by richeeditor, thanks to @mabasic Nov 24, 2015 |
| 1.1.8 |
Fix bug in Room component Oct 15, 2015 |
| 1.1.7 |
Fix total nights / days, thanks to @m.paniez9292 Aug 04, 2015 |
| 1.1.6 |
Fix storage for total nights Aug 03, 2015 |
| 1.1.5 |
Added russian langauge, thnaks to @maximlit for his PR Mar 31, 2015 |
| 1.1.4 |
Some settings were moved to the backend and added RainLab.Sitemap support. PR by @matissjanis Mar 11, 2015 |
| 1.1.3 |
RC compatibilty update Mar 03, 2015 |
| 1.1.2 |
Fix booked dates of each room Mar 03, 2015 |
| 1.1.1 |
Fix compatibility with RC Feb 19, 2015 |
| 1.1.0 |
Added user permissions Feb 19, 2015 |
| 1.0.17 |
Added Polish translations, thanks to gzysiol ! Feb 16, 2015 |
| 1.0.16 |
Plugin fully translated. NEXT UPDATES COULD IMPACT YOUR WEBSITE IF IN PRODUCTION, PLEASE TAKE CARE. Feb 16, 2015 |
| 1.0.15 |
Fix little issue on room creation Feb 14, 2015 |
| 1.0.14 |
Display booked dates only if they are validated Feb 11, 2015 |
| 1.0.13 |
Removed sorting by Room in Bookings Oct 15, 2014 |
| 1.0.12 |
Fixed typo in Booking model that was runing an exception Oct 05, 2014 |
| 1.0.11 |
Fixed bug from dates and bad fields seeds Sep 18, 2014 |
| 1.0.10 |
Remove Date type for datepickers input (Avoid a conflict with browsers which implements HTML5 data type input) Sep 18, 2014 |
| 1.0.9 |
Fixes empty field passed to Carbon Sep 18, 2014 |
| 1.0.8 |
Fixes issue on displaying Bookings Sep 04, 2014 |
| 1.0.7 |
Added required plugin for Rainlab.Translate Aug 26, 2014 |
| 1.0.6 |
Fully functionnal Pay Plans and are now set as relation Aug 20, 2014 |
| 1.0.5 |
Added Pay Plans to backend Aug 20, 2014 |
| 1.0.4 |
Plugin backend is now translatable Aug 05, 2014 |
| 1.0.3 |
Fix bad placeholders names in the bookingForm component Aug 05, 2014 |
| 1.0.2 |
Improve datepicker dates Jul 22, 2014 |
| 1.0.1 |
First version of Booking Jul 04, 2014 |