reservations documentation artio booking and veronika

ARTIO Booking andReservations Documentation

Veronika BijokováJiří Trumpeš

Michal Unzeitig

ARTIO s.r.o.

ARTIO Booking and Reservations Documentationby Veronika Bijoková, Jiří Trumpeš, and Michal UnzeitigARTIO s.r.o.Copyright © 2011 ARTIO International Co.

Abstract

User documentation for ARTIO Booking & Reservations (Book-it!) component for CMS Joomla!. This documentdescribes the component requirements, installation and usage. All main component parts are described in moredetails, including illustration images and examples. It specifies server and browser requirements and informationabout environment constraints. The documentation is helpful for both web developers and website administrators /owners.

iii

Table of Contents1. Introduction .............................................................................................................. 1

1.1. Technical Requirements ................................................................................... 11.2. Browser Compatibility ..................................................................................... 2

2. Installation ............................................................................................................... 32.1. Prerequisities .................................................................................................. 32.2. Installation ..................................................................................................... 3

3. Administration (backend) ............................................................................................ 63.1. Control Panel ................................................................................................. 63.2. Templates ...................................................................................................... 63.3. Bookable Items ............................................................................................. 103.4. Reservation Types ......................................................................................... 133.5. Prices .......................................................................................................... 163.6. Reservation Types - Extended Settings .............................................................. 223.7. Google Calendar ........................................................................................... 303.8. Closing Days ................................................................................................ 363.9. Google Maps ................................................................................................ 373.10. Supplements ............................................................................................... 383.11. Booking Administrators ................................................................................ 403.12. Reservation ................................................................................................. 403.13. Payment Methods ........................................................................................ 413.14. Global Configuration .................................................................................... 443.15. Sending E-mails and SMS ............................................................................. 51

4. Usage (frontend) ...................................................................................................... 544.1. Booking Customers ....................................................................................... 54

5. Troubleshooting ....................................................................................................... 59

1

Chapter 1. IntroductionBooking and Reservations (Book-it!) is an universal Joomla! component for online reservations. Nomatter what kind of service you are running or what you want to book. You can create any object withany number of parameters and manage its reservations schedule and prices. All using user-friendlyenvironment of the Joomla backend. Objects can be organized into hierarchy, so you can even managemultiple facilities consisting of many bookable units. E.g. you can manage several hotels with multiplerooms, multiple bowling, squash or other sport facility centers with several grounds. The system alsooffers object capacities, variable-lenght reservations, combination of different reservations, bookableextras and many more.

1.1. Technical Requirements1.1.1. Server Requirements

There are two versions of booking component: Book it!, Book it! 2

The component is compatible and has been tested with:

• Book it! is compatible with Joomla 1.5, Book it! 2 is compatible with Joomla 2.5.6+ and 3.x

• webserver (Apache2 or IIS) running PHP 5.1 or newer

• MySQL 5.0 or newer

Please note: Proper functionality may not be guaranteed with PHP 4. The component does not workwith Joomla! 1.0.

If your Joomla! includes custom core patches or 3rd party extensions modifying the default Joomlafunctionality, proper functionality may not be guaranteed as well.

1.1.2. JavaScript Framework RequirementsBook-it! uses Mootools JavaScript framework. With Joomla! 1.5, Mootools 1.12 is required; withJoomla! 2.5.6 and newer Mootools 1.3 is required. When using different versions of Mootoolsframework, proper functionality may not be guaranteed. Booking 1.3 automatically update MooToolsto 1.2 with Joomla 1.5.

Please note, that you can not use JQuery and Mootools JavaScript frameworks at the same time withoutspecial adjustment. There may exist a conflict between these frameworks that needs to be resolved.JQuery should run in non-conflict mode.

Joomla 3.x contains two JavaScript frameworks: Mootools and jQuery in non-conflict mode. Somenew features in Book it! 2.1.0+ can need also jQuery for right functionality. But there can be stillproblem with 3rd party extensions which do not use Joomla functions, but loads own jQuery script.You can try to use JQuery Easy plugin for Joomla 2.5 and 3.0, which should solve problems withconflict and also with duplicity of JavaScript frameworks.

Also note, the JavaScripts as well as CSS (Cascading Style Sheets) are usually cached by webbrowsers. When developing the component make sure to clean browser cache as it may keep outdatedversions of JS and CSS files. In most browsers you can use CTRL+F5 shortcut to force the full reload.

