silverware/userforms

SilverWare UserForms Module.

SilverWare UserForms Module

, _(*1)

Extends the SilverStripe UserForms Module for use with SilverWare apps., _(*2)

Contents

• Requirements
• Installation
• Configuration
• Usage
• Issues
• Contribution
• Maintainers
• License

Requirements

• SilverStripe UserForms Module
• SilverWare Validator

Installation

Installation is via Composer:, _(*3)

$ composer require silverware/userforms

Configuration

By default, this module will disable the built-in CSS and JavaScript that is required by silverstripe/userforms. This is achieved within the config.yml file with the following configuration:, _(*4)

SilverStripe\UserForms\Model\UserDefinedForm:
  block_default_userforms_js: true
  block_default_userforms_css: true

The configuration file also changes the user form validator to an instance of SilverWare Validator using the following configuration:, _(*5)

SilverStripe\UserForms\Form\UserForm:
  custom_validator_class: SilverWare\Validator\Validator
  custom_validator_enabled: true

Usage

This module adds an extension to the UserForm class which replaces the standard validator class with an instance of SilverWare Validator. This extension also adds a further extension point to UserForm named updateValidator, if you need to further customise the validator instance., _(*6)

Template overrides are also provided by this module which replace the standard user form templates with ones that will render correctly in SilverWare apps, namely with Bootstrap 4 theme classes and the Parsley.js validation errors provided by SilverWare Validator., _(*7)

Issues

Please use the issue tracker for bug reports and feature requests., _(*8)

Contribution

Your contributions are gladly welcomed to help make this project better. Please see contributing for more information., _(*9)

Maintainers

Colin Tucker	Praxis Interactive

License

BSD-3-Clause © Praxis Interactive, _(*10)