Headline

This is just a quick note to say that Formunculous is compatible with Django 1.3 as far as I know, but that isn't to say it will be compatible out of the box with future point releases.

With that out of the way, I realize there hasn't been a whole lot of activity on this project or this site for a while. Part of the reason for that is that Formunculous has proven to be stable and have enough features such that I haven't had many situations where it hasn't been ready to tackle the next crazy Web form I get asked for. That said, I still have a desire to add in some kind of actions framework that will allow you to say, send an e-mail to the address in this field when completed for example. That should it make it more generally usable for forms that require notifications to the submitter and some other cases I've run into.

Also of note is that the server hosting this site should be moving to a new VPS shortly, and so I'll be quite busy with my after work admin hat on, as opposed to my after work developer hat on. I'm also hoping to finally switch to the git train for this project in the near future.

In other words, it may not look like this project has been updated in months, and you are right, but it isn't a dead or inactive project by any means. It has just been stable, and some of my more temperamental projects have needed attention.

This is a release in order to correct backwards incompatibilities introduced between version 1.2.4 and 1.2.5 of Django. Because it includes new media, if you are using setuptools/easy_install you will need to relink your media or at least add the csrf.js file to { MEDIA_ROOT }/formunculous/js/ in order to correctly handle Django 1.2.5 with the CSRF middleware

Bug Fixes

• Added csrf.js to the media and included it in all templates that make POST AJAX calls in order to add a CSRF token HTTP header to the request.

Django just released a security update yesterday to their 1.2 line of the framework (Release Notes) that breaks compatibility with the AJAX portions of Formunculous. I hope to get patches and a compatible release out in the next week, but for now if you apply the Django update many features will fail to operate correctly if the CSRF middleware is enabled on 1.2 sites.

This is a minor bug fix release with two minor additional features.

A big thank you to @lkraav ( http://leho.kraav.com/ ) for his help with getting translations working properly and the split multi value field display code.

New Features

• CSV Export now includes the application ID as a field
• Added template code to properly display multi-select field responses on the thank you and review pages (Courtesy of @lkraav)

Bug Fixes

• Fixed unicode handling in CSV export
• Added URLEncode filter for attached file links in thank you and review
• Fixed several spacing issues and missing trans/ugettext strings (Courtesy of @lkraav)
• For additional language support, I setup the apply.html base template to try and include a language specific date picker from http://jquery-ui.googlecode.com/svn/trunk/ui/i18n/ if a language other than en or en-us is selected:
  {{ MEDIA_URL }}formunculous/js/jquery.ui.datepicker-{{ LANGUAGE_CODE }}.js
  (You must add the specific js to that folder for it to work) (Courtesy @kraav)
• File type fields now properly check that the file name is less than the max length allowed in the model. There is still an edge case where the path plus the file name is too long. I have submitted a patch upstream to Django to fix this.
Posted by Carson Gee Updated on Saturday, 13 April 2013 13:26 CDT
Tags: Bugfix, Headline, Latest, Release

Here are the release notes for Formunculous 2.2.0. It is probably the last release in the 2.x series as I have a host of database model changes that have been building up for about six months. Head over to the download page to install it manually, or easy_install to grab it from the cheese shop.

New Features:

• Reviewer list is now a better widget and is searchable and sorted.
• Ordering for dropdown selections - done by ordering on non-displayed value (note added to dropdown iframe form to that effect).
• Update CKEditor to 3.4
• Change display of boolean values to be icon based.
• Icons for each of the currently written field types for easier field selection
• Template tag for rendering pre/post text as templates (including tags/filters, etc). Added to apply.html default template for rendering.
• Template tag for rendering a form anywhere.
• Static media linking/copying easier with manage.py command line extension of func_media_link for symlinking media and func_media_copy for copying the media.
• Better display of available for definitions (tr:hover added).

Bug fixes:

• Multi submit authenticated e-mail only forms weren't allowing multi-submit.
• There were several broken login type issues leftover from django 1.0.
• Storage duplicate slug across application definition issue resolved.
• If optional file field left blank, template error on null field resolved.
• Corrected language on confirmation screen of authenticated forms that may have lead users to believe the form was submitted when it hadn't been.
• Fixed form building checkbox labels to have proper labels and behavior
• Document types for the Document Field have been corrected to accept docx and odt

Formunculous 2.2.0 will probably be the last feature release without any database schema changes that Django makes somewhat problematic. This means this release will focus primarily on interface improvements and enhancements to existing features.

Here is a short list of some of the upcoming features and bug fixes:

• Template tag for including forms in any Django Template.
• Pre and Post text in forms will now render as templates. Allowing you to include template tags and filters in your form HTML.
• Updated CK Editor for WYSIWYG editing of HTML fields.
• Dropdown selection ordering of fields (will be further enhanced in model changing release).
• Icons for each of the field types to make identification of fields easier.
• Yes/No questions are now displayed as icons instead of True/False or 0/1.
• Reviewer list in form definition configuration page has been greatly enhanced (searchable and alphabetically sorted).

In addition to those features, here are some of the bug fixes:

• Storage system didn't work when file type fields had the same slug, even if in different application definitions.
• If optional file type field is left blank, the reviewing and thank you pages threw a template error.
• Form building checkbox labels weren't done properly.
• Language on the confirmation screen of authenticated forms caused user confusion.

With any luck, this release should become available within a few weeks. There are one or two features left to write, and then considerable integration testing.

The customization guide covers everything from simple CSS customization of all aspects of Formunculous to replacing entire built-in templates globally, to replacing the templates just for a single form definitions.

If you find mistakes, missing information, like it, etc. let me know in the comments or via the contact form and I will look into it post haste.

I just thought I would put it out there that I am aware that there are some minor incompatibilities with Formunculous 2.1.0 and Django 1.2. This includes both the CSRF framework addition as well as the backwards incompatible change with formsets. Both of these can be temporarily worked around by commenting out the CSRF middleware from your settings.py file if it is there:

...
MIDDLEWARE_CLASSES = (
...
#	django.middleware.csrf.CsrfMiddleware
...
)

and if you have is with sub-forms with the Max Forms value set to 0 sub-forms are no longer displayed. You will temporarily need to change from 0, to sufficiently high number to work around this until 2.1.1 is released.

The Production Install and Config Guide is finished over in the Documentation section, and should be quite useful for people having a hard time getting Func up and running in an standard Apache style Django installation.

It covers setuptools installation, the settings.py options Func needs, how to specify the url include, and how to get the static media working. I hope to get up a styling and customization guide in the near future to show how to use CSS rules to style func forms for your site, and completely customize individual forms and thank you pages using custom templates. So look for that in the near future.

Woohoo. I have the first piece of documentation up for Formunculous. This is one of the primary reasons for the creating this site, and I didn't really have of it completed when I first put this site up. It is a quick start guide for installing and running formunculous using the included configuration for the Django dev server.

I hope to have more detailed guides and reference documentation in the coming weeks, but for now, there is at least something to get you started experimenting with func. I also hope to have a video demonstration up in a bit to accompany the guide, so look for that in the near term.