Introduction

2

1.1.3. Database RequirementsImportant: When running Book-it!, the database user used by Joomla must have permission to createtables/views and add and modify table columns. Book-it creates new database table each time a newobject template is created (not only on installation).

1.2. Browser CompatibilityThe component has been tested on Internet Explorer 9, 8 and 7, Google Chrome, Opera, MozillaFirefox. Compatibility with Internet Explorer 6 or older is not supported.

3

Chapter 2. Installation2.1. Prerequisities

Before installing ARTIO Booking, you need to have:

1. Joomla 1.5.x or 2.5.6+ or 3.x installed

Make sure that all the needed directories (as requested by Joomla!) are writable.

2.2. InstallationThe component is installed through Joomla standard installer in backend: Extensions → Install/Uninstall(Joomla 1.5) or Extensions → Manage Extensions(Joomla 2.5.6+ and Joomla 3.x)

Installation

4

Figure 2.1. Extension Manager: Install

The installation package contains all needed support libraries, so the size of installation pack is about2 MB or more. Some hostings maybe have the size of uploaded files limited, In such case it may benecessary to increase this limit or upload the files using FTP.

Please, watch for any error messages generated during installation. If any error appears, the installationmight not have been completed correctly.

Installation

5

Please note that after uninstall, component database is not deleted. So, if you install sample dataagain, they are duplicated. If you want really clean reinstall, delete all database tables starting with(JoomlaPrefix)_booking_.

6

Chapter 3. Administration (backend)3.1. Control Panel

All component parts are fully accessible from Joomla backend. Control panel is interface where youcan open all main component parts. Every main part is described in detail in following sections.

Figure 3.1. Control Panel

3.2. TemplatesThe basic template in which you set the attributes, depending on what object you will create. That canbe basic attributes such as name, but also properties that are characteristic for certain type of object(field size, number of beds, bathroom, car specification, ...) The types of properties are standard, as youknow it from web forms (Text box, Text area, Select box, Radio button and Check box). In additionto the name and the type you can still assign a style icon to the property and choose, if it can be usedfor searching and filtering. The last thing you can set to the template is, what kinds of calendars to bedisplayed to customer and which one is the default.

Templates settings is available in component administration on bookmark templates.

Figure 3.2. Template List

For templates are available basic tools new/edit/copy/trash. This tools are available in main toolbar.On clicking new/edit or click on template name you open editing page. On template editing page youset template name, calendars and properties.

The calendar is a dialogue, through which your customers will determine the time of reservation.There are three basic types, which differ both displayable time interval, as well as graphical form. Daycalendar lists possible reservation times for every day separately, and as all calendars shows occupiedterms. Week calendar´s appearance and functionality is very similar to the previous. Shows all daysfrom today (or from first day of the week - check Configuration → tab Calendars → option Show FullWeekly Calendar) until the end of the week. The last, month calendar shows all days of the monthafter a weeks. In contrast to previous two calendars, shows only full day reservations, no hourly. For

Administration (backend)

7

every calendar you set if it is available or not. One of them you have to set as default. Default calendaris displayed when customer opens object page for the first time. Calendars are choosed according toobject character. If you create objects as hotel room or car which are booked for full days you needonly month calendar. For objects as tennis court or sport hall which are booked for hours you useday or week calendar. There are also another types of calendar: Week Multi Calendar which displayavailable reservations in specific week. It is useful for hourly and daily reservation type and PeriodicCalendar that can be used when you want to reserve an object regularly for the certain time in certainday of the week.

Figure 3.3. Booking Calendars

Properties are attributes that belong to the certain template. You can take advantage if you have severalobjects of the same type (for example: tennis courts). This objects have the same attributes, but theirvalues are different. For example, the hotel will have a number of rooms, in each you will specify thesame attributes (number, floor, where is the view, number of beds,...). When you will then create theobjects of individual rooms, you can use this template and fill in simply the necessary information.You can have as many templates as you want, so there is not problem to have other for a room andother for an apartment. For each to indicate other information.


8

Figure 3.4. Template Edit Page

You can set template properties by click on tool new (for new property) or click on tool config (forexisting property). During creating new one you have to set property type.


9

