tupali/librerias/calendar/gcal.js
2017-10-16 13:51:40 -05:00

289 lines
7.0 KiB
JavaScript
Executable File

/*!
* FullCalendar v3.6.1 Google Calendar Plugin
* Docs & License: https://fullcalendar.io/
* (c) 2017 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 FC = $.fullCalendar;
var Promise = FC.Promise;
var EventSource = FC.EventSource;
var JsonFeedEventSource = FC.JsonFeedEventSource;
var EventSourceParser = FC.EventSourceParser;
var applyAll = FC.applyAll;
;;
var GcalEventSource = EventSource.extend({
// TODO: eventually remove "googleCalendar" prefix (API-breaking)
googleCalendarApiKey: null,
googleCalendarId: null,
googleCalendarError: null, // optional function
ajaxSettings: null,
constructor: function() {
EventSource.apply(this, arguments);
this.ajaxSettings = {};
},
fetch: function(start, end, timezone) {
var _this = this;
var url = this.buildUrl();
var requestParams = this.buildRequestParams(start, end, timezone);
var ajaxSettings = this.ajaxSettings;
var onSuccess = ajaxSettings.success;
if (!requestParams) { // could have failed
return Promise.reject();
}
return Promise.construct(function(onResolve, onReject) {
$.ajax($.extend(
{}, // destination
JsonFeedEventSource.AJAX_DEFAULTS,
ajaxSettings,
{
url: url,
data: requestParams,
success: function(responseData) {
var rawEventDefs;
var successRes;
if (responseData.error) {
_this.reportError('Google Calendar API: ' + responseData.error.message, responseData.error.errors);
onReject();
}
else if (responseData.items) {
rawEventDefs = _this.gcalItemsToRawEventDefs(
responseData.items,
requestParams.timeZone
);
successRes = applyAll(
onSuccess,
this, // forward `this`
// call the success handler(s) and allow it to return a new events array
[ rawEventDefs ].concat(Array.prototype.slice.call(arguments, 1))
);
if ($.isArray(successRes)) {
rawEventDefs = successRes;
}
onResolve(_this.parseEventDefs(rawEventDefs));
}
}
}
));
});
},
gcalItemsToRawEventDefs: function(items, gcalTimezone) {
var _this = this;
return items.map(function(item) {
return _this.gcalItemToRawEventDef(item, gcalTimezone);
});
},
gcalItemToRawEventDef: function(item, gcalTimezone) {
var url = item.htmlLink || null;
// make the URLs for each event show times in the correct timezone
if (url && gcalTimezone) {
url = injectQsComponent(url, 'ctz=' + gcalTimezone);
}
return {
id: item.id,
title: item.summary,
start: item.start.dateTime || item.start.date, // try timed. will fall back to all-day
end: item.end.dateTime || item.end.date, // same
url: url,
location: item.location,
description: item.description
};
},
buildUrl: function() {
return GcalEventSource.API_BASE + '/' +
encodeURIComponent(this.googleCalendarId) +
'/events?callback=?'; // jsonp
},
buildRequestParams: function(start, end, timezone) {
var apiKey = this.googleCalendarApiKey || this.calendar.opt('googleCalendarApiKey');
var params;
if (!apiKey) {
this.reportError("Specify a googleCalendarApiKey. See http://fullcalendar.io/docs/google_calendar/");
return null;
}
// 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');
}
params = $.extend(
this.ajaxSettings.data || {},
{
key: apiKey,
timeMin: start.format(),
timeMax: end.format(),
singleEvents: true,
maxResults: 9999
}
);
if (timezone && timezone !== 'local') {
// when sending timezone names to Google, only accepts underscores, not spaces
params.timeZone = timezone.replace(' ', '_');
}
return params;
},
reportError: function(message, apiErrorObjs) {
var calendar = this.calendar;
var calendarOnError = calendar.opt('googleCalendarError');
var errorObjs = apiErrorObjs || [ { message: message } ]; // to be passed into error handlers
if (this.googleCalendarError) {
this.googleCalendarError.apply(calendar, errorObjs);
}
if (calendarOnError) {
calendarOnError.apply(calendar, errorObjs);
}
// print error to debug console
FC.warn.apply(null, [ message ].concat(apiErrorObjs || []));
},
getPrimitive: function() {
return this.googleCalendarId;
},
applyManualStandardProps: function(rawProps) {
var superSuccess = EventSource.prototype.applyManualStandardProps.apply(this, arguments);
var googleCalendarId = rawProps.googleCalendarId;
if (googleCalendarId == null && rawProps.url) {
googleCalendarId = parseGoogleCalendarId(rawProps.url);
}
if (googleCalendarId != null) {
this.googleCalendarId = googleCalendarId;
return superSuccess;
}
return false;
},
applyMiscProps: function(rawProps) {
$.extend(this.ajaxSettings, rawProps);
}
});
GcalEventSource.API_BASE = 'https://www.googleapis.com/calendar/v3/calendars';
GcalEventSource.defineStandardProps({
// manually process...
url: false,
googleCalendarId: false,
// automatically transfer...
googleCalendarApiKey: true,
googleCalendarError: true
});
GcalEventSource.parse = function(rawInput, calendar) {
var rawProps;
if (typeof rawInput === 'object') { // long form. might fail in applyManualStandardProps
rawProps = rawInput;
}
else if (typeof rawInput === 'string') { // short form
rawProps = { url: rawInput }; // url will be parsed with parseGoogleCalendarId
}
if (rawProps) {
return EventSource.parse.call(this, rawProps, calendar);
}
return false;
};
function parseGoogleCalendarId(url) {
var match;
// 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)) {
return 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))
) {
return decodeURIComponent(match[1]);
}
}
// 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;
});
}
// expose
EventSourceParser.registerClass(GcalEventSource);
FC.GcalEventSource = GcalEventSource;
;;
});