Solgema.fullcalendar 2.1.1

Solgema Fullcalendar is a complete Agenda based on Adam Shaw's Fullcalendar into Plone

Solgema.fullcalendar Package Readme
===================================

Overview
--------

Solgema.fullcalendar is a complete implementation of Adam Shaw Fullcalendar into Plone.
More info on Fullcalendar here: http://arshaw.com/fullcalendar/

This calendar allows you to display events type objects in a powerfull and fast ajax agenda.
You will be also able to add, edit and more generally manage your events throught the Calendar
with a strong AJAX framework.

The calendar is a view you can choose on a Topic, on a Folder or on an Event.
The view is named "solgemafullcalendar_view".
After that, a new object action permits you to set up the basics parameters for the calendar.

On a Topic, the calendar displays the events that are searched by the Topic and
it's criterias.

On a Folder, the calendar displays the events that are contained in the Folder itself or in
the sub-folders if they are selected in the calendar properties.

In addition to the calendar, there is a small query form you can display in the bottom of
the calendar to choose which event you want to display. The fields in this query form are
taken from the Topic's Criterions or from the subfolders of the Folder.

As a developer, you can add event sources to default one.
You just have to define named IEventSource adapters which provides each a list of dictionaries
needed by fullcalendar.js API.
You can also replace the default event source providing an unnamed IEventSource
adapter for your specific context or layer.

Installation Note for Plone 3.x
-------------------------------
Add this line in the eggs section of your buildout.cfg

eggs=
...
collective.js.jquieryui<1.8

You will also have to ping the versions for plone.app.z3cform

[versions]
...
z3c.form = 1.9.0
zope.i18n = 3.4.0
zope.testing = 3.4.0
zope.component = 3.4.0
zope.securitypolicy = 3.4.0
zope.app.zcmlfiles = 3.4.3
plone.app.z3cform = 0.4.6

Customizing the skin
--------------------
You can easyly customize de calendar skin:

Go to http://jquieryui.com and click on the Themes tab.
There you can create or choose an existing theme. After that, download it to your computer by selecting only:
All UI Core, all UI Interactions and Dialog in UI Widgets. Unzip and copy the css file and all images in you
portal_skins/custom folder.

You can also try collective.jqueryuithememanager_

.. _collective.jqueryuithememanager: http://plone.org/products/collective.jqueryuithememanager


Changelog
=========

2.1.1 (unreleased)
------------------

- Fixed some bugs in the adapters and actions ("KeyError: Type" when adding event and "ComponentLookupError"
when workflow transition.)
[fmoret]

2.1.0 (2012-05-15)
------------------

- Added the fullcalendar_view for Folders. The view displays the events in the folder or use each subfolder as source.
[fmoret]

- Added the ability to add Google Calendar Sources to the fullcalendar in addition to Plone standard source.
[fmoret]

- Added Calendar widget to easily change the fullcalendar date.
[fmoret]

- Restored Plone 3.3.x compatibility
[fmoret]

- Added DaySplit View which shows the events in seperate columns regarding the selected collection criteria.
[fmoret]

- Use eventSources instead of events to get Events. Delegate the event's color attribution to fullcalendar.
[fmoret]

- Fix height of iframe in the popup for adding events in IE.
[pbauer]

- Created New 2.1.0 version as fullcalendar will no more be compatible with Plone under 4.x
[fmoret]

2.0.3 (2012-04-12)
------------------

- Fix infinite recursion error in SolgemaFullcalendarEventJS's __init__ method.
[pbauer]

- Fixed ical export on collection with plone.app.event installed.
[vincentfretin]

- Prevent that all pages become non-cacheable.
SolgemaFullcalendarActionGuards wrongly inherited from BaseActionView which
sets "Pragma: no-cache".
[weberlar]

- Many fixes on paste event feature.
[thomasdesvenain]

- Reccurence support uses adapter.
[thomasdesvenain]

- Added solgemafullcalendar_view for events also. (very useful with
recurring events with a lot of occurrences)
[fmoret]

- Add z3c.autoinclude to target plone. No more need to include zcml in buildout
[toutpt]

- Check also for portal_type in the Topic query (not just 'Type').
[jcbrand]

- Hide the spinner after closing the add/edit event dialogs.
[jcbrand]