Figure 3.5. Dialog to Select Property Type

Every property has title. If you use multiple properties, select box/radio button. You must set minimallytwo options. Every option must be on a single row. You can optionally choose an icon (you can setpath to your own icons in: Configuration → tab Images → option Template Icon Path) and searchable/filterable mark. Searchable properties will be possible to find via module. Filterable properties can befiltered in the component view.


10

Figure 3.6. Dialog to Edit Template Property

3.3. Bookable ItemsThis is the subject of your business. Bookable item could be anything you want to allow your customersto book. Whether that are hotel rooms, cars, tennis courts etc. Items can form a tree structure, which


11

you can adapt according to your wishes. Of course there is a gallery and descriptive text, which youcan also enrich with pictures, graphs and other elements. There is a possibility to set the values of yourproperties, which you created in the template. Furthermore there are also reservation types and prices,which is main part of items settings. For more information, read information below.

Objects settings are available in component administration on bookable items.

Figure 3.7. The objects backend filtered list

Items tree structure is important if you want order items into categories according to their character.Parent items are not bookable. They are meant to creating objects categories. Bookable are only lastchilds of tree structure.

Figure 3.8. The items backend editing page

The simple example details setting for hotel room

Booking of this room is available from 2013-10-08 (see option Start Publishing) to2013-12-31 (option Finish Publishing). Room is permanent published (see option published)and is displayed to all page visitors (access is public). In items hiearchy is room added intocategory Accomodation.


12

Bookable items must have title. Alias is used for creating SEF urls. If you let alias field empty thenalias is during item saving generated automatically. If itemt is published you should not change itbecause SEF url is already indexed by Google. Fields meta keywords and meta description are alsoused for SEO and you should fill them.

Every item has assigned one template. You are able to edit template from item editing page. All changesin template what you do by edit item are show in others items and template too. You can set for itemstandard Joomla! options as publish status and dates, user access and items ordering.

When the quantity is set and bigger than 1, customer can select booking capacity. There is also optionto "Show Quantity Information" which display in calendar available capacity. You have also option toset the Occupancy, for example number of normal beds in the room.

Figure 3.9. Example of setting Quantity and Occupancy


13

Figure 3.10. Example of Show Quantity Information (frontend)

You can upload images to the gallery and set which one will be default by selecting it and then click onicon "Default". Another part is File Attachements. You can upload and attach files to an object. Thatcan be for example user manuals. You can specify to every file if it will be available in item detail andif it will be sent along with reservation e-mail to customer.

3.4. Reservation TypesNow we come to the most important part. And this is very flexible reservation system through whicheverybody create a timetable which is required. Through Reservation Settings you choose the wayhow customer can book the certain item. The main parameter is type of reservation: daily or hourly.Daily means that the customer has to book the certain item at least for the full day, hourly then enablesthe shorter time intervals. The following two parameters apply to the hourly reservation types. It istime unit, alias time interval of reservation. It indicates that customer can book the items for exampleafter 30 minutes. Gap time is a time lag between individual reservations for example used for cleaning.You can set limit restrictions: minimum and maximum length, fixed length and restrictions for weekday from which can customer makes reservation.

You can set "Enable Maximum Reservation Limit" and to Allow Maximum of Reservation withindetermined time. It means that customer can make certain number of reservations within certain days.


14

Figure 3.11. Example of setting Maximum Reservation Limit

Figure 3.12. Example of Hotel Room Reservation (backend)


15

Figure 3.13. Example of Hotel Room Reservation (frontend)

Figure 3.14. Example of booking of room for whole week (backend)


16

Figure 3.15. Example of booking of room for whole week (frontend)

3.5. PricesThe most important item settings is Prices. It is necessary part of any item and together withReservation types it creates every schedule which has to be included in any reservation system. Fordefinition you have to specify the following parameters. The actual price, deposit, which will bereturned to the customer, reservation type, that we selected in the previous flag and dates from whento when is price valid. You can specify other parameters for hourly reservation type. Of course thereare the times between which the item can be booked. The reservation units are calculated among thistime, according to the time unit and the gap time. You can also modify in which days of the week is theprice up to date. You can create a whole series of reservation units with different type of reservations.The choice of the date is enabled through the calendar dialogue and hour can be set on the dial foruser-friendliness.

