Inquiries
About
Add a simple contact form to Refinery that notifies you and the customer when an inquiry is made.
In summary you can:
- Collect and manage inquiries
- Specify who is notified when a new inquiry comes in
- Customise an auto responder email that is sent to the person making the inquiry
When inquiries come in, you and the customer are generally notified. As we implemented spam filtering through the filters_spam plugin you will not get notified if an inquiry is marked as 'spam'. This feature is optional, and can be disabled in config/initializers/refinery/inquiries.rb
by setting config.filter_spam = false
.
Gem Installation using Bundler (The very best way)
Include the latest gem into your Refinery CMS application's Gemfile:
gem 'refinerycms-inquiries', '~> 3.0.0'
Then type the following at command line inside your Refinery CMS application's root directory:
bundle install
Installation on Refinery 2.0.0 or above.
To install the migrations, run:
rails generate refinery:inquiries
rake db:migrate
Add pages to the database and you're done:
rake db:seed
Optionally include the stylesheet.
Next, you can include the stylesheet that improves the form's display a bit,
and also adds an asterisk to each required
label: Name *
instead of Name
.
To do this, include it in your application.css
manifest file and insert:
//= require refinery/inquiries/inquiries
How do I enable reCAPTCHA support?
Note: enabling this feature disables the built in spam filtering.
Just add your reCAPTCHA "Site key" in config/initializers/refinery/inquiries.rb
:
config.recaptcha_site_key = "do NOT put your secret key here"
Inside config/secrets.yml
, the file for application secrets in Rails applications,
place the secret key:
development:
recaptcha_secret_key: "This IS your secret key"
production:
recaptcha_secret_key: <%= ENV["RECAPTCHA_SECRET_KEY"] %>
Note: This expects you to set your secret key via ENV
in your production environment.
How do I set up email to be sent from GMail, SendGrid or other service?
Inquiries uses actionmailer
under the hood so you can refer to Rails Action Mailer guide. For example to use GMail see Action Mailer Configuration for GMail guide.
How do I get Notified?
Go into your 'Inquiries' tab in the Refinery admin area and click on "Update who gets notified"
How do I Edit the Automatic Confirmation Email
Go into your 'Inquiries' tab in the Refinery admin area and click on "Edit confirmation email"
Simply set the following in config/application.rb
:
config.action_dispatch.tld_length = 2