decidim 0.15.2 → 0.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e3e4eca955fb89997478c0b18c5c900dc861fb4d66e9109c33a53d6c71573d8f
-  data.tar.gz: 872f6237456c57e196e3965c477bf04739e629c6be587e90c37ab217e7806899
+  metadata.gz: 1db0b8a1441fe291680f2a8a47eea5eb113586416616b6f91b77a86bfb72e869
+  data.tar.gz: 816dbbdf6f2302777aaa7950d73b1898eca3861e63490edc24456ac837135798
 SHA512:
-  metadata.gz: 84e0efefa2e11f21ad73dced9a14dba83a18b0938c894a1bb98ae120a38b4c2d4e1c1f78e7c48590d380b58baf73c03801ced4b5884a411554a630e5e28bcf2e
-  data.tar.gz: e091ace7383287f804c34a0d47162fc7283aeaafa87d5d22a6f48d7f77330e40e6070a3e4d8c6bc5af0d4058bbc9237b8f821b625785fb06af8c5a37403a62d8
+  metadata.gz: 5c2420ef26343d400bef86d1909cac60e041c788bb132333fde2e652c1dd058f75ac4fa381c1f5988111769ff5164c3857762558469ac0c89cdef7ec91b46c41
+  data.tar.gz: 34831221b3b62c518420683c2f163e04bbfbd316d92017a9314a3a31eec0844cd531175c41579e8196a2467aa644486b8ef29386714465e9ad1555eac6e2790d

data/README.md

