Do we or does your association horde events? Do we instruct your friends as well as business to simply supplement your events to their calendars as well as embrace involuntary reminders? Do your friends or clients have make make make use of of of of Windows Live Calendar, or would we similar to them to start? (Maybe if they had an online monthly calendar with built-in reminders they’d eventually recollect to come to your events as well as parties !)
Today I’ll speak about a singular approach we have your events simply accessible to Windows Live Calendar users from any Web page. This allows visitors to your blog or web site to supplement your eventuality to their Windows Live Calendar in a singular click. Well, dual really.
All it takes for this to work is a singular integrate in your Web page. Here’s what a URL looks like:
http://calendar.live.com/calendar/calendar.aspx?rru=addevent&dtstart=20090106T190000Z&dtend=20090106T200000Z&summary=title&location=location
When users click which link, they will go right to Windows Live Calendar with an “Add Event” dialog pre-filled with your interpretation (see below). All they have to do is click Save. If they’d like, they can additionally customize reminders, write remarks in a Details, or have any alternative changes they’d similar to prior to saving it. Nifty eh?
So, what is all this gobbledygook in a URL as well as how do we have it work for you?
Looking during a url we initial see rru=addevent. This is compulsory as well as equates to a initial thing to do after logging in is to move up a “add brand new event” form. The a single more parameters mention your data:
|
dtstart
|
Start date as well as time
|
|
dtend
|
End date as well as time
|
|
summary
|
The title of a eventuality
|
|
location
|
The place of a eventuality
|
|
description
|
The notation outline of a event |
So all we need to do is finish a URL with your event’s report in these parameters, creation certain it is URL-encoded properly , as well as you’re ready to go!
Now go ye onward as well as – no, wait, there’s still a singular pretence here. What about those dates? How do we format a date text? Well, given this was essentially dictated for programmed have make make make use of of of of by businesses as well as developers a date parsing isn’t really forgiving. It accepts dates in a format which we competence routinely usually see buried in a .ics file, something called an ISO8601 date. The format for this is:
YYYYMMDDTHHMMSSZ
YYYY is a 4 number year, MM is a 2 number month, DD is a 2 number day. T is literally a notation T (must be top case). HHMMSS have been hour, minute, as well as second in 24-hour time. The Z additionally has to be top box as well as it equates to a complete fibre is a UTC time. So yes, to have make make make use of of of of this API we have to initial modify your begin (and end) time in to UTC prior to we can have make make make use of of of of this API. You can additionally replace a Z as well as leave a time in internal time, though this equates to a eventuality is in “floating” time. A “floating” eventuality during 2pm will start during 2pm in any as well as each time zone. It is great if all a visitors have been internal or if we instruct an eventuality to start during midnight no make a difference where users have been located, though not so great for coordinating worldwide events.
Lastly, a integrate of tips for most appropriate usage:
- Set a aim of a integrate to be “_new” or “_top”. Calendar uses a complete browser window to equivocate blueprint issues as well as cranky site scripting bugs. So we should devise for which up front – this aim will remind we which this integrate is starting to mangle users out of your UI entirely. And when a user is accomplished we leave her in a Calendar UI rsther than than returning her to your site, we might instruct to aim “_new” to say site smoothness in a strange window/tab.
- For a same reason, don’t try to bucket a integrate in only a singular partial of your UI if we have been regulating frames. We’ll mangle out of a support as well as take over your total UI.
That’s it, you’re right away ready to go!
-Evan 
