rt.calendarinandout 1.0.0

A LinesWidget-like for Plone, used for selecting dates

Introduction

rt.calendarinandout provides an archetype widget that allows to add and remove dates using the fancy jquery.ui.datepicker plugin

Usage

The widget stores the information in to a LinesField archetype field. To use it just add a field like this in your archetype schema:

from Products.Archetypes.atapi import LinesField
from rt.calendarinandout.widget import CalendarInAndOutWidget

LinesField(
    'dates',
    widget = CalendarInAndOutWidget(
        label=u"Dates",
        description=u"Enter the dates in the form yyyy-mm-dd.",
        ),
)

Then you can start enjoyng this widget!

Screenshots

• The widget when no date is selected

  

• Data can be entered manually or clicking. If you click the calendar a nice datepicker will popup

  

• Clicking the plus the date will be added to the selected values, the red cross will remove the date

  

  You can also set the auto_add option for not displaying any “plus” icon, and add the date to the list when a date is selected.

• Add and remove all the dates you want

  

• With javascript disabled the widget is still fully functional, falling back to a normal textarea where you can insert dates manually

  

• In view the dates are rendered as an unordered list

  

Add this egg to your buildout

Direct installation

You can easily include rt.calendarinandout in your buildout by adding it in both in the eggs and zcml sections:

eggs=...
     rt.calendarinandout
     ...

zcml=...
     rt.calendarinandout
     ...

Triggering the installation from your own egg

If you are developing your own egg you can make it depend on rt.calendarinandout by following those three steps:

• add rt.calendarinandout it in the install_requires section of the setup.py of your egg:

  install_requires=[...
                    'rt.calendarinandout'
                    ...]

• add the dependency in your egg profiles/default/metadata.xml file:

  <?xml version="1.0"?>
  <metadata>
    <version>...</version>
    <dependencies>
      <dependency>profile-rt.calendarinandout:default</dependency>
    </dependencies>
  </metadata>

• add the dependency in the configure.zcml at the root of your package, including this line:

  <include package="rt.calendarinandout" />

Credits

Developed with the support of Comune di Modena; Comune di Modena supports the PloneGov initiative.

Authors

This product was developed by RedTurtle Technology team.

TODO

• Complete internazionalization

• Now duplicate values are forbidden, this should be an option

• Add an option to trigger the client side validation of the added date format

• Some artwork will be a nice plus :)

Changelog

1.0.0 (2011-02-07)

• No more fix the the collective.js.jqueryui version; leave this to buildouts [keul]

• removed “strip” non-standard method, replaced with a custom “.trim” method [keul]

• added the “auto_add” option, for automatically add dates to the field when they are selected [keul]

1.0.0-rc3 (2010-11-19)

• In view dates are rendered in an unordered list

• Added documentation

1.0.0-rc2 (2010-09-15)

• Fixed Javascript docstrings [keul]

• Removed unused locales directory [keul]

• Removed unused widget parameter “dateformat” [keul]

• Some relative URL are now absolute, not breaking browser cache [keul]

1.0.0-rc1 (Unreleased)

• Initial release