@@ -111,6 +111,7 @@ As a base you can use these modules, although check first that the version is co
 | Module                                                                                                                 | Version |  Description                                                                                                                                                  |
 | -----------------------------------------------------------------------------------------------------------------------| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | [Age Action Authorization](https://github.com/diputacioBCN/decidim-diba/tree/master/decidim-age_action_authorization)  |  0.9.3   | A Decidim based action authorization to check user's age inside actions.                                                                                     |
+| [Antivirus](https://github.com/mainio/decidim-module-antivirus) |  0.15.0 | Virus scanning validation for uploaded attachments based on ClamAV. |
 | [Calendar](https://github.com/castilla-lamancha/participa-castillalamancha/tree/master/decidim-calendar)               |  0.14.1  | Adds a calendar view for all the Meetings, without regarding the Participatory Process or Assembly that they belong.                                         |
 | [Crowdfunding](https://github.com/podemos-infoparticipa2/tree/master/decidim-module-crowdfundings)                     |  0.14.1  | This rails engine implements a Decidim component that allows to the administrators to configure crowfunding campaigns for a participatory space.             |
 | [DataViz](https://github.com/AjuntamentdeBarcelona/decidim-barcelona/tree/master/decidim-dataviz)                      |  0.13.1  | The Dataviz module adds the PAM data visualizations to any participatory process but it is intended to be used just for the PAM participatory process.       |

data/docs/advanced/metrics.md

@@ -23,17 +23,32 @@ Metrics calculations must be executed everyday. Some `rake task` have been added
 
 ## Current available metric names
 
-- *users*, confirmed Users
-- *proposals*, available Proposals
-- *accepted_proposals*, currently accepted Proposals
-- *votes*, votes in Proposals
-- *assemblies*, public Assemblies
-- *participatory_processes*, public ParticipatoryProcesses
-- *results*, Results in Accountabilities
-- *comment*, Comments generated by users, related to public elements and not *hidden*
-- *meetings*, public Meetings
+- *users*, confirmed `Users`
+- *proposals*, available `Proposals`
+- *accepted_proposals*, currently accepted `Proposals`
+- *supports*, supports in `Proposals`
+- *assemblies*, public `Assemblies`
+- *participatory_processes*, public `ParticipatoryProcesses`
+- *results*, `Results` in `Accountability`
+- *comment*, `Comments` generated by users, related to public elements and not *hidden*
+- *meetings*, public `Meetings`
+
+Only available for `ParticipatorySpaces` (restricted to `ParticipatoryProcesses`)
+
+- *participants*: unique users who make at least one of the following actions
+  - Create a proposal
+  - Create a debate
+  - Answer a survey
+  - Leave a comment
+  - Give support to a proposal
+  - Endorse
+  - Vote a participatory budgeting project
+- *followers*: unique users who follow any participatory element in a `ParticipatorySpace`
+- *endorsements*: number of `Endorsements` in `Proposals`, within a `ParticipatorySpace`
+- *debates*: number of `Debates` within a `ParticipatorySpace`
+- *survey_answers*: number of answered `Surveys` by users within a `ParticipatorySpace`
 
 ## To configure it correctly
 
 - A **crontab** line must be added to your server to maintain them updated daily. You could use [Whenever](https://github.com/javan/whenever) to manage it directly from the APP
-- A **ActiveJob** queue, like [Sidekiq](https://github.com/mperham/sidekiq) or [DelayedJob](https://github.com/collectiveidea/delayed_job/)
+- An **ActiveJob** queue, like [Sidekiq](https://github.com/mperham/sidekiq) or [DelayedJob](https://github.com/collectiveidea/delayed_job/)

data/docs/advanced/open-data.md

@@ -0,0 +1,9 @@
+# Open Data
+
+In order for users to be able to download Open Data files they have to be generated previously, since generating them on the fly would take too much time and resources.
+
+You should schedule this command to be run everyday, using `cron` or `whenever` or your favorite tool:
+
+```ruby
+  bundle exec rake decidim:open_data:export
+```

data/docs/checklist.md

@@ -32,6 +32,8 @@ As a technopolitical project, Decidim needs several things to work. This is a no
 
 1. Check that you don't have any **default users, emails and passwords**, neither on the admin or on the system panel.
 
+1. Configure recurring jobs for [**metrics**](advanced/metrics.md) and [**open data**](advanced/open-data.md)
+
 ## Contents
 
 1. Ideally you'll have a **Team** formed with experts on IT, Communication, Participation, Design and Law.
@@ -44,6 +46,6 @@ As a technopolitical project, Decidim needs several things to work. This is a no
 
 1. Read the **[Administration manual](https://decidim.org/docs/)**.
 
-1. Participate on **[MetaDecidim](http://meta.decidim.barcelona)**.
+1. Participate on **[MetaDecidim](http://meta.decidim.org)**.
 
 1. Read the Decidim **[Social Contract](https://decidim.org/contract/)**.

data/docs/customization/oauth.md

@@ -21,3 +21,30 @@ All the organization data will be used during the authorization process so the u
 Once you've created your application you'll get the settings to setup your client.
 
 Check [omniauth-decidim](https://github.com/decidim/omniauth-decidim) in order to configure your client application.
+
+## Performing more actions on omniauth registration
+
+Some times, there is the need to perform more actions than just ceating a user on registration, this is why `CreateOmniauthRegistration` command publishes a `"decidim.events.user.omniauth_registration` event after registration so that developers can subscribe to it and perform other actions like user verification or alike.
+
+This event comes with the following payload:
+
+* user_id: The id for the registered User.
+* identity_id: The id for the social Identity.
+* provider: The name for the social provider.
+* uid: OAuth's uid
+* email: User's email.
+* name: User's name.
+* nickname: User's nickname after being normalized.
+* avatar_url: Avatar's url, if any.
+* raw_data: The raw hash received directly from the Omniauth gem.
+
+To be notified after a registration one should subscribe to the event, in the passed block the after registration code should be implemented:
+
+```ruby
+ActiveSupport::Notifications.subscribe "decidim.events.user.omniauth_registration" do |name, started, finished, unique_id, data|
+  puts "the data: #{data.inspect}"
+  IdCatMobilVerificationJob.perform_later(data[:raw_data])
+end
+```
+
+It is a good practice to delegate the required implementation to a Job to bring a fastest response to the user, also it will avoid that crashes in this code to propagate to the registration process.

data/docs/customization/users_registration_mode.md

@@ -0,0 +1,17 @@
+# Users registration mode
+
+Decidim allows organizations to choose one of the three modes related to the registration and login of users. This can be configured by the system user, in the organization manager zone.
+
+## Allow users to register and login
+
+This is the default mode. It enables the registration form and allow anyone to create a new account and log in.
+
+## Don't allow users to register, but allow existing users to login
+
+This mode disables the registration form, but allows existing users to log in. This mode could be useful for organizations with a closed census that do not want to offer other people to register.
+
+Note: if you have configured [social providers](services/social_providers.md), users will still be able to sign in with external accounts even when this mode is configured.
+
+## Access only can be done with external accounts
+
+This mode disables the registration form and the login form. With this mode, users only can access through [social providers](services/social_providers.md), so it is recommended to configure at least one of them. This can be useful when an organization needs to allow participation only to users of another application of the organization itself.

data/docs/development_guide.md

@@ -112,3 +112,23 @@ This project uses [markdownlint](https://github.com/markdownlint/markdownlint) t
 ## Testing
 
 Refer to the [testing](advanced/testing.md) guide.
+
+## Releasing new versions
+
+Releasing new versions is quite easy, it's the same process whether it's a new version or a patch:
+
+1. Checkout the branch you want to release: `git checkout VERSION-stable`
+1. Update `.decidim-version` to the new version number.
+1. Run `bin/rake update_versions`, this will update all references to the new version.
+1. Run `bin/rake bundle`, this will update all the `Gemfile.lock` files
+1. Run `bin/rake webpack`, this will update the JavaScript bundle.
+1. Update `CHANGELOG.MD` and change the `Unreleased` title to the current version and link to previous versions if needed.
+1. Commit all the changes: `git add . && git commit -m "Bump version"`
+1. Run `bin/rake release_all`, this will create all the tags, push the commits and tags and release the gems to RubyGems.
+
+In order to release new version you need to be owner of all the gems at RubyGems, ask one of the owners to add you before releasing. (Try `gem owners decidim`)
+
+Once all the gems are published you should create a new release at this repository, just go to the [releases page](https://github.com/decidim/decidim/tags) and create a new one.
+
+Finally, you should update our [Docker repository](https://github.com/decidim/docker) so new images are build for the new release.
+To do it, just update `DECIDIM_VERSION` at [circle.yml](https://github.com/decidim/docker/blob/master/circle.yml).

data/docs/services/etherpad.md

@@ -0,0 +1,17 @@
+# Etherpad
+
+Decidim can be integrated with Etherpad so meetings can have their own pads.
+
+In order to use it you need to have your own Etherpad deployment, you can do it
+with the Docker compose using the provided `docker-compose-etherpad.yml`.
+
+You should edit that file to configure the environment variables and then run:
+
+```sh
+docker swarm init # just one time
+
+docker stack deploy --compose-file docker-compose-etherpad.yml decidim-etherpad
+```
+
+After deploying it, you should set the Etherpad host and API Key at
+`config/initializers/decidim.rb` and `config/secrets.yml`

data/docs/services/social_providers.md

@@ -39,3 +39,22 @@ If you want to enable sign up through social providers like Facebook you will ne
 1. Select `Web applications`. Fill in the `Authorized Javascript origins` with your url. Then fill in the `Authorized redirect URIs` with your url and append the path `/users/auth/google_oauth2/callback`.
 1. Copy the CLIENT_ID AND CLIENT_SECRET
 1. Paste credentials in `config/secrets.yml`. Ensure the `enabled` attribute is `true`.
+
+## Custom providers
+
+* You can define your own provider, to allow users from other external applications to login into Decidim.
+* The provider should implement an [OmniAuth](https://github.com/omniauth/omniauth) strategy.
+* You can use any of the [existing OnmiAuth strategies](https://github.com/omniauth/omniauth/wiki/List-of-Strategies).
+* 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).
+* Once you have defined your strategy, you can configure it in the `config/secrets.yml`, as it is done for the built-in providers.
+* 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.
+* Here is an example of the configuration section for the Decidim strategy, using an icon located on the application's `app/assets/images` folder:
+
+```yaml
+    decidim:
+      enabled: true
+      client_id: <%= ENV["DECIDIM_CLIENT_ID"] %>
+      client_secret: <%= ENV["DECIDIM_CLIENT_SECRET"] %>
+      site_url: <%= ENV["DECIDIM_SITE_URL"] %>
+      icon_path: decidim-logo.svg
+```

data/lib/decidim.rb

@@ -6,6 +6,8 @@ require "decidim/admin"
 require "decidim/api"
 require "decidim/version"
 
+require "decidim/forms"
+
 require "decidim/verifications"
 
 require "decidim/participatory_processes"

data/lib/decidim/version.rb

@@ -3,6 +3,6 @@
 # This holds the decidim version and the faker version it uses.
 module Decidim
   def self.version
-    "0.15.2"
+    "0.16.0"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: decidim
 version: !ruby/object:Gem::Version
-  version: 0.15.2
+  version: 0.16.0
 platform: ruby
 authors:
 - Josep Jaume Rey Peroy
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-01-08 00:00:00.000000000 Z
+date: 2019-01-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: decidim-accountability
@@ -18,252 +18,266 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.15.2
+        version: 0.16.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.15.2
+        version: 0.16.0
 - !ruby/object:Gem::Dependency
   name: decidim-admin
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.15.2
+        version: 0.16.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.15.2
+        version: 0.16.0
 - !ruby/object:Gem::Dependency
   name: decidim-api
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.15.2
+        version: 0.16.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.15.2
+        version: 0.16.0
 - !ruby/object:Gem::Dependency
   name: decidim-assemblies
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.15.2
+        version: 0.16.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.15.2
+        version: 0.16.0
 - !ruby/object:Gem::Dependency
   name: decidim-blogs
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.15.2
+        version: 0.16.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.15.2
+        version: 0.16.0
 - !ruby/object:Gem::Dependency
   name: decidim-budgets
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.15.2
+        version: 0.16.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.15.2
+        version: 0.16.0
 - !ruby/object:Gem::Dependency
   name: decidim-comments
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.15.2
+        version: 0.16.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.15.2
+        version: 0.16.0
 - !ruby/object:Gem::Dependency
   name: decidim-core
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.15.2
+        version: 0.16.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.15.2
+        version: 0.16.0
 - !ruby/object:Gem::Dependency
   name: decidim-debates
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.15.2
+        version: 0.16.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.15.2
+        version: 0.16.0
+- !ruby/object:Gem::Dependency
+  name: decidim-forms
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.16.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.16.0
 - !ruby/object:Gem::Dependency
   name: decidim-generators
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.15.2
+        version: 0.16.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.15.2
+        version: 0.16.0
 - !ruby/object:Gem::Dependency
   name: decidim-meetings
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.15.2
+        version: 0.16.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.15.2
+        version: 0.16.0
 - !ruby/object:Gem::Dependency
   name: decidim-pages
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.15.2
+        version: 0.16.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.15.2
+        version: 0.16.0
 - !ruby/object:Gem::Dependency
   name: decidim-participatory_processes
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.15.2
+        version: 0.16.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.15.2
+        version: 0.16.0
 - !ruby/object:Gem::Dependency
   name: decidim-proposals
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.15.2
+        version: 0.16.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.15.2
+        version: 0.16.0
 - !ruby/object:Gem::Dependency
   name: decidim-sortitions
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.15.2
+        version: 0.16.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.15.2
+        version: 0.16.0
 - !ruby/object:Gem::Dependency
   name: decidim-surveys
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.15.2
+        version: 0.16.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.15.2
+        version: 0.16.0
 - !ruby/object:Gem::Dependency
   name: decidim-system
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.15.2
+        version: 0.16.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.15.2
+        version: 0.16.0
 - !ruby/object:Gem::Dependency
   name: decidim-verifications
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.15.2
+        version: 0.16.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.15.2
+        version: 0.16.0
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -330,6 +344,7 @@ files:
 - docs/advanced/how_to_create_a_module.md
 - docs/advanced/managing_translations_i18n.md
 - docs/advanced/metrics.md
+- docs/advanced/open-data.md
 - docs/advanced/testing.md
 - docs/advanced/tradeoffs.md
 - docs/advanced/view_hooks.md
@@ -343,6 +358,7 @@ files:
 - docs/customization/oauth.md
 - docs/customization/styles.md
 - docs/customization/texts.md
+- docs/customization/users_registration_mode.md
 - docs/customization/views.md
 - docs/development_guide.md
 - docs/getting_started.md
@@ -350,6 +366,7 @@ files:
 - docs/possible_flows_for_proposal.png
 - docs/services/activejob.md
 - docs/services/analytics.md
+- docs/services/etherpad.md
 - docs/services/geocoding.md
 - docs/services/social_providers.md
 - lib/decidim.rb
@@ -375,7 +392,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.7.7
+rubygems_version: 2.7.6
 signing_key: 
 specification_version: 4
 summary: Citizen participation framework for Ruby on Rails.