tonyair
/
silverstripe-userforms
mirror of https://github.com/silverstripe/silverstripe-userforms.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
UserForms module provides a visual form builder for the SilverStripe CMS. No coding required to build forms such as contact pages.
533 Commits 32 Branches 158 Tags 14 MiB
PHP 70.9%
JavaScript 25%
Gherkin 1.8%
Scheme 1.4%
SCSS 0.9%
Go to file
Will Rossiter 6937d65a07 Add composer install reference. 2014-03-17 22:34:10 +13:00
.tx Transifex support, js globalisation 2013-10-30 14:31:51 +01:00
_config userforms.yml: changed FieldEditor.js to UserForm.js (Issue #126) 2013-05-15 19:38:17 +03:00
code NEW: Allow form submission when tokens are disabled 2014-02-27 12:36:12 +13:00
css Use classname for styling rather than ID 2013-09-07 15:07:22 +12:00
images NEW: Added a numeric field and associated png 2014-02-11 08:59:43 +13:00
javascript Add new lang strings, convert to JS. 2014-01-24 14:37:01 +13:00
lang Updated master strings 2014-02-17 23:02:19 +13:00
templates Correct template namespace for translations, updated translations 2013-11-06 15:05:31 +01:00
tests BUG: Fixing unit tests for form processing and adding unit test to check if form has been completed 2014-01-06 15:15:01 +13:00
thirdparty Added files from old submodules directly 2013-03-18 19:06:47 -04:00
.gitignore MINOR Added a .gitignore to the project 2012-05-14 14:17:24 +12:00
.travis.yml Revert "Ensure the simple theme is added; needed for test" 2014-02-14 17:47:37 +13:00
LICENSE Updated license 2012-09-11 21:32:47 +12:00
README.md Add composer install reference. 2014-03-17 22:34:10 +13:00
UPGRADE.md Don't use submodules until github downloads support 2013-03-16 11:43:43 +13:00
_config.php Use new config API for adding cms additions 2013-05-11 11:39:07 +12:00
composer.json Include dev-* support for userforms 2013-11-20 11:32:27 +13:00

README.md

UserForms

Build Status

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 3.1

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

Via composer

composer require "silverstripe/silverstripe-userforms:dev-master"

Manually

  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 framework and cms in it.

After installation, make sure you rebuild your database through dev/build. You should see a new PageType in the CMS 'User Defined Form'. This has a new 'Form' tab which has your form builder.

Troubleshooting

After installation make sure you have done a dev/build you may also need to flush the admin view by appending ?flush=1 to the URL like http://yoursite.com/admin?flush=1

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

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.

Contributing

Translations

Translations of the natural language strings are managed through a third party translation interface, transifex.com. Newly added strings will be periodically uploaded there for translation, and any new translations will be merged back to the project source code.

Please use https://www.transifex.com/projects/p/silverstripe-userforms to contribute translations, rather than sending pull requests with YAML files.