Dynamic include files allows you to add simple collections of read only events to any calendar in the system. Select the files that you would like to include from the list. The addition of these dynamically included events applies only to the current calendar unless you check 'apply to all calendars'.

Adding your own dynamic include files

You may add your own dynamic include files by placing a text file with the following format in the dynamic include folder (./cgi-bin/calweb/cw_addins by default). The file must have an extension of '.txt'. This dialog lists all files found in the above folder with a .txt file extension. For this reason simply adding the .txt file includes the file in this list. For example you may wish to add a file called 'Company Holidays.txt'.

The format of dynamic include files could not be more simple. Each row (except those that start with ';' which are comments) should contain two (or optionally three) semicolon separated fields, thus:

    Subject;MM/DD/YYYY;HH:MM[ap]

The date and time format of dynamically included files is the same regardless of the settings on the date settings page. In other words, the date is always expected to be MM/DD/YYYY and time is always HH/MM followed by 'a' for AM and 'p' for PM.

Dynamically generating dynamic include files

Notice that if you have some sort of process that automatically generates these files into the correct folder (for example if some other part of your website keeps track of people's vacations) you might use the calendar as a sort of 'front-end' for these other applications.

Because dynamically included files must be parsed while the calendar is being built (as opposed to regular events which are stored in the event database) you may see performance degradation if you include a very large number of dynamically included events (more than a couple of hundred) in these files.