123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180 |
- /*!
- * FullCalendar v3.1.0 Google Calendar Plugin
- * Docs & License: http://fullcalendar.io/
- * (c) 2016 Adam Shaw
- */
-
- (function(factory) {
- if (typeof define === 'function' && define.amd) {
- define([ 'jquery' ], factory);
- }
- else if (typeof exports === 'object') { // Node/CommonJS
- module.exports = factory(require('jquery'));
- }
- else {
- factory(jQuery);
- }
- })(function($) {
- var API_BASE = 'https://www.googleapis.com/calendar/v3/calendars';
- var FC = $.fullCalendar;
- var applyAll = FC.applyAll;
- FC.sourceNormalizers.push(function(sourceOptions) {
- var googleCalendarId = sourceOptions.googleCalendarId;
- var url = sourceOptions.url;
- var match;
- // if the Google Calendar ID hasn't been explicitly defined
- if (!googleCalendarId && url) {
- // detect if the ID was specified as a single string.
- // will match calendars like "asdf1234@calendar.google.com" in addition to person email calendars.
- if (/^[^\/]+@([^\/\.]+\.)*(google|googlemail|gmail)\.com$/.test(url)) {
- googleCalendarId = url;
- }
- // try to scrape it out of a V1 or V3 API feed URL
- else if (
- (match = /^https:\/\/www.googleapis.com\/calendar\/v3\/calendars\/([^\/]*)/.exec(url)) ||
- (match = /^https?:\/\/www.google.com\/calendar\/feeds\/([^\/]*)/.exec(url))
- ) {
- googleCalendarId = decodeURIComponent(match[1]);
- }
- if (googleCalendarId) {
- sourceOptions.googleCalendarId = googleCalendarId;
- }
- }
- if (googleCalendarId) { // is this a Google Calendar?
- // make each Google Calendar source uneditable by default
- if (sourceOptions.editable == null) {
- sourceOptions.editable = false;
- }
- // We want removeEventSource to work, but it won't know about the googleCalendarId primitive.
- // Shoehorn it into the url, which will function as the unique primitive. Won't cause side effects.
- // This hack is obsolete since 2.2.3, but keep it so this plugin file is compatible with old versions.
- sourceOptions.url = googleCalendarId;
- }
- });
- FC.sourceFetchers.push(function(sourceOptions, start, end, timezone) {
- if (sourceOptions.googleCalendarId) {
- return transformOptions(sourceOptions, start, end, timezone, this); // `this` is the calendar
- }
- });
- function transformOptions(sourceOptions, start, end, timezone, calendar) {
- var url = API_BASE + '/' + encodeURIComponent(sourceOptions.googleCalendarId) + '/events?callback=?'; // jsonp
- var apiKey = sourceOptions.googleCalendarApiKey || calendar.options.googleCalendarApiKey;
- var success = sourceOptions.success;
- var data;
- var timezoneArg; // populated when a specific timezone. escaped to Google's liking
- function reportError(message, apiErrorObjs) {
- var errorObjs = apiErrorObjs || [ { message: message } ]; // to be passed into error handlers
- // call error handlers
- (sourceOptions.googleCalendarError || $.noop).apply(calendar, errorObjs);
- (calendar.options.googleCalendarError || $.noop).apply(calendar, errorObjs);
- // print error to debug console
- FC.warn.apply(null, [ message ].concat(apiErrorObjs || []));
- }
- if (!apiKey) {
- reportError("Specify a googleCalendarApiKey. See http://fullcalendar.io/docs/google_calendar/");
- return {}; // an empty source to use instead. won't fetch anything.
- }
- // The API expects an ISO8601 datetime with a time and timezone part.
- // Since the calendar's timezone offset isn't always known, request the date in UTC and pad it by a day on each
- // side, guaranteeing we will receive all events in the desired range, albeit a superset.
- // .utc() will set a zone and give it a 00:00:00 time.
- if (!start.hasZone()) {
- start = start.clone().utc().add(-1, 'day');
- }
- if (!end.hasZone()) {
- end = end.clone().utc().add(1, 'day');
- }
- // when sending timezone names to Google, only accepts underscores, not spaces
- if (timezone && timezone != 'local') {
- timezoneArg = timezone.replace(' ', '_');
- }
- data = $.extend({}, sourceOptions.data || {}, {
- key: apiKey,
- timeMin: start.format(),
- timeMax: end.format(),
- timeZone: timezoneArg,
- singleEvents: true,
- maxResults: 9999
- });
- return $.extend({}, sourceOptions, {
- googleCalendarId: null, // prevents source-normalizing from happening again
- url: url,
- data: data,
- startParam: false, // `false` omits this parameter. we already included it above
- endParam: false, // same
- timezoneParam: false, // same
- success: function(data) {
- var events = [];
- var successArgs;
- var successRes;
- if (data.error) {
- reportError('Google Calendar API: ' + data.error.message, data.error.errors);
- }
- else if (data.items) {
- $.each(data.items, function(i, entry) {
- var url = entry.htmlLink || null;
- // make the URLs for each event show times in the correct timezone
- if (timezoneArg && url !== null) {
- url = injectQsComponent(url, 'ctz=' + timezoneArg);
- }
- events.push({
- id: entry.id,
- title: entry.summary,
- start: entry.start.dateTime || entry.start.date, // try timed. will fall back to all-day
- end: entry.end.dateTime || entry.end.date, // same
- url: url,
- location: entry.location,
- description: entry.description
- });
- });
- // call the success handler(s) and allow it to return a new events array
- successArgs = [ events ].concat(Array.prototype.slice.call(arguments, 1)); // forward other jq args
- successRes = applyAll(success, this, successArgs);
- if ($.isArray(successRes)) {
- return successRes;
- }
- }
- return events;
- }
- });
- }
- // Injects a string like "arg=value" into the querystring of a URL
- function injectQsComponent(url, component) {
- // inject it after the querystring but before the fragment
- return url.replace(/(\?.*?)?(#|$)/, function(whole, qs, hash) {
- return (qs ? qs + '&' : '?') + component + hash;
- });
- }
- });
|