Active Calendar Class Documentation

Active Calendar Class v1.0.5 Documentation

The source code included in this package is free. You can modify or pass it on under the conditions of the GNU Lesser General Public License, published by the Free Software Foundation.

I would appreciate any comments or suggestions. Please visit the Active Calendar Website to get the latest version of this library or to contact me.

Contents

About this Class

How to use the Class

Class Methods
Code Examples
Calendar layout

Quick installation

About Active Calendar Class

Active Calendar is PHP Class, that generates calendars (month or year view) as a HTML Table (XHTML-Valid).

can be static (without any links)
can optionally have navigation controls
can optionally have a date picker control
can optionally have linkable days (url or javascript)
can optionally have 'event days' with 'event links' and own layout
can optionally have 'event content' with 'links' and own layout
support different GMT zones for the current date calculation
support month and day names, depending on your language
can be configured using CSS
do not require Javascript to be displayed or navigated (server side generation)
can be generated with just 2-3 lines of code

Active Calendar is based on the PHP native date functions (default) and supports optionally the ADOdb Date Library.

Using PHP native date functions: 1902 - 2037 (UNIX) and 1971 - 2037 (Windows)
Using ADOdb Date Library: 100 - 3000 and later [ limited by the computation time of adodb_mktime() ] on both UNIX and Windows. To use the ADOdb Date Library just include it in your scripts. The Active Calendar class will use the library functions automatically.

How to use the Active Calendar Class

Class methods overview:

$cal = new activeCalendar([$year,$month,$day,$gmt_zone]);

Create first a new object of the class. The parameters $year, $month and $day are optional. If these parameters are not set, the current year, month and day will be passed to the program. The parameter $year should have the form "yyyy" e.g "2005" or "1996", the parameter $month should have the form "m" e.g "1" for January or "10" for October and the parameter $day should have the form "d" e.g "4" for the 4th month day or "24" for the 24th month day. So for the date e.g 7th January 2005 please set $cal = new activeCalendar("2005","1","7"). The parameter $gmt_zone is optional as well. Use this parameter to set the GMT (Greenwich Mean Time) zone for the current date calculation (e.g 9 for Osaka Japan, 2 for Athens Greece, - 5 for New York USA). If $gmt_zone is not set, the server local time will be used.

$cal->enableMonthNav([$link,$arrowBack,$arrowForw]);

Call this method, if you want the generated calendar to have month navigation controls (e.g "previous month" and "next month"). The parameter $link is optional. You can use this parameter to set the url for the calendar links (e.g "mycalendar.php" or "mycalendar.php?mode=4&item=test", if you need more complex urls). You should modify the private method mkUrl(), if you want to change the general structure of the generated links. The parameters $arrowBack and $arrowForw are optional as well: they set other month navigation controls, than the ones set in the configuration (an image link can be set too).

$cal->enableYearNav([$link,$arrowBack,$arrowForw]);

Call this method, if you want the generated calendar to have year navigation controls (e.g "previous year" and "next year"). The parameter $link is optional. You can use this parameter to set the url for the calendar links (e.g "mycalendar.php" or "mycalendar.php?mode=4&item=test", if you need more complex urls). You should modify the private method mkUrl(), if you want to change the general structure of the generated links. The parameters $arrowBack and $arrowForw are optional as well: they set other year navigation controls, than the ones set in the configuration (an image link can be set too).

$cal->enableDatePicker([$startYear,$endYear,$link,$button]);

Call this method, if you want the generated month calendar to have a date picker control. The parameters $startYear and $endYear define the range of the years, that can be selected (e.g $startYear=2000, $endYear=2010). This range is limited by the private class variables $startYear and $endYear. Please modify them according to your configuration. The parameter $link is optional. You can use this parameter to set the url for the calendar links (e.g "mycalendar.php" or "mycalendar.php?mode=4&item=test", if you need more complex urls). You should modify the private method mkUrl(), if you want to change the general structure of the generated links. The parameter $button is optional as well: it sets some other value for the date picker submit button, than the one set in the configuration.

$cal->enableDayLinks([$link,$javaScript]);

