Skip to content

achton/rooms

 
 

Repository files navigation

ROOMS 7.x-1.x

Rooms is a family of modules that allow you to manage bookings primarily for the accommodation industry it is suitable for hotels, B&Bs, vacation rentals and agencies that manage multiple properties.

If you are looking to create a fully customized booking solution for scenarios such as the ones above from scratch install Rooms on a vanilla Drupal site with all its dependencies. You will be able to use standard Drupal techniques to customize further.

If instead you are looking to get a head start checkout out roomify.us for access to our open-source ready made solutions for:

Vacation Rentals - Casa

Hotels and B&Bs - Locanda

Multiple Properties - Agency

General Documentation

QUICK INSTALLATION

Follow the steps below to install Rooms.

  1. To display interactive calendars, Rooms depends on the FullCalendar (http://fullcalendar.io) library.

The required version of FullCalendar is 2.4.0 and you can download the specific version from the FullCalendar Github repo1.

The FullCalendar library should be placed in sites/all/libraries so that you end up with the file located here: sites/all/libraries/fullcalendar/fullcalendar.js

This version of FullCalendar depends on moment.js library minified version (http://momentjs.com). You can download moment.js from this link[2]. The moment.js library should be placed in sites/all/libraries so that you end up with the file located here: sites/all/libraries/moment/moment.min.js

  1. Activate all the Rooms modules and their dependencies. Dependencies will be automatically downloaded if using [drush][3] to enable the Rooms modules. Alternatively please make sure you download all dependencies (which can be seen in the module page).

At this point the module is installed and you can proceed with configuration.

CONFIGURATION

  1. Visit admin/rooms/units/unit-types and create a unit type (e.g. standard double room).

  2. Visit admin/rooms/units and create a couple of bookable units.

  3. Set availability and pricing - clicking on events or date ranges in the calendars will bring up a pop-up dialog and allow you to interact with them.

  4. To manually create a Booking go to admin/rooms/bookings/add. This will also create a Commerce order and line item for that booking.

  5. Potential guests can go to /booking to do an availability search.

  6. If you wish to display availability information on an embedded calendar in a node (as vacation rentals properties often do) activate the Rooms Availability Reference Module.

6a. This will give you a new field type called "Availability Reference".

6b. Add the field to any entity and you may reference specific Booking Units to have the availability information rendered on the node display (or any other entity).

The results of the availability search are the rooms available over the period - adding one to a cart will create a Room Booking Unit commerce product for it and place it in the cart. Once checkout is completed the calendar is updated to reflect the change.

Please join us in the [Rooms issue queue][3] and collaborate with us to create a great booking solution for Drupal!

For a more complete set of documentation visit http://www.drupalrooms.com

PHP REQUIREMENTS & DATE REQUIREMENTS

The use of the DateInterval class and other bugs found in PHP means that we require PHP version 5.3.9 or greater.

In general, this module makes use of latest Date functionality in PHP, so ensure that it is enabled in your PHP setup. We may scale back on this to make things more usable for a wider range of configurations.

UPGRADING FROM PREVIOUS VERSIONS

Please make sure you test extensively on a test site before upgrading!

UNINSTALLATION

If you wish to uninstall Rooms, you must disable and uninstall the modules it provides in reverse order of dependencies. After disabling each module that is available to be disabled, visit the 'uninstall' tab and uninstall it.

[2]: http://momentjs.com/downloads/moment.min.js Moment JS Library [3]: http://drupal.org/project/drush "Drush, the Drupal shell" [4]: http://drupal.org/project/issues/rooms "Rooms issue queue on Drupal.org"

About

Open Source Booking & Room Management module for Drupal

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • PHP 63.7%
  • Gherkin 11.5%
  • SourcePawn 11.0%
  • JavaScript 8.6%
  • CSS 5.2%