DEPRECATION WARNING

This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.

EXT: rentalmgr

Created:2012-07-19T10:29:03
Changed:2014-04-13T14:01:53
Author:Joachim Ruhs
Email:postmaster@joachim-ruhs.de
Info 3:
Info 4:

EXT: rentalmgr

Extension Key: rentalmgr

Copyright 2014 Joachim Ruhs, <postmaster@joachim-ruhs.de>

This document is published under the Open Content License

available from http://www.opencontent.org/opl.shtml

The content of this document is related to TYPO3

- a GNU/GPL CMS/Framework available from www.typo3.com

Table of Contents

EXT: rentalmgr 1

Introduction 1

What does it do? 1

Sponsored by 1

Screenshots 2

Installation 4

Dependencies 6

Reference 6

Appendix 6

Known problems 6

To-Do 6

FAQ 7

Changelog 7

Introduction

Rentalmgr is an extension to manage FE user rentals for all kind of objects on a daily base.

What does it do?

The extension shows a booking calendar for daily booking objects. FE users can rent objects by test the availability check for a desired date period, put the objects into the basket and then execute the booking. The extension provides a booking list view, where the FE user can delete bookings which are completely in the future. Every time a booking is changed emails were generated and send to the FE user and the admins.

The extensions provides a monthly overview where the begin of the rental period is marked bold. In the calendar view he start of the rental is marked bold too. The rental objects can have up to 4 dependencies and up to 6 images which are shown in the singleView (details).

Screenshots

Calender view of booked objects

img-1

Monthly booking overview

In this view you can see, that the date of booking start is marked bold.

img-2

Availability form

img-3

Availability result

img-4

Basket view

img-5

Bookings view of the frontend user which can be deleted

img-6

Installation

Install the extension just like any other extension from the TYPO3 extension repository.

Create some new pages which are shown in the image to hold the plugin and the booking data. If you have a lot of rental objects it may be useful to create these page structure more than once and limit the shown categories with Typoscript see -> reference (plugin.categories = 1,2).

img-7

In page rentalmgr insert the plugin with display mode “month multirow view”. Set the details page ID to page details (general options).

In this page and all the other pages were the plugin is inserted set the Record storage page to the folder Data.

img-8

  1. In the other pages insert the plugin with the correct display mode

Monthly -> Monthly Overview

Availability -> Availability Check View (access only for FE users)

Basket -> Basket View (access only for FE users)

Bookings -> Bookings View (access only for FE users)

Details -> Single View

In page Basket and Bookings make sure that you have inserted Admin email addresses in the plugin

(otherwise no mails were send to the admins!)

In page Availability insert in the plugin the basket page id (General options).

If everything is done, go the the List modul and the page Data and insert some rentalmgr_categories and some rentalmgr_objects.

img-9

Dependencies

Every object for rental can have up to 4 dependencies. For example the object has dependency1 “Holder simple”. Then when availability check is done for the object a dependency check is done for objects named “Holder simple nn” where nn is a number. If one or more dependencies are available the availability check is successful. If the dependency check failed the whole availability check failed and the booking of the object is not possible.

It is recommended to give the dependency-objects an own category (for example addons) and disable the addons category in the calender and monthly views.

Objectname

a

Objectname

b

dependency1

c

dependency2

Demomaterial

a

Demomaterial

b

Holder simple

c

Holder simple 1

a

Holder simple 1

b

c

The dependency1 can have up to 4 dependencies of the same kind. For this, use the dependency1 max item field or the dependency1 min Item field. Min items > 1 are shown as disabled checked checkboxes.

Reference

Options in the template setup:

If this options are set in the template setup, they overrule the flexform-settings.

plugin.tx_rentalmgr_pi1 :

templateFile

Property

templateFile

Data type

string

Description

The template ile

Default

typo3conf/extrentalmgr/pi1/template.html

cssFile

Property

cssFile

Data type

striing

Description

The css file

Default

typo3conf/ext/rentalmgr/pi1/layout.css

((Unknown Property))

Property

Data type

Description

Default

bookingView.image.file

Property

bookingView.image.file

Data type

string

Description

cImage object

Example: plugin.tx_rentalmgr_pi1.bookingView.image.file.maxW = 50

Default

singleView.image.fiile

Property

singleView.image.fiile

Data type

string

Description

cImage object

Example: plugin.tx_rentalmgr_pi1.singleView.image.file.maxW = 250

Default

categories

Property

categories

Data type

string

Description

List of category uids to limit the shown objects to this categories

Example: plugin.tx_rentalmgr_pi1.categories = 1,2

Default

Appendix

Known problems

To-Do

any wishes, tell me

FAQ

  • ...

Changelog

  • 2014-03-18, initial version

img-10 EXT: rentalmgr - 7