.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ============== 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: EXT: rentalmgr ============== Extension Key: rentalmgr Copyright 2014 Joachim Ruhs, 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: 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: Introduction ------------ Rentalmgr is an extension to manage FE user rentals for all kind of objects on a daily base. .. _What-does-it-do: 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). .. _Sponsored-by: Sponsored by ^^^^^^^^^^^^ Sponsoring the extension accelerates the development of new features for the extension and is highly welcome. .. _Screenshots: 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: 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| 4. 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: 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. .. ### BEGIN~OF~TABLE ### .. _Objectname: **Objectname** ^^^^^^^^^^^^^^ .. container:: table-row a **Objectname** b **dependency1** c **dependency2** .. _Demomaterial: Demomaterial ^^^^^^^^^^^^ .. container:: table-row a Demomaterial b Holder simple c .. _Holder-simple-1: Holder simple 1 ^^^^^^^^^^^^^^^ .. container:: table-row a Holder simple 1 b c .. ###### END~OF~TABLE ###### 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: Reference --------- Options in the template setup: If this options are set in the template setup, they overrule the flexform-settings. *plugin.tx\_rentalmgr\_pi1* : .. ### BEGIN~OF~TABLE ### .. _templateFile: templateFile ^^^^^^^^^^^^ .. container:: table-row Property templateFile Data type string Description The template ile Default typo3conf/extrentalmgr/pi1/template.html .. _cssFile: cssFile ^^^^^^^ .. container:: table-row Property cssFile Data type striing Description The css file Default typo3conf/ext/rentalmgr/pi1/layout.css .. _Unknown-Property: ((Unknown Property)) ^^^^^^^^^^^^^^^^^^^^ .. container:: table-row Property Data type Description Default .. _bookingView-image-file: bookingView.image.file ^^^^^^^^^^^^^^^^^^^^^^ .. container:: table-row Property bookingView.image.file Data type string Description cImage object Example: plugin.tx\_rentalmgr\_pi1.bookingView.image.file.maxW = 50 Default .. _singleView-image-fiile: singleView.image.fiile ^^^^^^^^^^^^^^^^^^^^^^ .. container:: table-row Property singleView.image.fiile Data type string Description cImage object Example: plugin.tx\_rentalmgr\_pi1.singleView.image.file.maxW = 250 Default .. _categories: categories ^^^^^^^^^^ .. container:: table-row 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 .. ###### END~OF~TABLE ###### .. _Appendix: Appendix -------- .. _Known-problems: Known problems ^^^^^^^^^^^^^^ - None so far. - if you catch bugs, please report them to postmaster@joachim-ruhs.de .. _To-Do: To-Do ^^^^^ any wishes, tell me .. _FAQ: FAQ --- - - ... .. _Changelog: Changelog --------- - - 2014-03-18, initial version |img-10| EXT: rentalmgr - 7 .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. :border: 0 .. :height: 496 .. :id: Grafik1 .. :name: Grafik1 .. :width: 423 .. |img-2| image:: img-2.png .. :align: left .. :border: 0 .. :height: 179 .. :id: Grafik2 .. :name: Grafik2 .. :width: 669 .. |img-3| image:: img-3.png .. :align: left .. :border: 0 .. :height: 316 .. :id: Grafik4 .. :name: Grafik4 .. :width: 445 .. |img-4| image:: img-4.png .. :align: left .. :border: 0 .. :height: 91 .. :id: Grafik5 .. :name: Grafik5 .. :width: 368 .. |img-5| image:: img-5.png .. :align: left .. :border: 0 .. :height: 89 .. :id: Grafik6 .. :name: Grafik6 .. :width: 265 .. |img-6| image:: img-6.png .. :align: left .. :border: 0 .. :height: 453 .. :id: Grafik7 .. :name: Grafik7 .. :width: 362 .. |img-7| image:: img-7.png .. :align: left .. :border: 0 .. :height: 139 .. :id: Grafik8 .. :name: Grafik8 .. :width: 141 .. |img-8| image:: img-8.png .. :align: left .. :border: 0 .. :height: 235 .. :id: Grafik9 .. :name: Grafik9 .. :width: 519 .. |img-9| image:: img-9.png .. :align: left .. :border: 0 .. :height: 450 .. :id: Grafik3 .. :name: Grafik3 .. :width: 411 .. |img-10| image:: img-10.png .. :align: left .. :border: 0 .. :height: 32 .. :id: Graphic1 .. :name: Graphic1 .. :width: 102