New plugin SendEmailPlugin

A plugin that allows sending e-mails via HTML forms (ActionItem2056)

New plugin SendEmailPlugin
A plugin that allows sending e-mails via HTML forms (ActionItem2056)
Joenio Costa
1 parent a837f96c
Showing 22 changed files with 541 additions and 0 deletions Show diff stats
plugins/send_email/controllers/send_email_plugin_admin_controller.rb
plugins/send_email/controllers/send_email_plugin_base_controller.rb
plugins/send_email/controllers/send_email_plugin_environment_controller.rb
plugins/send_email/controllers/send_email_plugin_profile_controller.rb
plugins/send_email/db/migrate/20110804180047_add_send_email_plugin_config_to_environment.rb
plugins/send_email/doc/send_email.textile
plugins/send_email/lib/send_email_plugin.rb
plugins/send_email/lib/send_email_plugin/mail.rb
plugins/send_email/lib/send_email_plugin/sender.rb
plugins/send_email/public/style.css
plugins/send_email/test/features/send_email_plugin.feature
plugins/send_email/test/functional/send_email_plugin_admin_controller_test.rb
plugins/send_email/test/functional/send_email_plugin_base_controller_test.rb
plugins/send_email/test/unit/send_email_plugin_mail_test.rb
plugins/send_email/test/unit/send_email_plugin_sender_test.rb
plugins/send_email/test/unit/send_email_plugin_test.rb
plugins/send_email/views/send_email_plugin/sender/mail.rhtml
plugins/send_email/views/send_email_plugin_admin/index.rhtml
plugins/send_email/views/send_email_plugin_base/fail.rhtml
plugins/send_email/views/send_email_plugin_base/success.rhtml
@@ -0,0 +1,16 @@
+class SendEmailPluginAdminController < PluginsController
+  append_view_path File.join(File.dirname(__FILE__) + '/../views')
+
+  def index
+    @environment = environment
+    if request.post?
+      if environment.update_attributes(params[:environment])
+        session[:notice] = _('Configurations was saved')
+        redirect_to :controller => 'plugins'
+      else
+        session[:notice] = _('Configurations could not be saved')
+      end
+    end
+  end
+
+end
@@ -0,0 +1,31 @@
+module SendEmailPluginBaseController
+  def deliver
+    if request.post?
+      @context_url = profile ? profile.url : {:host => environment.default_hostname, :controller => 'home'}
+      @mail = SendEmailPlugin::Mail.new(
+        :from => environment.contact_email,
+        :to => params[:to],
+        :message => params[:message],
+        :environment => environment,
+        :params => params.dup
+      )
+      @mail.subject = params[:subject] unless params[:subject].blank?
+      if @mail.valid?
+        SendEmailPlugin::Sender.deliver_mail(request.referer, @context_url, @mail)
+        if request.xhr?
+          render :text => _('Message sent')
+        else
+          render :action => 'success'
+        end
+      else
+        if request.xhr?
+          render_dialog_error_messages :mail
+        else
+          render :action => 'fail'
+        end
+      end
+    else
+      render_access_denied
+    end
+  end
+end
@@ -0,0 +1,4 @@
+class SendEmailPluginEnvironmentController < ApplicationController
+  append_view_path File.join(File.dirname(__FILE__) + '/../views')
+  include SendEmailPluginBaseController
+end
@@ -0,0 +1,4 @@
+class SendEmailPluginProfileController < ProfileController
+  append_view_path File.join(File.dirname(__FILE__) + '/../views')
+  include SendEmailPluginBaseController
+end
@@ -0,0 +1,9 @@
+class AddSendEmailPluginConfigToEnvironment < ActiveRecord::Migration
+  def self.up
+    add_column :environments, :send_email_plugin_allow_to, :text
+  end
+
+  def self.down
+    remove_column :environments, :send_email_plugin_allow_to
+  end
+end
@@ -0,0 +1,61 @@
+h1. SendEmailPlugin
+
+Allows to send e-mails through an e-mail form.
+
+h2. Usage
+
+* Create a HTML form using RawHTMLBlock or RawHTMLArticle that invokes the {sendemail} action
+* Add a "to" and "message" field and a submit button
+* Make sure to fill in allowed 'to' addresses in plugin settings
+
+h2. HTML form
+
+h3. Form action
+
+You should use {sendemail} macro as form action, it will be expanded as:
+
+* */profile/&lt;identifier&gt;/plugins/send_email/deliver* in profile context
+* */plugin/send_email/deliver* in environment context
+
+h3. 'Subject' field
+
+Subject of message.
+
+(default: 'New mail')
+
+h3. 'Message' field
+
+Body of message.
+
+(required)
+
+h3. 'To' field
+
+Target address. Accepts multiple addresses separated by comma.
+
+(required)
+
+h3. extra fields
+
+Each other params in HTML form will compose message body in a format "key: value"
+
+h2. Options
+
+h3. Using ajax
+
+Ajax is supported using #ajax-form as id of HTML form.
+
+Example:
+
+<pre>
+<form action='{sendemail}' id='ajax-form'>
+   <input type='text' name='to'/>
+   <input type='text' name='subject'/>
+   <input type='text' name='message'/>
+   <input type='subject'/>
+</form>
+</pre>
+
+h2. Info
+
+This plugin was inspired by "Foswiki SendEmailPlugin":http://foswiki.org/Extensions/SendEmailPlugin
@@ -0,0 +1,23 @@
+class SendEmailPlugin < Noosfero::Plugin
+
+  def self.plugin_name
+    "SendEmailPlugin"
+  end
+
+  def self.plugin_description
+    _("A plugin that allows sending e-mails via HTML forms.")
+  end
+
+  def stylesheet?
+    true
+  end
+
+  def parse_content(raw_content)
+    if context.profile
+      raw_content.gsub(/\{sendemail\}/, "/profile/#{context.profile.identifier}/plugins/send_email/deliver")
+    else
+      raw_content.gsub(/\{sendemail\}/, '/plugin/send_email/deliver')
+    end
+  end
+
+end
@@ -0,0 +1,42 @@
+class SendEmailPlugin::Mail < ActiveRecord::Base #WithoutTable
+
+  N_('Subject'); N_('Message'); N_('To'); N_('From')
+  tableless :columns => [
+    [:from, :string],
+    [:to, :string],
+    [:subject, :string, _('New mail')],
+    [:message, :string],
+    [:params, :hash, {}],
+  ]
+  attr_accessor :environment
+
+  validates_presence_of :environment
+  validates_presence_of :to, :message
+
+  def validate
+    if to_as_list.any? do |value|
+        if value !~ Noosfero::Constants::EMAIL_FORMAT
+          self.errors.add(:to, _("%{fn} '%s' isn't a valid e-mail address") % value)
+        end
+      end
+    else
+      allowed_emails = environment ? environment.send_email_plugin_allow_to.to_s.gsub(/\s+/, '').split(/,/) : []
+      if to_as_list.any? do |value|
+          if !allowed_emails.include?(value)
+            self.errors.add(:to, _("%{fn} '%s' address is not allowed (see SendEmailPlugin config)") % value)
+          end
+        end
+      end
+    end
+  end
+
+  def params=(value = {})
+    [:action, :controller, :to, :message, :subject, :from].each{|k| value.delete(k)}
+    self[:params] = value
+  end
+
+  def to_as_list
+    to && to.split(/,/) || []
+  end
+
+end
@@ -0,0 +1,13 @@
+class SendEmailPlugin::Sender < Noosfero::Plugin::MailerBase
+  prepend_view_path(SendEmailPlugin.root_path+'/views')
+
+  def mail(referer, url, mail)
+    recipients mail.to
+    from mail.from
+    subject "[#{mail.environment.name}] #{mail.subject}"
+    body :message => mail.message,
+      :referer => referer,
+      :context_url => url,
+      :params => mail.params
+  end
+end
@@ -0,0 +1,22 @@
+.sendemail-plugin-message-sent {
+  width: 100%;
+  background-color: #F0F0F0;
+  border: 1px solid #CFCFCF;
+}
+.sendemail-plugin-message-sent td {
+  border: 0;
+}
+.sendemail-plugin-message-sent tr:hover,
+.sendemail-plugin-message-sent td:hover,
+.sendemail-plugin-message-sent tr:hover td {
+  background-color: auto;
+}
+.sendemail-plugin-message-sent pre {
+  margin: 0 auto;
+}
+.sendemail-plugin-message-sent td {
+  vertical-align: top;
+}
+.sendemail-plugin-message-sent .value {
+  width: 100%;
+}
@@ -0,0 +1,41 @@
+Feature: send_email_plugin
+
+  Background:
+    Given the following users
+      | login | name |
+      | joaosilva | Joao Silva |
+    And I am logged in as "joaosilva"
+
+  Scenario: expand macro in article content
+    Given plugin SendEmailPlugin is enabled on environment
+    And the following articles
+      | owner | name | body |
+      | joaosilva | sample-article | URL path to {sendemail} action |
+    When I go to /joaosilva/sample-article
+    Then I should see "URL path to /profile/joaosilva/plugins/send_email/deliver action"
+
+  Scenario: expand macro in block content
+    Given plugin SendEmailPlugin is enabled on environment
+    And the following blocks
+      | owner     | type         | html |
+      | joaosilva | RawHTMLBlock | URL path to {sendemail} action |
+    When I go to Joao Silva's homepage
+    Then I should see "URL path to /profile/joaosilva/plugins/send_email/deliver action"
+
+  Scenario: as admin I can configure plugin
+    Given I am logged in as admin
+    When I go to the environment control panel
+    And I follow "Enable/disable plugins"
+    Then I should see "SendEmailPlugin" linking to "/admin/plugin/send_email"
+
+  Scenario: configure plugin to allow emails to john@example.com
+    Given I am logged in as admin
+    And I go to the environment control panel
+    And I follow "Enable/disable plugins"
+    When I follow "SendEmailPlugin"
+    Then I should not see "john@example.com"
+    When I fill in "E-Mail addresses you want to allow to send" with "john@example.com"
+    And I press "Save"
+    Then I should be on /admin/plugins
+    When I follow "SendEmailPlugin"
+    Then I should see "john@example.com"
@@ -0,0 +1,37 @@
+require File.dirname(__FILE__) + '/../../../../test/test_helper'
+require File.dirname(__FILE__) + '/../../controllers/send_email_plugin_admin_controller'
+
+# Re-raise errors caught by the controller.
+class SendEmailPluginAdminController; def rescue_action(e) raise e end; end
+
+class SendEmailPluginAdminControllerTest < Test::Unit::TestCase
+
+  def setup
+    @controller = SendEmailPluginAdminController.new
+    @request    = ActionController::TestRequest.new
+    @response   = ActionController::TestResponse.new
+    @admin = create_user('adminplug').person
+    @environment = @admin.environment
+    @environment.add_admin(@admin)
+  end
+
+  should 'deny access to guests and redirect to login' do
+    get :index
+    assert_response :redirect
+    assert_redirected_to :controller => 'account', :action => 'login'
+  end
+
+  should 'allow access to admin' do
+    login_as @admin.identifier
+    get :index
+    assert_response :success
+  end
+
+  should 'deny access to ordinary users' do
+    @user = create_user('normaluser').person
+    login_as @user.identifier
+    get :index
+    assert_response 403
+  end
+
+end
@@ -0,0 +1,81 @@
+require File.dirname(__FILE__) + '/../../../../test/test_helper'
+require File.dirname(__FILE__) + '/../../controllers/send_email_plugin_profile_controller'
+
+# Re-raise errors caught by the controller.
+class SendEmailPluginProfileController; def rescue_action(e) raise e end; end
+
+def run_common_tests
+  should 'not deliver emails via GET requests' do
+    get :deliver, @extra_args
+    assert_response 403 # forbidden
+  end
+
+  should 'deliver emails only via POST requests' do
+    post :deliver, @extra_args
+    assert_response :success
+  end
+
+  should 'render fail template if could not deliver mail' do
+    post :deliver, @extra_args
+    assert_template 'fail'
+  end
+
+  should 'render success template after deliver mail' do
+    SendEmailPlugin::Mail.any_instance.stubs(:valid?).returns(true)
+    post :deliver, @extra_args.merge(:to => 'john@example.com', :message => 'Hi john')
+    assert_template 'success'
+  end
+
+  should 'render dialog error if could not deliver mail by ajax request' do
+    xhr :post, :deliver, @extra_args
+    assert_template '_dialog_error_messages'
+  end
+
+  should 'render success message after deliver mail by ajax request' do
+    SendEmailPlugin::Mail.any_instance.stubs(:valid?).returns(true)
+    xhr :post, :deliver, @extra_args.merge(:to => 'john@example.com', :message => 'Hi john')
+    assert_equal 'Message sent', @response.body
+  end
+
+  should 'deliver mail' do
+    Environment.any_instance.stubs(:send_email_plugin_allow_to).returns('john@example.com')
+    assert_difference ActionMailer::Base.deliveries, :size do
+      post :deliver, @extra_args.merge(:to => 'john@example.com', :message => 'Hi john')
+    end
+  end
+
+  should 'deliver mail with nondefault subject' do
+    Environment.any_instance.stubs(:send_email_plugin_allow_to).returns('john@example.com')
+    post :deliver, @extra_args.merge(:to => 'john@example.com', :message => 'Hi john', :subject => 'Hello john')
+    assert_equal '[Colivre.net] Hello john', ActionMailer::Base.deliveries.first.subject
+  end
+end
+
+class SendEmailPluginProfileControllerTest < Test::Unit::TestCase
+  def setup
+    @controller = SendEmailPluginProfileController.new
+    @request    = ActionController::TestRequest.new
+    @response   = ActionController::TestResponse.new
+    ActionMailer::Base.delivery_method = :test
+    ActionMailer::Base.perform_deliveries = true
+    ActionMailer::Base.deliveries = []
+    community = fast_create(Community)
+    @extra_args = {:profile => community.identifier}
+  end
+
+  run_common_tests()
+end
+
+class SendEmailPluginEnvironmentControllerTest < Test::Unit::TestCase
+  def setup
+    @controller = SendEmailPluginEnvironmentController.new
+    @request    = ActionController::TestRequest.new
+    @response   = ActionController::TestResponse.new
+    ActionMailer::Base.delivery_method = :test
+    ActionMailer::Base.perform_deliveries = true
+    ActionMailer::Base.deliveries = []
+    @extra_args = {}
+  end
+
+  run_common_tests()
+end
@@ -0,0 +1,63 @@
+require File.dirname(__FILE__) + '/../../../../test/test_helper'
+
+class SendEmailPluginMailTest < Test::Unit::TestCase
+
+  def setup
+    @environment = mock()
+    @environment.stubs(:send_email_plugin_allow_to).returns('john@example.com, someone@example.com, someother@example.com')
+  end
+
+  should 'instance a valid object with fields to be fired in mail' do
+    mail = SendEmailPlugin::Mail.new(:subject => 'Hi', :message => 'Hi john', :to => 'john@example.com', :environment => @environment)
+    assert mail.valid?
+  end
+
+  should 'requires to field' do
+    mail = SendEmailPlugin::Mail.new(:subject => 'Hi', :message => 'Hi john', :environment => @environment)
+    assert !mail.valid?
+  end
+
+  should 'require message field' do
+    mail = SendEmailPlugin::Mail.new(:subject => 'Hi', :to => 'john@example.com', :environment => @environment)
+    assert !mail.valid?
+  end
+
+  should 'require environment field' do
+    mail = SendEmailPlugin::Mail.new(:subject => 'Hi', :to => 'john@example.com', :message => 'Hi john')
+    assert !mail.valid?
+  end
+
+  should 'have a default subject' do
+    mail = SendEmailPlugin::Mail.new
+    assert_equal 'New mail', mail.subject
+  end
+
+  should 'not accept invalid email address' do
+    mail = SendEmailPlugin::Mail.new(:subject => 'Hi', :message => 'Hi john', :to => 'invalid-mail-address', :environment => @environment)
+    assert !mail.valid?
+  end
+
+  should 'not accept email that is not in allowed address list' do
+    mail = SendEmailPlugin::Mail.new(:subject => 'Hi', :message => 'Hi john', :to => 'unknow@example.com', :environment => @environment)
+    assert !mail.valid?
+  end
+
+  should 'discard some keys on set params hash' do
+    mail = SendEmailPlugin::Mail.new(:params => {:action => 1, :controller => 2, :to => 3, :message => 4, :subject => 5, :age => 6})
+    [:action, :controller, :to, :message, :subject].each do |k|
+      assert !mail.params.include?(k)
+    end
+    assert mail.params.include?(:age)
+  end
+
+  should "accept multiple 'to' emails" do
+    mail = SendEmailPlugin::Mail.new(:subject => 'Hi', :message => 'Hi john', :to => 'john@example.com,someother@example.com', :environment => @environment)
+    assert mail.valid?
+  end
+
+  should "invalid if just one listed in 'to' list was not allowed" do
+    mail = SendEmailPlugin::Mail.new(:subject => 'Hi', :message => 'Hi john', :to => 'john@example.com,notallowed@example.com,someother@example.com', :environment => @environment)
+    assert !mail.valid?
+  end
+
+end
@@ -0,0 +1,35 @@
+require File.dirname(__FILE__) + '/../../../../test/test_helper'
+
+class SendEmailPluginSenderTest < Test::Unit::TestCase
+
+  def setup
+    ActionMailer::Base.delivery_method = :test
+    ActionMailer::Base.perform_deliveries = true
+    ActionMailer::Base.deliveries = []
+    @environment = mock()
+    @environment.stubs(:contact_email).returns('noreply@localhost')
+    @environment.stubs(:default_hostname).returns('localhost')
+    @environment.stubs(:name).returns('Noosfero')
+    @environment.stubs(:send_email_plugin_allow_to).returns('john@example.com, someone@example.com, someother@example.com')
+    @mail = SendEmailPlugin::Mail.new(:subject => 'Hi', :message => 'Hi john', :to => 'john@example.com', :from => 'noreply@localhost', :environment => @environment)
+  end
+
+  should 'be able to deliver mail' do
+    response = SendEmailPlugin::Sender.deliver_mail("http://localhost/contact", 'http//profile', @mail)
+    assert_equal 'noreply@localhost', response.from.to_s
+    assert_equal "[Noosfero] #{@mail.subject}", response.subject
+  end
+
+  should 'deliver mail to john@example.com' do
+    response = SendEmailPlugin::Sender.deliver_mail("http://localhost/contact", 'http//profile', @mail)
+    assert_equal ['john@example.com'], response.to
+  end
+
+  should 'add each key value pair to message body' do
+    @mail.params = {:param1 => 'value1', :param2 => 'value2'}
+    response = SendEmailPlugin::Sender.deliver_mail("http://localhost/contact", 'http//profile', @mail)
+    assert_match /param1.+value1/m, response.body
+    assert_match /param2.+value2/m, response.body
+  end
+
+end
@@ -0,0 +1,29 @@
+require File.dirname(__FILE__) + '/../../../../test/test_helper'
+
+class SendEmailPluginTest < Test::Unit::TestCase
+
+  def setup
+    @plugin = SendEmailPlugin.new
+    @context = mock()
+    @plugin.context = @context
+  end
+
+  should 'return true to stylesheet?' do
+    assert @plugin.stylesheet?
+  end
+
+  should 'have admin controller' do
+    assert SendEmailPlugin.has_admin_url?
+  end
+
+  should 'expand macro in parse_content event' do
+    @plugin.context.stubs(:profile).returns(nil)
+    assert_match /plugin\/send_email\/deliver/, @plugin.parse_content("expand this macro {sendemail}")
+  end
+
+  should 'expand macro in parse_content event on profile context' do
+    @plugin.context.stubs(:profile).returns(fast_create(Community))
+    assert_match /profile\/#{@plugin.context.profile.identifier}\/plugins\/send_email\/deliver/, @plugin.parse_content("expand this macro {sendemail}")
+  end
+
+end
@@ -0,0 +1,8 @@
+<%= _('Contact from %s') % @referer %>
+
+<%= word_wrap(@message || @mail.message) %>
+<% (@params || @mail.params).each_pair do |key, value| %>
+<%= key %>: <%= word_wrap(value) %>
+<% end %>
+---
+<%= url_for @context_url %>
@@ -0,0 +1,9 @@
+<h1><%= _("SendEmailPlugin's config") %></h1>
+
+<% form_for :environment, :url => {:action => 'index'}, :html => {:method => 'post'} do |f| %>
+  <%= labelled_form_field(_("E-Mail addresses you want to allow to send"), f.text_area(:send_email_plugin_allow_to, :rows => 8)) %>
+  <small><%= _('(list of email addresses separated by comma)') %></small>
+  <% button_bar do %>
+    <%= submit_button 'save', _('Save'), :cancel => {:controller => 'plugins'} %>
+  <% end %>
+<% end %>
@@ -0,0 +1,3 @@
+<%= error_messages_for 'mail', :header_message => _('The message could not be sent') %>
+
+<%= button :back, _('Back'), :back %>
@@ -0,0 +1,8 @@
+<h2><%= _('Message sent') %></h2>
+
+<table class='sendemail-plugin-message-sent'>
+  <tr><td class='label'><strong><%= _('Subject') %>:</strong></td><td class='value'><em><%=h @mail.subject %></em></td></tr>
+  <tr><td class='label'><strong><%= _('Message') %>:</strong></td><td class='value'><pre><%=h render :file => 'send_email_plugin/sender/mail' %></pre></td></tr>
+</table>
+
+<p><%= button :back, _('Back'), :back %></p>
@@ -0,0 +1 @@
+send_email_plugin_base
 \ No newline at end of file
