What's new in Calendar 2.x for Drupal 6

Note! Views2 API Changes! The latest D6 -dev version uses the new Views2 API and requires the latest -dev version of Date, Calendar, CCK, and Views to work right. The changes involve some re-organization of files and folders, so empty the date folder out before adding in the updated files.

What's new in Calendar 2.x for Drupal 6

Calendar 2.x for Drupal 6 entailed a complete rewrite in order work with Views 2. There are a lot of changes from earlier versions, so I strongly suggest you start with the default calendar view provided and add and edit it to get the results you want.

1. Create a new calendar by enabling the default calendar view and changing it to use whatever date you want in your calendar. You can create multiple calendars by cloning the default calendar view as many times as necessary.
2. The Date argument has an option to select one or more Views date fields to filter on, automatically adds them to the view, and then filters the view by the value of the selected field(s). This argument can be used on any view, not just calendar views.
3. Unlike previous versions of the Calendar module, there is just a single argument instead of year, month, and day arguments. The argument value will be YYYY-MM-DD for a day, YYYY-MM for a month, YYYY for a year, and YYYY-W99 for a week. There is a default option to set the argument to the current date when the argument is empty
4. A calendar display creates calendar navigation and links to multiple displays for the year, month, day, or week views. The actual displays are created by attaching calendar views that use whatever styles are desired for those pages
5. Calendar views are attachments (note 1) to create the year, month, day, and week displays. They can be set to use any style, either a calendar style or any other Views style, like teasers or lists. They can each have their own fields and formatting. They must be attached to the main calendar page or to a calendar block
6. If you don't want to have a link to a week display, just remove the week display from the view. Ditto for any other displays you don't want to use. The links will automatically disappear for any displays that are not defined in the view
7. A calendar block will create a calendar block for the view results. This block requires the calendar argument to do its work, and uses one of the year, month, day, or week calendar view attachments created above.
8. Some versions of Calendar did not require that you add the date field to the 'Fields' section of the view, but that caused some problems. Calendar 2.2 REQUIRES your date field to be added to the 'Fields' section of the view. If you do not want to date field to display, you can check the 'Exclude from display' setting of your field. If this is not done, an error message will be displayed.
9. There are templates for the top of the calendar (the links and navigation), the year, month, day, and week displays, and the individual month, week, and day nodes, so you can easily style them.

Note 1: Attachments, Views 2 lets you combine a number of 'displays' together in one view, including, potentially, more than one page display. Each page display can be a regular page display, with its own url, or an 'attachment' to another display. Attachments are basically one or more views that all appear at the same url of the page they are attached to, one after the other. So the calendar now creates one display that creates the back/next navigation, and attaches to it a year, month, week, or day display with the calendar for the right period.