You are here

Home » API reference » Availability Calendars 7.4

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

Same filename and directory in other branches
  1. 7.5 README when coming from Availability Calendars.txt
  2. 7.3 README when coming from Availability Calendars.txt
/**
 * Special README for users coming form Availability Calendars module.
 *
 * This file describes the changes between the already existing Availability
   Calendars and this new fields based Availability Calendar module.
 */

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 receives 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 changes between the already existing Availability

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

  6.  */

  7. 

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

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

  10. Calendars module.

  11. 

  12. 

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

  14. --------------------------------------------------------

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

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

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

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

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

  20. upgrading.

  21. 

  22. 

  23. Compatibility with version 2 of Availability Calendars

  24. ------------------------------------------------------

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

  26. an overview of what happened with all settings:

  27. 

  28. 

  29. Old                                    With fields

  30. --------------------------------------------------------------------------------------------------

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

  32. 

  33. System wide and per node settings:

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

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

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

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

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

  39.                                        between other fields.

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

  41.                                        the interactive calendar. Different widgets and formatters

  42.                                        can be added on request.

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

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

  45.                                        month editing has been removed.

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

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

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

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

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

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

  52.                                        influences display, not storage.

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

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

  55. 

  56. States

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

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

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

  60. 

  61. Styling

  62.  * Basic styling on admin page         Basic styling on admin page.

  63. 

  64. 

  65. New settings

  66. ------------

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

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

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

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

  71. 

  72. 

  73. New render options

  74. ------------------

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

  76.    months to scroll).

  77. 

  78. 

  79. New features

  80. ------------

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

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