notification-renderer 1.2.4 → 3.0.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/LICENSE +21 -21
- data/README.md +84 -328
- data/lib/notifications-rails.rb +6 -0
- metadata +98 -42
- data/CHANGELOG.md +0 -46
- data/app/helpers/notification_renderer_helper.rb +0 -63
- data/lib/generators/notification_renderer/install_generator.rb +0 -47
- data/lib/generators/notification_renderer/type_generator.rb +0 -21
- data/lib/generators/templates/install/README.md +0 -1
- data/lib/generators/templates/install/initializer.rb +0 -12
- data/lib/generators/templates/install/notifications_migration.rb.erb +0 -5
- data/lib/generators/templates/type/_template.html +0 -7
- data/lib/notification-renderer.rb +0 -10
- data/lib/notification_renderer/configuration.rb +0 -26
- data/lib/notification_renderer/engine.rb +0 -7
- data/lib/notification_renderer/notification_library.rb +0 -45
- data/lib/notification_renderer/notification_scopes.rb +0 -26
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 36bf41fe2085e87d8719b4bf164cfd9620b65a048f3c784274f912abafb86853
|
4
|
+
data.tar.gz: cf6006fb927acdea8edaf91fc3b0c1c65efc9d60b3ac24cb643f0b4e23a5af3b
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 3b91805d98abf2485e2d41548196f1aa7244d627b238a4935833b6a0365ed7625062fd0752c6892f9b5bfe14af73c6c688735c1690182016bccc3c4003c6e998
|
7
|
+
data.tar.gz: c0d168c97b8570c04a56c8bc6e8a47aecff54ca051c47da3472128251aec578aee32387c1136076043d6bdff42a509dbac87a3875e7b6f10c185e258165082d4
|
data/LICENSE
CHANGED
@@ -1,21 +1,21 @@
|
|
1
|
-
MIT License
|
2
|
-
|
3
|
-
Copyright (c) 2017 Jonas Hübotter
|
4
|
-
|
5
|
-
Permission is hereby granted, free of charge, to any person obtaining a copy
|
6
|
-
of this software and associated documentation files (the "Software"), to deal
|
7
|
-
in the Software without restriction, including without limitation the rights
|
8
|
-
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
9
|
-
copies of the Software, and to permit persons to whom the Software is
|
10
|
-
furnished to do so, subject to the following conditions:
|
11
|
-
|
12
|
-
The above copyright notice and this permission notice shall be included in all
|
13
|
-
copies or substantial portions of the Software.
|
14
|
-
|
15
|
-
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
16
|
-
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
17
|
-
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
18
|
-
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
19
|
-
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
20
|
-
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
21
|
-
SOFTWARE.
|
1
|
+
MIT License
|
2
|
+
|
3
|
+
Copyright (c) 2017 Jonas Hübotter
|
4
|
+
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
7
|
+
in the Software without restriction, including without limitation the rights
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
10
|
+
furnished to do so, subject to the following conditions:
|
11
|
+
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
13
|
+
copies or substantial portions of the Software.
|
14
|
+
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
21
|
+
SOFTWARE.
|
data/README.md
CHANGED
@@ -1,328 +1,84 @@
|
|
1
|
-
#
|
2
|
-
|
3
|
-
|
4
|
-
|
5
|
-
|
6
|
-
|
7
|
-
|
8
|
-
|
9
|
-
|
10
|
-
|
11
|
-
|
12
|
-
|
13
|
-
|
14
|
-
|
15
|
-
|
16
|
-
|
17
|
-
|
18
|
-
|
19
|
-
|
20
|
-
|
21
|
-
|
22
|
-
|
23
|
-
|
24
|
-
|
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
|
-
|
58
|
-
|
59
|
-
|
60
|
-
|
61
|
-
|
62
|
-
|
63
|
-
|
64
|
-
|
65
|
-
|
66
|
-
|
67
|
-
|
68
|
-
|
69
|
-
|
70
|
-
|
71
|
-
|
72
|
-
|
73
|
-
|
74
|
-
|
75
|
-
|
76
|
-
|
77
|
-
|
78
|
-
|
79
|
-
|
80
|
-
|
81
|
-
|
82
|
-
|
83
|
-
|
84
|
-
|
85
|
-
You can also customize the generated templates (renderers):
|
86
|
-
|
87
|
-
$ rails g notification_renderer:type -t notification -r index feed
|
88
|
-
|
89
|
-
This command will also create a custom renderer called `feed` for the notification type `notification`:
|
90
|
-
|
91
|
-
* `views`
|
92
|
-
* `notifications`
|
93
|
-
* `notification`
|
94
|
-
* `_feed.html.erb`
|
95
|
-
* `_index.html.erb`
|
96
|
-
|
97
|
-
#### Using a type
|
98
|
-
|
99
|
-
You are able to specify the `type` of a `Notification` record:
|
100
|
-
|
101
|
-
```ruby
|
102
|
-
notification = Notification.create target: User.first, object: Recipe.first, type: 'notification'
|
103
|
-
```
|
104
|
-
|
105
|
-
**Note:** The `type` attribute of any new `Notification` record will default to the [`default_type` configuration](#configuration).
|
106
|
-
|
107
|
-
You can also scope records by their type:
|
108
|
-
|
109
|
-
```ruby
|
110
|
-
# Return records with `'notification'` as type
|
111
|
-
Notification.notification_type
|
112
|
-
|
113
|
-
# Return records with `'follow'` as type
|
114
|
-
Notification.follow_type
|
115
|
-
```
|
116
|
-
|
117
|
-
### Renderers
|
118
|
-
|
119
|
-
In your renderers you can access the `Notification` record through the `notification` variable. This is how a renderer could look like:
|
120
|
-
|
121
|
-
```erb
|
122
|
-
<%= notification.target.name %> commented on <%= notification.object.article.title %>.
|
123
|
-
```
|
124
|
-
|
125
|
-
### View helpers
|
126
|
-
|
127
|
-
NotificationRenderer introduces some view helpers to assist you in embedding notifications.
|
128
|
-
|
129
|
-
#### `render_notification`
|
130
|
-
|
131
|
-
`render_notification` renders a single `Notification` record:
|
132
|
-
|
133
|
-
```erb
|
134
|
-
<%= render_notification Notification.first %>
|
135
|
-
```
|
136
|
-
|
137
|
-
Rendering a notification will set its `read` attribute to `true`. This behavior can be [configured](#configuration).
|
138
|
-
|
139
|
-
You can also specify a renderer. It defaults to `'index'`.
|
140
|
-
|
141
|
-
```erb
|
142
|
-
<%= render_notification Notification.first, 'feed' %>
|
143
|
-
```
|
144
|
-
|
145
|
-
#### `render_notifications`
|
146
|
-
|
147
|
-
`render_notifications` takes an ActiveRecord array of `Notification` records and renders each of them in order:
|
148
|
-
|
149
|
-
```erb
|
150
|
-
<%= render_notifications Notification.all %>
|
151
|
-
```
|
152
|
-
|
153
|
-
You can also specify a renderer. It defaults to `'index'`.
|
154
|
-
|
155
|
-
```erb
|
156
|
-
<%= render_notifications Notification.all, 'feed' %>
|
157
|
-
```
|
158
|
-
|
159
|
-
It wraps the rendered notifications in a `div`:
|
160
|
-
|
161
|
-
```html
|
162
|
-
<div class="notification-renderer notifications">
|
163
|
-
<!-- ... -->
|
164
|
-
</div>
|
165
|
-
```
|
166
|
-
|
167
|
-
### Grouping
|
168
|
-
|
169
|
-
You can group any ActiveRecord array of `Notification` records by an attribute value:
|
170
|
-
|
171
|
-
```ruby
|
172
|
-
Notification.all.grouping(['object.article'])
|
173
|
-
Notification.all.grouping(['object.article', 'metadata[:title]'])
|
174
|
-
```
|
175
|
-
|
176
|
-
**Note:** Notifications will be grouped in order.
|
177
|
-
|
178
|
-
When rendering notifications you often want to group them by the object they belong to. This is how to group notifications by the associated object:
|
179
|
-
|
180
|
-
```erb
|
181
|
-
<%= render_notifications_grouped Notification.all, ['object'], renderer: 'feed' %>
|
182
|
-
```
|
183
|
-
|
184
|
-
You can also group notifications by nested attributes:
|
185
|
-
|
186
|
-
```erb
|
187
|
-
<%= render_notifications_grouped Notification.all, ['object.article'] %>
|
188
|
-
<%= render_notifications_grouped Notification.all, ['metadata[:title]'] %>
|
189
|
-
```
|
190
|
-
|
191
|
-
It is also possible to group notifications for just one object:
|
192
|
-
|
193
|
-
```erb
|
194
|
-
<%= render_notifications_grouped Notification.where(object_id: 1, object_type: 'Comment'), ['object'] %>
|
195
|
-
```
|
196
|
-
|
197
|
-
This will render the last notification for every group and pass the attributes value grouped by to your renderer:
|
198
|
-
|
199
|
-
```erb
|
200
|
-
<!-- View -->
|
201
|
-
|
202
|
-
<%= render_notifications_grouped Notification.notification_type, ['object.article'] %>
|
203
|
-
```
|
204
|
-
|
205
|
-
```erb
|
206
|
-
<!-- Renderer -->
|
207
|
-
|
208
|
-
<% if notification_grouped? %>
|
209
|
-
<%= notification.target.name %> and <%= (notifications.count - 1).to_s %> others commented on <%= attributes['object.article'].title %>.
|
210
|
-
<% else %>
|
211
|
-
<%= notification.target.name %> commented on <%= notification.object.article.title %>.
|
212
|
-
<% end %>
|
213
|
-
```
|
214
|
-
|
215
|
-
Grouping makes the following two methods available in your renderer:
|
216
|
-
|
217
|
-
**`attributes`** Hash of attributes grouped by and their values.
|
218
|
-
|
219
|
-
**`notifications`** The ActiveRecord array of notifications including the currently rendered notification.
|
220
|
-
|
221
|
-
You may check whether a template is being used for grouping by using the `notification_grouped?` helper method.
|
222
|
-
|
223
|
-
#### Grouping by notification types
|
224
|
-
|
225
|
-
It is common, if rendering multiple notification types at once, to group the notifications by their type:
|
226
|
-
|
227
|
-
```erb
|
228
|
-
<%= render_notifications_grouped Notification.all, ['object.article'], group_by_type: true %>
|
229
|
-
```
|
230
|
-
|
231
|
-
This is identical to the following:
|
232
|
-
|
233
|
-
```erb
|
234
|
-
<%= render_notifications_grouped Notification.all, [:type, 'object.article'] %>
|
235
|
-
```
|
236
|
-
|
237
|
-
#### Grouping by notification dates
|
238
|
-
|
239
|
-
It is also often required to group notifications by their date of creation:
|
240
|
-
|
241
|
-
```erb
|
242
|
-
<%= render_notifications_grouped Notification.all, ['object.article'], group_by_date: :month %>
|
243
|
-
```
|
244
|
-
|
245
|
-
This is identical to the following:
|
246
|
-
|
247
|
-
```erb
|
248
|
-
<%= render_notifications_grouped Notification.all, ['created_at.beginning_of_month', 'object.article'] %>
|
249
|
-
```
|
250
|
-
|
251
|
-
Accepted values are:
|
252
|
-
|
253
|
-
* `:minute`
|
254
|
-
* `:hour`
|
255
|
-
* `:day`
|
256
|
-
* `:week`
|
257
|
-
* `:month`
|
258
|
-
* `:year`
|
259
|
-
|
260
|
-
**Note:** If used together with `group_by_type`, notifications will be grouped first by creation date and then by `:type`.
|
261
|
-
|
262
|
-
---
|
263
|
-
|
264
|
-
## Configuration
|
265
|
-
|
266
|
-
You can configure NotificationRenderer by passing a block to `configure`. This can be done in `config/initializers/notification-renderer.rb`:
|
267
|
-
|
268
|
-
```ruby
|
269
|
-
NotificationRenderer.configure do |config|
|
270
|
-
config.default_type = 'notification'
|
271
|
-
end
|
272
|
-
```
|
273
|
-
|
274
|
-
**`default_type`** Choose your default notification type. Takes a string. Defaults to `'notification'`.
|
275
|
-
|
276
|
-
**`default_renderer`** Choose your default renderer. Takes a string. Defaults to `'index'`.
|
277
|
-
|
278
|
-
**`auto_read`** Automatically mark rendered notifications as read. Takes a boolean. Defaults to `true`.
|
279
|
-
|
280
|
-
---
|
281
|
-
|
282
|
-
## To Do
|
283
|
-
|
284
|
-
[Here](https://github.com/jonhue/notifications-rails/projects/7) is the full list of current projects.
|
285
|
-
|
286
|
-
To propose your ideas, initiate the discussion by adding a [new issue](https://github.com/jonhue/notifications-rails/issues/new).
|
287
|
-
|
288
|
-
---
|
289
|
-
|
290
|
-
## Contributing
|
291
|
-
|
292
|
-
We hope that you will consider contributing to NotificationRenderer. Please read this short overview for some information about how to get started:
|
293
|
-
|
294
|
-
[Learn more about contributing to this repository](https://github.com/jonhue/notifications-rails/blob/master/CONTRIBUTING.md), [Code of Conduct](https://github.com/jonhue/notifications-rails/blob/master/CODE_OF_CONDUCT.md)
|
295
|
-
|
296
|
-
### Contributors
|
297
|
-
|
298
|
-
Give the people some :heart: who are working on this project. See them all at:
|
299
|
-
|
300
|
-
https://github.com/jonhue/notifications-rails/graphs/contributors
|
301
|
-
|
302
|
-
### Semantic Versioning
|
303
|
-
|
304
|
-
NotificationRenderer follows Semantic Versioning 2.0 as defined at http://semver.org.
|
305
|
-
|
306
|
-
## License
|
307
|
-
|
308
|
-
MIT License
|
309
|
-
|
310
|
-
Copyright (c) 2017 Jonas Hübotter
|
311
|
-
|
312
|
-
Permission is hereby granted, free of charge, to any person obtaining a copy
|
313
|
-
of this software and associated documentation files (the "Software"), to deal
|
314
|
-
in the Software without restriction, including without limitation the rights
|
315
|
-
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
316
|
-
copies of the Software, and to permit persons to whom the Software is
|
317
|
-
furnished to do so, subject to the following conditions:
|
318
|
-
|
319
|
-
The above copyright notice and this permission notice shall be included in all
|
320
|
-
copies or substantial portions of the Software.
|
321
|
-
|
322
|
-
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
323
|
-
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
324
|
-
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
325
|
-
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
326
|
-
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
327
|
-
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
328
|
-
SOFTWARE.
|
1
|
+
# notifications-rails
|
2
|
+
|
3
|
+
notifications-rails is the most powerful notification library for Rails. It offers not only simple APIs to create and render notifications but also supports user-integration and cross-platform delivery of notifications.
|
4
|
+
|
5
|
+
## Philosophy
|
6
|
+
|
7
|
+
notifications-rails has been built with modularity in mind. It currently consists of four components each of which bringing one essential functionality to the integration of notifications in your Rails app.
|
8
|
+
|
9
|
+
**[notification-handler](notification-handler):** Create and modify your notifications through a simple API.
|
10
|
+
|
11
|
+
**[notification-renderer](notification-renderer):** Render your notifications in various contexts.
|
12
|
+
|
13
|
+
**[notification-pusher](notification-pusher):** Deliver your notifications to various services, including [Email](notification-pusher/notification-pusher-actionmailer) and [OneSignal](notification-pusher/notification-pusher-onesignal).
|
14
|
+
|
15
|
+
**[notification-settings](notification-settings):** Integrates with your authentication solution to craft a personalized user notification platform.
|
16
|
+
|
17
|
+
You may just use the components you actually need, or instead use this gem to bundle everything for a complete notification solution.
|
18
|
+
|
19
|
+
## Installation
|
20
|
+
|
21
|
+
You can add notifications-rails to your `Gemfile` with:
|
22
|
+
|
23
|
+
```ruby
|
24
|
+
gem 'notifications-rails'
|
25
|
+
```
|
26
|
+
|
27
|
+
And then run:
|
28
|
+
|
29
|
+
$ bundle install
|
30
|
+
|
31
|
+
Or install it yourself as:
|
32
|
+
|
33
|
+
$ gem install notifications-rails
|
34
|
+
|
35
|
+
If you always want to be up to date fetch the latest from GitHub in your `Gemfile`:
|
36
|
+
|
37
|
+
```ruby
|
38
|
+
gem 'notifications-rails', github: 'jonhue/notifications-rails'
|
39
|
+
```
|
40
|
+
|
41
|
+
## Usage
|
42
|
+
|
43
|
+
Details on usage are provided in the [documentation](#philosophy) of the specific modules.
|
44
|
+
|
45
|
+
## Development
|
46
|
+
|
47
|
+
To start development you first have to fork this repository and locally clone your fork.
|
48
|
+
|
49
|
+
Install the projects dependencies by running:
|
50
|
+
|
51
|
+
$ bundle install
|
52
|
+
|
53
|
+
### Testing
|
54
|
+
|
55
|
+
Tests are written with RSpec. Integration tests are located in `/spec`, unit tests can be found in `<module>/spec`.
|
56
|
+
|
57
|
+
To run all tests:
|
58
|
+
|
59
|
+
$ ./rspec
|
60
|
+
|
61
|
+
To run RuboCop:
|
62
|
+
|
63
|
+
$ bundle exec rubocop
|
64
|
+
|
65
|
+
You can find all commands run by the CI workflow in `.github/workflows/ci.yml`.
|
66
|
+
|
67
|
+
## Contributing
|
68
|
+
|
69
|
+
We warmly welcome everyone who is intersted in contributing. Please reference our [contributing guidelines](CONTRIBUTING.md) and our [Code of Conduct](CODE_OF_CONDUCT.md).
|
70
|
+
|
71
|
+
## Releases
|
72
|
+
|
73
|
+
[Here](https://github.com/jonhue/notifications-rails/releases) you can find details on all past releases. Unreleased breaking changes that are on the current master can be found [here](CHANGELOG.md).
|
74
|
+
|
75
|
+
notifications-rails follows Semantic Versioning 2.0 as defined at http://semver.org. Reference our [security policy](SECURITY.md).
|
76
|
+
|
77
|
+
### Publishing
|
78
|
+
|
79
|
+
1. Review breaking changes and deprecations in `CHANGELOG.md`.
|
80
|
+
1. Change the gem version in `VERSION`.
|
81
|
+
1. Reset `CHANGELOG.md`.
|
82
|
+
1. Create a pull request to merge the changes into `master`.
|
83
|
+
1. After the pull request was merged, create a new release listing the breaking changes and commits on `master` since the last release.
|
84
|
+
1. The release workflow will publish the gems to RubyGems.
|
metadata
CHANGED
@@ -1,17 +1,17 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: notification-renderer
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version:
|
4
|
+
version: 3.0.3
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Jonas Hübotter
|
8
8
|
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
|
-
date:
|
11
|
+
date: 2020-12-06 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
|
-
name:
|
14
|
+
name: actionview
|
15
15
|
requirement: !ruby/object:Gem::Requirement
|
16
16
|
requirements:
|
17
17
|
- - ">="
|
@@ -25,7 +25,7 @@ dependencies:
|
|
25
25
|
- !ruby/object:Gem::Version
|
26
26
|
version: '5.0'
|
27
27
|
- !ruby/object:Gem::Dependency
|
28
|
-
name:
|
28
|
+
name: activesupport
|
29
29
|
requirement: !ruby/object:Gem::Requirement
|
30
30
|
requirements:
|
31
31
|
- - ">="
|
@@ -39,7 +39,21 @@ dependencies:
|
|
39
39
|
- !ruby/object:Gem::Version
|
40
40
|
version: '5.0'
|
41
41
|
- !ruby/object:Gem::Dependency
|
42
|
-
name:
|
42
|
+
name: notification-handler
|
43
|
+
requirement: !ruby/object:Gem::Requirement
|
44
|
+
requirements:
|
45
|
+
- - '='
|
46
|
+
- !ruby/object:Gem::Version
|
47
|
+
version: 3.0.3
|
48
|
+
type: :runtime
|
49
|
+
prerelease: false
|
50
|
+
version_requirements: !ruby/object:Gem::Requirement
|
51
|
+
requirements:
|
52
|
+
- - '='
|
53
|
+
- !ruby/object:Gem::Version
|
54
|
+
version: 3.0.3
|
55
|
+
- !ruby/object:Gem::Dependency
|
56
|
+
name: railties
|
43
57
|
requirement: !ruby/object:Gem::Requirement
|
44
58
|
requirements:
|
45
59
|
- - ">="
|
@@ -53,73 +67,117 @@ dependencies:
|
|
53
67
|
- !ruby/object:Gem::Version
|
54
68
|
version: '5.0'
|
55
69
|
- !ruby/object:Gem::Dependency
|
56
|
-
name:
|
70
|
+
name: factory_bot
|
57
71
|
requirement: !ruby/object:Gem::Requirement
|
58
72
|
requirements:
|
59
|
-
- -
|
73
|
+
- - ">="
|
60
74
|
- !ruby/object:Gem::Version
|
61
|
-
version:
|
62
|
-
type: :
|
75
|
+
version: '0'
|
76
|
+
type: :development
|
63
77
|
prerelease: false
|
64
78
|
version_requirements: !ruby/object:Gem::Requirement
|
65
79
|
requirements:
|
66
|
-
- -
|
80
|
+
- - ">="
|
67
81
|
- !ruby/object:Gem::Version
|
68
|
-
version:
|
82
|
+
version: '0'
|
69
83
|
- !ruby/object:Gem::Dependency
|
70
|
-
name:
|
84
|
+
name: pry
|
71
85
|
requirement: !ruby/object:Gem::Requirement
|
72
86
|
requirements:
|
73
|
-
- - "
|
87
|
+
- - ">="
|
74
88
|
- !ruby/object:Gem::Version
|
75
|
-
version: '
|
89
|
+
version: '0'
|
76
90
|
type: :development
|
77
91
|
prerelease: false
|
78
92
|
version_requirements: !ruby/object:Gem::Requirement
|
79
93
|
requirements:
|
80
|
-
- - "
|
94
|
+
- - ">="
|
81
95
|
- !ruby/object:Gem::Version
|
82
|
-
version: '
|
96
|
+
version: '0'
|
97
|
+
- !ruby/object:Gem::Dependency
|
98
|
+
name: rails
|
99
|
+
requirement: !ruby/object:Gem::Requirement
|
100
|
+
requirements:
|
101
|
+
- - ">="
|
102
|
+
- !ruby/object:Gem::Version
|
103
|
+
version: '0'
|
104
|
+
type: :development
|
105
|
+
prerelease: false
|
106
|
+
version_requirements: !ruby/object:Gem::Requirement
|
107
|
+
requirements:
|
108
|
+
- - ">="
|
109
|
+
- !ruby/object:Gem::Version
|
110
|
+
version: '0'
|
111
|
+
- !ruby/object:Gem::Dependency
|
112
|
+
name: rspec-rails
|
113
|
+
requirement: !ruby/object:Gem::Requirement
|
114
|
+
requirements:
|
115
|
+
- - ">="
|
116
|
+
- !ruby/object:Gem::Version
|
117
|
+
version: '0'
|
118
|
+
type: :development
|
119
|
+
prerelease: false
|
120
|
+
version_requirements: !ruby/object:Gem::Requirement
|
121
|
+
requirements:
|
122
|
+
- - ">="
|
123
|
+
- !ruby/object:Gem::Version
|
124
|
+
version: '0'
|
83
125
|
- !ruby/object:Gem::Dependency
|
84
126
|
name: rubocop
|
85
127
|
requirement: !ruby/object:Gem::Requirement
|
86
128
|
requirements:
|
87
|
-
- - "
|
129
|
+
- - ">="
|
130
|
+
- !ruby/object:Gem::Version
|
131
|
+
version: '0'
|
132
|
+
type: :development
|
133
|
+
prerelease: false
|
134
|
+
version_requirements: !ruby/object:Gem::Requirement
|
135
|
+
requirements:
|
136
|
+
- - ">="
|
137
|
+
- !ruby/object:Gem::Version
|
138
|
+
version: '0'
|
139
|
+
- !ruby/object:Gem::Dependency
|
140
|
+
name: rubocop-rspec
|
141
|
+
requirement: !ruby/object:Gem::Requirement
|
142
|
+
requirements:
|
143
|
+
- - ">="
|
144
|
+
- !ruby/object:Gem::Version
|
145
|
+
version: '0'
|
146
|
+
type: :development
|
147
|
+
prerelease: false
|
148
|
+
version_requirements: !ruby/object:Gem::Requirement
|
149
|
+
requirements:
|
150
|
+
- - ">="
|
151
|
+
- !ruby/object:Gem::Version
|
152
|
+
version: '0'
|
153
|
+
- !ruby/object:Gem::Dependency
|
154
|
+
name: sqlite3
|
155
|
+
requirement: !ruby/object:Gem::Requirement
|
156
|
+
requirements:
|
157
|
+
- - ">="
|
88
158
|
- !ruby/object:Gem::Version
|
89
|
-
version: '0
|
159
|
+
version: '0'
|
90
160
|
type: :development
|
91
161
|
prerelease: false
|
92
162
|
version_requirements: !ruby/object:Gem::Requirement
|
93
163
|
requirements:
|
94
|
-
- - "
|
164
|
+
- - ">="
|
95
165
|
- !ruby/object:Gem::Version
|
96
|
-
version: '0
|
97
|
-
description: Render your notifications
|
98
|
-
|
99
|
-
email: me@jonhue.me
|
166
|
+
version: '0'
|
167
|
+
description: Render your notifications in various contexts.
|
168
|
+
email: jonas.huebotter@gmail.com
|
100
169
|
executables: []
|
101
170
|
extensions: []
|
102
171
|
extra_rdoc_files: []
|
103
172
|
files:
|
104
|
-
- CHANGELOG.md
|
105
173
|
- LICENSE
|
106
174
|
- README.md
|
107
|
-
-
|
108
|
-
- lib/generators/notification_renderer/install_generator.rb
|
109
|
-
- lib/generators/notification_renderer/type_generator.rb
|
110
|
-
- lib/generators/templates/install/README.md
|
111
|
-
- lib/generators/templates/install/initializer.rb
|
112
|
-
- lib/generators/templates/install/notifications_migration.rb.erb
|
113
|
-
- lib/generators/templates/type/_template.html
|
114
|
-
- lib/notification-renderer.rb
|
115
|
-
- lib/notification_renderer/configuration.rb
|
116
|
-
- lib/notification_renderer/engine.rb
|
117
|
-
- lib/notification_renderer/notification_library.rb
|
118
|
-
- lib/notification_renderer/notification_scopes.rb
|
175
|
+
- lib/notifications-rails.rb
|
119
176
|
homepage: https://github.com/jonhue/notifications-rails/tree/master/notification-renderer
|
120
177
|
licenses:
|
121
178
|
- MIT
|
122
|
-
metadata:
|
179
|
+
metadata:
|
180
|
+
github_repo: ssh://github.com/jonhue/notifications-rails
|
123
181
|
post_install_message:
|
124
182
|
rdoc_options: []
|
125
183
|
require_paths:
|
@@ -128,17 +186,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
|
|
128
186
|
requirements:
|
129
187
|
- - ">="
|
130
188
|
- !ruby/object:Gem::Version
|
131
|
-
version:
|
189
|
+
version: 2.2.2
|
132
190
|
required_rubygems_version: !ruby/object:Gem::Requirement
|
133
191
|
requirements:
|
134
192
|
- - ">="
|
135
193
|
- !ruby/object:Gem::Version
|
136
194
|
version: '0'
|
137
195
|
requirements: []
|
138
|
-
|
139
|
-
rubygems_version: 2.7.4
|
196
|
+
rubygems_version: 3.1.4
|
140
197
|
signing_key:
|
141
198
|
specification_version: 4
|
142
|
-
summary: Render your notifications
|
143
|
-
types
|
199
|
+
summary: Render your notifications in various contexts
|
144
200
|
test_files: []
|
data/CHANGELOG.md
DELETED
@@ -1,46 +0,0 @@
|
|
1
|
-
# Changelog
|
2
|
-
|
3
|
-
### master
|
4
|
-
|
5
|
-
* nothing yet
|
6
|
-
|
7
|
-
### 1.2.3 - 2018/01/23
|
8
|
-
|
9
|
-
* enhancements
|
10
|
-
* made `attribute` & `notifications_count` parameters optional for `render_notification` method
|
11
|
-
* bugfixes
|
12
|
-
* fixed magic type scopes
|
13
|
-
|
14
|
-
### 1.0.0 - 2017/12/28
|
15
|
-
|
16
|
-
* bugfixes
|
17
|
-
|
18
|
-
### 1.0.0.beta6 - 2017/12/28
|
19
|
-
|
20
|
-
* bugfixes
|
21
|
-
* fix lib loading problems
|
22
|
-
|
23
|
-
### 1.0.0.beta5 - 2017/12/28
|
24
|
-
|
25
|
-
* bugfixes
|
26
|
-
* fix generators
|
27
|
-
* fix lib loading problems
|
28
|
-
* fix syntax errors
|
29
|
-
|
30
|
-
### 1.0.0.beta4 - 2017/12/27
|
31
|
-
|
32
|
-
* features
|
33
|
-
* add helpers
|
34
|
-
* add `default_renderer` and `auto_read` configuration options
|
35
|
-
* add grouping functionality
|
36
|
-
* enhancements
|
37
|
-
* allow defining renderers for `type` generator
|
38
|
-
|
39
|
-
### 1.0.0.beta3 - 2017/12/25
|
40
|
-
|
41
|
-
* features
|
42
|
-
* introduce `type` generator
|
43
|
-
|
44
|
-
### 1.0.0.beta2 - 2017/12/23
|
45
|
-
|
46
|
-
* initial release
|
@@ -1,63 +0,0 @@
|
|
1
|
-
module NotificationRendererHelper
|
2
|
-
|
3
|
-
def render_notification notification, options = {}
|
4
|
-
defaults = {
|
5
|
-
renderer: NotificationRenderer.configuration.default_renderer,
|
6
|
-
attributes: nil,
|
7
|
-
notifications: nil
|
8
|
-
}
|
9
|
-
options = defaults.merge options
|
10
|
-
|
11
|
-
notification.update_attributes read: true if NotificationRenderer.configuration.auto_read
|
12
|
-
render "notifications/#{notification.type}/#{options[:renderer]}", notification: notification, attributes: options[:attributes], notifications: options[:notifications]
|
13
|
-
end
|
14
|
-
|
15
|
-
def render_notifications notifications, options = {}
|
16
|
-
defaults = {
|
17
|
-
renderer: NotificationRenderer.configuration.default_renderer
|
18
|
-
}
|
19
|
-
options = defaults.merge options
|
20
|
-
|
21
|
-
content_tag :div, class: 'notification-renderer notifications' do
|
22
|
-
notifications.each do |notification|
|
23
|
-
render_notification notification, renderer: options[:renderer]
|
24
|
-
end
|
25
|
-
end
|
26
|
-
end
|
27
|
-
|
28
|
-
def render_notifications_grouped notifications, group_by, options = {}
|
29
|
-
defaults = {
|
30
|
-
renderer: NotificationRenderer.configuration.default_renderer,
|
31
|
-
group_by_date: false,
|
32
|
-
group_by_type: false
|
33
|
-
}
|
34
|
-
options = defaults.merge options
|
35
|
-
|
36
|
-
group_by.unshift :type if options[:group_by_type]
|
37
|
-
group_by.unshift "created_at.beginning_of_#{options[:group_by_date]}" if options[:group_by_date]
|
38
|
-
|
39
|
-
content_tag :div, class: 'notification-renderer notifications' do
|
40
|
-
recursive_render_notifications_grouped notifications.grouping(options[:group_by]), options
|
41
|
-
end
|
42
|
-
end
|
43
|
-
|
44
|
-
def notification_grouped?
|
45
|
-
local_assigns[:attributes] && local_assigns[:notifications]
|
46
|
-
end
|
47
|
-
|
48
|
-
private
|
49
|
-
|
50
|
-
def recursive_render_notifications_grouped notifications, i = 0, options = {}
|
51
|
-
options[:attributes] = {} unless options.has_key? :attributes
|
52
|
-
notifications.each_pair do |k, v|
|
53
|
-
options[:attributes][options[:group_by][i]] = k
|
54
|
-
i += 1
|
55
|
-
if v.is_a? Hash
|
56
|
-
recursive_render_notifications_grouped v, options
|
57
|
-
else
|
58
|
-
render_notification v.last, renderer: options[:renderer], attributes: options[:attributes], notifications: v
|
59
|
-
end
|
60
|
-
end
|
61
|
-
end
|
62
|
-
|
63
|
-
end
|
@@ -1,47 +0,0 @@
|
|
1
|
-
require 'rails/generators'
|
2
|
-
require 'rails/generators/migration'
|
3
|
-
|
4
|
-
module NotificationRenderer
|
5
|
-
|
6
|
-
class InstallGenerator < Rails::Generators::Base
|
7
|
-
|
8
|
-
include Rails::Generators::Migration
|
9
|
-
|
10
|
-
source_root File.join File.dirname(__FILE__), '../templates/install'
|
11
|
-
desc 'Install NotificationRenderer'
|
12
|
-
|
13
|
-
def self.next_migration_number dirname
|
14
|
-
if ActiveRecord::Base.timestamped_migrations
|
15
|
-
Time.now.utc.strftime '%Y%m%d%H%M%S'
|
16
|
-
else
|
17
|
-
"%.3d" % ( current_migration_number(dirname) + 1 )
|
18
|
-
end
|
19
|
-
end
|
20
|
-
|
21
|
-
def create_initializer
|
22
|
-
template 'initializer.rb', 'config/initializers/notification-renderer.rb'
|
23
|
-
end
|
24
|
-
|
25
|
-
def create_notifications_migration_file
|
26
|
-
migration_template 'notifications_migration.rb.erb', 'db/migrate/notification_renderer_migration.rb', migration_version: migration_version
|
27
|
-
end
|
28
|
-
|
29
|
-
def create_templates
|
30
|
-
system 'rails g notification_renderer:type -t notification'
|
31
|
-
end
|
32
|
-
|
33
|
-
def show_readme
|
34
|
-
readme 'README.md'
|
35
|
-
end
|
36
|
-
|
37
|
-
private
|
38
|
-
|
39
|
-
def migration_version
|
40
|
-
if Rails.version >= '5.0.0'
|
41
|
-
"[#{Rails::VERSION::MAJOR}.#{Rails::VERSION::MINOR}]"
|
42
|
-
end
|
43
|
-
end
|
44
|
-
|
45
|
-
end
|
46
|
-
|
47
|
-
end
|
@@ -1,21 +0,0 @@
|
|
1
|
-
require 'rails/generators'
|
2
|
-
require 'rails/generators/migration'
|
3
|
-
|
4
|
-
module NotificationRenderer
|
5
|
-
|
6
|
-
class TypeGenerator < Rails::Generators::Base
|
7
|
-
|
8
|
-
source_root File.join File.dirname(__FILE__), '../templates/type'
|
9
|
-
desc 'Create a new notification type'
|
10
|
-
class_option :type, desc: 'Specify the notification type', type: :string, default: NotificationRenderer.configuration.default_type, aliases: '-t'
|
11
|
-
class_option :renderers, desc: 'Specify the renderer templates', type: :string, default: NotificationRenderer.configuration.default_renderer, aliases: '-r'
|
12
|
-
|
13
|
-
def create_templates
|
14
|
-
options[:renderers].split(' ')&.each do |template|
|
15
|
-
template '_template.html', "app/views/notifications/#{options[:type]}/_#{template}.html.erb"
|
16
|
-
end
|
17
|
-
end
|
18
|
-
|
19
|
-
end
|
20
|
-
|
21
|
-
end
|
@@ -1 +0,0 @@
|
|
1
|
-
Now run `rails db:migrate` to add NotificationRenderer to your database.
|
@@ -1,12 +0,0 @@
|
|
1
|
-
NotificationRenderer.configure do |config|
|
2
|
-
|
3
|
-
# Choose your default notification type. Takes a string.
|
4
|
-
# config.default_type = 'notification'
|
5
|
-
|
6
|
-
# Choose your default renderer. Takes a string.
|
7
|
-
# config.default_renderer = 'index'
|
8
|
-
|
9
|
-
# Automatically mark rendered notifications as read. Takes a boolean.
|
10
|
-
# config.auto_read = true
|
11
|
-
|
12
|
-
end
|
@@ -1,7 +0,0 @@
|
|
1
|
-
<!--
|
2
|
-
In your renderers you can access the `Notification` record through the `notification` variable. This is how a renderer could look like:
|
3
|
-
|
4
|
-
<%#= notification.target.name %> commented on <%#= notification.object.article.title %>
|
5
|
-
|
6
|
-
Learn more: https://github.com/jonhue/notifications-rails/tree/master/notification-renderer#renderers
|
7
|
-
-->
|
@@ -1,10 +0,0 @@
|
|
1
|
-
module NotificationRenderer
|
2
|
-
|
3
|
-
require 'notification_renderer/configuration'
|
4
|
-
|
5
|
-
require 'notification_renderer/engine'
|
6
|
-
|
7
|
-
autoload :NotificationLibrary, 'notification_renderer/notification_library'
|
8
|
-
autoload :NotificationScopes, 'notification_renderer/notification_scopes'
|
9
|
-
|
10
|
-
end
|
@@ -1,26 +0,0 @@
|
|
1
|
-
module NotificationRenderer
|
2
|
-
|
3
|
-
class << self
|
4
|
-
attr_accessor :configuration
|
5
|
-
end
|
6
|
-
|
7
|
-
def self.configure
|
8
|
-
self.configuration ||= Configuration.new
|
9
|
-
yield configuration
|
10
|
-
end
|
11
|
-
|
12
|
-
class Configuration
|
13
|
-
|
14
|
-
attr_accessor :default_type
|
15
|
-
attr_accessor :default_renderer
|
16
|
-
attr_accessor :auto_read
|
17
|
-
|
18
|
-
def initialize
|
19
|
-
@default_type = 'notification'
|
20
|
-
@default_renderer = 'index'
|
21
|
-
@auto_read = true
|
22
|
-
end
|
23
|
-
|
24
|
-
end
|
25
|
-
|
26
|
-
end
|
@@ -1,45 +0,0 @@
|
|
1
|
-
require 'notification-handler'
|
2
|
-
require 'active_support'
|
3
|
-
|
4
|
-
module NotificationRenderer
|
5
|
-
module NotificationLibrary
|
6
|
-
|
7
|
-
extend ActiveSupport::Concern
|
8
|
-
|
9
|
-
module ClassMethods
|
10
|
-
|
11
|
-
def grouping group_by
|
12
|
-
notifications = all
|
13
|
-
group_by.each do |method|
|
14
|
-
notifications = recursive_grouping notifications, method
|
15
|
-
end
|
16
|
-
notifications
|
17
|
-
end
|
18
|
-
|
19
|
-
def grouping_by group_by
|
20
|
-
all.group_by{ |notification| notification.send(group_by) }
|
21
|
-
end
|
22
|
-
|
23
|
-
def recursive_grouping notifications, group_by
|
24
|
-
if notifications.is_a? Hash
|
25
|
-
notifications.each_pair do |k, v|
|
26
|
-
if v.is_a? Hash
|
27
|
-
recursive_grouping v, group_by
|
28
|
-
else
|
29
|
-
k = v.grouping_by group_by
|
30
|
-
end
|
31
|
-
end
|
32
|
-
else
|
33
|
-
notifications.grouping_by group_by
|
34
|
-
end
|
35
|
-
notifications
|
36
|
-
end
|
37
|
-
|
38
|
-
end
|
39
|
-
|
40
|
-
def type
|
41
|
-
self[:type] || NotificationRenderer.configuration.default_type
|
42
|
-
end
|
43
|
-
|
44
|
-
end
|
45
|
-
end
|
@@ -1,26 +0,0 @@
|
|
1
|
-
require 'notification-handler'
|
2
|
-
require 'active_support'
|
3
|
-
|
4
|
-
module NotificationRenderer
|
5
|
-
module NotificationScopes
|
6
|
-
|
7
|
-
extend ActiveSupport::Concern
|
8
|
-
|
9
|
-
module ClassMethods
|
10
|
-
|
11
|
-
def method_missing m, *args
|
12
|
-
if m.to_s[/(.+)_type/]
|
13
|
-
where type: $1.singularize.classify
|
14
|
-
else
|
15
|
-
super
|
16
|
-
end
|
17
|
-
end
|
18
|
-
|
19
|
-
def respond_to? m, include_private = false
|
20
|
-
super || m.to_s[/(.+)_type/]
|
21
|
-
end
|
22
|
-
|
23
|
-
end
|
24
|
-
|
25
|
-
end
|
26
|
-
end
|