@@ -0,0 +1 @@
+send_email_plugin_base
 \ No newline at end of file
@@ -0,0 +1,16 @@		@@ -0,0 +1,16 @@
	1	+class SendEmailPluginAdminController < PluginsController
	2	+ append_view_path File.join(File.dirname(__FILE__) + '/../views')
	3	+
	4	+ def index
	5	+ @environment = environment
	6	+ if request.post?
	7	+ if environment.update_attributes(params[:environment])
	8	+ session[:notice] = _('Configurations was saved')
	9	+ redirect_to :controller => 'plugins'
	10	+ else
	11	+ session[:notice] = _('Configurations could not be saved')
	12	+ end
	13	+ end
	14	+ end
	15	+
	16	+end
@@ -0,0 +1,31 @@		@@ -0,0 +1,31 @@
	1	+module SendEmailPluginBaseController
	2	+ def deliver
	3	+ if request.post?
	4	+ @context_url = profile ? profile.url : {:host => environment.default_hostname, :controller => 'home'}
	5	+ @mail = SendEmailPlugin::Mail.new(
	6	+ :from => environment.contact_email,
	7	+ :to => params[:to],
	8	+ :message => params[:message],
	9	+ :environment => environment,
	10	+ :params => params.dup
	11	+ )
	12	+ @mail.subject = params[:subject] unless params[:subject].blank?
	13	+ if @mail.valid?
	14	+ SendEmailPlugin::Sender.deliver_mail(request.referer, @context_url, @mail)
	15	+ if request.xhr?
	16	+ render :text => _('Message sent')
	17	+ else
	18	+ render :action => 'success'
	19	+ end
	20	+ else
	21	+ if request.xhr?
	22	+ render_dialog_error_messages :mail
	23	+ else
	24	+ render :action => 'fail'
	25	+ end
	26	+ end
	27	+ else
	28	+ render_access_denied
	29	+ end
	30	+ end
	31	+end