The Multiply capacity parameter is used if item has bigger capacity than one. It specifies, whetermultiply reservation price and deposit by reserved capacity. For example, if you reserve cars or rooms,setting should be checked (more -> more price). If you reserve something where price stays constantno matter of reserved capacity, setting should be unchecked.

You can also have an option to select interval only in one price by clicking on "Allow Booking OverDifferent Pricing Periods". In this case you can make a reservation over more prices but with samereservation type.


17

Below you can see an example of Squash Courts available every day from Monday to Sunday (DayAvailability) from 07:00 am to 11:00 pm (Time Range) but the prices are different. From 07:00 am to6:00 pm is price 5 EUR, from 6:00 am to 11 pm is 8 EUR.

Figure 3.16. Example of Squash Court Prices (backend)


18

Figure 3.17. Example of Squash Court Prices (frontend)

You can also set a deposit that will be returned back to the customer. In this case is necessary to setReservation Expiration. There are these following types: „Online Payment Only“, „After Reservation“and „Before Booking“. If you set „Online Payment Only“ customer can pay only with online methods.If payment will not be done immediate after the reservation, reservation will be cancelled. „Afterreservation“ means that order has to be paid specified number of hours after reservation was created.If not, reservation will be cancelled. „Before Booking“ is same like previous type. But it will checkreservation payment status before event start. Deposit multiply parameter specifies, wheter multipledeposit by reserved time units. If not checked, deposit is the same no matter of reserved time.

Here is an example how to set a deposit when customer have to pay it after reservation. Determinedtime is 2 hours, it means that customer has to pay it within 2 hours, if not then reservation will becancelled. Deposit value is 10 EUR.


19

Figure 3.18. Example of setting deposit

All prices include tax with default settings but you have also the option to change it that prices willnot include a tax. This can be set in Configuration → tab Prices → option Show prices without tax.In tab Prices is also possible to add "new tax" and its values.


20

Figure 3.19. Example of setting "Show prices without tax" (backend -configuration)


21

Figure 3.20. Example of setting "Show Prices with Tax" (frontend)


22

Figure 3.21. Example of setting "Show Prices without Tax" (frontend)

You can also provide a discount, if customer reserve more than one time unit.

3.6. Reservation Types - Extended SettingsIf you have more then one reservation types and each reservation type has different length, you canuse optional minimum interval. With only one reservation type this option is not used.

In following example we have a squash court where customer can book 60 or 120 minutes. We needto display 60 minutes boxes in calendar. For this reason we have to set minimum interval length for 60minutes. When customer wants 60 minutes, then chooses one box. When customer wants 120 minutes,in calendar are highlighted always two following boxes for one click. Now in weekly calendar, incolored price box are displayed currently available capacities. See examples below.


23

Figure 3.22. Example of two reservation types with different lengths (backendobject reservation types)

Figure 3.23. Example of two reservation types with different lengths (backendobject prices)


24

Figure 3.24. Example of two reservation types with different lengths (frontend)

The fixed shedule you can use, for example, if you use more prices with different time ranges and incalendar every day has different shedule length. And you want every day calendar to have specifiedlength, even if there is no available reservations through whole time. See examples bellow. You haveto set minimal interval length and fixed shedule from-to properties. Fixed shedule interval from-tomust be wide enough to match all prices time ranges.


25

Figure 3.25. Example of Fixed Schedule (backend object reservation types)


26

Figure 3.26. Example of Fixed Schedule (backend object prices)

Figure 3.27. Example of Fixed Schedule (frontend)


27

The another situation can be when you are providing for example Castle Tour or Road. Every Tourtakes 2 hours but starts every hour. In this case is necessary to set "Overlay Prices". As you can seebelow there is a Tour Castle which is possible to reserve every day from 1:00 PM to 5:00 PM andstarst every hour.


28

Figure 3.28. Example of setting Overlay Prices (backend)


29

Figure 3.29. Example of setting Overlay Prices (backend)


30

Figure 3.30. Example of Overlay Prices (frontend)

3.7. Google CalendarSynchronization your reservation with your Google Calendar. You have to have own Google accountwhere you want to synchronize reservation.

3.7.1. Google SettingsCreate google calendar in your google account, than go at https://cloud.google.com and create theproject by clicking on CREATE PROJECT. Enter Project name and Project ID.

