aboutsummaryrefslogtreecommitdiff
path: root/doc/todo/Set_arbitrary_date_to_be_used_by_calendar_plugin.mdwn
blob: e0074eef8dcad4c23d7ce374fb5d918da9f2afdc (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
[[!tag patch plugins/calendar]]

Here's my next version of the patch - still a work in progress.

  Note:I partially updated part of this patch to work on Ikiwiki v3 - see [here](http://ikiwiki.info/forum/Calendar:_listing_multiple_entries_per_day/) -- Matt Ford

It provides the following new features. The features are designed to preserve the behavior of the existing plugin by default.

 * If you specify an event preprocessor in a post, such as:

    [[!event time="2008-06-24"]]

 That date will be used instead of the post creation time when displaying the calendar.

 * When specifying a calendar preprocessor, you can now add the following new parameters:

  * time_src: by default it is set to auto. auto means that when determining the date to use for a given post, take the date given in the event preprocessor directive if it exists and if not, use the creation time of the post. The other option is event which means: take the date given in the event preprocessor directive. If there is not event preprocessor in a post, don't include the post.
  * detail: by default it is set to 0. If set to 0, display the monthly calendar as a series of days. Each day is a link to the post on that day. If there is more than one post on a day, only one is linked to. If set to 1 - then display the title of each post on the day as a link to the post. Is 0 and 1 the best values here? On/Off? Yes/no?

The following changes are in the works:

 * Switch to using HTML::CalendarMonth to create the html output

 * Display the start time when detail is set to 1. 

Longer term plans:

 * Support recurring events
 
 * Support for end time on events (including end time that is on a different day than the start time)

 * Convincing the world to switch to base 10 calendar system.


		--- calendar.pm.orig	2008-06-24 22:36:09.000000000 -0400
		+++ calendar.pm	2008-06-28 22:02:15.000000000 -0400
		@@ -23,6 +23,8 @@
		 use IkiWiki 2.00;
		 use Time::Local;
		 use POSIX;
		+use Date::Parse;
		+use Data::Dumper;
		 
		 my %cache;
		 my %linkcache;
		@@ -32,6 +34,7 @@
		 sub import {
			hook(type => "needsbuild", id => "version", call => \&needsbuild);
			hook(type => "preprocess", id => "calendar", call => \&preprocess);
		+	hook(type => "preprocess", id => "event", call => \&preprocess_event);
		 }
		 
		 sub is_leap_year (@) {
		@@ -58,6 +61,7 @@
			my $nmonth   = $params{nmonth};
			my $pyear    = $params{pyear};
			my $nyear    = $params{nyear};
		+	my $detail   = $params{detail};
		 
			my @list;
			my $calendar="\n";
		@@ -153,33 +157,58 @@
				}
				
				my $tag;
		+		my $display_day;
				my $mtag = sprintf("%02d", $month);
		-		if (defined $cache{$pagespec}{"$year/$mtag/$day"}) {
		-			if ($day == $today) {
		+		if ($day == $today) {
						$tag='month-calendar-day-this-day';
		-			}
		-			else {
		-				$tag='month-calendar-day-link';
		-			}
		-			$calendar.=qq{\t\t<td class="$tag $downame{$wday}">};
		-			$calendar.=htmllink($params{page}, $params{destpage}, 
		-			                    pagename($linkcache{"$year/$mtag/$day"}),
		-			                    "linktext" => "$day");
		-			push @list, pagename($linkcache{"$year/$mtag/$day"});
		-			$calendar.=qq{</td>\n};
		+		}
		+		elsif ($day >= $future_dom) {
		+			$tag='month-calendar-day-future';
		+		}
		+		elsif($params{detail} == 0 && 
		+			!defined $cache{$pagespec}{"$year/$mtag/$day"}) {
		+			$tag='month-calendar-day-nolink';
		+		} 
		+		elsif($params{detail} == 0 && 
		+			defined $cache{$pagespec}{"$year/$mtag/$day"}) {
		+			$tag='month-calendar-day-link';
				}
				else {
		-			if ($day == $today) {
		-				$tag='month-calendar-day-this-day';
		-			}
		-			elsif ($day == $future_dom) {
		-				$tag='month-calendar-day-future';
		+			$tag='month-calendar-day';
		+		}
		+
		+		$calendar.=qq{\t\t<td class="$tag $downame{$wday}">};
		+		my $day_label = qq{<span class="month-calendar-day-label">$day</span>};	
		+		if (defined $cache{$pagespec}{"$year/$mtag/$day"}) {
		+			my $srcpage; my $destpage;
		+			if($params{detail} == 0) {
		+				# pull off the first page
		+				(($srcpage,$destpage) = each(%{$linkcache{"$year/$mtag/$day"}}));
		+				$calendar.=htmllink($params{page}, $params{destpage}, 
		+			                    pagename($destpage),
		+			                    "linktext" => "$day_label");
		+				push @list, pagename($linkcache{"$year/$mtag/$day"});
					}
					else {
		-				$tag='month-calendar-day-nolink';
		+				$calendar.=qq{$day_label\n};
		+				while(($srcpage,$destpage) = each(%{$linkcache{"$year/$mtag/$day"}})) {
		+					my $title = IkiWiki::basename(pagename($srcpage));
		+					if (exists $pagestate{$srcpage}{meta}{title} ) {
		+						$title = $pagestate{$srcpage}{meta}{title};
		+					}
		+					$calendar.=qq{\t\t<div class="$tag $downame{$wday}">};
		+					$calendar.=htmllink($params{page}, $params{destpage}, 
		+															pagename($destpage),
		+															"linktext" => $title);
		+					push @list, pagename($linkcache{"$year/$mtag/$day"}{"$srcpage"});
		+					$calendar.=qq{\t\t</div>};
		+				}
					}
		-			$calendar.=qq{\t\t<td class="$tag $downame{$wday}">$day</td>\n};
				}
		+		else {
		+			$calendar.=qq{$day_label\n};
		+		}
		+		$calendar.=qq{</td>\n};
			}
		 
			# finish off the week
		@@ -304,6 +333,18 @@
			return $calendar;
		 }
		 
		+sub preprocess_event (@) {
		+	my %params=@_;
		+	# if now time is given, use now
		+	$params{begin} = localtime($time)            unless defined $params{begin};
		+
		+	my $timestamp = str2time($params{begin});
		+	if ( defined $timestamp) {
		+		$pagestate{$params{page}}{event}{begin}=$timestamp;
		+	}
		+	return "<!-- $params{begin} -->";
		+} #}}
		+
		 sub preprocess (@) {
			my %params=@_;
			$params{pages} = "*"            unless defined $params{pages};
		@@ -311,6 +352,8 @@
			$params{month} = sprintf("%02d", $params{month}) if defined  $params{month};
			$params{week_start_day} = 0     unless defined $params{week_start_day};
			$params{months_per_row} = 3     unless defined $params{months_per_row};
		+	$params{time_src} = 'auto'      unless defined $params{time_src};
		+	$params{detail} = 0				      unless defined $params{detail};
		 
			if (! defined $params{year} || ! defined $params{month}) {
				# Record that the calendar next changes at midnight.
		@@ -355,19 +398,29 @@
			if (! defined $cache{$pagespec}) {
				foreach my $p (keys %pagesources) {
					next unless pagespec_match($p, $pagespec);
		-			my $mtime = $IkiWiki::pagectime{$p};
		-			my $src   = $pagesources{$p};
		-			my @date  = localtime($mtime);
		-			my $mday  = $date[3];
		-			my $month = $date[4] + 1;
		-			my $year  = $date[5] + 1900;
		-			my $mtag  = sprintf("%02d", $month);
		-
		-			# Only one posting per day is being linked to.
		-			$linkcache{"$year/$mtag/$mday"} = "$src";
		-			$cache{$pagespec}{"$year"}++;
		-			$cache{$pagespec}{"$year/$mtag"}++;
		-			$cache{$pagespec}{"$year/$mtag/$mday"}++;
		+			my $begin = '';
		+			# use time defined by event preprocessor if it's available
		+			if (defined $pagestate{$p}{event}{begin}) {
		+				$begin = $pagestate{$p}{event}{begin};
		+			# fall back on ctime if time_src is set to auto
		+			# set time_src to 'event' to skip posts that don't
		+			# have the event preprocessor
		+			} elsif ($params{time_src} eq 'auto') {
		+				$begin = $IkiWiki::pagectime{$p};
		+			}
		+			if($begin ne '') {
		+				my $dest   = $pagesources{$p};
		+				my @date  = localtime($begin);
		+				my $mday  = $date[3];
		+				my $month = $date[4] + 1;
		+				my $year  = $date[5] + 1900;
		+				my $mtag  = sprintf("%02d", $month);
		+
		+				$linkcache{"$year/$mtag/$mday"}{$p} = "$dest";
		+				$cache{$pagespec}{"$year"}++;
		+				$cache{$pagespec}{"$year/$mtag"}++;
		+				$cache{$pagespec}{"$year/$mtag/$mday"}++;
		+			}
				}
			}