Skip to content

Commit

Permalink
Edited README.md and LICENSE
Browse files Browse the repository at this point in the history
  • Loading branch information
Samuel Lüscher committed Jan 5, 2010
1 parent a1204e2 commit 653235c
Show file tree
Hide file tree
Showing 2 changed files with 76 additions and 0 deletions.
28 changes: 28 additions & 0 deletions LICENSE
Original file line number Original file line Diff line number Diff line change
@@ -0,0 +1,28 @@
Copyright (c) 2009, Samuel Luescher
All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are
met:

* Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the above
copyright notice, this list of conditions and the following
disclaimer in the documentation and/or other materials provided
with the distribution.
* Neither the name of the author nor the names of other
contributors may be used to endorse or promote products derived
from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
48 changes: 48 additions & 0 deletions README.md
Original file line number Original file line Diff line number Diff line change
@@ -0,0 +1,48 @@
Django Form Designer
====================

A Django app for building many kinds of forms visually, without any programming knowledge.

Features:

* Design contact forms, search forms etc from the Django admin, without writing any code
* Form data can be logged, sent via e-mail or forwarded to any web address
* Integration with Django CMS (add forms to any page)
* Use drag & drop to change the position of your form fields
* Fully collapsible admin interface for better overview over your form
* Implements many form fields included with Django (TextField, EmailField, DateField etc)
* Validation rules as supplied by Django are fully configurable (maximum length, regular expression etc)
* Customizable messages and labels
* Supports POST and GET forms

Installation
------------

Add the form_designer app to your INSTALLED_APPS setting.

"form_designer",

Add the form_designer URLs to your URL conf. For instance, in order to make a form "example-form" available under http://domain.com/forms/example-form, add the following line:

(r'^forms/', include('form_designer.urls')),

If you are using the form_designer plugin for Django CMS, this second step is not necessary.

Optional requirements
---------------------

* form_designer supports [django-notify](http://code.google.com/p/django-notify/). If it is installed in your project, it will be used for success and error notifications.

* The form_designer admin form requires jQuery and the jQuery UI Sortable plugin to make building forms a lot more user-friendly. The two Javascript files are bundled with the form_designer app. If you want to use you own jquery-*.js and jquery-ui-*.js instead, define JQUERY_JS and JQUERY_UI_JS in your settings file. For instance:

JQUERY_JS = 'jquery/jquery-latest.js'

Known issues
------------

* Redirection after successful form submission currently doesn't work if used with Django CMS.

Missing features
----------------

* File upload fields will be implemented

0 comments on commit 653235c

Please sign in to comment.