- Add a zcml browser:menuItem entry to give the dynamic view a human readable title.
[jcbrand]

- Add collective.js.fullcalendar as dependency in metadata.xml
[jcbrand]

- Add Italian translation
[giacomos]

- Add needed jqueryui plugins explicitly using registry.xml step
[toutpt]

- Add Nederlands translation
[cirb]

2.0.2 (2011-11-28)
------------------

- Fixed a bug on SFAllowedRolesAndUsersModify index
that could make cut/paste actions fail on whole site.
[thomasdesvenain]

- Fixed ical export.
[thomasdesvenain]

- Calendar export works with plone.app.event future.
[thomasdesvenain]

2.0 (2011-10-18)
----------------

- Dependencies: Added collective.js.fullcalendar to product dependencies
so that it installs automatically.
[fmoret]

- Fixed: Event adding/editing popupu is now resized on scroll to get the
correct height.
[fmoret]

- Added: Extra css class added on events in calendar are now queries by
adapters.
[fmoret]

- Fixed: Changed static CSS selectors (for undefined colors) so colors
get applied correctly.
[thomasdesvenain]

- UI: a lock icon in displayed on private events.
[thomasdesvenain]

- ICal export of future events.
[thomasdesvenain]

- API: If event do not have a 'type-x' class,
it is not displayed with a SF_x_light view in a popup,
but a new window is open.
[thomasdesvenain]

- UI: query criterion labels are clickable.
[thomasdesvenain]

- Fixed: we needed 'Modify portal content' on calendar
to change the transition of an event.
Transition permission on event itself is enough.
[thomasdesvenain]

- Optimization: Huge optimization on calendar events getting.
(More than 10 times faster)
[thomasdesvenain]

- API: Source of events are now adapters that can be customized.
Provide an IEventSource adapter for a specific layer or context
to get the list of events to display (or to export under ical).
Adapter without a name will replace default source event.
Adapter with a name will add a source event to default one.
[thomasdesvenain]

- API: Code cleanup to make color management easier to customize.
- Cleanup component registration so that color filter is easier to customize.
- Use an adapter to get event brain classes.
[thomasdesvenain]

- Refactor: remove solgemafullcalendar_ prefix from most module names.
[thomasdesvenain]

- Refactor: Use collective.js.colorpicker and collective.js.fullcalendar package
instead of embedding code.
[thomasdesvenain]

- Fixed: Fixed date formats in french.
[thomasdesvenain]


1.10 (2011-08-16)
-----------------
- Internationalization: Updated english translation Solgema.fullcalendar.po
[fmoret]

- Fixed: Changed generated CSS selectors for events on fullcalendar so colors
get applied correctly.
[davidjb]

- Fixed: Avoid CSS generation throwing an error if colors haven't been
specified yet and we have a non-existing colors dict.
[davidjb]

