decidim 0.21.0 → 0.22.0

Sign up to get free protection for your applications and to get access to all the features.

Potentially problematic release.

This version of decidim might be problematic. Click here for more details.

Files changed (23) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +1 -50
  3. data/docs/advanced/authorship.md +1 -2
  4. data/docs/advanced/components.md +40 -0
  5. data/docs/advanced/content_blocks.md +5 -3
  6. data/docs/advanced/data-picker.md +37 -9
  7. data/docs/advanced/embeddable.md +2 -1
  8. data/docs/advanced/endorsable.md +113 -0
  9. data/docs/advanced/how_to_fix_metrics.md +32 -19
  10. data/docs/advanced/metrics.md +7 -9
  11. data/docs/advanced/newsletter_templates.md +64 -0
  12. data/docs/advanced/notifications.md +114 -0
  13. data/docs/advanced/permissions.md +23 -0
  14. data/docs/advanced/releases.md +105 -0
  15. data/docs/advanced/testing.md +3 -0
  16. data/docs/customization/views.md +31 -2
  17. data/docs/development_guide.md +16 -43
  18. data/docs/getting_started.md +3 -2
  19. data/docs/manual-installation.md +4 -0
  20. data/docs/services/etherpad.md +1 -1
  21. data/docs/services/social_providers.md +33 -7
  22. data/lib/decidim/version.rb +1 -1
  23. metadata +47 -42
data/docs/getting_started.md CHANGED
@@ -67,7 +67,7 @@ Then create a development application
67
67
  ```console
68
68
  d/bundle install
69
69
  d/rake development_app
70
- d/rails server
70
+ d/rails server -b 0.0.0.0
71
71
  ```
72
72
 
73
73
  In general, to use the docker development environment, change any instruction in
@@ -108,8 +108,9 @@ Decidim comes pre-configured with some safe defaults, but can be changed through
108
108
  For Decidim to function as expected, there are some background tasks that should be scheduled to be executed regularly.
109
109
 
110
110
  - Expired *data portability* files should be removed. To do it, write a `crontab -e` line like: `0 0 * * * cd /Users/you/projects/myrailsapp && /usr/local/bin/rake RAILS_ENV=production decidim:delete_data_portability_files`
