Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

jQuery UI widget that provides "Add to Calendar" functionality. Supports an extensible range of calendar services - desktop and web-based

branch: master

update to 0.1.2

* includes some whitespace cleanup
latest commit 9bcfd03cd3
Paul Gallagher authored
Octocat-spinner-32 libs basic add cal link July 29, 2010
Octocat-spinner-32 CHANGELOG.rdoc update to 0.1.2 January 08, 2013
Octocat-spinner-32 MIT-LICENSE add license and documentation October 03, 2010
Octocat-spinner-32 README.rdoc update to 0.1.2 January 08, 2013
Octocat-spinner-32 addtocal.htm update to 0.1.2 January 08, 2013
Octocat-spinner-32 jquery.addtocal.css bsic popup working July 28, 2010
Octocat-spinner-32 jquery.addtocal.js update to 0.1.2 January 08, 2013
README.rdoc

jQuery UI AddToCal widget v0.1.2

AddToCal is a jQuery UI widget that provides “Add to Calendar” functionality for any website. Given event details, it allows users to add the event to any supported calendar system.

Supported calendar systems:

  • Google Calendar

  • Microsoft Live Calendar

  • Yahoo! Calendar

  • 30boxes

  • Any iCal-compatible desktop application

  • Any vCalendar-compatible desktop application

See the addtocal.htm demo file for an example of how to initialize and use the widget. You can find and use a live demo at tardate.com/addtocal/addtocal.htm

Using AddToCal is simply a matter of initializing the widget, and attaching it to any DOM element that will hold a calendarable event in your application.

You need to implement one method when initializing AddToCal: getEventDetails( element ). It is called when a user selects a calendar to add an event to. The element parameter is the jQuery object for the event invoked. You must return an object packed with the relevant event details. How you determine the event attributes will depend on your page structure, and whether you are using a standard markup such as the hCalendar microformat.

Widget Initialzation

Here's an example of the minimal initialisation require. This example attaches the addtocal widget to all elements with the class 'addtocal'.

<script type='text/javascript' src='http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js'></script>
<script type='text/javascript' src='http://ajax.googleapis.com/ajax/libs/jqueryui/1.8.2/jquery-ui.min.js'></script>

<script type='text/javascript' src='javascripts/rfc3339date.js'></script>
<script type='text/javascript' src='javascripts/jquery.addtocal.js'></script>

<script type='text/javascript'>
$(document).ready(function() {

  $('.addtocal').AddToCal({
    // ical and vcal require an ics or vcs file to be served.
    // Disable these features if reqired (as a result the 30boxes, iCal and vCalendar menu links will not appear)
    icalEnabled:false,
    vcalEnabled:false,

    getEventDetails: function( element ) {

      ... [implement whatever is required to parse 'element' into the required event structure] ...

      // return the required event structure
      return {
        webcalurl: null,
        icalurl: null,
        vcalurl: null,
        start: start,
        end: end,
        title: title,
        details: details,
        location: null,
        url: null
      };
    }
  });

});
</script>

Required getEventDetails event structure

The structure returned from getEventDetails has the following members:

  • webcalurl: full url to webcal resource (if supported) e.g. webcal://mydomain/events/1.ics

  • icalurl: full url to iCal resource (if supported) e.g. mydomain/events/1.ics

  • vcalurl: full url to vCalendar resource (if supported) e.g. mydomain/events/1.vcs

  • start: start time of the event (javascript date object)

  • end: end time of the event (javascript date object)

  • title: event title text

  • details: event details text

  • location: event location text

  • url: full url to information about the event e.g. mydomain/events/1.html

Source

For more information and source files, see the project's github repository. Feel free to fork and enhance!

Dependencies

Copyright

Copyright © 2010 Paul GALLAGHER tardate.com

Dual licensed under the MIT or GPL Version 2 licenses.

Other References

Something went wrong with that request. Please try again.