mail_manager 3.2.0 → 3.2.1
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/README.md +25 -62
- data/app/views/layouts/mail_manager/application.html.erb +1 -1
- data/lib/mail_manager/version.rb +1 -1
- metadata +2 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA1:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 629cb0adeedd16a50516d77a801d98a355d3c4f1
|
4
|
+
data.tar.gz: 1257352173175de86d30db19ddfbe1890b342ebb
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: bcb81576b3fd8311480e663386bb4537f51fe56d66eb574c1867fe1972aab6dff8d5e00ffbc51537dcb5c2ca4ba94f15fda0b65dcc51effa3715afedb0af9f6f
|
7
|
+
data.tar.gz: c9f26c7e02ead7da06cbac09e31785ed14d4457c52d41768d049e410d523b5c3d437ced9e33a60b40021b0e9aa518a7e6bf42d39ef46bac915b7c41a1dbcfd4c
|
data/README.md
CHANGED
@@ -5,104 +5,67 @@ The goal of this project will be to create a plugin for use in any site which wi
|
|
5
5
|
|
6
6
|
Requirements
|
7
7
|
------------
|
8
|
-
* Rails 3.2.x
|
9
|
-
* Ruby 1.9.3
|
8
|
+
* Rails 3.2.x (currently tested with rails 3.2.21)
|
9
|
+
* Ruby 2.1.5 (currently tested with 2.1.5, we have tested against 1.9.3, but ruby devs no longer support it)
|
10
10
|
* [Bundler](http://bundler.io)
|
11
11
|
* [Delayed::Job](https://github.com/collectiveidea/delayed_job/) - (currently the only queue job runnerwe support)
|
12
12
|
|
13
13
|
Optional Dependencies
|
14
14
|
---------------------
|
15
15
|
* [RVM](http://rvm.io) - How we control our ruby environment(mainly concerns development)
|
16
|
+
* currently we use github/git for our repository
|
16
17
|
|
17
18
|
Installation
|
18
19
|
------------
|
19
20
|
Using bundler, edit your Gemfile.. add a one of the following lines:
|
20
|
-
|
21
|
+
```ruby
|
21
22
|
gem 'mail_manager', '~>3' # this points to the latest rails stable 3.2.x version
|
22
|
-
# OR
|
23
|
+
# OR
|
23
24
|
gem 'mail_manager', git: 'https://github.com/LoneStarInternet/mail_manager.git', branch: 'rails3.2.x' # for the bleeding edge rails 3.2.x version
|
24
|
-
|
25
|
+
```
|
25
26
|
Then run bundle install:
|
26
|
-
|
27
|
+
```
|
27
28
|
bundle install
|
28
|
-
|
29
|
-
Generate and configure the mail manager settings file at config/mail_manager.yml: (replace table prefix with something... or nothing if you don't want to scope it)
|
30
|
-
|
29
|
+
```
|
30
|
+
Generate and configure the mail manager settings file at config/mail_manager.yml: (replace table prefix with something... or nothing if you don't want to scope it)
|
31
|
+
```
|
31
32
|
rake mail_manager:default_app_config[table_prefix]
|
32
|
-
|
33
|
+
```
|
33
34
|
Generate migrations:
|
34
|
-
|
35
|
+
```
|
35
36
|
rake mail_manager:import_migrations
|
36
|
-
|
37
|
+
```
|
37
38
|
Generate delayed_jobs (this is the only job runner we support right now):
|
38
|
-
|
39
|
+
```
|
39
40
|
rails g delayed_job:active_record
|
41
|
+
```
|
40
42
|
|
41
43
|
**NOTE:** you need to create an email account that will receive bounces from your mailings(and allow POP)... configure in the following file:
|
42
44
|
|
43
45
|
Add your routes to config/routes.rb (you can say where with at: '/path')
|
44
|
-
|
46
|
+
```ruby
|
45
47
|
mount MailManager::Engine, at: '/admin/mail_manager'
|
48
|
+
```
|
46
49
|
|
47
50
|
config/mail_manager.yml
|
48
51
|
-----------------------
|
49
52
|
This is where amost all of your configuration options are for this gem... current generator will add documentation to it (preserving your current settings) .. we'll probably want to upgrade to something like: [AppConfig](https://github.com/Oshuma/app_config) gem
|
50
53
|
|
51
|
-
You can generate this file like above(where table_prefix is for prefixing table names):
|
52
54
|
|
55
|
+
You can generate this file like above(where table_prefix is for prefixing table names):
|
56
|
+
```
|
53
57
|
rake mail_manager:default_app_config[table_prefix]
|
54
|
-
|
55
|
-
|
58
|
+
```
|
59
|
+
* This generator adds settings documentation to the yml file
|
60
|
+
* You can override values with a config/mail_manager.local.yml
|
61
|
+
* For a full description [See the wiki](https://github.com/LoneStarInternet/mail_manager/wiki/config-mail_manager.yml)
|
56
62
|
|
57
63
|
Securing your App
|
58
64
|
-----------------
|
59
65
|
We implemented [CanCan](https://github.com/CanCanCommunity/cancancan). If you'd like to secure your actions to certain users and don't currently have any authorization in your app, you can follow the following steps if you want an easy config.. or you could make it more finely grained.. currently its all or nothing:
|
60
|
-
|
61
|
-
If you don't have an app/models/ability.rb(i.e. you don't currently use cancan):
|
62
|
-
|
63
|
-
rails g cancan:ability
|
64
|
-
|
65
|
-
Next add the mail manager abilities to your file (which should look something like this):
|
66
|
-
|
67
|
-
class Ability
|
68
|
-
include CanCan::Ability
|
69
|
-
|
70
|
-
def initialize(user)
|
71
|
-
eval MailManager.abilities # this is what you ADD
|
72
|
-
end
|
73
|
-
|
74
|
-
end
|
75
|
-
|
76
|
-
Next decide whether they just need to log in ... or if they should have a role
|
77
|
-
|
78
|
-
If they need to at least log in, set the following in their config/mail_manager.yml:
|
79
|
-
|
80
|
-
requires_authentication: true
|
81
|
-
|
82
|
-
If they need a certain role, the following in their config/mail_manager.yml:
|
83
|
-
|
84
|
-
authorized_roles:
|
85
|
-
- admin
|
86
|
-
|
87
|
-
If you're using roles, User must either respond to 'roles' or 'role' or you can configure a custom role method on your model and configure it in mail_manager.yml like so:
|
88
|
-
|
89
|
-
roles_method: my_role_names
|
66
|
+
[See the wiki](https://github.com/LoneStarInternet/mail_manager/wiki/Securing-your-app)
|
90
67
|
|
91
68
|
Development
|
92
69
|
-----------
|
93
70
|
If you wish to contribute, you should follow these instructions to get up and running:
|
94
|
-
|
95
|
-
Clone the repository:
|
96
|
-
|
97
|
-
git clone https://github.com/LoneStarInternet/mail_manager.git
|
98
|
-
|
99
|
-
Checkout the rails3.2.x branch:
|
100
|
-
|
101
|
-
cd mail_manager
|
102
|
-
git checkout rails3.2.x
|
103
|
-
|
104
|
-
Set up your database(currently mysql and sqlite are supported); you can get an example db file by copying one of the examples:
|
105
|
-
|
106
|
-
cd spec/test_app
|
107
|
-
cp config/database.mysql.yml config/database.yml # for mysql
|
108
|
-
cp config/database.sqlite.yml config/database.yml # for sqlite
|
71
|
+
[See the wiki](https://github.com/LoneStarInternet/mail_manager/wiki/Contributing)
|
@@ -14,7 +14,7 @@
|
|
14
14
|
<div style="background-color: #fff;">
|
15
15
|
<div id="menu">
|
16
16
|
<ul>
|
17
|
-
<li><span onClick="$('#mailings_submenu').toggle();return false">Mailings</span>
|
17
|
+
<li><span style="cursor: pointer;" onClick="$('#mailings_submenu').toggle();return false">Mailings</span>
|
18
18
|
<ul id='mailings_submenu' <%= ' style="display:none"' unless request.path =~ %r|/mail_manager| %>>
|
19
19
|
<%= content_tag(:li, link_to('Contacts', mail_manager.contacts_path)) if can?(:manage, MailManager::Contact) %>
|
20
20
|
<%= content_tag(:li, link_to('Mailings', mail_manager.mailings_path)) if can?(:manage, MailManager::Mailing) %>
|
data/lib/mail_manager/version.rb
CHANGED
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: mail_manager
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 3.2.
|
4
|
+
version: 3.2.1
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Lone Star Internet
|
8
8
|
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
|
-
date: 2015-04-
|
11
|
+
date: 2015-04-27 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: rails
|