\n";
# Create calendar foot
my $foot = CALENDAR_FOOT;
$foot =~ s/\$(\w+)/$dict->{$1}/g;
$calendar .= $foot;
# Assign calendar to variable that can be used a flavour template
$self->{state}->{current_entry}->{Plugin}->{Calendar}->{Month} = $calendar;
return 1;
}
#----------------------------------------------------------------------
# Compute weekday by Zeller's congruence
sub zeller {
my ($y, $m, $d) = @_;
my @d = (0, 3, 2, 5, 0, 3, 5, 1, 4, 6, 2, 4);
$y-- if $m < 3;
return ($y+ int($y/4) - int($y/100) + int($y/400) + $d[$m-1] + $d) % 7;
}
1;
__END__
=head1 NAME
Blosxom Plug-in: Calendar.pm
=head1 SYNOPSIS
Create a calendar for the month with links to entries on that day
=head1 DESCRIPTION
This plugin creates an html table representing a month's
calendar. Dates in the calendar are links to entries made on that day,
if any were made that day. The calendar is for the current month
unless the url for the web page contains a date, in which case that
day's month is used instead. Add the variable $Plugin::Calendar::Month
to the head.html or foot.html template file to include the calendar in
your Blosxom weblog. The look of the calendar can be modified by
changing the configuration variables CALENDAR_HEAD and CALENDAR_FOOT.
=head1 CONFIGURABLE VARIABLES
=over 4
=item USE_PATH
If this is set to one, the calendar will only link to entries in the
current path, effectively filtering entries by category. If it is set
to zero, the calendar will link to all articles created in the month.
=item MONTH_NAMES
The names of the twelve months
=item MONTH_ABBREV
Abbreviations for the twelve month names.
=item MONTH_LENGTH
The number of days in each month.
=item DATE_CLASS
The html tag of each calendar date is given this class. You can assign
CSS styles to this class to configure the look of the calendar.
=item CALENDAR_HEAD
The html code for the top of the calendar. The html can contain
variables, which start with a "$", just like in Blosxom flavour
templates. The variables are listed below. Edit the lines up to but
not including the EOQ.
=tem CALENDAR_FOOT
The html code for the bottom of the calendar. It can contain
variables, just like CALENDAR_HEAD.
=back
The following variables can be included in the CALENDAR_HEAD and
CALENDAR_FOOT. Most variables come in threes: one for the prvious,
current and next month.
=over 4
=item $date_class
The date class, as set in the configuration variable DATE_CLASS
=item $prev_month_year, $this_month_year, and $next_month_year
The year of the previous, current, and next month.
=item $prev_month_name, $this_month_nae, and $next_month_name
The names of the previous, current, and next months.
=item $prev_month_abbrev, $this_month_abbrev, and $next_month_abbrev
The abbreviated name for the previous, current, and next months
=item $prev_month_url, $this_month_url, and $next_month_url
The url for the entries for the previous, current, and next months
=back
=head1 INSTALLATION
Place this file in the plugins directory and add the line
Blosxom::Plugin::Calendar::run
to the .settings/handlers.flow file between the lines
Blosxom::run_entries
and
Blosxom::render_response
Edit the .templates/head.html or .templates/foot.html file and add the
variable
$Plugin::Calendar::Month
where you want the calendar to appear.
=head1 BUGS
Because the version of Blosxom 3 that is currently being distributed
ignores the handlers.flow file, you need to first install a patch to
Blosxom 3 to fix this problem, such as the one distributed on my
site in order for changes to the handlers.flow file to be recognized.
=head1 AUTHOR
Bernie Simon (http://carelesshand.net)
=head1 LICENSE
Copyright Bernard Simon, 2005. You may use this file as you wish as
long as this copyright notice is maintained.