Figure 3.31. Create new google calendar


31

Figure 3.32. Create new project

Turn on Calendar API at the APIs & auth/APIs.

Create connection to Joomla by using REGISTE APP at the APIs & auth/Registered Apps


32

Figure 3.33. Calendar API


33

Figure 3.34. Register APP

Choose any Name and create Web Application

Choose OAuth 2.0 Client ID

Redirect URL - enter name of your domain http://yourdomain/administrator"index.php?option=com_booking&task=google.authenticate

By clicking on GENERATE you receive Client ID and Client Secret

3.7.2. Booking SettingsGo to Global Configuration - Google and enter Client ID and Client Secret - Save


34

Figure 3.35. Entering Client ID and Client Secret

Run Load Calendars on the Control Panel/Google - this function loads calendars created in your googleaccount


35

Now you can choice Default Calendar in Global Configuration

Figure 3.36. Default Google Calender


36

To finish synchronization by using Control Panel - Google - Synchronize Events. The reservation willbe synchronized into your google calendar.

3.8. Closing DaysClosing days enable you to set a days, hours when the item is not available for any reason. If you wantto create closing days, you have to fill Title, Date up and Date down, Time up and Time down, thenselect the existing items for which you want to set closing day.

Figure 3.37. Closing Days List

Below you can see Squash court Nr.1 which is not available on Wednesday from 11:00 am to 02:00 pm.


37

Figure 3.38. Example of setting closing days for Squash Court (backend)

3.9. Google MapsGoogle Maps allow you to give customers information about place where they can find you or bookableitem. You can insert Google Map into the object detail page by two different ways. The first is whenyou select Address for Type option. Address should contain street, city and country. Then set a widht,height (in pixels) and zoom (higher value means higher zoom). The second way is to find a map athttp://maps.google.com/ and then insert code from this page into the last field.


38

Figure 3.39. Example of setting Google Maps (backend)

3.10. SupplementsSupplements is next bookable item settings. For example: you run the hotel accomodation andcustomers can reserve beside room also breakfast, phone, internet or another services. Anotherexample can be for squash courts where you can provide also rackets for players. See examples below.

Supplements have two forms. Supplement "Option yes/no" is realized on frontend by checkbox formfield and have price (option "One price") or is free (option "Free"). Supplement "Select from list" hasmore values and is realized by drop down list form field. Each value has own price (option "Moreprices") or all values have one price (option "One price") or supplement is free (option "Free"). Forsupplement "Select from list" you can set property "Use empty option". It means that customer doesn'thave to choose this supplement value (in drop down list is option without value). Property "Use emptyoption" is unavailable for supplement "Option yes/no". Supplements prices are automatically addedto full reservation price.


39

Supplement capacity setting allows you to set behavior of supplement capacity. No capacity meanssupplement will be always one and price will be constant. Default is multiply by object capacity -number of supplements will be same as reserved object capacity (if object has capacity) and pricewill be multiplied as well. Option "Select Capacity Manually" allows customer to specify number ofsupplements manually and supplement price will be multiplied by selected number of supplements.You can set maximum number of supplements for this setting. This can be used for example foradditional cathering or sporting equipement.

Figure 3.40. Example of room supplements (backend)

Figure 3.41. Example of squash courts supplements (backend)


40

Figure 3.42. Example of squash courts supplements (frontend)

3.11. Booking AdministratorsFor using Booking is important to have frontend administrators. Frontend administrators managereservations from frontend interface (not backend). Administrators are selected from existing Joomla!users. This users cannot be used in customers acounts. On following image is backend dialog ofadministrators setting. There is filtered list of existing users. In column "Is admin" you can see markif user is/isn't administrator or is customer (cannot be administrator). You can assign more users asadministrators by tools from main toolbar.

Figure 3.43. Backend booking administrators setting

3.12. ReservationIf you have published items, customers can book them and make reservations. One reservation canhave multiple booked items (optionally with supplements), their time ranges, computed prices andcustomer personal data. Customers create reservations from frontend item detail page with calendar.According to item settings, calendars display available intervals with specific color. Customers chooseavailable intervals and items supplements. After click on button Book it!, lightbox window is opened,where customer can select item and supplements capacity (if available) and choose between going


41

to checkout or continue and reserve different object. On checkout page, customer can manage hisreservation, fill his personal data and send reservation to Book it! system.

