Skip to content

WheelhouseCMS/wheelhouse-forms

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

90 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Forms Plugin for Wheelhouse CMS

Screenshot of forms plugin

This gem makes it easy to add customizable forms (such as contact forms) into your Wheelhouse CMS site, via an easy-to-use form builder. Form submissions are saved within the CMS and may optionally be emailed to one or more recipients.

The following field types are supported:

  • single-line text (with HTML5 input types)
  • text areas
  • select/dropdown box
  • single checkboxes
  • checkbox set
  • radio button set
  • US/Australian states dropdown
  • countries dropdown
  • HTML content
  • custom fields
  • nesting within field sets

Other features include:

  • server-side and HTML5 form validation
  • CSV export of submissions
  • optional spam filtering (via Akismet)

Installation & Usage

1. Add wheelhouse-forms to your Gemfile:

gem "wheelhouse-forms"

Then run bundle install.

2. Create a new form from the New Page dropdown.

3. To customize, copy the form.html.haml template from app/templates to your theme templates folder.

Spam Filtering with Akismet

Spam filtering support requires an Akismet API key. Sign up for one at https://akismet.com/signup/.

1. Add rakismet to your Gemfile:

gem "rakismet"

Then run bundle install.

2. Add your Akismet API key and web site URL to config/application.rb.

config.rakismet.key = "1234abcd1234"
config.rakismet.url = "http://www.example.com/"

3. Restart your Rails server. The forms plugin will automatically use Rakismet if it is configured.

Releases

No releases published

Packages

No packages published