- add new buttons to the header via
customButtons
(225) - control stacking order of events via
eventOrder
(364) - control frequency of slot text via
slotLabelInterval
(946) displayEventTime
(1904)on
andoff
methods (1910)- renamed
axisFormat
toslotLabelFormat
- minor code adjustment in preparation for plugins
- Fix week view column title for en-gb (PR220)
- Publish to NPM (2447)
- Detangle bower from npm package (PR179)
- internal refactoring in preparation for other views
- businessHours now renders on whole-days in addition to timed areas
- events in "more" popover not sorted by time (2385)
- avoid using moment's deprecated zone method (2443)
- destroying the calendar sometimes causes all window resize handlers to be unbound (2432)
- multiple calendars on one page, can't accept external elements after navigating (2433)
- accept external events from jqui sortable (1698)
- external jqui drop processed before reverting (1661)
- IE8 fix: month view renders incorrectly (2428)
- IE8 fix: eventLimit:true wouldn't activate "more" link (2330)
- IE8 fix: dragging an event with an href
- IE8 fix: invisible element while dragging agenda view events
- IE8 fix: erratic external element dragging
- view.title wasn't defined in viewRender callback (2407)
- FullCalendar versions >= 2.2.5 brokenness with Moment versions <= 2.8.3 (2417)
- Support Bokmal Norwegian language specifically (2427)
- Compatibility with Moment v2.9. Was breaking GCal plugin (2408)
- View object's
title
property mistakenly omitted (2407) - Single-day views with hiddens days could cause prev/next misbehavior (2406)
- Don't let the current date ever be a hidden day (solves 2395)
- Hebrew locale (2157)
buttonText
specified for custom views via theviews
option- bugfix: wrong default value, couldn't override default
- feature: default value taken from locale
- Arbitrary durations for basic/agenda views with the
views
option (692) - Specify view-specific options using the
views
option. fixes 2283 - Deprecate view-option-hashes
- Formalize and expose View API (1055)
- updateEvent method, more intuitive behavior. fixes 2194
- removeEventSource with Google Calendar object source, would not remove (2368)
- Events with invalid end dates are still accepted and rendered (2350, 2237, 2296)
- Bug when rendering business hours and navigating away from original view (2365)
- Links to Google Calendar events will use current timezone (2122)
- Google Calendar plugin works with timezone names that have spaces
- Google Calendar plugin accepts person email addresses as calendar IDs
- Internally use numeric sort instead of alphanumeric sort (2370)
- Fixes to Google Calendar API V3 code
- wouldn't recognize a lone-string Google Calendar ID if periods before the @ symbol
- removeEventSource wouldn't work when given a Google Calendar ID
- Migrate Google Calendar plugin to use V3 of the API (1526)
- Background events. Event object's
rendering
property (144, 1286) businessHours
option (144)- Controlling where events can be dragged/resized and selections can go (396, 1286, 2253)
eventOverlap
,selectOverlap
, and similareventConstraint
,selectConstraint
, and similar
- Improvements to dragging and dropping external events (2004)
- Associating with real event data. used with
eventReceive
- Associating a
duration
- Associating with real event data. used with
- Performance boost for moment creation
- Be aware, FullCalendar-specific methods now attached directly to global moment.fn
- Helps with issue 2259
- Reintroduced forgotten
dropAccept
option (2312)
- removeEventSource not working with array (2203)
- mouseout not triggered after mouseover+updateEvent (829)
- agenda event's render with no href, not clickable (2263)
Large code refactor with better OOP, better code reuse, and more comments. No more reliance on jQuery UI for event dragging, resizing, or anything else.
Significant changes to HTML/CSS skeleton:
- Leverages tables for liquid rendering of days and events. No costly manual repositioning (809)
- Backwards-incompatibilities:
- Many classNames have changed. Custom CSS will likely need to be adjusted.
- IE7 definitely not supported anymore
- In
eventRender
callback,element
will not be attached to DOM yet - Events are styled to be one line by default (1992). Can be undone through custom CSS, but not recommended (might get gaps like this in certain situations).
A "more..." link when there are too many events on a day (304). Works with month and basic views as well as the all-day section of the agenda views. New options:
eventLimit
. a number ortrue
eventLimitClick
. the"popover
" value will reveal all events in a raised panel (the default)eventLimitText
dayPopoverFormat
Changes related to height and scrollbars:
aspectRatio
/height
/contentHeight
values will be honored no matter what'auto'
value forheight
/contentHeight
options. If content is too tall, the view will vertically stretch to accomodate and no scrollbars will be used (521).- Tall weeks in month view will borrow height from other weeks (243)
- Automatically scroll the view then dragging/resizing an event (1025, 2078)
- New
fixedWeekCount
option to determines the number of weeks in month view- Supersedes
weekMode
(deprecated). Instead, use a combination offixedWeekCount
and one of the height options, possibly with an'auto'
value
- Supersedes
Much nicer, glitch-free rendering of calendar for printers (35). Things you might not expect:
- Buttons will become hidden
- Agenda views display a flat list of events where the time slots would be
Other issues resolved along the way:
- Space on right side of agenda events configurable through CSS (204)
- Problem with window resize (259)
- Events sorting stays consistent across weeks (510)
- Agenda's columns misaligned on wide screens (511)
- Run
selectHelper
througheventRender
callbacks (629) - Keyboard access, tabbing (637)
- Run resizing events through
eventRender
(714) - Resize an event to a different day in agenda views (736)
- Allow selection across days in agenda views (778)
- Mouseenter delegated event not working on event elements (936)
- Agenda event dragging, snapping to different columns is erratic (1101)
- Android browser cuts off Day view at 8 PM with no scroll bar (1203)
- Don't fire
eventMouseover
/eventMouseout
while dragging/resizing (1297) - Customize the resize handle text ("=") (1326)
- If agenda event is too short, don't overwrite
.fc-event-time
(1700) - Zooming calendar causes events to misalign (1996)
- Event destroy callback on event removal (2017)
- Agenda views, when RTL, should have axis on right (2132)
- Make header buttons more accessibile (2151)
- daySelectionMousedown should interpret OSX ctrl+click as a right mouse click (2169)
- Best way to display time text on multi-day events with times (2172)
- Eliminate table use for header layout (2186)
- Event delegation used for event-related callbacks (like
eventClick
). Speedier.
- moment-2.8.1 compatibility (2221)
- relative path in bower.json (PR 117)
- upgraded jquery-ui and misc dev dependencies
- bug with persisting addEventSource calls (2191)
- bug with persisting removeEvents calls with an array source (2187)
- bug with removeEvents method when called with 0 removes all events (2082)
delta
parameters reintroduced ineventDrop
andeventResize
handlers (2156)- Note: this changes the argument order for
revertFunc
- Note: this changes the argument order for
- wrongfully triggering a windowResize when resizing an agenda view event (1116)
this
values in event drag-n-drop/resize handlers consistently the DOM node (1177)displayEventEnd
- v2 workaround to force display of an end time (2090)- don't modify passed-in eventSource items (954)
- destroy method now removes fc-ltr class (2033)
- weeks of last/next month still visible when weekends are hidden (2095)
- fixed memory leak when destroying calendar with selectable/droppable (2137)
- Icelandic language (2180)
- Bahasa Indonesia language (PR 172)
Internationalization support, timezone support, and MomentJS integration. Extensive changes, many of which are backwards incompatible.
Full list of changes | Affected Issues
An automated testing framework has been set up (Karma + Jasmine) and tests have been written which cover about half of FullCalendar's functionality. Special thanks to @incre-d, @vidbina, and @sirrocco for the help.
In addition, the main development repo has been repurposed to also include the built distributable JS/CSS for the project and will serve as the new Bower endpoint.
- better algorithm for positioning timed agenda events (1115)
slotEventOverlap
option to tweak timed agenda event overlapping (218)- selection bug when slot height is customized (1035)
- supply view argument in
loading
callback (1018) - fixed week number not displaying in agenda views (1951)
- fixed fullCalendar not initializing with no options (1356)
- NPM's
package.json
, no more warnings or errors (1762) - building the bower component should output
bower.json
instead ofcomponent.json
(PR 125) - use bower internally for fetching new versions of jQuery and jQuery UI
viewRender
callback (PR 15)viewDestroy
callback (PR 15)eventDestroy
callback (PR 111)handleWindowResize
option (PR 54)eventStartEditable
/startEditable
options (PR 49)eventDurationEditable
/durationEditable
options (PR 49)- specify function for
$.ajax
data
parameter for JSON event sources (PR 59) - fixed bug with agenda event dropping in wrong column (PR 55)
- easier event element z-index customization (PR 58)
- classNames on past/future days (PR 88)
- allow
null
/undefined
event titles (PR 84) - small optimize for agenda event rendering (PR 56)
- deprecated:
viewDisplay
disableDragging
disableResizing
- bundled with latest jQuery (1.10.2) and jQuery UI (1.10.3)
hiddenDays
option (686)- bugfix: when
eventRender
returnsfalse
, incorrect stacking of events (762) - bugfix: couldn't change
event.backgroundImage
when callingupdateEvent
(thx @stephenharris)
- fixed event inner content overflow bug (1783)
- fixed table header className bug 1772
- removed text-shadow on events (better for general use, thx @tkrotoff)
- visual facelift, with bootstrap-inspired buttons and colors
- simplified HTML/CSS for events and buttons
dayRender
, for modifying a day cell (191, thx @althaus)- week numbers on side of calendar (295)
weekNumber
weekNumberCalculation
weekNumberTitle
W
formatting variable
- finer snapping granularity for agenda view events (495, thx @ms-doodle-com)
eventAfterAllRender
(753, thx @pdrakeweb)eventDataTransform
(thx @joeyspo)data-date
attributes on cells (thx @Jae)- expose
$.fullCalendar.dateFormatters
- when clicking fast on buttons, prevent text selection
- bundled with latest jQuery (1.9.1) and jQuery UI (1.10.2)
- Grunt/Lumbar build system for internal development
- build for Bower package manager
- build for jQuery plugin site
- made compatible with jQuery 1.8.* (thx @archaeron)
- bundled with jQuery 1.8.1 and jQuery UI 1.8.23
- fixed dragging issue with jQuery UI 1.8.16 (1168)
- bundled with jQuery 1.7.1 and jQuery UI 1.8.17
- correctly process UTC "Z" ISO8601 date strings (750)
- more flexible ISO8601 date parsing (814)
- more flexible parsing of UNIX timestamps (826)
- FullCalendar now buildable from source on a Mac (795)
- FullCalendar QA'd in FF4 (883)
- upgraded to jQuery 1.5.2 (which supports IE9) and jQuery UI 1.8.11
- slicker default styling for buttons
- reworked a lot of the calendar's HTML and accompanying CSS (solves 327 and 395)
- more printer-friendly (fullcalendar-print.css)
- fullcalendar now inherits styles from jquery-ui themes differently. styles for buttons are distinct from styles for calendar cells. (solves 299)
- can now color events through FullCalendar options and Event-Object properties (117)
THIS IS NOW THE PREFERRED METHOD OF COLORING EVENTS (as opposed to using className and CSS)
- FullCalendar options:
- eventColor (changes both background and border)
- eventBackgroundColor
- eventBorderColor
- eventTextColor
- Event-Object options:
- color (changes both background and border)
- backgroundColor
- borderColor
- textColor
- FullCalendar options:
- can now specify an event source as an object with a
url
property (json feed) or anevents
property (function or array) with additional properties that will be applied to the entire event source:- color (changes both background and border)
- backgroudColor
- borderColor
- textColor
- className
- editable
- allDayDefault
- ignoreTimezone
- startParam (for a feed)
- endParam (for a feed)
- ANY OF THE JQUERY $.ajax OPTIONS
allows for easily changing from GET to POST and sending additional parameters (386)
allows for easily attaching ajax handlers such as
error
(754) allows for turning caching on (355)
- Google Calendar feeds are now specified differently:
- specify a simple string of your feed's URL
- specify an object with a
url
property of your feed's URL. you can include any of the new Event-Source options in this object. - the old
$.fullCalendar.gcalFeed
method still works
- no more IE7 SSL popup (504)
- remove
cacheParam
- use json event sourcecache
option instead - latest jquery/jquery-ui
- fixed rerenderEvents bug (790)
- fixed bug with faulty dragging of events from all-day slot in agenda views
- bundled with jquery 1.5 and jquery-ui 1.8.9
- fixed bug with resizing event to different week in 5-day month view (740)
- fixed bug with events not sticking after a removeEvents call (757)
- fixed bug with underlying parseTime method, and other uses of parseInt (688)
- new algorithm for vertically stacking events (111)
- resizing an event to a different week (306)
- bug: some events not rendered with consecutive calls to addEventSource (679)
- ignoreTimezone option (set to
false
to process UTC offsets in ISO8601 dates) - bugfixes
- event refetching not being called under certain conditions (417, 554)
- event refetching being called multiple times under certain conditions (586, 616)
- selection cannot be triggered by right mouse button (558)
- agenda view left axis sized incorrectly (465)
- IE js error when calendar is too narrow (517)
- agenda view looks strange when no scrollbars (235)
- improved parsing of ISO8601 dates with UTC offsets
- $.fullCalendar.version
- an internal refactor of the code, for easier future development and modularity
- "dropping" external objects onto the calendar
- droppable (boolean, to turn on/off)
- dropAccept (to filter which events the calendar will accept)
- drop (trigger)
- selectable options can now be specified with a View Option Hash
- bugfixes
- support newlines in event titles
- select/unselect callbacks now passes native js event
- "selecting" days or timeslots
- options: selectable, selectHelper, unselectAuto, unselectCancel
- callbacks: select, unselect
- methods: select, unselect
- when dragging an event, the highlighting reflects the duration of the event
- code compressing by Google Closure Compiler
- bundled with jQuery 1.4.2 and jQuery UI 1.8.1
- lazyFetching option, which can force the calendar to fetch events on every view/date change
- scroll state of agenda views are preserved when switching back to view
- bugfixes
- optimized event rendering in all views (events render in 1/10 the time)
- gotoDate() does not force the calendar to unnecessarily rerender
- render() method now correctly readjusts height
- added destroy method
- Google Calendar event pages respect currentTimezone
- caching now handled by jQuery's ajax
- protection from setting aspectRatio to zero
- bugfixes
- parseISO8601 and DST caused certain events to display day before
- button positioning problem in IE6
- ajax event source removed after recently being added, events still displayed
- event not displayed when end is an empty string
- dynamically setting calendar height when no events have been fetched, throws error
- eventAfterRender trigger
- getDate & getView methods
- height & contentHeight options (explicitly sets the pixel height)
- minTime & maxTime options (restricts shown hours in agenda view)
- getters [for all options] and setters [for height, contentHeight, and aspectRatio ONLY! stay tuned..]
- render method now readjusts calendar's size
- bugfixes
- lightbox scripts that use iframes (like fancybox)
- day-of-week classNames were off when firstDay=1
- guaranteed space on right side of agenda events (even when stacked)
- accepts ISO8601 dates with a space (instead of 'T')
- can exclude weekends with new 'weekends' option
- gcal feed 'currentTimezone' option
- bugfixes
- year/month/date option sometimes wouldn't set correctly (depending on current date)
- daylight savings issue caused agenda views to start at 1am (for BST users)
- cleanup of gcal.js code
- agendaWeek and agendaDay views
- added some options for agenda views:
- allDaySlot
- allDayText
- firstHour
- slotMinutes
- defaultEventMinutes
- axisFormat
- modified some existing options/triggers to work with agenda views:
- dragOpacity and timeFormat can now accept a "View Hash" (a new concept)
- dayClick now has an allDay parameter
- eventDrop now has an an allDay parameter (this will affect those who use revertFunc, adjust parameter list)
- added 'prevYear' and 'nextYear' for buttons in header
- minor change for theme users, ui-state-hover not applied to active/inactive buttons
- added event-color-changing example in docs
- better defaults for right-to-left themed button icons
- Bugfixes (please upgrade from 1.3.1!)
- squashed potential infinite loop when addMonths and addDays is called with an invalid date
- $.fullCalendar.parseDate() now correctly parses IETF format
- when switching views, the 'today' button sticks inactive, fixed
- gotoDate now can accept a single Date argument
- documentation for changes in 1.3.1 and 1.3.2 now on website
- Important Bugfixes (please upgrade from 1.3!)
- When current date was late in the month, for long months, and prev/next buttons were clicked in month-view, some months would be skipped/repeated
- In certain time zones, daylight savings time would cause certain days to be misnumbered in month-view
- Subtle change in way week interval is chosen when switching from month to basicWeek/basicDay view
- Added 'allDayDefault' option
- Added 'changeView' and 'render' methods
- different 'views': month/basicWeek/basicDay
- more flexible 'header' system for buttons
- themable by jQuery UI themes
- resizable events (require jQuery UI resizable plugin)
- rescoped & rewritten CSS, enhanced default look
- cleaner css & rendering techniques for right-to-left
- reworked options & API to support multiple views / be consistent with jQuery UI
- refactoring of entire codebase
- broken into different JS & CSS files, assembled w/ build scripts
- new test suite for new features, uses firebug-lite
- refactored docs
- Options
-
- date
-
- defaultView
-
- aspectRatio
-
- disableResizing
-
- monthNames (use instead of $.fullCalendar.monthNames)
-
- monthNamesShort (use instead of $.fullCalendar.monthAbbrevs)
-
- dayNames (use instead of $.fullCalendar.dayNames)
-
- dayNamesShort (use instead of $.fullCalendar.dayAbbrevs)
-
- theme
-
- buttonText
-
- buttonIcons
- x draggable -> editable/disableDragging
- x fixedWeeks -> weekMode
- x abbrevDayHeadings -> columnFormat
- x buttons/title -> header
- x eventDragOpacity -> dragOpacity
- x eventRevertDuration -> dragRevertDuration
- x weekStart -> firstDay
- x rightToLeft -> isRTL
- x showTime (use 'allDay' CalEvent property instead)
-
- Triggered Actions
-
- eventResizeStart
-
- eventResizeStop
-
- eventResize
- x monthDisplay -> viewDisplay
- x resize -> windowResize
- 'eventDrop' params changed, can revert if ajax cuts out
-
- CalEvent Properties
- x showTime -> allDay
- x draggable -> editable
- 'end' is now INCLUSIVE when allDay=true
- 'url' now produces a real tag, more native clicking/tab behavior
- Methods:
-
- renderEvent
- x prevMonth -> prev
- x nextMonth -> next
- x prevYear/nextYear -> moveDate
- x refresh -> rerenderEvents/refetchEvents
- x removeEvent -> removeEvents
- x getEventsByID -> clientEvents
-
- Utilities:
- 'formatDate' format string completely changed (inspired by jQuery UI datepicker + datejs)
- 'formatDates' added to support date-ranges
- Google Calendar Options:
- x draggable -> editable
- Bugfixes
- gcal extension fetched 25 results max, now fetches all
- bugfixes
- allows and corrects invalid end dates for events
- doesn't throw an error in IE while rendering when display:none
- fixed 'loading' callback when used w/ multiple addEventSource calls
- gcal className can now be an array
- expanded API
- 'className' CalEvent attribute
- 'source' CalEvent attribute
- dynamically get/add/remove/update events of current month
- locale improvements: change month/day name text
- better date formatting ($.fullCalendar.formatDate)
- multiple 'event sources' allowed
- dynamically add/remove event sources
- options for prevYear and nextYear buttons
- docs have been reworked (include addition of Google Calendar docs)
- changed behavior of parseDate for number strings (now interpets as unix timestamp, not MS times)
- bugfixes
- rightToLeft month start bug
- off-by-one errors with month formatting commands
- events from previous months sticking when clicking prev/next quickly
- Google Calendar API changed to work w/ multiple event sources
- can also provide 'className' and 'draggable' options
- date utilties moved from $ to $.fullCalendar
- more documentation in source code
- minified version of fullcalendar.js
- test suit (available from svn)
- top buttons now use
<button>
w/ an inner<span>
for better css cusomization- thus CSS has changed. IF UPGRADING FROM PREVIOUS VERSIONS, UPGRADE YOUR FULLCALENDAR.CSS FILE
- Added the following options:
- weekStart
- rightToLeft
- titleFormat
- timeFormat
- cacheParam
- resize
- Fixed rendering bugs
- Opera 9.25 (events placement & window resizing)
- IE6 (window resizing)
- Optimized window resizing for ALL browsers
- Events on same day now sorted by start time (but first by timespan)
- Correct z-index when dragging
- Dragging contained in overflow DIV for IE6
- Modified fullcalendar.css
- for right-to-left support
- for variable start-of-week
- for IE6 resizing bug
- for THEAD and TBODY (in 1.0, just used TBODY, restructured in 1.1)
- IF UPGRADING FROM FULLCALENDAR 1.0, YOU MUST UPGRADE FULLCALENDAR.CSS