Skip to main content
Help us improve Python packaging – donate today!

Recurrence widgets for Plone

Project Description

Introduction

The plone.formwidget.recurrence package provides an Archetype and a z3cform widget for recurrence.

The main GUI work is done with the jquery.recurrenceinput.js widget from http://github.com/collective/jquery.recurrenceinput.js .

This widget also provides a simple textarea where a RFC 5545 compliant recurrence rule can be entered, if javascript is not available.

The resulting value of the widget is a RFC5445 compliant recurrence rule string, ready to be used with python-dateutil’s rrulestr.

Installation

You need to add plone.formwidget.recurrence to either your buildout, or your product requirements. In this addition you should specify if you want the Archetypes or the z3c.form widget, or both. For example:

[buildout]
eggs += plone.formwidget.recurrence[archetypes]

or:

[buildout]
eggs += plone.formwidget.recurrence[z3cform]

or:

install_requires=[
   'plone.formwidget.recurrence[z3cform,archetypes]',
]

Usage

See plone/formwidget/recurrence/example .

For developers: Updating the javascript

The javascript files in plone/formwidget/recurrence/browser/lib comes from jquery.recurrenceinput.js. There is one modification needed:

In jquery.recurrenceinput.js there are two submit buttons near the end of the FORMTMPL definition:

'<div class="ributtons">',
    '<input',
        'type="submit"',
        'class="ricancelbutton"',
        'value="${i18n.cancel}" />',
    '<input',
        'type="submit"',
        'class="risavebutton"',
        'value="${i18n.save}" />',
'</div>',

When the javascript files are updated from jquery.recurrenceinput.form.js, these buttons need to have the “allowMultiSubmit” class, to prevent Plone’s warnings against clicking the same submit button multiple times. Add those to the buttons class, so it looks like this:

'<div class="ributtons">',
    '<input',
        'type="submit"',
        'class="ricancelbutton allowMultiSubmit"',
        'value="${i18n.cancel}" />',
    '<input',
        'type="submit"',
        'class="risavebutton allowMultiSubmit"',
        'value="${i18n.save}" />',
'</div>',

That is all the changes necessary, unless there are changes to the labels, in which case you need to update plone/formwidget/recurrence/browser/i18n.py and the translations to support the new labels.

Changelog

1.0b4 (2012-10-12)

  • jQueryTools DateInput localization fixed. [vsomogyi]
  • Updated to latest jquery.recurrenceinput.js (8db74cee2bd53794726591c5ac8c8b3814778cbc) to fix a problem with IE8 and older. [dokai]
  • Added Finnish translation. [dokai]

1.0b3 (2012-03-12)

  • By default, preselect the BYOCCURRENCES “End recurrence” field, so that recurrence rules with unlimited occurences are not selected by accident but intentionally (from jquery.recurrenceinput.js). [thet]
  • Include z3c.form’s meta.zcml, so widgetsTemplate directive is registered. [thet]
  • For conditional zcml incudes, use zcml:condition instead of zcml:provides. [thet]

1.0b2 (2012-02-28)

  • Reorganization to make it possible to install only the Archetypes or the z3c.form widget. [regebro]

1.0b1 (2012-02-01)

  • Initial release

Release history Release notifications

History Node

2.1.2

History Node

2.1.1

History Node

2.1.0

History Node

2.0.2

History Node

2.0.1

History Node

2.0

History Node

1.2.6

History Node

1.2.5

History Node

1.2.4

History Node

1.2.3

History Node

1.2.2

History Node

1.2.1

History Node

1.2

History Node

1.1

History Node

1.0

History Node

1.0b11

History Node

1.0b10

History Node

1.0b9

History Node

1.0b8

History Node

1.0b7

History Node

1.0b6

History Node

1.0b5

This version
History Node

1.0b4

History Node

1.0b3

History Node

1.0b2

History Node

1.0b1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
plone.formwidget.recurrence-1.0b4.tar.gz (55.5 kB) Copy SHA256 hash SHA256 Source None Oct 12, 2012

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page