@@ -0,0 +1,4 @@		@@ -0,0 +1,4 @@
	1	+class SendEmailPluginEnvironmentController < ApplicationController
	2	+ append_view_path File.join(File.dirname(__FILE__) + '/../views')
	3	+ include SendEmailPluginBaseController
	4	+end
@@ -0,0 +1,4 @@		@@ -0,0 +1,4 @@
	1	+class SendEmailPluginProfileController < ProfileController
	2	+ append_view_path File.join(File.dirname(__FILE__) + '/../views')
	3	+ include SendEmailPluginBaseController
	4	+end
@@ -0,0 +1,9 @@		@@ -0,0 +1,9 @@
	1	+class AddSendEmailPluginConfigToEnvironment < ActiveRecord::Migration
	2	+ def self.up
	3	+ add_column :environments, :send_email_plugin_allow_to, :text
	4	+ end
	5	+
	6	+ def self.down
	7	+ remove_column :environments, :send_email_plugin_allow_to
	8	+ end
	9	+end
@@ -0,0 +1,61 @@		@@ -0,0 +1,61 @@
	1	+h1. SendEmailPlugin
	2	+
	3	+Allows to send e-mails through an e-mail form.
	4	+
	5	+h2. Usage
	6	+
	7	+* Create a HTML form using RawHTMLBlock or RawHTMLArticle that invokes the {sendemail} action
	8	+* Add a "to" and "message" field and a submit button
	9	+* Make sure to fill in allowed 'to' addresses in plugin settings
	10	+
	11	+h2. HTML form
	12	+
	13	+h3. Form action
	14	+
	15	+You should use {sendemail} macro as form action, it will be expanded as:
	16	+
	17	+* /profile/<identifier>/plugins/send_email/deliver in profile context
	18	+* /plugin/send_email/deliver in environment context
	19	+
	20	+h3. 'Subject' field
	21	+
	22	+Subject of message.
	23	+
	24	+(default: 'New mail')
	25	+
	26	+h3. 'Message' field
	27	+
	28	+Body of message.
	29	+
	30	+(required)
	31	+
	32	+h3. 'To' field
	33	+
	34	+Target address. Accepts multiple addresses separated by comma.
	35	+
	36	+(required)
	37	+
	38	+h3. extra fields
	39	+
	40	+Each other params in HTML form will compose message body in a format "key: value"
	41	+
	42	+h2. Options
	43	+
	44	+h3. Using ajax
	45	+
	46	+Ajax is supported using #ajax-form as id of HTML form.
	47	+
	48	+Example:
	49	+
	50	+<pre>
	51	+<form action='{sendemail}' id='ajax-form'>
	52	+ <input type='text' name='to'/>
	53	+ <input type='text' name='subject'/>
	54	+ <input type='text' name='message'/>
	55	+ <input type='subject'/>
	56	+</form>
	57	+</pre>
	58	+
	59	+h2. Info
	60	+
	61	+This plugin was inspired by "Foswiki SendEmailPlugin":http://foswiki.org/Extensions/SendEmailPlugin
