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.
743 Commits 32 Branches 156 Tags 13 MiB
PHP 70.9%
JavaScript 25%
Gherkin 1.8%
Scheme 1.4%
SCSS 0.9%
Go to file
Damian Mooyman 1dd787327a API Integrate with secure assets module 2015-08-28 16:30:41 +12:00
.tx Transifex support, js globalisation 2013-10-30 14:31:51 +01:00
_config API Integrate with secure assets module 2015-08-28 16:30:41 +12:00
code API Integrate with secure assets module 2015-08-28 16:30:41 +12:00
css Consistant treatment of field's right title 2015-08-21 15:21:33 +12:00
docs API Integrate with secure assets module 2015-08-28 16:30:41 +12:00
images NEW: Added a numeric field and associated png 2014-02-11 08:59:43 +13:00
javascript focus on first invalid element after form validation 2015-08-27 15:27:08 +12:00
lang Added placeholder support for the EditableTextField 2015-08-27 13:54:28 +02:00
scss Consistant treatment of field's right title 2015-08-21 15:21:33 +12:00
templates Make checkbox field markup consistant with other fields 2015-08-24 15:30:55 +12:00
tests API Integrate with secure assets module 2015-08-28 16:30:41 +12:00
thirdparty Add option for displaying error messages at the top of the form 2015-07-22 09:19:48 +12:00
.editorconfig Adding .editorconfig 2014-12-04 15:43:27 +00:00
.gitignore Cms styling for fieldgroups 2015-08-12 16:24:06 +12:00
.scrutinizer.yml Added Scrutinizer delay 2015-08-21 09:15:54 +12:00
.travis.yml API Integrate with secure assets module 2015-08-28 16:30:41 +12:00
LICENSE Updated license 2012-09-11 21:32:47 +12:00
README.md Added user documentation. 2014-07-22 14:53:18 +12:00
UPGRADE.md Don't use submodules until github downloads support 2013-03-16 11:43:43 +13:00
_config.php API new form editor 2015-08-10 13:15:59 +12:00
composer.json API Integrate with secure assets module 2015-08-28 16:30:41 +12:00
config.rb Cms styling for fieldgroups 2015-08-12 16:24:06 +12: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

Installation can be done either by composer or by manually downloading a release.

Via composer

composer require "silverstripe/userforms:*"

Manually

  1. Download the module from the releases page.
  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.

Configuration

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.

Documentation

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.