Call this method, if you want the generated calendar to have linkable dates. The parameter $link is optional. You can use this parameter to set the url for the calendar links (e.g "mycalendar.php" or "mycalendar.php?mode=4&item=test", if you need more complex urls). You should modify the private method mkUrl(), if you want to change the general structure of the generated links. The parameter $javaScript is optional as well. You can use this parameter to set a JavaScript function instead of an url for the calendar links. So if you set $cal->enableDayLinks(false,"selectDate"), this link will be created on e.g 27 May 2007: ..href="javascript:selectDate(2007,5,27)".. The content of the Javascript function 'selectDate' will not be created by the class. You should develop it according to your needs.

$cal->setMonthNames($monthNamesArray);

Call this method, if you want the class generate different names for the calendar months, than the ones set in the configuration. The parameter $monthNamesArray must be an array of 12 month names starting with January.

$cal->setDayNames($dayNamesArray);

Call this method, if you want the class generate different names for the calendar weekdays, than the ones set in the configuration. The parameter $dayNamesArray must be an array of 7 day names starting with Sunday.

$cal->setEvent($year,$month,$day,[$id,$eventUrl]);

Call this method, if you want the class to create an HTML td class=$id on the date specified by the parameters $year, $month, $day. You can configure every 'event date' in your CSS, so that it would have e.g a different background color. The parameter $id is optional. If you do not set an $id, a default HTML class='event' will be generated. The parameter $eventUrl is optional as well: If you set an $eventUrl, an event specific link (..href='$eventUrl'..) will be generated on the 'event date', even if the method $cal->enableDayLinks($link) was not called.

$cal->setEventContent($year,$month,$day,$content,[$contentUrl,$id]);

Call this method, if you want the class to create a new HTML table within the date specified by the parameters $year, $month, $day. The parameter $content can be a string or an array. If $content is a string, then the new generated table will contain one row with the value of $content. If it is an array, the generated table will contain as many rows as the array length and each row will contain the value of each array item. The parameter $contentUrl is optional: If you set a $contentUrl, an event content specific link (..href='$contentUrl'..) will be generated in the 'event content' table row(s), even if the method $cal->enableDayLinks($link) was not called. The parameter $id is optional as well: if you set an $id, a HTML class='$id' will be generated for each event content (default: 'eventcontent').

$cal->showMonth([$showNoMonthDays]);

This method will generate the html string of the month calendar. You can display the calendar by "print $cal->showMonth()". This method calls several private class functions, that create each tr tag of the generated table. So if you would like to change the table structure, you could simply modifiy the order, that these private functions are called (mkMonthHead() must remain first and mkMonthFoot() must remain last though). The parameter $showNoMonthDays is optional: if it is set true, days that do not belong to the current month will be displayed in the calendar (default: false). Please note that these days will not contain any events or event contents!.

$cal->showYear([$columns]);

This method will generate the html string of the year calendar. You can display the calendar by "print $cal->showYear()". This method calls several private class functions, that create each tr tag of the generated table. So if you would like to change the table structure, you could simply modify the order, that these private functions are called (mkYearHead() must remain first and mkYearFoot() must remain last though). The parameter $columns is optional: it sets the number of the generated months in each row of the year calendar (default: 4).

Code Examples:

<?php
require_once("activecalendar.php");
$cal = new activeCalendar();
echo $cal->showMonth();
?>

<?php
require_once("activecalendar.php");
$myurl=$_SERVER['PHP_SELF']; // the links url is this page
$yearID=false; // init false to display current year
$monthID=false; // init false to display current month
$dayID=false; // init false to display current day
extract($_GET); // get the new values (if any) of $yearID,$monthID,$dayID
$cal = new activeCalendar($yearID,$monthID,$dayID);
$cal->enableMonthNav($myurl);
echo $cal->showMonth();
?>

<?php
require_once("activecalendar.php");
$myurl=$_SERVER['PHP_SELF']; // the links url is this page
$cal = new activeCalendar("2007","11");
$cal->enableDayLinks($myurl);
echo $cal->showMonth();
?>