111
- - *Metrics* also require a cron to be computed nightly. Find more information in the [related documentation](https://github.com/decidim/decidim/blob/master/docs/advanced/mertics.md#Configuration).
111
+ - *Metrics* also require a cron to be computed nightly. Find more information in the [related documentation](https://github.com/decidim/decidim/blob/master/docs/advanced/metrics.md#Configuration).
112
112
  - *Open Data* is also produced nightly via a scheduled job. Find more information in the [open-data documentation](https://github.com/decidim/decidim/blob/master/docs/advanced/open-data.md).
113
+ - Registration forms for meetings that have ended should be removed for privacy concerns. To do it, write a `crontab -e` line like: `0 0 * * * cd /Users/you/projects/myrailsapp && /usr/local/bin/rake RAILS_ENV=production decidim_meetings:clean_registration_forms`
113
114
 
114
115
  ### Further configuration
115
116
 
data/docs/manual-installation.md CHANGED
@@ -122,6 +122,10 @@ This data won't be created in production environments, if you still want to do i
122
122
  SEED=true rails db:setup
123
123
  ```
124
124
 
125
+ #### Notes
126
+
127
+ When you run `bin/rails db:migrate` you should see a lot of output. If you don't, or if you run into errors seeding your database, try runnning `bin/rake decidim:upgrade` before.
128
+
125
129
  You can now start your server!
126
130
 
127
131
  ```bash
data/docs/services/etherpad.md CHANGED
@@ -32,7 +32,7 @@ config.etherpad = {
32
32
 
33
33
  and then in `config/secrets.yml`:
34
34
 
35
- ```
35
+ ```yaml
36
36
  etherpad:
37
37
  server: <%= ENV["ETHERPAD_SERVER"] %>
38
38
  api_key: <%= ENV["ETHERPAD_API_KEY"] %>
data/docs/services/social_providers.md CHANGED
@@ -54,13 +54,13 @@ twitter:
54
54
 
55
55
  ## Custom providers
56
56
 
57
- * You can define your own provider, to allow users from other external applications to login into Decidim.
58
- * The provider should implement an [OmniAuth](https://github.com/omniauth/omniauth) strategy.
59
- * You can use any of the [existing OnmiAuth strategies](https://github.com/omniauth/omniauth/wiki/List-of-Strategies).
60
- * Or you can create a new strategy, as the [Decidim OmniAuth Strategy](https://github.com/decidim/omniauth-decidim). This strategy allow users from a Decidim instance to login in other Decidim instance. For example, this strategy is used to allow [decidim.barcelona](https://decidim.barcelona) users to log into [meta.decidim.barcelona](https://meta.decidim.barcelona).
61
- * Once you have defined your strategy, you can configure it in the `config/secrets.yml` or in the organization configuration, as it is done for the built-in providers.
62
- * By default, Decidim will search in its icons library for an icon named as the provider. You can change this adding an `icon` or `icon_path` attribute to the provider configuration. The `icon` attribute sets the icon name to look for in the Decidim's icons library. The `icon_path` attribute sets the route to the image that should be used.
63
- * Here is an example of the configuration section for the Decidim strategy, using an icon located on the application's `app/assets/images` folder:
57
+ - You can define your own provider, to allow users from other external applications to login into Decidim.
58
+ - The provider should implement an [OmniAuth](https://github.com/omniauth/omniauth) strategy.
59
+ - You can use any of the [existing OnmiAuth strategies](https://github.com/omniauth/omniauth/wiki/List-of-Strategies).
60
+ - Or you can create a new strategy, as the [Decidim OmniAuth Strategy](https://github.com/decidim/omniauth-decidim). This strategy allow users from a Decidim instance to login in other Decidim instance. For example, this strategy is used to allow [decidim.barcelona](https://decidim.barcelona) users to log into [meta.decidim.barcelona](https://meta.decidim.barcelona).
61
+ - Once you have defined your strategy, you can configure it in the `config/secrets.yml` or in the organization configuration, as it is done for the built-in providers.
62
+ - By default, Decidim will search in its icons library for an icon named as the provider. You can change this adding an `icon` or `icon_path` attribute to the provider configuration. The `icon` attribute sets the icon name to look for in the Decidim's icons library. The `icon_path` attribute sets the route to the image that should be used.
63
+ - Here is an example of the configuration section for the Decidim strategy, using an icon located on the application's `app/assets/images` folder:
64
64
 
65
65
  ```yaml
66
66
  decidim:
@@ -70,3 +70,29 @@ twitter:
70
70
  site_url: <%= ENV["DECIDIM_SITE_URL"] %>
71
71
  icon_path: decidim-logo.svg
72
72
  ```
73
+
74
+ - You will need a custom initializer for your provider in order to pass the proper params to the OmniaAuth Builder.
75
+
76
+ An example of custom initializer could be written as:
77
+
78
+ ```ruby
79
+ #config/initializers/omniauth_myprovider.rb
80
+ if Rails.application.secrets.dig(:omniauth, :myprovider).present?
81
+ Rails.application.config.middleware.use OmniAuth::Builder do
82
+ provider(
83
+ :myprovider,
84
+ setup: ->(env) {
85
+ request = Rack::Request.new(env)
86
+ organization = Decidim::Organization.find_by(host: request.host)
87
+ provider_config = organization.enabled_omniauth_providers[:myprovider]
88
+ env["omniauth.strategy"].options[:client_id] = provider_config[:client_id]
89
+ env["omniauth.strategy"].options[:client_secret] = provider_config[:client_secret]
90
+ env["omniauth.strategy"].options[:site] = provider_config[:site_url]
91
+ },
92
+ scope: :public
93
+ )
94
+ end
95
+ end
96
+ ```
97
+
98
+ The custom provider may have different configuration options, instead of `client_id`, `client_secret` and `site`.
data/lib/decidim/version.rb CHANGED
@@ -3,6 +3,6 @@
3
3
  # This holds the decidim version and the faker version it uses.
4
4
  module Decidim
5
5
  def self.version
6
- "0.21.0"
6
+ "0.22.0"
7
7
  end
8
8
  end
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: decidim
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.21.0
4
+ version: 0.22.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Josep Jaume Rey Peroy
@@ -10,7 +10,7 @@ authors:
10
10
  autorequire:
11
11
  bindir: bin
12
12
  cert_chain: []
13
- date: 2020-04-08 00:00:00.000000000 Z
13
+ date: 2020-09-01 00:00:00.000000000 Z
14
14
  dependencies:
15
15
  - !ruby/object:Gem::Dependency
16
16
  name: decidim-accountability
@@ -18,280 +18,280 @@ dependencies:
18
18
  requirements:
19
19
  - - '='
20
20
  - !ruby/object:Gem::Version
21
- version: 0.21.0
21
+ version: 0.22.0
22
22
  type: :runtime
23
23
  prerelease: false
24
24
  version_requirements: !ruby/object:Gem::Requirement
25
25
  requirements:
26
26
  - - '='
27
27
  - !ruby/object:Gem::Version
28
- version: 0.21.0
28
+ version: 0.22.0
29
29
  - !ruby/object:Gem::Dependency
30
30
  name: decidim-admin
31
31
  requirement: !ruby/object:Gem::Requirement
32
32
  requirements:
33
33
  - - '='
34
34
  - !ruby/object:Gem::Version
35
- version: 0.21.0
35
+ version: 0.22.0
36
36
  type: :runtime
37
37
  prerelease: false
38
38
  version_requirements: !ruby/object:Gem::Requirement
39
39
  requirements:
40
40
  - - '='
41
41
  - !ruby/object:Gem::Version
42
- version: 0.21.0
42
+ version: 0.22.0
43
43
  - !ruby/object:Gem::Dependency
44
44
  name: decidim-api
45
45
  requirement: !ruby/object:Gem::Requirement
46
46
  requirements:
47
47
  - - '='
48
48
  - !ruby/object:Gem::Version
49
- version: 0.21.0
49
+ version: 0.22.0
50
50
  type: :runtime
51
51
  prerelease: false
52
52
  version_requirements: !ruby/object:Gem::Requirement
53
53
  requirements:
54
54
  - - '='
55
55
  - !ruby/object:Gem::Version
56
- version: 0.21.0
56
+ version: 0.22.0
57
57
  - !ruby/object:Gem::Dependency
58
58
  name: decidim-assemblies
59
59
  requirement: !ruby/object:Gem::Requirement
60
60
  requirements:
61
61
  - - '='
62
62
  - !ruby/object:Gem::Version
63
- version: 0.21.0
63
+ version: 0.22.0
64
64
  type: :runtime
65
65
  prerelease: false
66
66
  version_requirements: !ruby/object:Gem::Requirement
67
67
  requirements:
68
68
  - - '='
69
69
  - !ruby/object:Gem::Version
70
- version: 0.21.0
70
+ version: 0.22.0
71
71
  - !ruby/object:Gem::Dependency
72
72
  name: decidim-blogs
73
73
  requirement: !ruby/object:Gem::Requirement
74
74
  requirements:
75
75
  - - '='
76
76
  - !ruby/object:Gem::Version
77
- version: 0.21.0
77
+ version: 0.22.0
78
78
  type: :runtime
79
79
  prerelease: false
80
80
  version_requirements: !ruby/object:Gem::Requirement
81
81
  requirements:
82
82
  - - '='
83
83
  - !ruby/object:Gem::Version
84
- version: 0.21.0
84
+ version: 0.22.0
85
85
  - !ruby/object:Gem::Dependency
86
86
  name: decidim-budgets
87
87
  requirement: !ruby/object:Gem::Requirement
88
88
  requirements:
89
89
  - - '='
90
90
  - !ruby/object:Gem::Version
91
- version: 0.21.0
91
+ version: 0.22.0
92
92
  type: :runtime
93
93
  prerelease: false
94
94
  version_requirements: !ruby/object:Gem::Requirement
95
95
  requirements:
96
96
  - - '='
97
97
  - !ruby/object:Gem::Version
98
- version: 0.21.0
98
+ version: 0.22.0
99
99
  - !ruby/object:Gem::Dependency
100
100
  name: decidim-comments
101
101
  requirement: !ruby/object:Gem::Requirement
102
102
  requirements:
103
103
  - - '='
104
104
  - !ruby/object:Gem::Version
105
- version: 0.21.0
105
+ version: 0.22.0
106
106
  type: :runtime
107
107
  prerelease: false
108
108
  version_requirements: !ruby/object:Gem::Requirement
109
109
  requirements:
110
110
  - - '='
111
111
  - !ruby/object:Gem::Version
112
- version: 0.21.0
112
+ version: 0.22.0
113
113
  - !ruby/object:Gem::Dependency
114
114
  name: decidim-core
115
115
  requirement: !ruby/object:Gem::Requirement
116
116
  requirements:
117
117
  - - '='
118
118
  - !ruby/object:Gem::Version
119
- version: 0.21.0
119
+ version: 0.22.0
120
120
  type: :runtime
121
121
  prerelease: false
122
122
  version_requirements: !ruby/object:Gem::Requirement
123
123
  requirements:
124
124
  - - '='
125
125
  - !ruby/object:Gem::Version
126
- version: 0.21.0
126
+ version: 0.22.0
127
127
  - !ruby/object:Gem::Dependency
128
128
  name: decidim-debates
129
129
  requirement: !ruby/object:Gem::Requirement
130
130
  requirements:
131
131
  - - '='
132
132
  - !ruby/object:Gem::Version
133
- version: 0.21.0
133
+ version: 0.22.0
134
134
  type: :runtime
135
135
  prerelease: false
136
136
  version_requirements: !ruby/object:Gem::Requirement
137
137
  requirements:
138
138
  - - '='
139
139
  - !ruby/object:Gem::Version
140
- version: 0.21.0
140
+ version: 0.22.0
141
141
  - !ruby/object:Gem::Dependency
142
142
  name: decidim-forms
143
143
  requirement: !ruby/object:Gem::Requirement
144
144
  requirements:
145
145
  - - '='
146
146
  - !ruby/object:Gem::Version
147
- version: 0.21.0
147
+ version: 0.22.0
148
148
  type: :runtime
149
149
  prerelease: false
150
150
  version_requirements: !ruby/object:Gem::Requirement
151
151
  requirements:
152
152
  - - '='
153
153
  - !ruby/object:Gem::Version
154
- version: 0.21.0
154
+ version: 0.22.0
155
155
  - !ruby/object:Gem::Dependency
156
156
  name: decidim-generators
157
157
  requirement: !ruby/object:Gem::Requirement
158
158
  requirements:
159
159
  - - '='
160
160
  - !ruby/object:Gem::Version
161
- version: 0.21.0
161
+ version: 0.22.0
162
162
  type: :runtime
163
163
  prerelease: false
164
164
  version_requirements: !ruby/object:Gem::Requirement
165
165
  requirements:
166
166
  - - '='
167
167
  - !ruby/object:Gem::Version
168
- version: 0.21.0
168
+ version: 0.22.0
169
169
  - !ruby/object:Gem::Dependency
170
170
  name: decidim-meetings
171
171
  requirement: !ruby/object:Gem::Requirement
172
172
  requirements:
173
173
  - - '='
174
174
  - !ruby/object:Gem::Version
175
- version: 0.21.0
175
+ version: 0.22.0
176
176
  type: :runtime
177
177
  prerelease: false
178
178
  version_requirements: !ruby/object:Gem::Requirement
179
179
  requirements:
180
180
  - - '='
181
181
  - !ruby/object:Gem::Version
182
- version: 0.21.0
182
+ version: 0.22.0
183
183
  - !ruby/object:Gem::Dependency
184
184
  name: decidim-pages
185
185
  requirement: !ruby/object:Gem::Requirement
186
186
  requirements:
187
187
  - - '='
188
188
  - !ruby/object:Gem::Version
189
- version: 0.21.0
189
+ version: 0.22.0
190
190
  type: :runtime
191
191
  prerelease: false
192
192
  version_requirements: !ruby/object:Gem::Requirement
193
193
  requirements:
194
194
  - - '='
195
195
  - !ruby/object:Gem::Version
196
- version: 0.21.0
196
+ version: 0.22.0
197
197
  - !ruby/object:Gem::Dependency
198
198
  name: decidim-participatory_processes
199
199
  requirement: !ruby/object:Gem::Requirement
200
200
  requirements:
201
201
  - - '='
202
202
  - !ruby/object:Gem::Version
203
- version: 0.21.0
203
+ version: 0.22.0
204
204
  type: :runtime
205
205
  prerelease: false
206
206
  version_requirements: !ruby/object:Gem::Requirement
207
207
  requirements:
208
208
  - - '='
209
209
  - !ruby/object:Gem::Version
210
- version: 0.21.0
210
+ version: 0.22.0
211
211
  - !ruby/object:Gem::Dependency
212
212
  name: decidim-proposals
213
213
  requirement: !ruby/object:Gem::Requirement
214
214
  requirements:
215
215
  - - '='
216
216
  - !ruby/object:Gem::Version
217
- version: 0.21.0
217
+ version: 0.22.0
218
218
  type: :runtime
219
219
  prerelease: false
220
220
  version_requirements: !ruby/object:Gem::Requirement
221
221
  requirements:
222
222
  - - '='
223
223
  - !ruby/object:Gem::Version
224
- version: 0.21.0
224
+ version: 0.22.0
225
225
  - !ruby/object:Gem::Dependency
226
226
  name: decidim-sortitions
227
227
  requirement: !ruby/object:Gem::Requirement
228
228
  requirements:
229
229
  - - '='
230
230
  - !ruby/object:Gem::Version
231
- version: 0.21.0
231
+ version: 0.22.0
232
232
  type: :runtime
233
233
  prerelease: false
234
234
  version_requirements: !ruby/object:Gem::Requirement
235
235
  requirements:
236
236
  - - '='
237
237
  - !ruby/object:Gem::Version
238
- version: 0.21.0
238
+ version: 0.22.0
239
239
  - !ruby/object:Gem::Dependency
240
240
  name: decidim-surveys
241
241
  requirement: !ruby/object:Gem::Requirement
242
242
  requirements:
243
243
  - - '='
244
244
  - !ruby/object:Gem::Version
245
- version: 0.21.0
245
+ version: 0.22.0
246
246
  type: :runtime
247
247
  prerelease: false
248
248
  version_requirements: !ruby/object:Gem::Requirement
249
249
  requirements:
250
250
  - - '='
251
251
  - !ruby/object:Gem::Version
252
- version: 0.21.0
252
+ version: 0.22.0
253
253
  - !ruby/object:Gem::Dependency
254
254
  name: decidim-system
255
255
  requirement: !ruby/object:Gem::Requirement
256
256
  requirements:
257
257
  - - '='
258
258
  - !ruby/object:Gem::Version
259
- version: 0.21.0
259
+ version: 0.22.0
260
260
  type: :runtime
261
261
  prerelease: false
262
262
  version_requirements: !ruby/object:Gem::Requirement
263
263
  requirements:
264
264
  - - '='
265
265
  - !ruby/object:Gem::Version
266
- version: 0.21.0
266
+ version: 0.22.0
267
267
  - !ruby/object:Gem::Dependency
268
268
  name: decidim-verifications
269
269
  requirement: !ruby/object:Gem::Requirement
270
270
  requirements:
271
271
  - - '='
272
272
  - !ruby/object:Gem::Version
273
- version: 0.21.0
273
+ version: 0.22.0
274
274
  type: :runtime
275
275
  prerelease: false
276
276
  version_requirements: !ruby/object:Gem::Requirement
277
277
  requirements:
278
278
  - - '='
279
279
  - !ruby/object:Gem::Version
280
- version: 0.21.0
280
+ version: 0.22.0
281
281
  - !ruby/object:Gem::Dependency
282
282
  name: bundler
283
283
  requirement: !ruby/object:Gem::Requirement
284
284
  requirements:
285
285
  - - "~>"
286
286
  - !ruby/object:Gem::Version
287
- version: '1.12'
287
+ version: 2.1.2
288
288
  type: :development
289
289
  prerelease: false
290
290
  version_requirements: !ruby/object:Gem::Requirement
291
291
  requirements:
292
292
  - - "~>"
293
293
  - !ruby/object:Gem::Version
294
- version: '1.12'
294
+ version: 2.1.2
295
295
  - !ruby/object:Gem::Dependency
296
296
  name: rake
297
297
  requirement: !ruby/object:Gem::Requirement
@@ -343,13 +343,18 @@ files:
343
343
  - docs/advanced/data-picker.md
344
344
  - docs/advanced/deploy.md
345
345
  - docs/advanced/embeddable.md
346
+ - docs/advanced/endorsable.md
346
347
  - docs/advanced/followers.md
347
348
  - docs/advanced/how_to_create_a_module.md
348
349
  - docs/advanced/how_to_fix_metrics.md
349
350
  - docs/advanced/managing_translations_i18n.md
350
351
  - docs/advanced/metrics.md
351
352
  - docs/advanced/modules.md
353
+ - docs/advanced/newsletter_templates.md
354
+ - docs/advanced/notifications.md
352
355
  - docs/advanced/open-data.md
356
+ - docs/advanced/permissions.md
357
+ - docs/advanced/releases.md
353
358
  - docs/advanced/testing.md
354
359
  - docs/advanced/tradeoffs.md
355
360
  - docs/advanced/view_hooks.md