@@ -0,0 +1,23 @@		@@ -0,0 +1,23 @@
	1	+class SendEmailPlugin < Noosfero::Plugin
	2	+
	3	+ def self.plugin_name
	4	+ "SendEmailPlugin"
	5	+ end
	6	+
	7	+ def self.plugin_description
	8	+ _("A plugin that allows sending e-mails via HTML forms.")
	9	+ end
	10	+
	11	+ def stylesheet?
	12	+ true
	13	+ end
	14	+
	15	+ def parse_content(raw_content)
	16	+ if context.profile
	17	+ raw_content.gsub(/\{sendemail\}/, "/profile/#{context.profile.identifier}/plugins/send_email/deliver")
	18	+ else
	19	+ raw_content.gsub(/\{sendemail\}/, '/plugin/send_email/deliver')
	20	+ end
	21	+ end
	22	+
	23	+end
@@ -0,0 +1,42 @@		@@ -0,0 +1,42 @@
	1	+class SendEmailPlugin::Mail < ActiveRecord::Base #WithoutTable
	2	+
	3	+ N_('Subject'); N_('Message'); N_('To'); N_('From')
	4	+ tableless :columns => [
	5	+ [:from, :string],
	6	+ [:to, :string],
	7	+ [:subject, :string, _('New mail')],
	8	+ [:message, :string],
	9	+ [:params, :hash, {}],
	10	+ ]
	11	+ attr_accessor :environment
	12	+
	13	+ validates_presence_of :environment
	14	+ validates_presence_of :to, :message
	15	+
	16	+ def validate
	17	+ if to_as_list.any? do \|value\|
	18	+ if value !~ Noosfero::Constants::EMAIL_FORMAT
	19	+ self.errors.add(:to, _("%{fn} '%s' isn't a valid e-mail address") % value)
	20	+ end
	21	+ end
	22	+ else
	23	+ allowed_emails = environment ? environment.send_email_plugin_allow_to.to_s.gsub(/\s+/, '').split(/,/) : []
	24	+ if to_as_list.any? do \|value\|
	25	+ if !allowed_emails.include?(value)
	26	+ self.errors.add(:to, _("%{fn} '%s' address is not allowed (see SendEmailPlugin config)") % value)
	27	+ end
	28	+ end
	29	+ end
	30	+ end
	31	+ end
	32	+
	33	+ def params=(value = {})
	34	+ [:action, :controller, :to, :message, :subject, :from].each{\|k\| value.delete(k)}
	35	+ self[:params] = value
	36	+ end
	37	+
	38	+ def to_as_list
	39	+ to && to.split(/,/) \|\| []
	40	+ end
	41	+
	42	+end
