2011-12-05 10:44:23 +01:00
|
|
|
# UserForms
|
2011-02-12 00:49:34 +01:00
|
|
|
|
2013-03-29 09:54:12 +01:00
|
|
|
[](http://travis-ci.org/silverstripe/silverstripe-userforms)
|
|
|
|
|
|
2011-02-12 00:49:34 +01:00
|
|
|
## Introduction
|
|
|
|
|
|
2011-12-05 10:44:23 +01:00
|
|
|
UserForms enables CMS users to create dynamic forms via a drag and drop interface
|
|
|
|
|
and without getting involved in any PHP code.
|
2011-02-12 00:49:34 +01:00
|
|
|
|
|
|
|
|
## Maintainer Contact
|
|
|
|
|
|
2011-12-05 10:44:23 +01:00
|
|
|
* Will Rossiter (Nickname: wrossiter, willr) `<will (at) fullscreen (dot) io>`
|
2011-02-12 00:49:34 +01:00
|
|
|
|
|
|
|
|
## Requirements
|
|
|
|
|
|
2013-04-14 19:47:41 +02:00
|
|
|
* SilverStripe 3.1
|
2011-02-12 00:49:34 +01:00
|
|
|
|
|
|
|
|
## Features
|
|
|
|
|
|
|
|
|
|
* Construct a form using all major form fields (text, email, dropdown, radio, checkbox..)
|
2011-12-05 10:44:23 +01:00
|
|
|
* Ability to extend userforms from other modules to provide extra fields.
|
2011-02-12 00:49:34 +01:00
|
|
|
* Ability to email multiple people the form submission
|
|
|
|
|
* View submitted submissions and export them to CSV
|
|
|
|
|
* Define custom error messages and validation settings
|
2011-12-05 10:44:23 +01:00
|
|
|
* Optionally display and hide fields using javascript based on users input
|
2011-12-20 22:07:40 +01:00
|
|
|
* Pre fill your form fields, by passing your values by url (http://yoursite.com/formpage?EditableField1=MyValue)
|
2011-02-12 00:49:34 +01:00
|
|
|
|
|
|
|
|
## 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'
|
2013-05-17 01:09:12 +02:00
|
|
|
4. Place this directory in your sites root directory. This is the one with framework and cms in it.
|
2011-02-12 00:49:34 +01:00
|
|
|
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.
|
|
|
|
|
|
2013-08-08 23:27:14 +02:00
|
|
|
## Tasks
|
|
|
|
|
|
|
|
|
|
### UserForms EditableFormField Column Clean task ###
|
|
|
|
|
|
|
|
|
|
This task is used to clear unused columns from EditableFormField
|
|
|
|
|
|
|
|
|
|
The reason to clear these columns is because having surplus forms can break form saving.
|
|
|
|
|
|
|
|
|
|
Currently it only supports MySQL and when it is run it queries the EditableFormField class for the valid columns,
|
|
|
|
|
it then grabs the columns for the live database it will create a backup of the table and then remove any columns that
|
|
|
|
|
are surplus.
|
|
|
|
|
|
|
|
|
|
To run the task login as Admin and go to to http://yoursite/dev/tasks/UserFormsColumnCleanTask
|
|
|
|
|
|
2011-05-08 23:27:56 +02:00
|
|
|
## Thanks
|
|
|
|
|
|
2011-12-05 10:44:23 +01:00
|
|
|
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.
|
2011-05-08 23:27:56 +02:00
|
|
|
|
2011-12-05 10:44:23 +01:00
|
|
|
A big thanks goes out to [Jan Düsedau](http://eformation.de) for drawing
|
2013-04-14 19:47:41 +02:00
|
|
|
the custom icon set for the form fields.
|
