monet.calendar.star

A complete and modular site calendar application for Plone

Project Description

Introduction

The Monet Calendar suite (also monet.calendar.star) is a complete event managing solution for Plone, inspired by needs of the City of Modena. Is widely used there for managing all kind of events.

This is only a transitional package, for downloading and installing all other products in the suite in a simple way.

Features

We want to give to Plone an event type that:

  • hide totally the "time" data (managed as simple text)
  • give a closed (but configurable) set of type of events
  • the days of weeks where really the event take place
  • be able to manage special days where the event don't take place
  • a lot of additional text information
  • an advanced search feature

See the monent.calendar.event page for know how to configure the event.

Searching events

Additionally one (at least) or more Plone folders can be marked as "Calendar section" in a new "Calendar" menu.

The new Calendar menu

Entries inside the new "Calendar menu"

This mean that this folder can use the "Calendar view" that show events in the current day, taken (by default, see below) from all the site events. This search take care of counting exceptions and days of the week of events.

Single day view

The "Calendar view"

Every event (and the also calendar sections) will also show a new "search" section at the top. This form can be used to perform a search on events of the calendar.

As new events looks like

The search form on events

The form can be used to expand the search to more than one day, showing a summary of all events, per-day

Search results on multiple days

Search results on multiple days

Use multiple calendar: "Calendar root" sections

Using again the "Calendar menu" you can also mark folders as "Calendar root". This is useful when using a Plone filled of subsites, where you can have a main calendar that look at every event in the site, but also additional sub-calendars (inside many calendar roots).

When a calendar perform searches inside a Calendar root, it will only look for events inside the calendar root itself.

A calendar outside a Calendar root looks for all events in the site.

Search results on multiple days

Same search above, but on a local calendar ("Subsite 1" there is a "Calendar root" section)

New calendar portlet

The calendar construction is expensive, and not good to be used in a portlet of the site, where is visible (in the worst case, also not cached) in every page of the site.

When you install the monet.calendar.extension product, the calendar portlet is replaced with a version that:

  • not show anymore events in a specific day
  • every cell is a link that perform a day-search in the nearest calendar

"Nearest calendar" mean that if the visitor is inside a "calendar root" section he will be moved to the calendar of that section, otherwise a global calendar section will be used.

You can also install an additional portlet from the monet.calendar.portlet product. This portlet gives you a way to select a calendar section in the site, then display it in a portlet (in the same way you can see him in the calendar section itself).

Note

The portlet is designed to be used with collective.portletpage. Using it in a narrow column portlet must be fixed by your Plone theme!

New collection criteria

You can use the monet.calendar.criteria for beeing able to create collection that looks for events taking care of event's filters parameter.

Special event types

From ZMI (see also monet.calendar.event configuration) you can specify one or more event type as "special". Those are then highlighted in the single day view, below the categorizations done for the time of event.

Examples:

  • Morning
  • Afternoon
  • Evening
  • YouEventType

Dependencies tree

You can freely install single components of the suite, that are:

  • monet.calendar.event
    • rt.calendarinandout
      • collective.js.jqueryui
  • monet.calendar.extensions
  • monet.calendar.portlet (optional, see above)
  • monet.calendar.criteria
  • monet.calendar.location (optional, and not covered by this package. It contains Modena's and italian specific patch... you probably don't need this. Really)

Requirements

The monet.calendar.star solution works onto:

  • Plone 3.3
  • Plone 4
  • Plone 4.1

Migrating from older release

If you have a Plone site where you used and old version of monet.calendar.event (older than 0.4) you probably need to add to your buildout the historical monet.recurring_event (0.7 or better.)

Authors

This product was developed by RedTurtle Technology team.

RedTurtle Technology Site

Self-Certification

[X] Internationalized

[ ] Unit tests

[X] End-user documentation

[X] Internal documentation (documentation, interfaces, etc.)

[X] Existed and maintained for at least 6 months

[ ] Installs and uninstalls cleanly

[ ] Code structure follows best practice

Current Release
monet.calendar.star 1.0.0

Released Mar 18, 2011 — tested with Plone 4, Plone 3

First public release
More about this release…

Download file Get monet.calendar.star for all platforms
monet.calendar.star-1.0.0.tar.gz
If you are using Plone 3.2 or higher, you probably want to install this product with buildout. See our tutorial on installing add-on products with buildout for more information.

All Releases

Version Released Description Compatibility Licenses Status
1.2.0 Better 4.1 compatibility, and new features More about this release…
Plone 4.1
Plone 4
Plone 3
GPL beta
1.1.0 Added the new monet.calendar.portlet to the suite More about this release…
Plone 4
Plone 3
GPL beta
1.0.0 Mar 18, 2011 First public release More about this release…
Plone 4
Plone 3
GPL final