EXT: Booking Extension¶

Table of Contents¶

`EXT: Booking Extension 1 <#__RefHeading__5708_1738894311>`_

`Introduction 3 <#__RefHeading__5710_1738894311>`_

What does it do? 3

Screenshots 3

`Users manual 7 <#__RefHeading__467_413120346>`_

`Administration 9 <#__RefHeading__31511_818911409>`_

`Configuration 10 <#__RefHeading__31515_818911409>`_

Reference 10

`Tutorial 12 <#__RefHeading__31523_818911409>`_

`Known problems 13 <#__RefHeading__31525_818911409>`_

`To-Do list 14 <#__RefHeading__477_413120346>`_

`ChangeLog 15 <#__RefHeading__31623_818911409>`_

Introduction¶

Users manual¶

• Just install ab_booking and the optional ab_swiftmailer and date2cal extensions.

• Create a Sysfolder (“ab_booking) and add new records to it. Start with a “ Product Prices ” and then a “ Product Properties ”. Each product requires at least one associated price.

• Create at least one “ Season” (see figure Fehler: Referenz nicht gefunden) and assign it to the prices. You may created seasons with start and stopdates.

• If multiple prices are valid for a day, the price on top will be choosen.

• You may add a special product (“closing times”) with all details set to zero. The price don't care. You can use this “product” to lock the whole booking system for certain dates.

• Create for each product a page in your tree. Add another page, which may be used as short description. Insert the Booking Calendar plugin and select a view (e.g. Calendar) for one or more Product Ids (e.g. “Zimmer 1” and “Schliesszeiten”).

• Important : Select the PID of the Sysfolder (“ab_booking”) as StoragePID in each plugin! Note : You may set the StoragePID by adding it to the General Record Storage Page in your page settings (see “Configuration” below).

• Create an “Booking Page” where people enter their personal data and submit the booking form. On this page you add again the Booking Calendar plugin but with the “BOOKING” view. Go to the Booking-tab and enter your message you will send as email-confirmation to your clients.

  figure 6: Plugin Settings in Flexform

• Up to TYPO3 4.4.x it is possible to use ab_swiftmailer to send theconfirmation mail via the global settings of it. If you don't use it, you have to enter your name and email-address in the Booking- tab.As of TYPO3 4.5.x the swiftmailer is included into TYPO3. I'm using the following settings in my localconf.php:

  $TYPO3_CONF_VARS['MAIL']['transport'] = 'smtp';
  $TYPO3_CONF_VARS['MAIL']['transport_smtp_server'] = 'mail.bytecamp.net:25';
  $TYPO3_CONF_VARS['MAIL']['transport_smtp_encrypt'] = '0';
  $TYPO3_CONF_VARS['MAIL']['transport_smtp_username'] = 'EMAIL_USERNAME';
  $TYPO3_CONF_VARS['MAIL']['transport_smtp_password'] = 'EMAIL_PASSWORD';
  $TYPO3_CONF_VARS['MAIL']['defaultMailFromAddress'] = 'linux@bigga.de';
  $TYPO3_CONF_VARS['MAIL']['defaultMailFromName'] = 'Alexander Bigga';
  

• If you want to use the language overlay feature , don't forget to add the config.sys_lanugage_mode and config_sys_language_overlay settings to your template (see Configuration)

• More details and a HowTo will follow. In the meantime have a look at http://ab_booking.bigga.de where ab_booking is in action. This is a demo site . Feel free to play with the extension!

• If you like the small calendar next to the date field, install date2cal extension. I tested it with current version 7.3.1.

• I hope, you aren't confused totally now.Please mail your question, feature and bug-reports to linux@bigga.de

• ab_booking is on forge now. You may use the bugtracker to report your bugs and feature requests too: http://forge.typo3.org/projects /extension-ab_booking/issues

• Have a look at the backend login at http://ab_booking.bigga.de/login . Username is “abbooking”, password is “demo”. You can't change anything but you can follow the setup easily.

90,D:3:80,D:7:20%

10,D:2:-1

10,D:2:5,D:7:-1

7,D:3:10%,O

3,W:8:2,W:1:1

Administration¶

Configuration¶

• To add a CSS style to the extension you may select “Default CSS ab_booking” as static template file in your template. This default CSS may be overwritten using TypoScript.
• You may enable logging of availability requests after installation of ab_booking in the Extension-Manger -> ab_booking -> Enable features -> enableDebug and DebugLogFile. Please check if the directory of the given path already exists.

plugin.tx_abbooking_pi1.PIDstorage = 15

1

Example:
config.language = de
plugin.tx_abbooking_pi1.dateFormat = %d.%m.%y
[globalVar = GP:L = 1]
config.language = en
plugin.tx_abbooking_pi1.dateFormat = %d/%m/%y
[global]

%d.%m.%Y for config.language = de
%d/%m/%Y for
config.language = en
%Y-%m-%d for all other settings

Example:
plugin.tx_abbooking_pi1.file.cssBooking = fileadmin/templates/cssBookingExample.css

EXT:res/cssBooking.css

plugin.tx_abbooking_pi1 {
  _LOCAL_LANG {
    de {
      we_may_offer = was für eine blöde Überschrift:
        discount = Rabatt
        specialComponent1 = Endreinigungspauschale
    }
    en {
      we_may_offer = what a stupid headline:
   discount = Discount
        specialComponent1 = Room Cleaning
    }
  }
}

config {
  sys_language_mode = content_fallback
  sys_language_overlay = 1
}

Tutorial¶

TBD

Known problems¶

To-Do list¶

• Add support for more “business models” (e.g. weekend prices, )
• Add categories
• Add support for multiple items of the same category
• Evaluate the web accessibility

TYPO3 Forge link to ab_booking project .

ChangeLog¶