This section explains how you can configure any of the following options which cannot be changed by any simple configuration form and involve some sort of manual involvement between the person doing the configuring and either the operating system and/or individual configuration files. However, don't let that scare you from taking advantage of these absolutely cool features! :
* The configuration form (which is used to configure every calendar)
is the only program which does not have a separate language module.
It can still be translated into a foreign language, but only by modifying
the original code, and not a separate language module.
Changing calendar text verbiage- The file "calendar_master_text.txt" is the main verbiage template
that all subsequently created calendar text modules are generated from.
To change the text for the calendar and have it take effect
on subsequent calendars (such as the weekday names, error messages presented, etc),
this is the file to modify.
When a new calendar is created, a new textual module is generated, which is
created from the "calendar_master_text.txt" template.
Any subsequent modules follow the naming scheme:
<calendarabbreviation>_calendar_text.txt
where the part <calendarabbreviation> is the short abbreviation
chosen when the calendar was created.
For example, if the abbreviation chosen is "vacation", then the text module
that's generated will be called:
vacation_calendar_text.txt
These text modules can be modified with any simple text editor such as
"Notepad" on Windows or "VI" on Unix.
Note that you must follow file's format -- as a hint I strongly suggest you
just modify the text between quotes.
HTML tags can be used when modifying the verbiage, but only where noted within the file.
Important note! : If the months are renamed for whatever reason, then
monthly graphics will have to be renamed as well! The calendar loads the month
graphics based on the name stored in this module.
For example, if "December" is changed to "Dec", then file "December.gif" needs to be
changed to to "Dec.gif"!
Translating into other languages- If all the calendars are to be in a language other than English, then translate
the calendar into the required language by translating the text in the file "calendar_master_text.txt".
Creating any new calendars will automatically take on the new language.
Important note! : If the months are renamed for whatever reason, then
monthly graphics will have to be renamed as well! The calendar loads the month
graphics based on the name stored in this module.
For example, if "December" is changed to "Dec", then file "December.gif" needs to be
changed to to "Dec.gif"!
Running multiple calendars in multiple languages- To run multiple calendars in multiple languages,
translate the separate language file for each calendar.
Then there will be multiple calendars in multiple languages,
all running from the same source code.
Using your own set of monthly images- To use custom monthly graphics:
- create a directory where the monthly graphics will be kept
- copy the monthly graphics into this new directory
- make sure to also have a "prev_month.gif" and "next_month.gif" graphic in this directory!
- edit the option URL to this Calendar's Months Graphics to point to the custom images
- DO NOT change the url for "images directory"!
Add your own icons, edit those listed, or delete those currently used- The calendar uses the icons specified in the
Full Operating System Path to this Calendar's Icons. To:
- add custom icons, just copy the icon(s) into this directory
- edit the icons, just edit the particular icon image file within this directory
- delete an icon, just delete the icon image from the directory
If a new directory is chosen for the custom icons,
make sure to change BOTH the
Full Operating System Path to this Calendar's Icons
AND the
URL to this Calendar's Icons
configuration items!
Editing the colors to the color selection menus on the configuration forms- To change the color names or codes from the menus on the configuration forms,
modify the following file depending on the language:
- ASP:
calendar_config_common.asp
- PHP:
calendar_config_common.php
- Perl:
calendar_config_common.pl
To add in a new color, follow these steps:
- open the file in a text editor
- select a line which already has a color defined
- copy and paste the entire line just below another line
- edit the name and hex values as appropriate
To delete a color, just delete the entire line from the file.
Editing the fonts listed in the font selection menus on the configuration forms- To use other fonts with your calendar:
- open the file:
- ASP:
calendar_config_common.asp
- PHP:
calendar_config_common.php
- Perl:
calendar_config_common.pl
in a text editor
- look for the listing of fonts at the top of the file
- following the pattern, add in the name of the new font
- save the file
To remove a font, simply delete it from the listing.
Reload the configuration form.
Note that text in any of these fonts will only be displayed if the end user has the font on their system!
If the font is not on the end user's system, their browser will use a substitute font!
|
