SpreeContactUs

A Rails 3+ Engine providing a basic contact form as a Spree Extension.

Modified version of the contact_us gem to work with Spree.

For more information please see https://github.com/jdutil/contact_us

REQUIREMENTS

SpreeContactUs requires:

Spree Core 1.0.0 or greater
Ruby 1.9.2 or greater.

INSTALLATION

In your Gemfile, add the following dependencies:

To install from edge:

gem 'spree_contact_us', :git => 'https://github.com/jdutil/spree_contact_us'

Or install from latest stable version:

gem 'spree_contact_us', '~> 1.1.0'

From Rails.root run:

$ bundle
$ bundle exec rails g spree_contact_us:install

In config/initializers/spree_contact_us.rb modify:

config.mailer_to = "[email protected]"

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

config.mailer_to = "[email protected]"

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 = "[email protected]"

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 spree_contact_us initializer located at config/initializers/spree_contact_us.rb:

config.require_name = true
config.require_subject = true

You may also update your locales under config/locales/spree_contact_us.en.yml or create your own. Please feel free to submit your own locales so that other users will hopefully find this gem more useful.

USAGE

Visit your website and navigate to /contact-us to see the form in action.

ISSUES

Please report any bugs or feature requests to the Github issues page @ https://github.com/jdutil/spree_contact_us/issues

CONTRIBUTING

In the spirit of free software, everyone is encouraged to help improve this project.

Here are some ways you can contribute:

by using prerelease versions
by reporting bugs
by suggesting new features
by translating to a new language
by writing or editing documentation
by writing specifications
by writing code (no patch is too small: fix typos, add comments, clean up inconsistent whitespace)
by refactoring code
by resolving issues
by reviewing patches

Testing

Be sure to bundle your dependencies and then create a dummy test app for the specs to run against.

$ bundle
$ bundle exec rake test_app
$ bundle exec rspec spec

TODO

Modify settings within the admin
Add new language translations