Skip to main content

Utilities to auto save forms while user fills them

Project description

collective.autosaveform

The goal of this product is to save what user entered in a form and possibly repopulate the form when something bad happened (browser crash, lost internet access etc).

If available, it stores data entered in the browser’s local storage and sends them to the server to copy them. If the local storage is not available, it always sends the data to the server. If a problem arise, the form will be prepopulated when the user opens is again.

Installation

Add ‘collective.autosaveform’ to your list of eggs in the buildout. Run buildout again, then install it using Zope quick installer (or Plone product managment).

Sample

A form sample can be found at this address:

http://localhost:8080/<yourplonesite>/autosave_sample

Setting up forms

To enable auto saving of a form, you first need to add an ID to your form:

<form id="my_saved_form">
</form>

Then, you have to register it on the Python side. This can be done via an upgrade step for example:

from collective.autosaveform import config
from Products.CMFCore.utils import getToolByName

def register_form(context):
    tool = getToolByName(context, 'portal_autosaveform')
    try:
        tool.register_form('my_saved_form',
                           {'text_field': config.TEXT,
                            'radio_field': config.RADIO})
    except:
        # Log that the form was already registered.
        pass

When you process the form, you should also mark it as processed (so the data will not be filled again):

def process_form(...):
    # Process the form ...
    tool = getToolByName(context, 'portal_autosaveform')
    tool.mark_form_processed('my_saved_form')

Last step, in the template where your form is located, enable the jQuery plugin to have your form automatically saved:

<script type="text/javascript">
  jq('#my_saved_form').autosaveform();
</script>

You can have a look at the jQuery plugin for available options (collective/autosaveform/skins/autosaveform/jquery.autosaveforms.js).

Changelog

0.2 (2011-10-13)

  • Bugfix: calback was not called when the form is marked as processed. [vincent]

0.1 (2011-10-13)

  • Initial release

Project details


Download files

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

Source Distribution

collective.autosaveform-0.2.zip (32.8 kB view details)

Uploaded Source

File details

Details for the file collective.autosaveform-0.2.zip.

File metadata

File hashes

Hashes for collective.autosaveform-0.2.zip
Algorithm Hash digest
SHA256 4ca20abb76c3dc544536be356c1d26e4fe9a5f072caeff7214d353725a76af6c
MD5 2f7b5264c4488a744b64db56f0248ccd
BLAKE2b-256 d04a96b17ccafe55fae8005d21a292d4657ed76b7b6e3b40cdd3903da74c02d3

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page