REQUIREMENTS

It is also recommended to use Formtastic or SimpleForm (see configuration) in order to hook into your apps custom form builders.

INSTALLATION

In your Gemfile, add the following dependencies:

gem 'contact_us', '~> 1.0.1'

From Rails.root in your Terminal run:

bundle
bundle exec rake contact_us:install

In config/initializers/contact_us.rb modify:

config.mailer_to ="contact@please-change-me.com"

Change to the email address you would like to receive the form submissions at for example:

config.mailer_to ="contact@yourdomain.com"

By default the emails from field will be the email entered by the user to easily reply, but this may not be allowed if your required to verify your sending email addresses.
You may also specify an email address for the notification emails from field:

config.mailer_from ="dontreply@yourdomain.com"

CONFIGURATION

If you would like to add a name or subject field to the form you may simply
set the options to true within the contact_us initializer located at config/initializers/contact_us.rb:

config.require_name =true
config.require_subject =true

To redirect to a specific URL after a successful form submission:

config.success_redirect ='/contact-success'

If you're using I18n localization and would like to have the locale be a part of your paths
For example: /en/contact-us OR /fr/contact-us OR /en-UK/contact-us

config.localize_routes =true

Views

To copy the view files to app/views/contact_us, and customize them to suit your needs run:

bundle exec rake contact_us:copy_views

Locales

To copy the locale files to config/locales/contact_us.*.yml, and customize them to suit your needs run:

bundle exec rake contact_us:copy_locales

Please feel free to submit your own locales so that other users will hopefully find this gem more useful in your language.

If you would like to include the locale in your paths (e.g. /en/contact-us), set the localize_routes
parameter to true in your initializer (see the configuration section above)

Formtastic

In order to use a Formtastic compatible template to hook into your custom form styles configure config/initializers/contact_us.rb:

config.form_gem ='formtastic'

By default the HTML should match that produced by Formtastic, but to ensure it is up to date you should set Formtastic.

SimpleForm

In order to use a SimpleForm compatible template to hook into your custom form styles configure config/initializers/contact_us.rb:

config.form_gem ='simple_form'

UPGRADING

When upgrading from 0.1.x to 0.2.x you should rerun the install generator to install the new settings, views, and locale updates:

bundle exec rake contact_us:install

Or you may run the generators for each specific component you would like to update, which is quite useful when upgrading during patch releases for example from 0.2.0 to 0.2.1: