How to install p4a.plonecalendar
- Download and install ActivePython
- Open Command Prompt
- Type
pypm install p4a.plonecalendar
Lastest release
Overview
p4a.plonecalendar provides nice calendaring views for Plone, specifically a Month, Week and Day view, and also nice lists of past and previous events.
There are today better calendaring views for Plone, specifcally solgema.fullcalendar. However, that's a JavaScript calendar, so if you need a calendar that you can use without JavaScript, for example for accessibility reasons, then p4a.plonecalendar is a good choice.
Upgrading from version 2.0
p4a.plonecalendar 2.1 removes the dependency on p4a.subtyper. As a result upgrading to p4a.plonecalendar can be a bit of work.
Step 1:
Firstly you need to add p4a.subtyper to your buildout.cfg.
Under [instance] add "4a.subtyper" to the eggs property, remove p4a.plonecalendars zcml entries and replace them with p4a.subtypers zcml entries. The result should look something like this:
[instance] ...
- eggs =
- Plone p4a.plonecalendar p4a.subtyper ${buildout:eggs}
- zcml =
- p4a.subtyper p4a.subtyper-meta
Run buildout and restart the server.
Step 2:
- Go to the ZMI and open the Upgrades tab of portal_setup:
- http://yourplonesite/portal_setup/manage_upgrades
Choose the p4a.plonecalendar:default profile, and the upgrade named "Upgrade to 2.1: Remove all marker interfaces" should be visible. Select it and press "Upgrade."
Step 3:
- Then go to the quickinstaller:
- http://yourplonesite/portal_quickinstaller/manage_installProductsForm
Here, reinstall P4A Plone Calendar. You will after this have to go to all calendars and select a Calendar View as default view again.
Step 4 (optional):
If you have no other parts of Plone4Artists installed you can also uninstall Plone4Artists Subtyper, and remove it from the buildout.cfg.
Installation
- Add p4a.plonecalendar as a dependency either to your buildout:
[buildout] eggs = p4a.plonecalendar
- Include p4a.plonecalendar ZCML:
[instance] zcml = p4a.plonecalendar
Notes
Importing an iCalendar file via http
Plone4Artists calendar can import an iCalendar file over http into a Plone calendar. This is useful for example if another site presents a schedule that you also want to present or integrate into your site.
An example url for importing an icalendar file over http is:
http://path/to/calendar/import_from_url?url=http://url/to/icalendarfile.ics
This will open up a connection to the other site, get the icalendar file called "icalendarfile.ics" and import it into the folder located at /path/to/calendar/
Credits
- Maintainer, Lennart Regebro - regebro (at) gmail.com
- Rocky Burt - rocky (at) serverzen.com
- Nate Aune - natea (at) jazkarta.com
Changelog
2.1 (2013-05-21)
This version was tested with Plone 4.0.10, 4.1.6, 4.2.5, Plone 3 is no longer supported, but may still work.
- Don't depend on p4a.calendar [tomgross]
- Use jQuery instead of KSS. [regebro]
- New buildouts for development on various Plone versions. [regebro]
2.1b1 (2012-08-04)
This version was tested with Plone 3.3.5, Plone 4.1.6 and Plone 4.2.
- ignore cases where ICalendarSupport is already properly uninstalled on uninstall step. [iElectric]
- Added support for i18n. [macagua]
- Added support for Spanisn translation. [macagua]
- make views subclass Products.Five.browser.BrowserView so that their templates can be customized through portal_view_customizations. [swampmonkey]
- Removed tests for p4a.ploneevent. It hasn't had any new users since 2009, afaik. [regebro]
- No longer uses p4a.subtyper. The calendar views are just normal views. [regebro]
- Added upgrade step to get rid of all marker interfaces, etc. This also means we no longer need an uninstall, and therefore also no Extensions/Install.py so they have also been removed. [regebro]
- Now uses the z3c.autoinclude.plugin. [regebro]
- Added Plone 4.1 and 4.2 support. [regebro]
2.0a7 (2010-08-01)
- Update profile installation to work with GenericSetup 1.6.x. [davisagli]
- Made IObjectModifiedEvent import location conditional for compatibility with Zope 2.12. [tom_gross]
2.0a6 (2009-08-07)
- The import link is no longer shown in Topics. [regebro]
2.0a5 (2009-07-05)
- Removed p4a.ploneevent as a dependency. It's not required. [regebro]
2.0a3 (2009-05-17)
- Fixed issue where a TopicEventProvider died on topics with no criteria. This fixes #152 [claytron]
- Fixed an issue where a recurring event would show up in TopicEventProvider results no matter what the criteria on the topic were. [claytron]
- Added uninstalling support, which fixes #168. [regebro]
- Updated wording to be consistent with other iCal/vCal actions. [aaronvanderlip]
- Fixed an issue where a recurring event would show up in TopicEventProvider results no matter what the criteria on the topic were. [lucielejard]
- Fixed Trac #138 (fixing daily 'Add...' link so it defaults start/end dates to the proper day) by building a portal_factory link with startDate and endDate query string parameters for each day. [brianfive]
- Re-enabled the import UI by adding beforecontent viewlet that shows icon and link. [aaronvanderlip]
2.0a2 (2008-10-04)
- Implemented the canCreate method for the ATEventCreator so that the 'Add...' does not show for anonymous. [claytron]
- Updated the way we get all the events in the exportCalendar method and added parameters for restricting the export. [lucielejard]
- Various fixes in the recurring event support.
2.0a1 (2008-07-09)
- Reworked to use dateables views and interfaces instead of p4a.calendar.
- Package is now installable via CMFQuickInstaller.
- Dependentent package slugs are now included (meta and regular).
1.1 (2008-04-12)
- Updated documentation
- Fixed some install bugs under Plone 2.5.
1.1b1 (2008-02-20)
- Plone 3 support
- Now uses p4a.subtyper
- Various timezone fixes, and some minor fixes.
1.0 (2007-10-14)
- Fixed issue #24 where folders created by uploading ICS files via webdav were not becoming calendar enhanced [Rocky Burt]
- Fixed issue #41 where regular users couldn't activate their own folders to be calendars [Rocky Burt]
1.0rc1 (2007-07-31)
- Many bug fixes resulting from the Boston 2007 P4A sprint
- #40 - Events not displayed in Month View on Windows IE6. Default install would not display events in IE 6. Rob Baker supplied fix.
- #39 - Timezone issue when exporting to iCal. Issue is resolved. It was an old version of DateTime.py that caused the trouble. Replacing the file with the new version (available at zope.org) solved the problem.
- #38 - Time formatting for internationalization. P4A Calendar now uses the i18n library to convert the hour/minute format to the locale based on the language of the incoming browser request. This change removed several methods on the Month class that were formally handling this formatting chore. However, this new code does not have any tests written against it.
- #36 - Event starting in the past, ending in the future is not listed. The submitter of the original bug supplied a patch. The patch was applied to the code base and tested. We concluded that the patch solves this issue.
- #35 - KeyError causes month view to crash
- #34 and #37 - Bug deals with a site breakage when the P4A product is removed from the file system. This occurs after marker interfaces are set on containerish objects. Rocky Burt concluded that this is a core Zope issue and provided a workaround is to remove all marker interfaces for P4A when uninstalling the product via the QuickInstaller. Reinstall does not affect the marker interface settings. The drawback is that if the product is uninstalled all site setting dealing with the calendar will be lost. But it was considered worse to have a product that breaks a site with its removal from the files system. The long term solution will have to come from Zope core.
- #30 - Changing folder back to normal causes error.
- #28 - Events with future month don't show up
1.0beta1 (2007-04-29)
- Various bugfixes
1.0alpha2 (2007-01-14)
- Fixed bug where URL retrieval was getting the brain's incorrect URL [Lennart Regebro]
- Now has support for setting up a site/portal which means calendaring functionality is only available after this has been performed on the site/portal [Rocky Burt]
- Added support to import iCalendar from a remote URL [Lennart Regebro]
- Added support for add links [Lennart Regebro]
1.0alpha1 (2006-10-21)
- First release with unrecorded set of functionality [Rocky Burt]