#157

Product support

Get help in the plugin support forum.

Categories

  • Utility

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' %}
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