silverstripe-userforms/README.md

71 lines
2.7 KiB
Markdown
Raw Normal View History

# UserForms
2011-02-12 00:49:34 +01:00
2013-03-29 09:54:12 +01:00
[![Build Status](https://secure.travis-ci.org/silverstripe/silverstripe-userforms.png?branch=master)](http://travis-ci.org/silverstripe/silverstripe-userforms)
2011-02-12 00:49:34 +01:00
## Introduction
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
* 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..)
* 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
* 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)
2011-02-12 00:49:34 +01:00
## Installation
Installation can be done either by composer or by manually downloading a release.
2014-03-17 10:34:10 +01:00
### Via composer
`composer require "silverstripe/userforms:*"`
2014-03-17 10:34:10 +01:00
### Manually
1. Download the module from [the releases page](https://github.com/silverstripe/silverstripe-userforms/releases).
2011-02-12 00:49:34 +01:00
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.
2014-03-17 10:34:10 +01:00
### Configuration
2014-03-17 10:34:10 +01:00
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
* [Index](docs/en/index.md)
* [Installation instructions](docs/en/installation.md)
* [Troubleshooting](docs/en/troubleshooting.md)
* [User Documentation](docs/en/user-documentation.md)
## 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](http://eformation.de) for drawing
2013-04-14 19:47:41 +02:00
the custom icon set for the form fields.
2013-10-30 14:21:28 +01:00
## 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.
2014-03-17 10:34:10 +01:00
Please use [https://www.transifex.com/projects/p/silverstripe-userforms](https://www.transifex.com/projects/p/silverstripe-userforms) to contribute translations, rather than sending pull requests with YAML files.