Class: Alchemy::MessagesController

Inherits:
BaseController
  • Object
show all
Defined in:
app/controllers/alchemy/messages_controller.rb

Overview

Sending Messages:

To send Messages via contact forms you can create your form fields in the config.yml

Example:

Make an Element with this options inside your @elements.yml file:

- name: contactform
  contents:
  - name: mail_to
    type: EssenceText
  - name: subject
    type: EssenceText
  - name: mail_from
    type: EssenceText
  - name: success_page
    type: EssenceSelect

The fields mail_to, mail_from, subject and success_page are recommended. The Alchemy::MessagesController uses them to send your mails. So your customer has full controll of these values inside his contactform element.

Then make a page layout for your contact page in the page_layouts.yml file:

- name: contact
  unique: true
  cache: false
  elements: [pageheading, heading, contactform]
  autogenerate: [contactform]

Disabling the page caching is stronlgy recommended!

The editor view for your element should have this layout:

<%= render_essence_editor_by_name(element, 'mail_from') %>
<%= render_essence_editor_by_name(element, 'mail_to') %>
<%= render_essence_editor_by_name(element, 'subject') %>
<%= page_selector(element, 'success_page', page_attribute: :urlname) %>

Please have a look at the alchemy/config/config.yml file for further Message settings.

Instance Method Summary collapse

Methods included from Modules

included, #module_definition_for, register_module

Methods included from ConfigurationMethods

#configuration, #multi_language?, #multi_site?

Instance Method Details

#createObject

:nodoc:



58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
# File 'app/controllers/alchemy/messages_controller.rb', line 58

def create #:nodoc:
  @message = Message.new(params[:message])
  @message.ip = request.remote_ip
  @element = Element.find_by(id: @message.contact_form_id)
  if @element.nil?
    raise ActiveRecord::RecordNotFound, "Contact form id not found. Please pass the :contact_form_id in a hidden field. Example: <%= f.hidden_field :contact_form_id, value: element.id %>"
  end
  @page = @element.page
  @root_page = @page.get_language_root
  if @message.valid?
    Messages.contact_form_mail(@message, mail_to, mail_from, subject).deliver
    redirect_to_success_page
  else
    render template: 'alchemy/pages/show'
  end
end

#indexObject

:nodoc:



49
50
51
# File 'app/controllers/alchemy/messages_controller.rb', line 49

def index #:nodoc:
  redirect_to show_page_path(urlname: @page.urlname, locale: multi_language? ? @page.language_code : nil)
end

#newObject

:nodoc:



53
54
55
56
# File 'app/controllers/alchemy/messages_controller.rb', line 53

def new #:nodoc:
  @message = Message.new
  render template: 'alchemy/pages/show'
end