Reservations can have a following status: Prereserved, Reserved, Trashed, Cancelled and Conflicted.There is also Payment Status: Unpaid, Deposit Paid, Paid in Full.

Figure 3.44. Reservations backend list.

Figure 3.45. Reservations Status.

3.13. Payment MethodsPayment Methods List is available in "Extensions-Plug in Manager-bookingpayment". Here you canset if is it enabled to pay by a certain payment method. Then you have to go back to configuration"Payment Methods" and you can edit existing method and set who can pay pay it or no.


42

Figure 3.46. Payment Methods List - Plug in Manager


43

Figure 3.47. Payment Methods Manager


44

Figure 3.48. Edit Payment Methods

3.14. Global ConfigurationGeneral, User Group Assigned toNew Customers

User group, where are assigned newly created customers. Werecommend to use registered group.

Customer has to Login or RegisterBefore Reserving

If you select No customer is prompted to login or register duringreservation. If guest user group can reserve then customer canreserve without login or registration.

Enable to New Reservation Temporary blocking of new customers registering

Show customer names Show customer ś name which already made reservation inreserved interval (only for front-end)

Figure 3.49. Show customers of reservations

Show User Note in Calendar Show customer´s note (note during checkout) in calendar, ifday/hour is booked.

Use captcha Only for unregistered customers. Before customer savereservation he has to fill captcha image. It's security to robots.


45

Figure 3.50. The captcha for unregistered users.

Enable More Reservation User can add more booked object during reservations. It issomething like "cart".

Confirm Reservation If you set "Yes" manager has to confirm created reservationfirst.

Redirection after Reservation Target where customer is redirect after reservation has beendone. Customer can be redirect to "Thank you page","Bookable Items List" etc.

Redirection after Reservation Menu When you select in option Redirection after Reservation valueMenu Item then select here some item.

Redirection after Reservation URL When you select in option Redirection after Reservation valueCustom URL then add here some URL.

Redirection back from Reservation Target where customer i redirect when click on button back atreservation detail


46

Enable Responsive Responsive design is modified for mobile devices. It will alsodetect whether customer us tablet or mobile, otherwise it willshow standard design.

Enable jQuery jQuery is necessary part of responsive design. If you alreadyuse jQuery on your site (loaded by any other extension) thenplease, do not enable this option.

Require Accepting You can set if customer has to accept Terms of Contract andTerms of Privacy before reservation.

Date Format Date formatting is used in frontend and backend. There ispossible to use a predefined format or custom format. Ifyou choice a custom format you can set: Long Date Format(containing date and time, it means date/month/year/hour/minutes), Standard Date Format (contains only date, day/month/year), Day/Week Calendar Format (this format is usedin daily/weekly calendar as caption of day, should contain ashort value of day and month without year), Month CalendarFormat (format is used in monthly calendar as caption of day,should contain as in previous format). There is also possibleto show "Time Format" which is used for displaying time, forexample in daily or weekly calendar. Should contain only hoursor minutes.

Images, Popup Type Select popup type you want to use on your website. If you useResponsive design, we recommend you to use shadowbox.

Image Path The directory path where are saved objects images. It'srelative path from Joomla! root. For example: your Joomla! isinstalled in directory /var/www and you want to save imagesin directory /var/www/images/objects. You have to set thisoptions as images/objects. Template icons path is path whereare saved templates icons. The rules are similar like image path.There is also possible to set JPG quality of thumbnails. Youcan choice between 75 and 100. 75 is maximum compressionbut lowest quality and 100 is maximum quality but biggest filesize. PNF quality is possible to set between 0 and 9, when 0 iswithout compression and 9 is maximum.

Prices, Using Prices Settings of using prices - Prices with Deposit, Prices withoutDeposit or without Prices.

Currency Your currency display with prices.

Display Last Zero You can display last zeros in prices. If you choice this option,the value will be displayed as 12.50.

Decimals and decimals point Here is possible to set number of decimal and separator fordecimals (comma or point)

Thousands Separator Here you can select how will be thousands separated, theoptions are following: None, Space, Comma, Point or there isalso possible to select Custom Separator.


47

Price Format Price can have different formats, you can select position ofcurrency (in front of value or behind value) and if separatesvalue and currency with space.

