the_merger 0.0.1

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,5 @@
+#source 'https://rubygems.org'
+source 'http://rubygems.railscamp.org'
+gem 'rake'
+# Specify your gem's dependencies in the_merger.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Michael Pope
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,65 @@
+# TheMerger
+
+A mail merge gem which allows you to do the following;
+- link to a table eg: clients. 
+- dynamically collects fields from the linked table and displays them in a helper drop down box
+- creates a letters table to store you custom letters to be mail merged
+- does the mail merging part which is to regex a body of text and replace with fields
+- manages bulk emails
+- manages scheduled emails (optional)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'the_merger'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install the_merger
+
+## Configure
+
+When using TheMerger in a controller you have to add the following line to the top
+    
+    include TheMerger
+
+Create a yaml file in your config directory called 'the_merger.yml' with something like this
+
+    ---
+    merge_model: "Client"
+
+
+To use the javascript included in this gem put the following in your application.js
+
+    //= require the_merger/application
+
+## Usage
+
+Currently it's just one method and this is how you pass it information
+
+    body = "Dear [firstname] [lastname], Please update your listing, from Mick"
+    TheMerger.merge_fields(body, "firstname", "lastname")
+
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+## TODO
+
+ - DONE - Get all users from the users table
+ - DONE - Mail merge and output to the screen
+ - DONE - Make the table a variable
+ - DONE - Create a method to get all fields from the selected table.
+ - DONE - Create a helper method to have a dropdown of fields
+ - DONE - Turn this into an engine so that I can include asset pipeline javascript.
+ - Get the Email all button to work

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/app/assets/javascript/jquery.caret.1.02.js

@@ -0,0 +1,71 @@
+/*
+ *
+ * Copyright (c) 2010 C. F., Wong (<a href="http://cloudgen.w0ng.hk">Cloudgen Examplet Store</a>)
+ * Licensed under the MIT License:
+ * http://www.opensource.org/licenses/mit-license.php
+ *
+ */
+(function($,len,createRange,duplicate){
+	$.fn.caret=function(options,opt2){
+		var start,end,t=this[0],browser='';//,browser=$.browser.msie;
+		if(typeof options==="object" && typeof options.start==="number" && typeof options.end==="number") {
+			start=options.start;
+			end=options.end;
+		} else if(typeof options==="number" && typeof opt2==="number"){
+			start=options;
+			end=opt2;
+		} else if(typeof options==="string"){
+			if((start=t.value.indexOf(options))>-1) end=start+options[len];
+			else start=null;
+		} else if(Object.prototype.toString.call(options)==="[object RegExp]"){
+			var re=options.exec(t.value);
+			if(re != null) {
+				start=re.index;
+				end=start+re[0][len];
+			}
+		}
+		if(typeof start!="undefined"){
+			if(browser){
+				var selRange = this[0].createTextRange();
+				selRange.collapse(true);
+				selRange.moveStart('character', start);
+				selRange.moveEnd('character', end-start);
+				selRange.select();
+			} else {
+				this[0].selectionStart=start;
+				this[0].selectionEnd=end;
+			}
+			this[0].focus();
+			return this
+		} else {
+			// Modification as suggested by Андрей Юткин
+           if(browser){
+				var selection=document.selection;
+                if (this[0].tagName.toLowerCase() != "textarea") {
+                    var val = this.val(),
+                    range = selection[createRange]()[duplicate]();
+                    range.moveEnd("character", val[len]);
+                    var s = (range.text == "" ? val[len]:val.lastIndexOf(range.text));
+                    range = selection[createRange]()[duplicate]();
+                    range.moveStart("character", -val[len]);
+                    var e = range.text[len];
+                } else {
+                    var range = selection[createRange](),
+                    stored_range = range[duplicate]();
+                    stored_range.moveToElementText(this[0]);
+                    stored_range.setEndPoint('EndToEnd', range);
+                    var s = stored_range.text[len] - range.text[len],
+                    e = s + range.text[len]
+                }
+			// End of Modification
+            } else {
+				var s=t.selectionStart,
+					e=t.selectionEnd;
+			}
+			var te=t.value.substring(s,e);
+			return {start:s,end:e,text:te,replace:function(st){
+				return t.value.substring(0,s)+st+t.value.substring(e,t.value[len])
+			}}
+		}
+	}
+})(jQuery,"length","createRange","duplicate");

data/app/assets/javascript/the_merger/application.js.coffee