- Fixed: Allow add menu to display even if the current context (doesn't have
a query specified yet.
[davidjb]

- Internationalization: Allow calendar properties form buttons to have a
default English translation.
[davidjb]

- Internationalization: Fixing some French messages in the English translation.
[davidjb]


1.9 (2011-06-16)
----------------

- The ui-lightness skin for jqueryui has been removed. You can add your own
jqueryui skin if you want to.
[fmoret]

- Added the possibility to choose short day name format
(short: 2 characters or abbreviated: 3 characters).
[fmoret]

- Fixed: week-view didn't translate saturday.
[pbauer]

- Upgrade to fullcalendar-1.5.1. Remove unused js-files/
[pbauer]

- Add german translation and german date-formats
[pbauer]

- Show reccurring events if plone.event is available.
[vincentfretin]

- Security: use 'Change portal topics' permission
to manage access to Calendar properties.
[thomasdesvenain]

- Security: check 'Add portal content' permission on target folder
instead of 'Modify portal' content on calendar
to allow adding an event on the calendar.
[thomasdesvenain]

- Fixed: disallow caching ajax action views,
to avoid issues behind cache proxies.
[thomasdesvenain]

- Fixed: event popup is translated.
[thomasdesvenain]

- Fixed: adding 'all day' event add an event from 00:00 to 23:55.
[fmoret]

- Fixed: remove duplicated scroll in popup.
[thomasdesvenain]

- Fixed: closing popups after an event has been added works.
[fmoret]

- Internationalization: translation files generation with i18ndude.
[thomasdesvenain]

- Internationalization: fixed event popup translation.
[thomasdesvenain]

- Internationalization: calendar parameters tab
and calendar display layout are internationalized and french translated.
[thomasdesvenain]

- Infrastructure : timezones forward compatibility.
[vincentfretin, thomasdesvenain]

- Infrastructure : plone.app.event forward compatibility :
event view uses event_view macros by default,
never use direct access to startDate and endDate attributes for timezones compatibility.
[vincentfretin]

- Infrastucture: use Generic setup to install some dependencies.
[thomasdesvenain]

- Infrastucture: hide upgrade profiles on Plone site creation form.
Upgrade profiles don't appear in root profiles.
[thomasdesvenain]

- Pep8 & pyflakes.
[thomasdesvenain]

- Plone 4.1 compatibility.
[thomasdesvenain]

- Imported Solgema.fullcalendar in collective.
[fmoret, thomasdesvenain]


1.8
---

- Clicking on an event always asks for SFLight_event_view.pt. Allows the use of xdv theming
(thanks to Sylvain Boureliou)

- Comes with ui lightness 1.8.9 theme

1.7
---

- Removed own jqueryui and added collective.js.jqueryui (Thanks to Thomas Desvenain)

- Fixed views and javascript files (fix issue #17 and #20, Thanks to Christian Lederman!)

- Fixed dependencies declarations (Thanks to Olav Peeters)

- Added a small workaround to solve a conflict between base jqueryui css and custom jqueryui lightness css.

- Based on fullcalendar 1.4.10 (Thanks to Adam Arshaw)

1.6
---

- Fixed wrong call to getUrl method and completed with here/absolute_url

- Fixed bad condition expression in actions (Thanks to Thomas Desvanain)

- Added some steps to be sure (as sure as possible) that solgemafullcalendar_view remains in topic views

1.5
---

- Fixed adapting content that is not attribute annotable.
(changed indexer in catalog.py ) that fixes bug with plone.app.discussion.

- Fixed cancel button and dialog close when editing. The edited event remained locked when closing dialog.

- Fixed content type for solgemafullcalendar_vars.js


1.4
---

- Now based on Fullcalendar v 1.4.8

- Fixed IE7 bug (thanks to Kyle Homstead)

- Added the subtopics display in solgemafullcalendar_view (thanks to Christian Ledermann)

- Added a <noscript> tag in solgemafullcalendar_view so that events are display even if javascript is not enabled.
This can be disabled in Calendar View settings. (thanks to Christian Ledermann)

1.3
---

- Added the ability to choose your own color for events in the calendar. The color is linked to the topic's critrias.

- Added colorpicker widget to choose the colors in Calendar View settings

- Fixed Content Menu showing under calendar events


1.2
---

- Fixed calendar Height Setting

- Using now jquery ui 1.8.5 (added javascripts for 1.8.5 and removed 1.8.4)

1.1
---

- Created an adapter to filter for editable events so that it can be easily overriden.

- Solgema.ContextualContentMenu package included in configure.zcml

- Installs Solgema.ContextualContentMenu properly

- Fix jquery.js to 1.4.2 version (jquery.js added in skins directory)

- Fix height dialog box

- Added an override review_state in topic query for Admins so that the can see private events in calendar
Event if they are not searched basically by the topic (e.g. for default events aggregator)


1.0
---

- Added relative start hour and relative start day

- Fixed paste action in contextual content menu (when nothing in clipboard)

- Fixed error when deleting topic's criterion after having set them in calendar view criterias.

- Several bug fixed


0.3
---

- Added automatic dependencies installation in install.py ( installation of Solgema.ContextualContentMenu )

- Changed the javascript in SFAjax_base_edit.cpt so that when editing through calendar,
the dialog's iframe is resized to display the entire edit form ( fixes issue #1 )

- Changed Dialog title when adding content
(msgid was "label_add_type" in Plone 3 and now 'heading_add_item' in Plone 4).


0.2
---

- Added a topicRelativeUrl variable into solgemafullcalendar_vars to fix the cookies path.
(fix an issue with mutiple cookies when the topic is default view of a folder)