phpEventCalendar :: Customization
Changing the Display Language
The language option in the "config.php" file allows you to change the calendar's display language. To change the language you need two translated language files in the distribution's lang directory. Many language files are included with the script, and those that users have contributed since the last release are available on the downloads page. For each of these files, the two characters before the ".php" extension represent the language the files have been translated into. This language code is the value you need to enter for the language option in the "config.php" file. The calendar should appear correctly once the two language files are in place, and the language option is set in the config.php file.
Modules
Modules are pieces of code written by others and offered as additions to the calendar. I will try to make modules available when I can, but I will not edit them much, and so keep in mind that they are coming from a variety of authors. I included one module in the version 0.2 release. The module displays all future events in one list. This module, like all future modules, is accomplanied by a readme file that explains how it works. Thank you to Dominik Zumstein <nick@olp.ch> for this code.
Limiting Event Entries
There are two options in the "config.php" file that can be used to limit the content that appears on the calendar. These options are designed to keep entries from distorting the intended size of the month-at-a-glance calendar. The titlelimit, allows you to limit the numer of entry titles that appear on the calendar, and the titlecharlimit, allows you to limit the maximum number of characters that will display for any given title. Neither option limits the number of characters that can be input and stored, and neither option limits what is displayed when users click to view individual events.
Editing Colors and Overall Size
All the text and table cell attributes can be customized by editing the "default.css" file in the css subfolder. The file contains comments explaining what each css class controls. All text formatting and color customization of the calendar should be possible by editing this file, which contains comments that explain what elements of the calendar each css class controls.
What is least obvious is that you can adjust the overall size of the calendar through the css file. You will notice that each of these three cell classes (day_cell, empty_day_cell, today_cell) has a height and width attribute. You should make sure that all three classes have the same height value, and the same width value. The height value will determine the height in pixels of the each of the calendar's rows - after the row that contains the week names. The width value controls the width of each column, and the overall width of the column, which is (n * 7 + 8).
Editing the Template File
The template file allows you to add a header and footer to the calendar. This file is located under the templates folder, and is called "default.php" initially. You can add whatever html you need to this file to make the calendar work with your site, however there are a couple of things you should observe. First, the calendar relies on a number of javascript functions that are included in the page with the line "<? javaScript() ?>" in the header. Do not delete this line. Second, there is one table in the template. This table pieces together the components of the table. You can change the position of these components, but do not remove any of them. If you only want to embed the calendar in your page without changing the order in which these components appear, then embed the unaltered table, with all its contents, in your html.