Default Reservation CancellationTime

Here you can set how long after reservation has to be depositpaid

Show Prices without Tax and TaxRates

You can choice if the price will displayed with or without taxand also add new tax rates.

Show Total Price Show row with total price in reservation summarty orreservation list.

Show Payment Status Show row with payment status in reservation summary orreservation list.

Show Item Price Show row with item price in reservation summary.

Show Deposit Price Show row with deposit price in reservation summary orreservation list.

Show Price ex. Tax Show row with price excluding tax in reservation summary.

Show Tax Show row with tax value in reservation summary.

Calendars, Week Starts on You can set first week day as Monday or Sunday.

Figure 3.51. First week day is sunday

Enable reservation after x days You can set if you want to enable to book object after x days,hours. Use format 1d, 2h, 50m to enable book after 1 day, 2hours and 50 minutes. If it is set to 7d and today is 6.12., userwill be able to book objects from 13.12.

Show Quick Navigator Calendar has quick navigator realized as drop down list withnum months/weeks/days to future according to used calendar.This option is related to next options "Future months toshow"/"Future weeks to show"/"Future days to show". Forexample if you set 5 months to future in quick navigator is offerquick jump to next five months after current month.


48

Figure 3.52. Display quick navigator

Setting of color 'You can set color of field in calendar, which is reserved(reservation color), which can be booked (vacancy color),which is unavailable (unavailable color) and also PricesboxColor for Reserverd Fields.

Allow Current Day Booking You can allow to book only current day, this is used for dailyreservation type.

Hide Days in which does not BeginFixed Limit

If the daily booking type using fixed limit, which does not starton all days of the week so this option can hide these days.

Label Style for Night Booking Style of nights labels in monthly calendar if night booking isused (e.g. for hotel reservation). You can use Mon/Tue - theyare both days which night cover or Mon - it is day when nightstarts.

Google, Client ID You need it for Gioogle Calendar synchronize. Setupproject with service Calendar API at https://code.google.com/apis.console. This item you find at API Access.

Client secret You need it for Gioogle Calendar synchronize. Setupproject with service Calendar API at https://code.google.com/apis.console. This item you find at API Access.

Default Calendar If calendar list is empty or out of date then go to control panel/google and click button load calendars

Event Summary Select item which you want to use as summary of GoogleCalendar Event. Summary is text in event box in calendar.

Item List Defaults

Show Flag is Featured Show near of item title flag that item is featured

Show Item Thumbnails In objects list display thumbnails of objects main images ifavailable. This option is related to next options Thumbnailwidth and Thumbnail height. You should set one or bothof them. If you set only one then second is automaticallycomputed. If you set both then thumbnail is realized as cutout.

Show introtext If object has introtext then is used in objects list. If set, defineslength to what an introtext will be croped.

Show filter There are used template properties which are set as filterable.


49

Figure 3.53. Filter over the objects list fromfltered template properties

Pagination It's standard pagination bottom filtered list. In option Defaultpagination is available setting of default listing value. Ifswitched on, object list displays pagination with select limitbox. If objects total is less then minimum limit box option, limitbox is not displayed. If switched off, all objects are displayedon one page without pagination.

Show Book it button This button opened object detail page to make reservation.

Show Month Calendar Displays list of small monthly calendars for each object. Startmonth and number of list you can set in next field. Reserveddays are showed in gray. It is quick information for customerwhich days are free. This is related to Month Calendar Style.

First Shown Month Offset Value to shift of first month in calendar from current. If thereis 0, then first is current month. If there is 1, then first monthis next month. For example: now is March and start is 3, thenis first month.

Number of Months Shown Number of months in list from first. For example: now isMarch, calendar start is 2, months number is 3. In calendar willbe May, June and July.

Show Week Calendar Weekly calendar for each object in the list. Engaged days arehighlighted. You can also set number of days should be shown.


50

Item Detail Defaults

Multiple Reservations You can allow to select more than one reservation in calendar.

Show Cart in Popup Popup window will display after clicking on book it buttonwhere customer selects go to checkout or save reservation andcontinue.

Show Capacity Show capacity selector near of book it button if total capacityis higher then 1.

Show Primary Image You can show object main image at detail page. If you canchoice this option, you can also set Primary Image Width andHeight. If it is not set, it will be computed automatically.

