Description

The dynamic include screen allows you to add a simple collection of events to any calendar in the system. Select the files that you would like to include. The addition of these dynamically included events applies only to the current calendar.

Adding Your Own Dynamic Include Files

You may add your own dynamic include files by adding an ASCII text file with the following format to the folder mentioned at the bottom of the screen (by default it is ./cgi-bin/calweb/cw_addins). The file must have an extension of '.txt'. The next time you access this screen your new files will appear in the list for you to select.

The format of dynamic include files could not be easier. 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]

Each event in all dynamically included files will appear as a read only event on any calendars for which they are selected.

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 can use the calendar as a sort of 'front-end' for other scheduling applications. Note though that there are other ways to accomplish this same task as described on the Ascii Front End help page.

  • 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.

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

  • The Dynamic Include Editor is only part of the Event Manager if you are logged in as an Admin user for this calendar.