<?php
require_once("activecalendar.php");
$cal = new activeCalendar("2007","11");
$cal->setEvent("2007","11","17","meeting"); //it will create a class="meeting"
$cal->setEvent("2007","11","7","birthday"); //it will create a class="birthday"
//The following will create a class="myevent" and an <a href="myevent.html">
$cal->setEvent("2007","11","20","myevent","myevent.html");
echo $cal->showMonth();
?>

<?php
require_once("activecalendar.php");
$cal = new activeCalendar();
echo $cal->showYear(2); // 2 months in each row
?>

<?php
require_once("activecalendar.php");
$myurl=$_SERVER['PHP_SELF']; // the links url is this page
$cal = new activeCalendar("2007");
$cal->enableDayLinks($myurl);
echo $cal->showYear();
?>

<?php
require_once("activecalendar.php");
$cal = new activeCalendar("2007");
$cal->setEvent("2007","1","24","meeting");
$cal->setEvent("2007","5","12","birthday");
$cal->setEvent("2007","6","24","event");
$cal->setEvent("2007","6","25");
echo $cal->showYear();
?>

<?php
require_once("activecalendar.php");
$cal = new activeCalendar("2007");
$cal->setEventContent("2007","1","24","meeting");
$cal->setEventContent("2007","5","12","birthday");
$cal->setEventContent("2007","6","24","Google","http://www.google.com");
$multipleLinesEvent=array("Title: News","Time: 16.00","Status: ok"); $cal->setEventContent("2007","6","25",$multipleLinesEvent);
echo $cal->showYear();
?>

Calendar layout:

The layout of the generated calendar can be configured with CSS. The Active Calendar Class returns html tags with various classes, which can be used for the layout configuration. Please check the following sample css (that uses the default configuration):

