RubyGems - mail_engine - Versions diffs - 0.0.1 → 0.1.0 - Mend

mail_engine 0.0.1 → 0.1.0

Files changed (452) hide show

data/doc/MailEngine/ZipProcessor.html ADDED Viewed

@@ -0,0 +1,267 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <meta name="Content-Type" content="text/html; charset=utf-8" />
+<title>Class: MailEngine::ZipProcessor</title>
+<link rel="stylesheet" href="../css/style.css" type="text/css" media="screen" charset="utf-8" />
+<link rel="stylesheet" href="../css/common.css" type="text/css" media="screen" charset="utf-8" />
+<script type="text/javascript" charset="utf-8">
+  relpath = '..';
+  if (relpath != '') relpath += '/';
+</script>
+<script type="text/javascript" charset="utf-8" src="../js/jquery.js"></script>
+<script type="text/javascript" charset="utf-8" src="../js/app.js"></script>
+  </head>
+  <body>
+    <script type="text/javascript" charset="utf-8">
+      if (window.top.frames.main) document.body.className = 'frames';
+    </script>
+    <div id="header">
+      <div id="menu">
+    <a href="../_index.html">Index (Z)</a> &raquo;
+    <span class='title'><span class='object_link'><a href="../MailEngine.html" title="MailEngine (module)">MailEngine</a></span></span>
+     &raquo;
+    <span class="title">ZipProcessor</span>
+  <div class="noframes"><span class="title">(</span><a href="." target="_top">no frames</a><span class="title">)</span></div>
+</div>
+      <div id="search">
+  <a id="class_list_link" href="#">Class List</a>
+  <a id="method_list_link" href="#">Method List</a>
+  <a id ="file_list_link" href="#">File List</a>
+</div>
+      <div class="clear"></div>
+    </div>
+    <iframe id="search_frame"></iframe>
+    <div id="content"><h1>Class: MailEngine::ZipProcessor
+</h1>
+<dl class="box">
+    <dt class="r1">Inherits:</dt>
+    <dd class="r1">
+      <span class="inheritName">Object</span>
+        <ul class="fullTree">
+          <li>Object</li>
+            <li class="next">MailEngine::ZipProcessor</li>
+        </ul>
+        <a href="#" class="inheritanceTree">show all</a>
+      </dd>
+    <dt class="r2 last">Defined in:</dt>
+    <dd class="r2 last">lib/mail_engine/zip_processor.rb</dd>
+</dl>
+<div class="clear"></div>
+    <h2>
+      Class Method Summary
+      <small>(<a href="#" class="summary_toggle">collapse</a>)</small>
+    </h2>
+    <ul class="summary">
+        <li class="public ">
+  <span class="summary_signature">
+      <a href="#extract_all_files-class_method" title="extract_all_files (class method)">+ (Object) <strong>extract_all_files</strong>(zip_file_path, needed_exts) </a>
+  </span>
+    <span class="summary_desc"><div class='inline'><p>
+Usage: MailEngine::ZipProcessor.extract_all_files(path, [&quot;css&quot;,
+&quot;jpg&quot;, &quot;gif&quot;]) do |file_path|.
+</p>
+</div></span>
+</li>
+    </ul>
+  <div id="class_method_details" class="method_details_list">
+    <h2>Class Method Details</h2>
+      <div class="method_details first">
+  <p class="signature first" id="extract_all_files-class_method">
+    + (<tt>Object</tt>) <strong>extract_all_files</strong>(zip_file_path, needed_exts)
+</p><div class="docstring">
+  <div class="discussion">
+    <p>
+Usage: MailEngine::ZipProcessor.extract_all_files(path, [&quot;css&quot;,
+&quot;jpg&quot;, &quot;gif&quot;]) do |file_path|
+</p>
+<pre class="code">
+  <span class='Image constant id'>Image</span><span class='dot token'>.</span><span class='create identifier id'>create</span> <span class='symbol val'>:file</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='File constant id'>File</span><span class='dot token'>.</span><span class='open identifier id'>open</span><span class='lparen token'>(</span><span class='file_path identifier id'>file_path</span><span class='rparen token'>)</span>
+</pre>
+<p>
+end
+</p>
+<p>
+Params: zip_file_path =&gt; /path/to/your/zip_file needed_exts =&gt;
+[&#8216;jpg&#8217;, &#8216;jpeg&#8217;, &#8216;css&#8217;]
+</p>
+<p>
+Result: the first item of array is file paths you needed and extracted from
+zip file. the second item is the unzip path.
+</p>
+<p>
+[
+</p>
+<pre class="code">
+  <span class='lbrack token'>[</span>
+    <span class='string val'>&quot;/Volumes/documents/projects/work/mail_engine/test/dummy/tmp/zip_processor_tmp_dir/compress_by_dir9671920/compress_by_file/css/example.css&quot;</span><span class='comma token'>,</span>
+    <span class='string val'>&quot;/Volumes/documents/projects/work/mail_engine/test/dummy/tmp/zip_processor_tmp_dir/compress_by_dir9671920/compress_by_file/images/logo.png&quot;</span><span class='comma token'>,</span>
+    <span class='string val'>&quot;/Volumes/documents/projects/work/mail_engine/test/dummy/tmp/zip_processor_tmp_dir/compress_by_dir9671920/compress_by_file/index.html&quot;</span>
+  <span class='rbrack token'>]</span><span class='comma token'>,</span>
+  <span class='string val'>&quot;/Volumes/documents/projects/work/mail_engine/test/dummy/tmp/zip_processor_tmp_dir/compress_by_dir9671920&quot;</span>
+</pre>
+<p>
+]
+</p>
+  </div>
+</div>
+<div class="tags">
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+25
+26
+27
+28
+29
+30
+31
+32
+33
+34
+35
+36
+37
+38
+39
+40
+41
+42
+43
+44
+45
+46
+47
+48
+49
+50
+51
+52
+53
+54
+55
+56
+57</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/mail_engine/zip_processor.rb', line 25</span>
+<span class='def def kw'>def</span> <span class='extract_all_files identifier id'>extract_all_files</span><span class='lparen token'>(</span><span class='zip_file_path identifier id'>zip_file_path</span><span class='comma token'>,</span> <span class='needed_exts identifier id'>needed_exts</span><span class='rparen token'>)</span>
+  <span class='return return kw'>return</span> <span class='unless unless_mod kw'>unless</span> <span class='zip_file_path identifier id'>zip_file_path</span> <span class='match op'>=~</span> <span class='regexp val'>/\.zip$/i</span>
+  <span class='comment val'># Create zip_processor_tmp_dir dir</span>
+  <span class='zip_processor_tmp_dir identifier id'>zip_processor_tmp_dir</span> <span class='assign token'>=</span> <span class='File constant id'>File</span><span class='dot token'>.</span><span class='join identifier id'>join</span><span class='lparen token'>(</span><span class='Rails constant id'>Rails</span><span class='dot token'>.</span><span class='root identifier id'>root</span><span class='comma token'>,</span> <span class='string val'>'tmp'</span><span class='comma token'>,</span> <span class='string val'>'zip_processor_tmp_dir'</span><span class='rparen token'>)</span>
+  <span class='unless unless kw'>unless</span> <span class='File constant id'>File</span><span class='dot token'>.</span><span class='exist? fid id'>exist?</span><span class='lparen token'>(</span><span class='zip_processor_tmp_dir identifier id'>zip_processor_tmp_dir</span><span class='rparen token'>)</span>
+    <span class='FileUtils constant id'>FileUtils</span><span class='dot token'>.</span><span class='mkdir_p identifier id'>mkdir_p</span><span class='lparen token'>(</span><span class='zip_processor_tmp_dir identifier id'>zip_processor_tmp_dir</span><span class='rparen token'>)</span>
+  <span class='end end kw'>end</span>
+  <span class='file_fullname identifier id'>file_fullname</span> <span class='assign token'>=</span> <span class='File constant id'>File</span><span class='dot token'>.</span><span class='basename identifier id'>basename</span><span class='lparen token'>(</span><span class='zip_file_path identifier id'>zip_file_path</span><span class='rparen token'>)</span>
+  <span class='filename identifier id'>filename</span> <span class='assign token'>=</span> <span class='file_fullname identifier id'>file_fullname</span><span class='dot token'>.</span><span class='sub identifier id'>sub</span><span class='lparen token'>(</span><span class='regexp val'>/.zip$/</span><span class='comma token'>,</span> <span class='string val'>&quot;&quot;</span><span class='rparen token'>)</span>
+  <span class='unzip_path identifier id'>unzip_path</span> <span class='assign token'>=</span> <span class='File constant id'>File</span><span class='dot token'>.</span><span class='join identifier id'>join</span><span class='lparen token'>(</span><span class='zip_processor_tmp_dir identifier id'>zip_processor_tmp_dir</span><span class='comma token'>,</span> <span class='dstring node'>&quot;#{filename}#{rand(10000000)}&quot;</span><span class='rparen token'>)</span>
+  <span class='unzip_result identifier id'>unzip_result</span> <span class='assign token'>=</span> <span class='system identifier id'>system</span><span class='lparen token'>(</span><span class='dstring node'>&quot;unzip #{zip_file_path} -d #{unzip_path} &gt; /dev/null&quot;</span><span class='rparen token'>)</span>
+  <span class='unzip_result identifier id'>unzip_result</span> <span class='assign token'>=</span> <span class='unzip_result identifier id'>unzip_result</span> <span class='andop op'>&amp;&amp;</span> <span class='$? gvar id'>$?</span><span class='dot token'>.</span><span class='exitstatus identifier id'>exitstatus</span> <span class='eq op'>==</span> <span class='integer val'>0</span>
+  <span class='return return kw'>return</span> <span class='unless unless_mod kw'>unless</span> <span class='unzip_result identifier id'>unzip_result</span>
+  <span class='file_ext_param_str identifier id'>file_ext_param_str</span> <span class='assign token'>=</span> <span class='needed_exts identifier id'>needed_exts</span><span class='dot token'>.</span><span class='map identifier id'>map</span> <span class='lbrace token'>{</span><span class='bitor op'>|</span><span class='ext identifier id'>ext</span><span class='bitor op'>|</span> <span class='dstring node'>&quot;-iname '*.#{ext}'&quot;</span> <span class='rbrace token'>}</span><span class='dot token'>.</span><span class='join identifier id'>join</span><span class='lparen token'>(</span><span class='string val'>&quot; -o &quot;</span><span class='rparen token'>)</span>
+  <span class='result_list_string identifier id'>result_list_string</span> <span class='assign token'>=</span> <span class='dxstring node'>`find #{unzip_path} #{file_ext_param_str}`</span>
+  <span class='result_list identifier id'>result_list</span> <span class='assign token'>=</span> <span class='result_list_string identifier id'>result_list_string</span><span class='dot token'>.</span><span class='split identifier id'>split</span><span class='lparen token'>(</span><span class='string val'>&quot;\n&quot;</span><span class='rparen token'>)</span>
+  <span class='if if kw'>if</span> <span class='block_given? fid id'>block_given?</span>
+    <span class='result_list identifier id'>result_list</span><span class='dot token'>.</span><span class='each identifier id'>each</span> <span class='do do kw'>do</span> <span class='bitor op'>|</span><span class='file_path identifier id'>file_path</span><span class='bitor op'>|</span>
+      <span class='yield yield kw'>yield</span> <span class='file_path identifier id'>file_path</span>
+    <span class='end end kw'>end</span>
+    <span class='comment val'># remove the unzip tmp files.</span>
+    <span class='system identifier id'>system</span><span class='lparen token'>(</span><span class='dstring node'>&quot;rm -rf #{unzip_path}&quot;</span><span class='rparen token'>)</span>
+  <span class='else else kw'>else</span>
+    <span class='lbrack token'>[</span><span class='result_list identifier id'>result_list</span><span class='comma token'>,</span> <span class='unzip_path identifier id'>unzip_path</span><span class='rbrack token'>]</span>
+  <span class='end end kw'>end</span>
+<span class='end end kw'>end</span>
+</pre>
+    </td>
+  </tr>
+</table>
+</div>
+  </div>
+</div>
+    <div id="footer">
+  Generated on Fri Mar  4 00:23:20 2011 by
+  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
+  0.6.4 (ruby-1.8.7).
+</div>
+  </body>
+</html>

data/doc/_index.html CHANGED Viewed

@@ -121,16 +121,16 @@
             <ul>
                 <li>
-                  <span class='object_link'><a href="MailEngine/Sendgrid/Base/ClassMethods.html" title="MailEngine::Sendgrid::Base::ClassMethods (module)">ClassMethods</a></span>
+                  <span class='object_link'><a href="MailEngine/ActsAsMailReceiver/ClassMethods.html" title="MailEngine::ActsAsMailReceiver::ClassMethods (module)">ClassMethods</a></span>
-                    <small>(MailEngine::Sendgrid::Base)</small>
+                    <small>(MailEngine::ActsAsMailReceiver)</small>
                 </li>
                 <li>
-                  <span class='object_link'><a href="MailEngine/ActsAsMailReceiver/ClassMethods.html" title="MailEngine::ActsAsMailReceiver::ClassMethods (module)">ClassMethods</a></span>
+                  <span class='object_link'><a href="MailEngine/Sendgrid/Base/ClassMethods.html" title="MailEngine::Sendgrid::Base::ClassMethods (module)">ClassMethods</a></span>
-                    <small>(MailEngine::ActsAsMailReceiver)</small>
+                    <small>(MailEngine::Sendgrid::Base)</small>
                 </li>
@@ -149,14 +149,21 @@
                 </li>
                 <li>
-                  <span class='object_link'><a href="MailEngine/CreateConfig.html" title="MailEngine::CreateConfig (class)">CreateConfig</a></span>
+                  <span class='object_link'><a href="MailEngine/CopyMigrations.html" title="MailEngine::CopyMigrations (class)">CopyMigrations</a></span>
+                    <small>(MailEngine)</small>
+                </li>
+                <li>
+                  <span class='object_link'><a href="MailEngine/CopyResources.html" title="MailEngine::CopyResources (class)">CopyResources</a></span>
                     <small>(MailEngine)</small>
                 </li>
                 <li>
-                  <span class='object_link'><a href="MailEngine/CreateMigration.html" title="MailEngine::CreateMigration (class)">CreateMigration</a></span>
+                  <span class='object_link'><a href="MailEngine/CreateConfig.html" title="MailEngine::CreateConfig (class)">CreateConfig</a></span>
                     <small>(MailEngine)</small>
@@ -215,6 +222,13 @@
             <li class="letter">I</li>
             <ul>
+                <li>
+                  <span class='object_link'><a href="MailEngine/Install.html" title="MailEngine::Install (class)">Install</a></span>
+                    <small>(MailEngine)</small>
+                </li>
                 <li>
                   <span class='object_link'><a href="MailEngine/Sendgrid/Base/InstanceMethods.html" title="MailEngine::Sendgrid::Base::InstanceMethods (module)">InstanceMethods</a></span>
@@ -313,7 +327,7 @@
 </div></div>
     <div id="footer">
-  Generated on Fri Feb 25 18:06:27 2011 by
+  Generated on Fri Mar  4 00:23:18 2011 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.6.4 (ruby-1.8.7).
 </div>

data/doc/class_list.html CHANGED Viewed

@@ -27,7 +27,7 @@
       <ul id="full_list" class="class">
         <li><span class='object_link'><a href="top-level-namespace.html" title=" (root)">Top Level Namespace</a></span></li>
-<li><a class='toggle'></a> <span class='object_link'><a href="ActionMailer.html" title="ActionMailer (module)">ActionMailer</a></span><small class='search_info'>Top Level Namespace</small></li><ul><li><span class='object_link'><a href="ActionMailer/Base.html" title="ActionMailer::Base (class)">Base</a></span> &lt; Object<small class='search_info'>ActionMailer</small></li><li><span class='object_link'><a href="ActionMailer/Collector.html" title="ActionMailer::Collector (class)">Collector</a></span> &lt; Object<small class='search_info'>ActionMailer</small></li></ul><li><a class='toggle'></a> <span class='object_link'><a href="MailEngine.html" title="MailEngine (module)">MailEngine</a></span><small class='search_info'>Top Level Namespace</small></li><ul><li><a class='toggle'></a> <span class='object_link'><a href="MailEngine/ActsAsMailReceiver.html" title="MailEngine::ActsAsMailReceiver (module)">ActsAsMailReceiver</a></span><small class='search_info'>MailEngine</small></li><ul><li><span class='object_link'><a href="MailEngine/ActsAsMailReceiver/ClassMethods.html" title="MailEngine::ActsAsMailReceiver::ClassMethods (module)">ClassMethods</a></span><small class='search_info'>MailEngine::ActsAsMailReceiver</small></li></ul><li><span class='object_link'><a href="MailEngine/Base.html" title="MailEngine::Base (class)">Base</a></span> &lt; Object<small class='search_info'>MailEngine</small></li><li><span class='object_link'><a href="MailEngine/Configuration.html" title="MailEngine::Configuration (class)">Configuration</a></span> &lt; Object<small class='search_info'>MailEngine</small></li><li><span class='object_link'><a href="MailEngine/CreateConfig.html" title="MailEngine::CreateConfig (class)">CreateConfig</a></span> &lt; Base<small class='search_info'>MailEngine</small></li><li><span class='object_link'><a href="MailEngine/CreateMigration.html" title="MailEngine::CreateMigration (class)">CreateMigration</a></span> &lt; Base<small class='search_info'>MailEngine</small></li><li><span class='object_link'><a href="MailEngine/Engine.html" title="MailEngine::Engine (class)">Engine</a></span> &lt; Engine<small class='search_info'>MailEngine</small></li><li><span class='object_link'><a href="MailEngine/HtmlDocumentAssetsReplacer.html" title="MailEngine::HtmlDocumentAssetsReplacer (class)">HtmlDocumentAssetsReplacer</a></span> &lt; Object<small class='search_info'>MailEngine</small></li><li><span class='object_link'><a href="MailEngine/MailLogSubscriber.html" title="MailEngine::MailLogSubscriber (class)">MailLogSubscriber</a></span> &lt; LogSubscriber<small class='search_info'>MailEngine</small></li><li><a class='toggle'></a> <span class='object_link'><a href="MailEngine/Sendgrid.html" title="MailEngine::Sendgrid (module)">Sendgrid</a></span><small class='search_info'>MailEngine</small></li><ul><li><a class='toggle'></a> <span class='object_link'><a href="MailEngine/Sendgrid/Base.html" title="MailEngine::Sendgrid::Base (module)">Base</a></span><small class='search_info'>MailEngine::Sendgrid</small></li><ul><li><span class='object_link'><a href="MailEngine/Sendgrid/Base/ClassMethods.html" title="MailEngine::Sendgrid::Base::ClassMethods (module)">ClassMethods</a></span><small class='search_info'>MailEngine::Sendgrid::Base</small></li><li><span class='object_link'><a href="MailEngine/Sendgrid/Base/InstanceMethods.html" title="MailEngine::Sendgrid::Base::InstanceMethods (module)">InstanceMethods</a></span><small class='search_info'>MailEngine::Sendgrid::Base</small></li></ul><li><span class='object_link'><a href="MailEngine/Sendgrid/FilterSetting.html" title="MailEngine::Sendgrid::FilterSetting (class)">FilterSetting</a></span> &lt; Object<small class='search_info'>MailEngine::Sendgrid</small></li><li><span class='object_link'><a href="MailEngine/Sendgrid/RestApi.html" title="MailEngine::Sendgrid::RestApi (class)">RestApi</a></span> &lt; Object<small class='search_info'>MailEngine::Sendgrid</small></li><li><span class='object_link'><a href="MailEngine/Sendgrid/RestApiError.html" title="MailEngine::Sendgrid::RestApiError (class)">RestApiError</a></span> &lt; StandardError<small class='search_info'>MailEngine::Sendgrid</small></li><li><span class='object_link'><a href="MailEngine/Sendgrid/SmtpApi.html" title="MailEngine::Sendgrid::SmtpApi (class)">SmtpApi</a></span> &lt; Object<small class='search_info'>MailEngine::Sendgrid</small></li></ul><li><span class='object_link'><a href="MailEngine/ZipProcessor.html" title="MailEngine::ZipProcessor (class)">ZipProcessor</a></span> &lt; Object<small class='search_info'>MailEngine</small></li></ul>
+<li><a class='toggle'></a> <span class='object_link'><a href="ActionMailer.html" title="ActionMailer (module)">ActionMailer</a></span><small class='search_info'>Top Level Namespace</small></li><ul><li><span class='object_link'><a href="ActionMailer/Base.html" title="ActionMailer::Base (class)">Base</a></span> &lt; Object<small class='search_info'>ActionMailer</small></li><li><span class='object_link'><a href="ActionMailer/Collector.html" title="ActionMailer::Collector (class)">Collector</a></span> &lt; Object<small class='search_info'>ActionMailer</small></li></ul><li><a class='toggle'></a> <span class='object_link'><a href="MailEngine.html" title="MailEngine (module)">MailEngine</a></span><small class='search_info'>Top Level Namespace</small></li><ul><li><a class='toggle'></a> <span class='object_link'><a href="MailEngine/ActsAsMailReceiver.html" title="MailEngine::ActsAsMailReceiver (module)">ActsAsMailReceiver</a></span><small class='search_info'>MailEngine</small></li><ul><li><span class='object_link'><a href="MailEngine/ActsAsMailReceiver/ClassMethods.html" title="MailEngine::ActsAsMailReceiver::ClassMethods (module)">ClassMethods</a></span><small class='search_info'>MailEngine::ActsAsMailReceiver</small></li></ul><li><span class='object_link'><a href="MailEngine/Base.html" title="MailEngine::Base (class)">Base</a></span> &lt; Object<small class='search_info'>MailEngine</small></li><li><span class='object_link'><a href="MailEngine/Configuration.html" title="MailEngine::Configuration (class)">Configuration</a></span> &lt; Object<small class='search_info'>MailEngine</small></li><li><span class='object_link'><a href="MailEngine/CopyMigrations.html" title="MailEngine::CopyMigrations (class)">CopyMigrations</a></span> &lt; Base<small class='search_info'>MailEngine</small></li><li><span class='object_link'><a href="MailEngine/CopyResources.html" title="MailEngine::CopyResources (class)">CopyResources</a></span> &lt; Base<small class='search_info'>MailEngine</small></li><li><span class='object_link'><a href="MailEngine/CreateConfig.html" title="MailEngine::CreateConfig (class)">CreateConfig</a></span> &lt; Base<small class='search_info'>MailEngine</small></li><li><span class='object_link'><a href="MailEngine/Engine.html" title="MailEngine::Engine (class)">Engine</a></span> &lt; Engine<small class='search_info'>MailEngine</small></li><li><span class='object_link'><a href="MailEngine/HtmlDocumentAssetsReplacer.html" title="MailEngine::HtmlDocumentAssetsReplacer (class)">HtmlDocumentAssetsReplacer</a></span> &lt; Object<small class='search_info'>MailEngine</small></li><li><span class='object_link'><a href="MailEngine/Install.html" title="MailEngine::Install (class)">Install</a></span> &lt; Base<small class='search_info'>MailEngine</small></li><li><span class='object_link'><a href="MailEngine/MailLogSubscriber.html" title="MailEngine::MailLogSubscriber (class)">MailLogSubscriber</a></span> &lt; LogSubscriber<small class='search_info'>MailEngine</small></li><li><a class='toggle'></a> <span class='object_link'><a href="MailEngine/Sendgrid.html" title="MailEngine::Sendgrid (module)">Sendgrid</a></span><small class='search_info'>MailEngine</small></li><ul><li><a class='toggle'></a> <span class='object_link'><a href="MailEngine/Sendgrid/Base.html" title="MailEngine::Sendgrid::Base (module)">Base</a></span><small class='search_info'>MailEngine::Sendgrid</small></li><ul><li><span class='object_link'><a href="MailEngine/Sendgrid/Base/ClassMethods.html" title="MailEngine::Sendgrid::Base::ClassMethods (module)">ClassMethods</a></span><small class='search_info'>MailEngine::Sendgrid::Base</small></li><li><span class='object_link'><a href="MailEngine/Sendgrid/Base/InstanceMethods.html" title="MailEngine::Sendgrid::Base::InstanceMethods (module)">InstanceMethods</a></span><small class='search_info'>MailEngine::Sendgrid::Base</small></li></ul><li><span class='object_link'><a href="MailEngine/Sendgrid/FilterSetting.html" title="MailEngine::Sendgrid::FilterSetting (class)">FilterSetting</a></span> &lt; Object<small class='search_info'>MailEngine::Sendgrid</small></li><li><span class='object_link'><a href="MailEngine/Sendgrid/RestApi.html" title="MailEngine::Sendgrid::RestApi (class)">RestApi</a></span> &lt; Object<small class='search_info'>MailEngine::Sendgrid</small></li><li><span class='object_link'><a href="MailEngine/Sendgrid/RestApiError.html" title="MailEngine::Sendgrid::RestApiError (class)">RestApiError</a></span> &lt; StandardError<small class='search_info'>MailEngine::Sendgrid</small></li><li><span class='object_link'><a href="MailEngine/Sendgrid/SmtpApi.html" title="MailEngine::Sendgrid::SmtpApi (class)">SmtpApi</a></span> &lt; Object<small class='search_info'>MailEngine::Sendgrid</small></li></ul><li><span class='object_link'><a href="MailEngine/ZipProcessor.html" title="MailEngine::ZipProcessor (class)">ZipProcessor</a></span> &lt; Object<small class='search_info'>MailEngine</small></li></ul>
       </ul>
     </div>

data/doc/file.README.html ADDED Viewed

@@ -0,0 +1,231 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <meta name="Content-Type" content="text/html; charset=utf-8" />
+<title>Documentation by YARD 0.6.4</title>
+<link rel="stylesheet" href="css/style.css" type="text/css" media="screen" charset="utf-8" />
+<link rel="stylesheet" href="css/common.css" type="text/css" media="screen" charset="utf-8" />
+<script type="text/javascript" charset="utf-8">
+  relpath = '';
+  if (relpath != '') relpath += '/';
+</script>
+<script type="text/javascript" charset="utf-8" src="js/jquery.js"></script>
+<script type="text/javascript" charset="utf-8" src="js/app.js"></script>
+  </head>
+  <body>
+    <script type="text/javascript" charset="utf-8">
+      if (window.top.frames.main) document.body.className = 'frames';
+    </script>
+    <div id="header">
+      <div id="menu">
+    <a href="_index.html" title="Index">Index</a> &raquo;
+    <span class="title">File: README</span>
+  <div class="noframes"><span class="title">(</span><a href="." target="_top">no frames</a><span class="title">)</span></div>
+</div>
+      <div id="search">
+  <a id="class_list_link" href="#">Class List</a>
+  <a id="method_list_link" href="#">Method List</a>
+  <a id ="file_list_link" href="#">File List</a>
+</div>
+      <div class="clear"></div>
+    </div>
+    <iframe id="search_frame"></iframe>
+    <div id="content"><div id='filecontents'><h1>Why Mail Engine</h1>
+<ol>
+<li>Don't need to export and import your system data to any other mail systems(like mailchimp, mad_mimi).</li>
+<li>Allow user to edit all email templates directly in system admin, save the time of developer to participate in.</li>
+<li>Allow user to add mail sending schedule directly in system admin, don't need developer to add
+them into code or deploy crontab at server each time when client have new request.</li>
+<li>Fully take advantage of the convenience of loading any system data to mail template. In the past,
+like using mailchimp, you have to store everything into user list, then you are able to load that into
+mail template, it increased the complexity of maintaining information in another system.</li>
+<li>If you want to trace your mail, like open rate, click rate and unsubscribe rate, we provide Sendgrid
+integration configuration to take advantage that system. (More information at http://sendgrid.com)</li>
+<li>Allow logging all sent mails, you can check which mail been sent to which user.</li>
+<li>You can know send the email to the active users, so that you don't need to waste your credits of sendgrid or amazon.</li>
+</ol>
+<h1>Problem when using third party mail system</h1>
+<p>We are using mailchimp mostly for the newsletter solution, but it's has many problems that we have to make a new mail engine
+to fit our needs in real project:</p>
+<ol>
+<li>It is only one newsletter or marketing mail solution, so for system mail, it can do nothing, so for system mail we still go the original way (put them in the rails project.)</li>
+<li>Mailchimp don't support other encode for mail, when sending japanese or chinese mail it will be failed.</li>
+<li>It doesn't support localization, so different language is different campaign, you need to set a lot config for each of them.</li>
+<li>Manage user list is awkward, it even can't create list by API, so you have to create list one by one by hand.</li>
+<li>It can't load other user personal or customized data from system into mail, like latest unchecked news or messages, it's very limited to load info from user list record.</li>
+<li>It doesn't support reusable partials, which like you hope to put a fixed content of footer or header.</li>
+<li>It doesn't support recurring mail sending.</li>
+</ol>
+<h1>Installation</h1>
+<p><strong> Step 1: </strong></p>
+<pre class="code"><span class='gem identifier id'>gem</span> <span class='install identifier id'>install</span> <span class='mail_engine identifier id'>mail_engine</span>
+</pre>
+<p><strong> Step 2: </strong></p>
+<p>Add management page needed javascript lib and css files, migration files and mail<em>engine</em>config.yml under config directory.</p>
+<pre class="code"><span class='rails identifier id'>rails</span> <span class='g identifier id'>g</span> <span class='mail_engine identifier id'>mail_engine</span><span class='symbol val'>:install</span>
+</pre>
+<p><strong> Step 3: </strong></p>
+<p>Run migration.</p>
+<pre class="code"><span class='rake identifier id'>rake</span> <span class='db identifier id'>db</span><span class='symbol val'>:migrate</span>
+</pre>
+<p><strong> Step 4: </strong></p>
+<p>Add below line to the crontab list of your sever:</p>
+<pre class="code"><span class='comment val'>### check mail schedule for every 15 minutes ###</span>
+<span class='mult op'>*</span><span class='regexp val'>/4 * * * * sh -c &quot;cd /</span><span class='path identifier id'>path</span><span class='div op'>/</span><span class='to identifier id'>to</span><span class='div op'>/</span><span class='your identifier id'>your</span><span class='div op'>/</span><span class='system identifier id'>system</span> <span class='andop op'>&amp;&amp;</span> <span class='rake identifier id'>rake</span> <span class='mail_engine identifier id'>mail_engine</span><span class='symbol val'>:sendmail</span> <span class='RAILS_ENV constant id'>RAILS_ENV</span><span class='assign token'>=</span><span class='production identifier id'>production</span><span class='string val'>&quot;
+</span></pre>
+<h1>Usage</h1>
+<p><strong> For System Mail: </strong></p>
+<p>Due to the sender of system mail is ActionMailer, so you just need to set template physical store path (e.g. user_mailer/notify)
+as the mailer template load path, system will load it from database. (Notice, database template will
+override your file template.)</p>
+<p>Mail Engine use Liquid template engine, so you can read the Liquid Reference at http://www.liquidmarkup.org/</p>
+<p>Steps:</p>
+<ol>
+<li>Create a template in mail engine.</li>
+</ol>
+<p><strong> For Marketing Mail: </strong></p>
+<p>For normal marketing mails are quite simple in logic, so don't need logic code in the mail template.
+So we provide a mail dispatcher which allows user can send marketing mail only by providing the template and
+select the data pre-defined in system to the mail template, don't need developer to do anything like adding mailer file.</p>
+<p>Steps:</p>
+<ol>
+<li>Create a mail tempate in mail engine.</li>
+<li>Create a sending schedule record. (You can specify the users to receive this mail, total sending count,
+sending period, when start to deliver the first mail and load which data into this template, You also can set
+condition for the scheduler, like if no specified data in collection, don't send the mail.)</li>
+</ol>
+<p>You also can send mail in your program by using:
+MailEngine::MailDispatcher.marketing mail template name(:to => "Michael he <a href="&#x6d;&#x61;&#x69;&#108;&#x74;&#111;&#58;&#x68;&#108;&#x78;&#119;&#x65;&#108;&#108;&#x40;&#103;&#109;&#97;&#x69;&#x6c;&#x2e;&#99;&#x6f;&#109;">&#x68;&#108;&#x78;&#x77;&#x65;&#108;&#x6c;&#64;&#x67;&#109;&#x61;&#105;&#108;&#x2e;&#99;&#x6f;&#109;</a>", :values => => "Michael He").deliver</p>
+<h1>Screenshots</h1>
+<h2>Dashboard</h2>
+<p>Shows the latest report.</p>
+<p><img src="https://github.com/hlxwell/mail-engine/raw/master/screenshots/dashboard.png" title="Dashboard" alt="Dashboard" /></p>
+<h2>Template Management</h2>
+<p>You can manage the template used in your system, including:</p>
+<ol>
+<li>System mail, has it's own action mailer file.</li>
+<li>Marketing mail, simple logic and without it's own action mailer.</li>
+<li>Partials, you can reused it in any other templates.</li>
+</ol>
+<p><img src="https://github.com/hlxwell/mail-engine/raw/master/screenshots/templates.png" title="Template Management" alt="Template Management" /></p>
+<h2>Template editing Page</h2>
+<p>You can see here are many details you can change:</p>
+<ol>
+<li>Template Path, system action mailer can find it when lookup mail template.</li>
+<li>Locale</li>
+<li>Format</li>
+<li>Layout</li>
+<li>Files will used in the template.</li>
+<li>Zip File when you used at creating this template.</li>
+<li>Preview template in time.</li>
+</ol>
+<p><img src="https://github.com/hlxwell/mail-engine/raw/master/screenshots/editing_mail_template.png" title="Template editing Preview" alt="Template editing Preview" /></p>
+<h2>Upload html template with image in a zip file</h2>
+<p>You can create a template by uplaoding a zip file including one html and other images or css files.</p>
+<p><img src="https://github.com/hlxwell/mail-engine/raw/master/screenshots/new_by_upload.png" title="Upload html template with image in a zip file." alt="Upload html template with image in a zip file.&quot;)" /></p>
+<h2>Partial and Layout selection</h2>
+<p><img src="https://github.com/hlxwell/mail-engine/raw/master/screenshots/select_layout_partial.png" title="Partial and Layout selection" alt="Partial and Layout selection" /></p>
+<h2>Mail Schedule</h2>
+<p>You can set a mail sending schedule, here are some useful setting items:</p>
+<ol>
+<li>Marketing Mail Template.</li>
+<li>User Group will be received this mail.</li>
+<li>Total send count.</li>
+<li>Already send count.</li>
+<li>Sending Period.</li>
+<li>Payloads which load from user model and send to template when sending.</li>
+<li>First send date time, this date will indicate when this mail will be send first time, and according to the seding period it will resend at the same time after one period.</li>
+<li>You can set requirements, which been predefined in the system, let the mail not been sent if the requirements is unreached.</li>
+</ol>
+<p><img src="https://github.com/hlxwell/mail-engine/raw/master/screenshots/schedule.png" title="Mail Schedule" alt="Mail Schedule" /></p>
+<h2>Mail Logs</h2>
+<p>It will log all mails' content been sent, you can turn it off in config file.</p>
+<p><img src="https://github.com/hlxwell/mail-engine/raw/master/screenshots/logs.png" title="Mail Logs" alt="Mail Logs" /></p>
+<h2>Report</h2>
+<p>Shows detail chart and data list of mail sending stats.</p>
+<p><img src="https://github.com/hlxwell/mail-engine/raw/master/screenshots/reports.png" title="Report" alt="Report" /></p>
+<h2>Bounce Report</h2>
+<p><img src="https://github.com/hlxwell/mail-engine/raw/master/screenshots/bounce_report.png" title="Bounce Report" alt="Bounce Report" /></p></div></div>
+    <div id="footer">
+  Generated on Fri Mar  4 00:23:18 2011 by
+  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
+  0.6.4 (ruby-1.8.7).
+</div>
+  </body>
+</html>