rt.calendarinandout 1.2.0

A LinesWidget-like for Plone, used for selecting dates

Provides an Archetypes widget that allows to add and remove dates using the fancy jquery.ui.datepicker plugin

Table of contents

• Usage

  • Configuration

  • Screenshots

• Installation

  • TODO

• Credits

• Authors

• Changelog

  • 1.2.0 (2014-02-19)

  • 1.1.0 (2013-10-30)

  • 1.0.3 (2012-05-02)

  • 1.0.2 (2012-02-23)

  • 1.0.1 (2011-10-04)

  • 1.0.0 (2011-02-07)

  • 1.0.0-rc3 (2010-11-19)

  • 1.0.0-rc2 (2010-09-15)

  • 1.0.0-rc1 (Unreleased)

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!

Configuration

You can use following additional widget options:

auto_add

Instead of showing an “add date” button/icon, automatically add the date when selected on the calendar. Default is true.

allow_duplicate

Allow the selection of the same date more and more times. Default is false.

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

  

Installation

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

eggs=...
     rt.calendarinandout
     ...

After then, re-run your buildout, restart your instance and activate the rt.calendarinandout add-on.

TODO

• Complete internazionalization

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

• Gives to developer a way to control date format used

• Some artwork will be a nice plus :)

• Refactor JavaScript to not use global namespace

Credits

Developed with the support of:

• Rete Civica Mo-Net - Comune di Modena

  

• Regione Emilia Romagna

All of them supports the PloneGov initiative.

Authors

This product was developed by RedTurtle Technology team.

Changelog

1.2.0 (2014-02-19)

Plone 4.3 supported while dropped Plone 3

• Activate jQueryUI datepicker when installed [keul]

• Include icons in the product itself for Plone 4.3 compatibility [keul]

• All images loaded from site root, to be cache friendly [keul]

• Changed default value of auto_add to true [keul]

• HTML sanitize: removed duplicated id that origin validation errors [keul]

• Accessibility fixes: the widget can now be used with keyboard [keul]

1.1.0 (2013-10-30)

• removed any deprecated reference to jq [keul]

• do not pollute global namespace anymore [keul]

• fixed disabled option allow_duplicate [keul]

• when auto_add option is used, automatically clear the new date field [keul]

• code cleanup

1.0.3 (2012-05-02)

• Egg changes as we moved to github [keul]

• Enabled adding a date also with “enter” key [cekk]

1.0.2 (2012-02-23)

• Fix problem with widget activation on IE [lucabel]

1.0.1 (2011-10-04)

• fix the problem with duplicate widgets in one schema [amleczko]

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