Calendar Help
From ICCC
This page is intended to set out how to add an event into the calendar.
Events can be added anywhere on the wiki, through the use of the <event> syntax extension. It's as easy as editing the page, all that is required is to know the right syntax.
Contents |
Examples
- <event title="A Trip" start="2009-03-12 12:00" end="2009-03-15 12:00"/>
- Creates an event called "A Trip" which will go on between the dates/times specified
- <event title="A Trip" start="2009-03-12 12:00" end="2009-03-15 12:00" url="Trip Wiki Page"/>
- The same, but providing a link to a page within the wiki
- <event title="A Trip" start="2009-03-12 12:00" end="2009-03-15 12:00" url="http://www.google.co.uk"/>
- The same, but providing a link to an external page
- <event title="A Trip" start="2009-03-12 12:00" end="2009-03-15 12:00" hide="1"/>
- The same, hidden on the current page, but showing up in the calendar.
Note the "/" immediately before the final ">".
Where should I put an event?
The simple answer is anywhere. However, this would make it very difficult to find events to edit them.
Take a look at Category:Calendar Info. This contains a few pages which were set up specifically to put calendar events on.
The one exception to this is big trip planning. There is no problem with putting the event tag on the planning page.
How can I edit/delete an event?
It may not be obvious where the event is defined, because it can be on any page in the wiki.
To find out where the event is, take a look at Special:EventsList. This provides a listing of all events, along with a link to the defining pages.
Troubleshooting
If your event does not show up on the calendar, or shows up on the wrong date, it could be for one of a few reasons:-
- Incorrect Syntax: Use this page to provide you with examples. Make sure that the event tag is properly closed (i.e. with the slash)
- Enough Information: As a minimum, you must provide a start date and a title.
- Incorrect Date: Use the recommended syntax for dates. The server doesn't know whether '03/12/2009' means 3rd December or 12th March.
- Date out of range: Is your event in the past, or too far in the future to show up yet?
You can eliminate the first three reasons by checking Special:EventsList to see if your event is in the list.
Description
The basic event tag is constructed as follows:-
<event title="..." start="..."/>
Obviously, you need to fill in the title and the start date/time. You can use any format you like for times, provided it can be interpreted by PHP. I would recommend using this format:-
YYYY-MM-DD
or
YYYY-MM-DD HH:mm
(i.e. Year, Month, Date, Hours, Minutes). You don't have to do it like this, but it might get parsed incorrectly otherwise.
There are more settings as well. These are all optional, and can be used together.
- url="..."
- Specify a link to a specific page. You can link to a page in the wiki by just using its name (e.g. url="Calendar Help").
- end="..."
- Specify the end time of the event. Use the same input format as for the start time
- hide="1"
- Hide the event on the current page. It will still appear in the calendar.
Geek Info
The calendar is one of Andy's bizarre creations on this site.
- It was originally just a piece of wiki code which was edited manually
- Not satisfied with this, Andy made it contact IC's exchange server and read calendar info from here. The only problem with that was that most people couldn't add things to it, which slightly goes against the grain of having a wiki
The current calendar is written using Mediawiki article management hooks. Whenever you save a page, the text is checked for 'events'. When one of these is found, it is magically inserted into the database.
Also, purely for techie joy, the calendar is rendered using the hcalendar Microformat, so you can easily add the events into your calendar software.