.year {border-style: outset; border-width: 1px; background-color: #cbeaca; text-align: center;}
.month {border-style: none; background-color: #cbeaca; text-align: center;}
.yearname {text-align: center; font-size: 20px; font-weight: bold;}
.monthname {text-align: center; font-size: 13px; height: 30px; background-color: #e9e9e9;}
.yearnavigation {background-color: #dddddd;}
.monthnavigation {background-color: #dddddd;}
.datepicker {background-color: #ffffff;}
.datepickerform {margin: 0px;}
.monthpicker {background-color: #eeeeee;}
.yearpicker {background-color: #eeeeee;}
.pickerbutton {background-color: #eeeeee; border-style: none;}
.dayname td {text-align: center; font-size: 13px; background-color: #dddddd;}
.nomonthday {background-color: #cbeaca; height:25px; width:25px;}
.monthday {text-align: center; background-color: #e9e9e9; height:25px; width:25px;}
.today {text-align: center; background-color: #ffff99; height:25px; width:25px;}
.selectedday {text-align: center; background-color: #66ff66; height:25px; width:25px;}
.sunday {text-align: center; font-weight: bold; color: red; height:20px; width:20px;}
.sunday a {color: red;}
.saturday {text-align: center; font-weight: bold; color: red; height:20px; width:20px;}
.saturday a {color: red;}
.event {text-align: center; color: red; background-color: #ffff99; height:20px; width:20px;}
.event a {background-color: #ffff99; color: red;}
.selectedevent {text-align: center; color: red; background-color: #ffff99; height:20px; width:20px;}
.selectedevent a {background-color: #ffff99; color: red;}
.todayevent {text-align: center; color: red; background-color: #ffff99; height:20px; width:20px;}
.todayevent a {background-color: #ffff99; color: red;}
.eventcontent {font-size: 10px; border-style: outset; border-width: 1px;}

Here is a table with the classes of the html tags, generated by the Active Calendar Class and their configuration variables. To avoid conflicts with your existing CSS, the names of the generated classes can be changed in the Active Calendar class configuration.
Configuration variable	HTML Class	HTML TAG
$cssYearTable	year	table tag: calendar year
$cssYearTitle	yearname	td tag: calendar year title
$cssYearNav	yearnavigation	td tag: calendar year navigation
$cssMonthTable	month	table tag: calendar month
$cssMonthTitle	monthname	td tag: calendar month title
$cssMonthNav	monthnavigation	td tag: calendar month navigation
$cssWeekDay	dayname	tr tag: calendar weekdays
$cssPicker	datepicker	td tag: date picker
$cssPickerForm	datepickerform	form tag: date picker form
$cssPickerMonth	monthpicker	select tag: month picker
$cssPickerYear	yearpicker	select tag: year picker
$cssPickerButton	pickerbutton	input (submit) tag: date picker button
$cssMonthDay	monthday	td tag: days, that belong to the current month
$cssNoMonthDay	nomonthday	td tag: days, that do not belong to the current month
$cssToday	today	td tag: the current day
$cssSelecDay	selectedday	td tag: the selected day
$cssSunday	sunday	td tag: all Sundays
$cssSaturday	saturday	td tag: all Saturdays
$cssEvent	event	td tag: Event day set by setEvent(). Multiple classes can be generated (e.g 'meeting')
$cssPrefixSelecEvent	selected	td tag: Event day set by setEvent(), when it is selected. This prefix will be added to the event class name (e.g 'selectedevent'). Multiple classes (e.g 'selectedmeeting') can be generated
$cssPrefixTodayEvent	today	td tag: Event day set by setEvent(), when it is the current day. This prefix will be added to the event class name (e.g 'todayevent'). Multiple classes (e.g 'todaymeeting') can be generated
$cssEventContent	eventcontent	table tag : Event content set by setEventContent(). Multiple classes can be generated (e.g 'meetingcontent')

Quick installation

1. Edit the configuration section in Active Calendar Class file activecalendar.php, if you want to change the default configuration.

********* Month names *********
[This is just the default configuration. You may set the month names by calling the method setMonthNames()]
var $jan = "Name to display for January";
var $feb = "Name to display for February";
var $mar = "Name to display for March";
var $apr = "Name to display for April";
var $may = "Name to display for May";
var $jun = "Name to display for June";
var $jul = "Name to display for July";
var $aug = "Name to display for August";
var $sep = "Name to display for September";
var $oct = "Name to display for October";
var $nov = "Name to display for November";
var $dec = "Name to display for December";
******** Weekday names ********
[This is just the default configuration. You may set the day names by calling the method setDayNames()]
var $sun = "Name to display for Sunday";
var $mon = "Name to display for Monday";
var $tue = "Name to display for Tuesday";
var $wed = "Name to display for Wednesday";
var $thu = "Name to display for Thursday";
var $fri = "Name to display for Friday";
var $sat = "Name to display for Saturday";
****** Navigation controls ******
[This is just the default configuration. You may set the controls by calling the methods enableYearNav(), enableMonthNav() and enableDatePicker()]
var $yearNavBack = "Previus year control (it could be an image link e.g.:<img src=\"leftarrow.gif\">";
var $yearNavForw = "Next year control (it could be an image link e.g.:<img src=\"rightarrow.gif\">";
var $monthNavBack = "Previus month control (it could be an image link e.g.:<img src=\"leftarrow.gif\">";
var $monthNavForw = "Next month control (it could be an image link e.g.:<img src=\"rightarrow.gif\">";
var $selBtn = "Date picker button value";
****** Day links variables ******
var $yearID = "Name of the year GET VARIABLE for the links";
var $monthID = "Name of the month GET VARIABLE for the links";
var $dayID = "Name of the day GET VARIABLE for the links";
******** Monthview display ********
var $monthYearDivider = "Divider between month and year in the month`s title e.g '/'";
var $startOnSun = "True: first day of week is Sunday, False: first day of week is Monday";
var $crSunClass = "True: creates a HTML class 'sunday' on every Sunday";
var $crSatClass = "True: creates a HTML class 'saturday' on every Saturday";
******** Yearview display ********
var $rowCount = "Number of months in a row in yearview";
[This is just the default configuration. You may set the number of months in a row by calling the method showYear()]

2. Upload the Active Calendar Class file activecalendar.php on your server and include it in your scripts.