@@ -0,0 +1,9 @@
+#= require jquery.caret.1.02
+#= require the_merger/insert_field
+
+the_merger = new TheMerger
+
+$ ->
+  $('.insert_field').click ->
+    the_merger.insert_field($(".mail_merge_body"), $("#field").val())
+    false

data/app/assets/javascript/the_merger/insert_field.js.coffee

@@ -0,0 +1,9 @@
+class window.TheMerger
+
+  insert_field: (body,field) ->
+    start=body.caret().start;                          # Get the start of the caret
+    first_half=body.val().slice(0, start);             # Get all text up to caret
+    last_half=body.val().slice(start, body.len);       # Get all text from caret to end
+    text = first_half + "[" + field + "]" + last_half  # Glue it all together with field
+    body.val(text)                                     # Put the result back into the text_area
+    false

data/app/mailer/the_merger/mailer.rb

@@ -0,0 +1,9 @@
+class TheMerger::Mailer < ActionMailer::Base
+    
+  def batch_mail(from,subject,body,person)
+    mail(from: from, 
+         to: person.email,
+         subject: subject,
+         body: body)
+  end  
+end

data/lib/the_merger/engine.rb

@@ -0,0 +1,3 @@
+class TheMerger::Engine < Rails::Engine
+	engine_name :the_merger
+end

data/lib/the_merger/version.rb

@@ -0,0 +1,3 @@
+module TheMerger
+  VERSION = "0.0.1"
+end

data/lib/the_merger/view_helpers/field_selector.rb

@@ -0,0 +1,9 @@
+module TheMerger
+  module ViewHelpers
+    class FieldSelector
+      def select_field
+        "<b>Select field box</b>"
+      end
+    end
+  end
+end

data/lib/the_merger.rb

@@ -0,0 +1,54 @@
+require "the_merger/version"
+
+module TheMerger
+  #
+  # Default settings for TheMerger
+  # 
+  # - merge_model:   User
+  #
+
+  def merge_fields(subject,original_body)
+    parse_config
+    
+    @merge_model.constantize.all.each do |user|
+      body = original_body.dup
+      
+      model_fields.each do |field|
+        newbody = body.gsub!("[#{field}]", user.send(field))
+        body = newbody unless newbody.nil?
+      end
+
+      # Send the emails
+      mailer = TheMerger::Mailer.batch_mail("from@example.com", subject, body, user)
+      mailer.deliver
+
+    end
+  end
+
+  def field_selection
+    body = select_tag :field, options_for_select(model_fields)
+    body += button_tag "Insert", class: "insert_field"
+    content_tag(:div, body, class: "merge_field")
+  end
+
+  def model_fields
+    parse_config
+    @merge_model.constantize.attribute_names.reject{|x| %w[created_at updated_at id].include?(x)}
+  end
+  
+  private
+
+  def parse_config
+    path = "#{Rails.root}/config/the_merger.yml"
+    
+    if File.exists?(path)
+      conf=YAML::load(IO.read(path))
+      @merge_model = conf["merge_model"]
+    else
+      @merge_model = "User"
+    end
+  end  
+end
+
+require "the_merger/engine"
+ActionView::Base.send :include, TheMerger

data/the_merger.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'the_merger/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "the_merger"
+  gem.version       = TheMerger::VERSION
+  gem.authors       = ["Michael Pope"]
+  gem.email         = ["map7777@gmail.com"]
+  gem.description   = %q{Mail merge a table of fields into a standard letter}
+  gem.summary       = %q{Mail Merge}
+  gem.homepage      = ""
+
+  # gem.add_development_dependency "mail"
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+end

metadata

@@ -0,0 +1,65 @@
+--- !ruby/object:Gem::Specification
+name: the_merger
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Michael Pope
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-06-25 00:00:00.000000000 Z
+dependencies: []
+description: Mail merge a table of fields into a standard letter
+email:
+- map7777@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- app/assets/javascript/jquery.caret.1.02.js
+- app/assets/javascript/the_merger/application.js.coffee
+- app/assets/javascript/the_merger/insert_field.js.coffee
+- app/mailer/the_merger/mailer.rb
+- lib/the_merger.rb
+- lib/the_merger/engine.rb
+- lib/the_merger/version.rb
+- lib/the_merger/view_helpers/field_selector.rb
+- the_merger.gemspec
+homepage: ''
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -3883735968301740834
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -3883735968301740834
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: Mail Merge
+test_files: []