Show Image Gallery Display photo gallery with objects images. You can also choicethe position of image gallery, how should photo gallery look,image and thumbnail width, height in pixels (if not, width andheight will be computed automatically)

Show Properties Style Here is an option how to show object properties. You canshow as Table, Icon List, Text List (this is defined in templateparameters)

Show Back Link Display back link to parent object (if exists)

Description Position You can set Below Primary Image or Below Properties.

Prices Layout You can set a style of section with prices, deposit and discounts.The option is: Detailed List, Brief Legeng or there is also achoice to hid it.

SMS/E-mail There you can turn off or set sending emails for manager,customers or for both. Here you can set what email/SMS willbe sent to a customer after reservation, which one will be sentto the manager after customer registration, what will be sent toa customer after reservation, what will be sent to the managerafter customer reservation. You can also inform a customerafter change reservation status. More information you can findin Chapter 14: Sending Emails/SMS.

Customer Fields Fields which customer has to fill during registration or objectsreservation you can set here. You can disable (option hiden)or enable (option optional or required) fields. Is recomendedto set customer e-mail as compulsory if using reservatione-mails. Customers accounts are accessible from componentbackend. Customer can be disabled by blocking his Joomla!user account. In backend you can edit or delete customers.

Registration ARTIO Download ID - Here you have to enter your ID receivedduring purchase our product.

Permission Here is possible to manage the permission settings for the usergroups. Please note, if you change the setting, it will apply tothis and all child group, components and content.


51

3.15. Sending E-mails and SMSComponent can send e-mails and SMS to administrators and customers. Setting of sending e-mailsand SMS is available in global configuration. There you can turn off this service or set if is availableonly for administrators, customers or for both. For sending e-mails and sms, component uses settingfrom Joomla! global configuration.

In component configuration you can set sender e-mail, telephone, sender name, subject for customerand administrator, format of e-mail (HTML or plain text) and e-mail and SMS body. Other settingsas mailer (php mail/smtp/sendmail), username, password, security etc. are used from Joomla! globalconfiguration. In e-mail body you use transcription marks which are replaced by reservation orregistration data. There are data as customer name, reservation date, object name etc.. Specialtranscription mark is pair of marks {OBJECTS} and {/OBJECTS}, which defines part, which willbe repeated for each reserved object. Available transcription marks you can see in component globalconfiguration above the e-mail body field.

Figure 3.54. SMS/Email Templates


52

Figure 3.55. Edit Email and SMS Template

3.15.1. SMS and E-mail NotificationYou can let your customer know about their order status change or send SMS messages on differentevents. Or send single or bulk messages to customers from your customer database. It is very importantto set when the notification has to be send to customer.


53

Figure 3.56. Edit Email/SMS Notification

54

Chapter 4. Usage (frontend)4.1. Booking Customers

Customers are page visitors who can make reservation in Booking component. You can allow pagevisitors reservation without registration or with registration and Joomla! user account to login. Ifvisitor hasn't Joomla! user account, component offers him to create new customer registration withnew Joomla! user account. For logged users component offers to become customer.

Fields which customer has to fill during registration or objects reservation you can set in componentglobal configuration (bookmark Registration/reservation fields). You can disable (option hide) orenable (option show) fields. Enabled fields can be compulsory or optional. Is recomended to setcustomer e-mail as compulsory if using reservation e-mails.

Customers accounts are accessible from component backend. Customer can be disabled by blockinghis Joomla! user account. In backend you can edit or delete customers.

Figure 4.1. The page visitor isn't logged. Component offers him login orregistering.

Usage (frontend)

55

Figure 4.2. The page visitor is logged. Component offers him to becomecustomer.

Usage (frontend)

56

Figure 4.3. Customer registration page. With customer account is also creatednew Joomla! user account.

Usage (frontend)

57

Figure 4.4. Become customer page. To existing Joomla! user account is createdcustomer account.

Figure 4.5. Config registration/reservation fields page.

Usage (frontend)

58

Figure 4.6. The customers backend list

59

Chapter 5. TroubleshootingIf you encounter problems or have questions, check for the answers or post your question at our supportforums at http://www.artio.net/support-forums/book-it.

You can also check FAQ http://www.artio.net/faqs/booking.

???

???

reservations documentation artio booking and veronika

Documents