@@ -0,0 +1,13 @@		@@ -0,0 +1,13 @@
	1	+class SendEmailPlugin::Sender < Noosfero::Plugin::MailerBase
	2	+ prepend_view_path(SendEmailPlugin.root_path+'/views')
	3	+
	4	+ def mail(referer, url, mail)
	5	+ recipients mail.to
	6	+ from mail.from
	7	+ subject "[#{mail.environment.name}] #{mail.subject}"
	8	+ body :message => mail.message,
	9	+ :referer => referer,
	10	+ :context_url => url,
	11	+ :params => mail.params
	12	+ end
	13	+end
@@ -0,0 +1,22 @@		@@ -0,0 +1,22 @@
	1	+.sendemail-plugin-message-sent {
	2	+ width: 100%;
	3	+ background-color: #F0F0F0;
	4	+ border: 1px solid #CFCFCF;
	5	+}
	6	+.sendemail-plugin-message-sent td {
	7	+ border: 0;
	8	+}
	9	+.sendemail-plugin-message-sent tr:hover,
	10	+.sendemail-plugin-message-sent td:hover,
	11	+.sendemail-plugin-message-sent tr:hover td {
	12	+ background-color: auto;
	13	+}
	14	+.sendemail-plugin-message-sent pre {
	15	+ margin: 0 auto;
	16	+}
	17	+.sendemail-plugin-message-sent td {
	18	+ vertical-align: top;
	19	+}
	20	+.sendemail-plugin-message-sent .value {
	21	+ width: 100%;
	22	+}