UserForms module provides a visual form builder for the SilverStripe CMS. No coding required to build forms such as contact pages.
Go to file
Will Rossiter 7cd37cf0a3 Merge pull request #7 from marcokernler/url-params
FEATURE: Allow pre filled form fields via url params
2012-04-13 18:01:01 -07:00
code Merge pull request #7 from marcokernler/url-params 2012-04-13 18:01:01 -07:00
css BUGFIX: fixed layout of FieldEditor in IE6 2010-09-21 06:14:09 +00:00
images MINOR: dropped in new icon set of the module. Thanks to Jan (eformation.de) 2011-05-09 09:27:56 +12:00
javascript BUGFIX: workaround for drag not firing when adding options 2011-12-05 21:57:34 +13:00
lang MINOR: update master lang file 2011-12-06 09:59:18 +13:00
templates Added another require line, so that the jquery-ui.custom.js is included. This is because this file was renamed in the post 2.4 branch of SS 2012-02-14 14:41:15 +11:00
tests BUGFIX: added exists() check on getFormFields (via Bruce Walter) to prevent fieldless forms. BUGFIX: if built form is empty still strip the $UserDefinedForm token out of the content. 2011-03-21 09:14:45 +13:00
thirdparty/jquery-validate BUGFIX: added validate plugin to module as 2.4 will not include the plugin. MINOR: changed path to jquery to not use jsparty folder 2009-12-07 00:37:20 +00:00
_config.php ENHANCEMENT Moved UserDefinedForm and related code, templates, CSS and javascript out of cms and sapphire classes into userforms/trunk 2008-09-29 03:18:23 +00:00
LICENSE MINOR: updated changelog to reflect 0.2 release 2009-07-26 22:30:27 +00:00
README.md MINOR - Added documentation to the readme 2011-12-20 22:07:40 +01:00

UserForms

Introduction

UserForms enables CMS users to create dynamic forms via a drag and drop interface and without getting involved in any PHP code.

Maintainer Contact

* Will Rossiter (Nickname: wrossiter, willr) `<will (at) fullscreen (dot) io>`

Requirements

  • SilverStripe 2.4.6+
  • PHP 5 >= 5.1.0 (fputcsv)

Features

  • Construct a form using all major form fields (text, email, dropdown, radio, checkbox..)
  • Ability to extend userforms from other modules to provide extra fields.
  • Ability to email multiple people the form submission
  • View submitted submissions and export them to CSV
  • Define custom error messages and validation settings
  • Optionally display and hide fields using javascript based on users input
  • Pre fill your form fields, by passing your values by url (http://yoursite.com/formpage?EditableField1=MyValue)

Installation

  1. Download the module from the link above.
  2. Extract the file (if you are on windows try 7-zip for extracting tar.gz files
  3. Make sure the folder after being extracted is named 'userforms'
  4. Place this directory in your sites root directory. This is the one with sapphire and cms in it.
  5. Run in your browser - /dev/build to rebuild the database.
  6. You should see a new PageType in the CMS 'User Defined Form'. This has a new 'Form' tab which has your form builder.

Upgrading

0.1 to 0.2

We undertook some major API changes between 0.1 and 0.2. To help you migrate we have included a build task which you can run which will go through your installed forms and rebuild them with the new 0.2 data model.

To run this build task you visit the url /dev/tasks/UserFormsMigrationTask

Thanks

I would like to thank everyone who has contributed to the module, bugfixers, testers, clients who use the module and everyone that submits new features.

A big thanks goes out to Jan Düsedau for drawing the custom icon set for the form fields.