You are here

Home » API reference » Availability Calendars 7.3

README when coming from Availability Calendars.txt in Availability Calendars 7.3

Same filename and directory in other branches
  1. 7.5 README when coming from Availability Calendars.txt
  2. 7.4 README when coming from Availability Calendars.txt
/**
 * Special README for users coming form Availability Calendars module.
 *
 * This file describes the cahnges between the already existing Availability
   Calendars and this new fields based Availability Calendar module.
 * @author Erwin Derksen (http://drupal.org/user/750928)
 */

The availability calendar module defines an availability calendar field. It is
a complete fields-based rewrite of version 7.x-2.x of the Availability
Calendars module.


Upgrading from Availability Calendars 7.x-2.x or earlier
--------------------------------------------------------
To Drupal this is a different module from the already existing Availability
Calendars module. This makes upgrading via update.php a bit tricky. Therefore, a
separate update module has been created. This module can be found in the latest
7.x-2.x package. So install that version as well. The Availability Calendars
update module contains an UPGRADE.txt with more detailed information about
upgrading.


Compatibility with version 2 of Availability Calendars
------------------------------------------------------
A lot of settings has been changed, moved, removed or added. Below you can find
an overview of what happened with all settings:


Old                                    With fields
--------------------------------------------------------------------------------------------------
Enable for content types               Add an availability calendar field to the content type.

System wide and per node settings:
 * Show automatically on node page     Define on Manage display page of a content type.
 * Allow to override per node          Obsolete, we now have field and field instance setting.
 * Show calendars in teasers           Define on Manage display page of a content type.
 * Show a key for the calendars        Available as a block. Use the block reference module
                                       (http://drupal.org/project/blockreference) to put it in
                                       between other fields.
 * Show an edit link per month         Removed. For now, the only way of editing an a calendar is
                                       the interactive calendar. Different widgets and formatters
                                       can be added on request.
 * Edit calendar on its own tab/page   Removed for now.
 * Show a note before each week        Removed for now. Not sure about the UI for this as the per
                                       month editing has been removed.
 * Show only the first letter ...      Can be set separately in "Manage display" (show calendar)
                                       and "Manage fields" (edit calendar).
 * Do not show dates in the past       Removed, defaults to not showing states in the past.
 * Allow split day statuses            Renamed to "show split state", can be set separately in
                                       "Manage display" (show calendar) and "Manage fields" (edit
                                       calendar). This setting has become a setting that only
                                       influences display, not storage.
 * Number of months to display         "Manage display", thus per view mode (teaser, full, ...).
 * Number of months for editors        "Manage fields".

States
 * 1 set of states on admin page       1 global set of states on admin page, with the option to
                                       define a subset of allowed states per field instance.
 * 1 default state on admin page       Default state per field instance.

Styling
 * Basic styling on admin page         Basic styling on admin page.
                                       

New settings
------------
 * Show week number before each week  Can be set separately in "Manage display" (show calendar)
                                      and "Manage fields" (edit calendar).
 * Enable/disable calendar            Per node, as part of the field value. However at instance
                                      setting level you can disable the disabling per node.


New render options
------------------
 * viewport (with settings for horizontal and vertical number of months, and
   months to scroll).


New features
------------
 * Show a booking formlet on the (node/entity) page that reveives the arrival
   and departure dates that can subsequently be posted to a webform.

File

README when coming from Availability Calendars.txt
View source 
  1. /**

  2.  * Special README for users coming form Availability Calendars module.

  3.  *

  4.  * This file describes the cahnges between the already existing Availability

  5.    Calendars and this new fields based Availability Calendar module.

  6.  * @author Erwin Derksen (http://drupal.org/user/750928)

  7.  */

  8. 

  9. The availability calendar module defines an availability calendar field. It is

  10. a complete fields-based rewrite of version 7.x-2.x of the Availability

  11. Calendars module.

  12. 

  13. 

  14. Upgrading from Availability Calendars 7.x-2.x or earlier

  15. --------------------------------------------------------

  16. To Drupal this is a different module from the already existing Availability

  17. Calendars module. This makes upgrading via update.php a bit tricky. Therefore, a

  18. separate update module has been created. This module can be found in the latest

  19. 7.x-2.x package. So install that version as well. The Availability Calendars

  20. update module contains an UPGRADE.txt with more detailed information about

  21. upgrading.

  22. 

  23. 

  24. Compatibility with version 2 of Availability Calendars

  25. ------------------------------------------------------

  26. A lot of settings has been changed, moved, removed or added. Below you can find

  27. an overview of what happened with all settings:

  28. 

  29. 

  30. Old                                    With fields

  31. --------------------------------------------------------------------------------------------------

  32. Enable for content types               Add an availability calendar field to the content type.

  33. 

  34. System wide and per node settings:

  35.  * Show automatically on node page     Define on Manage display page of a content type.

  36.  * Allow to override per node          Obsolete, we now have field and field instance setting.

  37.  * Show calendars in teasers           Define on Manage display page of a content type.

  38.  * Show a key for the calendars        Available as a block. Use the block reference module

  39.                                        (http://drupal.org/project/blockreference) to put it in

  40.                                        between other fields.

  41.  * Show an edit link per month         Removed. For now, the only way of editing an a calendar is

  42.                                        the interactive calendar. Different widgets and formatters

  43.                                        can be added on request.

  44.  * Edit calendar on its own tab/page   Removed for now.

  45.  * Show a note before each week        Removed for now. Not sure about the UI for this as the per

  46.                                        month editing has been removed.

  47.  * Show only the first letter ...      Can be set separately in "Manage display" (show calendar)

  48.                                        and "Manage fields" (edit calendar).

  49.  * Do not show dates in the past       Removed, defaults to not showing states in the past.

  50.  * Allow split day statuses            Renamed to "show split state", can be set separately in

  51.                                        "Manage display" (show calendar) and "Manage fields" (edit

  52.                                        calendar). This setting has become a setting that only

  53.                                        influences display, not storage.

  54.  * Number of months to display         "Manage display", thus per view mode (teaser, full, ...).

  55.  * Number of months for editors        "Manage fields".

  56. 

  57. States

  58.  * 1 set of states on admin page       1 global set of states on admin page, with the option to

  59.                                        define a subset of allowed states per field instance.

  60.  * 1 default state on admin page       Default state per field instance.

  61. 

  62. Styling

  63.  * Basic styling on admin page         Basic styling on admin page.

  64.                                        

  65. 

  66. New settings

  67. ------------

  68.  * Show week number before each week  Can be set separately in "Manage display" (show calendar)

  69.                                       and "Manage fields" (edit calendar).

  70.  * Enable/disable calendar            Per node, as part of the field value. However at instance

  71.                                       setting level you can disable the disabling per node.

  72. 

  73. 

  74. New render options

  75. ------------------

  76.  * viewport (with settings for horizontal and vertical number of months, and

  77.    months to scroll).

  78. 

  79. 

  80. New features

  81. ------------

  82.  * Show a booking formlet on the (node/entity) page that reveives the arrival

  83.    and departure dates that can subsequently be posted to a webform.

  84.