decidim 0.5.1 → 0.6.0

data/decidim-core/app/services/decidim/events_manager.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Decidim
+  # This class acts as a wrapper of `ActiveSupport::Notifications`, so that if
+  # we ever need to change the API we just have to change it in a single point.
+  class EventsManager
+    # Publishes a event through the events channel. It requires  the name of an
+    # event, a class that handles the event and the resource that received the action.
+    #
+    # event - a String representing the event that has happened. Ideally, it should
+    #   start with `decidim.events` and include the name of the engine that publishes
+    #   it.
+    # event_class - The event class must be a class that wraps the event name and
+    #   the resource and builds the needed information to publish the event to
+    #   the different subscribers in the system.
+    # resource - an instance of a class that received the event.
+    # recipient_ids - an Array of IDs of the users that will receive the event
+    # extra - a Hash with extra information to be included in the notification.
+    #
+    # Returns nothing.
+    def self.publish(event:, event_class: Decidim::Events::BaseEvent, resource:, recipient_ids:, extra: {})
+      ActiveSupport::Notifications.publish(
+        event,
+        event_class: event_class.name,
+        resource: resource,
+        recipient_ids: recipient_ids,
+        extra: extra
+      )
+    end
+
+    # Subscribes to the given event, and runs the block every time that event
+    # is received.
+    #
+    # event - a String or a RegExp to match against event names.
+    #
+    # Returns nothing.
+    def self.subscribe(event, &block)
+      ActiveSupport::Notifications.subscribe(event, &block)
+    end
+  end
+end

data/decidim-core/app/services/decidim/notification_generator.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Decidim
+  # This class handles system events affecting resources and generates a
+  # notification for each recipient by scheduling a new
+  # `Decidim::NotificationGeneratorForRecipientJob` job for each of them. This way
+  # we can easily control which jobs fail and retry them, so that we don't have
+  # duplicated notifications.
+  class NotificationGenerator
+    # Initializes the class.
+    #
+    # event - A String with the name of the event.
+    # event_class - A class that wraps the event.
+    # resource - an instance of a class implementing the `Decidim::Resource` concern.
+    # extra - a Hash with extra information for the event.
+    def initialize(event, event_class, resource, recipient_ids, extra)
+      @event = event
+      @event_class = event_class
+      @resource = resource
+      @recipient_ids = recipient_ids
+      @extra = extra
+    end
+
+    # Schedules a job for each recipient to create the notification. Returns `nil`
+    # if the resource is not resource or if it is not present.
+    #
+    # Returns nothing.
+    def generate
+      return unless resource
+      return unless event_class.types.include?(:notification)
+
+      recipient_ids.each do |recipient_id|
+        generate_notification_for(recipient_id)
+      end
+    end
+
+    private
+
+    attr_reader :event, :event_class, :resource, :recipient_ids, :extra
+
+    def generate_notification_for(recipient_id)
+      NotificationGeneratorForRecipientJob.perform_later(
+        event,
+        event_class.name,
+        resource,
+        recipient_id,
+        extra
+      )
+    end
+  end
+end

data/decidim-core/app/services/decidim/notification_generator_for_recipient.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Decidim
+  # This class generates a notification based on the given event, for the given
+  # resource/recipient couple. It is intended to be used by the
+  # `Decidim::NotificationGenerator` class, which schedules a job for each recipient
+  # of the event, so that we can easily control which jobs fail.
+  class NotificationGeneratorForRecipient
+    # Initializes the class.
+    #
+    # event - A String with the name of the event.
+    # event_class - The class that wraps the event, in order to decorate it.
+    # resource - an instance of a class implementing the `Decidim::Resource` concern.
+    # recipient - the ID of the User that will receive the notification.
+    # extra - a Hash with extra information to be included in the notification.
+    def initialize(event, event_class, resource, recipient_id, extra)
+      @event = event
+      @event_class = event_class
+      @resource = resource
+      @recipient_id = recipient_id
+      @extra = extra
+    end
+
+    # Generates the notification. Returns `nil` if the resource is not resource
+    # or if the resource or the user are not present.
+    #
+    # Returns a Decidim::Notification.
+    def generate
+      return unless event_class
+      return unless resource
+      return unless recipient
+
+      Notification.create!(
+        user: recipient,
+        event_class: event_class,
+        resource: resource,
+        event_name: event,
+        extra: extra
+      )
+    end
+
+    private
+
+    attr_reader :event, :event_class, :resource, :recipient_id, :extra
+
+    def recipient
+      @recipient ||= User.where(id: recipient_id).first
+    end
+  end
+end

data/decidim-core/app/uploaders/decidim/attachment_uploader.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module Decidim
-  # This class deals with uploading attachments to a ParticipatoryProcess.
+  # This class deals with uploading attachments to a participatory space.
   class AttachmentUploader < ApplicationUploader
     include CarrierWave::MiniMagick
 

data/decidim-core/app/views/decidim/authorizations/first_login.html.erb

@@ -11,9 +11,9 @@
         <div class="card">
           <div class="card__content">
             <% handlers.each do |handler| %>
-              <%= link_to t(handler.handler_name, scope: "decidim.authorizations.first_login.actions"), new_authorization_path(handler: handler.handler_name), class: "button expanded" %>
+              <%= link_to t("authorizations.first_login.actions.#{handler.handler_name}", scope: "decidim"), new_authorization_path(handler: handler.handler_name), class: "button expanded" %>
             <% end %>
-            <p class="text-center skip"><%= t("decidim.authorizations.skip_verification", link: link_to(t("decidim.authorizations.current_participatory_processes"), participatory_processes_path).html_safe).html_safe %>.</p>
+            <p class="text-center skip"><%= t("decidim.authorizations.skip_verification", link: link_to(t("decidim.authorizations.current_participatory_processes"), decidim_participatory_processes.participatory_processes_path).html_safe).html_safe %>.</p>
           </div>
         </div>
       </div>

data/decidim-core/app/views/decidim/follows/update_button.js.erb

@@ -0,0 +1,3 @@
+var $followResource = $("#follow-resource");
+
+morphdom($followResource[0], "<%= j(render partial: "decidim/shared/follow_button", locals: { followable: resource } ).strip.html_safe %>");

data/decidim-core/app/views/decidim/notification_mailer/event_received.html.erb

@@ -0,0 +1,9 @@
+<p><%= @event_instance.email_greeting %></p>
+
+<p><%= @event_instance.email_intro %></p>
+
+<p>
+  <%= link_to @event_instance.resource_url, @event_instance.resource_url %>
+</p>
+
+<p><%= @event_instance.email_outro %></p>

data/decidim-core/app/views/decidim/notifications/_notification.html.erb

@@ -0,0 +1,18 @@
+<div class="card--list__item">
+  <div class="card--list__text">
+    <%= link_to notification.event_class_instance.resource_path do %>
+      <%= resource_icon notification.resource, class: "icon--chat card--list__icon" %>
+    <% end %>
+    <div>
+      <h5 class="card--list__heading">
+        <%= notification.event_class_instance.notification_title %>
+      </h5>
+      <span class="text-small"><%= l notification.created_at.to_date, format: :long %></span>
+    </div>
+  </div>
+  <div class="card--list__data">
+    <%= link_to notification, class: "mark-as-read-button card--list__data__icon", remote: true, method: :delete do %>
+      <%= icon "check", class: "icon icon--chevron-right" %>
+    <% end %>
+  </div>
+</div>

data/decidim-core/app/views/decidim/notifications/index.html.erb

@@ -0,0 +1,32 @@
+<main class="wrapper" id="notifications">
+  <div class="row">
+    <div class="columns">
+      <div class="title-action" >
+        <h1 class="heading1 title-action__title"><%= t("title", scope: "layouts.decidim.notifications_dashboard") %></h1>
+        <%= link_to(
+          t("mark_all_as_read", scope: "layouts.decidim.notifications_dashboard"),
+          decidim.read_all_notifications_path,
+          class: "button title-action__action hollow mark-all-as-read-button",
+          method: :delete,
+          data: { disable: true },
+          remote: true
+        ) %>
+      </div>
+    </div>
+  </div>
+  <div class="row">
+    <div class="columns mediumlarge-12 large-12">
+      <p class="empty-notifications hide"><%= t("no_notifications", scope: "layouts.decidim.notifications_dashboard") %></p>
+      <% if notifications.any? %>
+        <section class="section" id="notifications-list">
+          <div class="card card--list">
+            <%= render notifications %>
+          </div>
+        </section>
+        <%= decidim_paginate notifications %>
+      <% end %>
+    </div>
+  </div>
+</main>
+
+<%= javascript_include_tag "decidim/notifications" %>

data/decidim-core/app/views/decidim/notifications_settings/show.html.erb

@@ -1,17 +1,10 @@
 <div class="row">
   <%= form_for(@notifications_settings, url: notifications_settings_path, method: :put, class: "user-form") do |f| %>
-    <div class="switch tiny switch-with-label comments_notifications">
+    <div class="switch tiny switch-with-label email_on_notification">
       <label>
-        <%= f.check_box :comments_notifications, label: false, class: "switch-input" %>
+        <%= f.check_box :email_on_notification, label: false, class: "switch-input" %>
         <span class="switch-paddle"></span>
-        <span class="switch-label"><%= t('.comments_notifications') %></span>
-      </label>
-    </div>
-    <div class="switch tiny switch-with-label replies_notifications">
-      <label>
-        <%= f.check_box :replies_notifications, label: false, class: "switch-input" %>
-        <span class="switch-paddle"></span>
-        <span class="switch-label"><%= t('.replies_notifications') %></span>
+        <span class="switch-label"><%= t('.email_on_notification') %></span>
       </label>
     </div>
     <div class="switch tiny switch-with-label newsletter_notifications">

data/decidim-core/app/views/decidim/shared/_follow_button.html.erb

@@ -0,0 +1,19 @@
+<% if current_user %>
+  <div id="follow-resource">
+    <% if current_user.follows?(followable) %>
+      <%= button_to decidim.follow_path, class: "button secondary hollow expanded small button--icon follow-button", params: { follow: { followable_gid: followable.to_sgid.to_s }}, data: { disable: true }, method: :delete, remote: true do %>
+        <%= icon "bell" %>
+        <span>
+          <%= t("follows.destroy.button", scope: "decidim") %>
+        </span>
+      <% end %>
+    <% else %>
+      <%= button_to decidim.follow_path, class: "button secondary hollow expanded small button--icon follow-button", params: { follow: { followable_gid: followable.to_sgid.to_s }}, data: { disable: true }, remote: true do %>
+        <%= icon "bell" %>
+        <span>
+          <%= t("follows.create.button", scope: "decidim") %>
+        </span>
+      <% end %>
+    <% end %>
+  </div>
+<% end %>

data/decidim-core/app/views/layouts/decidim/_head.html.erb

@@ -22,3 +22,4 @@
 <%= javascript_include_tag 'application' %>
 
 <%= render partial: 'layouts/decidim/head_extra' %>
+<%== current_organization.header_snippets %>

data/decidim-core/app/views/layouts/decidim/_head_extra.html.erb

@@ -2,6 +2,13 @@
 This file is meant to be overriden by the app developers in order to
 include extra headers like tracking, error handling and such.
 
+Note that thie code you add here will be run for all organizations in
+your instance of Decidim. If you want to add code for a specific
+organization, add it to the organization's `header_snippets` field,
+which can be modified at the organization admin section.
+
+The `header_snippets` organization field will render *after* this file.
+
 Just copy your own version of the file under:
 `app/views/layouts/decidim/_head_extra.html.erb`
 %>

data/decidim-core/app/views/layouts/decidim/_user_menu.html.erb

@@ -1,4 +1,5 @@
 <li><%= link_to t(".profile"), decidim.account_path %></li>
+<li><%= link_to t(".notifications"), decidim.notifications_path %></li>
 <% if can? :read, :admin_dashboard %>
   <li><%= link_to t(".admin_dashboard"), decidim_admin.root_path %></li>
 <% end %>

data/decidim-core/app/views/layouts/decidim/_wrapper.html.erb

@@ -36,6 +36,9 @@
             </div>
             <% if current_user %>
               <div class="topbar__dropmenu topbar__user__logged">
+                <%= link_to decidim.notifications_path, class: "topbar__notifications #{current_user.notifications.any? ? "is-active" : ""}" do %>
+                  <%= icon "bell" %>
+                <% end %>
                 <ul class="dropdown menu" data-dropdown-menu>
                   <li class="is-dropdown-submenu-parent show-for-medium">
                     <%= link_to current_user.name, decidim.account_path %>

data/decidim-core/app/views/layouts/decidim/widget.html.erb

@@ -13,15 +13,15 @@
       <%= content_for(:header) %>
     <% else %>
       <div class="participatory-process">
-        <%= link_to translated_attribute(current_participatory_process.title), decidim.participatory_process_path(current_participatory_process), target: "_blank" %>
+        <%= link_to translated_attribute(current_participatory_space.title), polymorphic_path(current_participatory_space), target: "_blank" %>
       </div>
     <% end %>
     <div class="row collapse">
       <div class="column">
 
         <article class="card">
-          <% if current_participatory_process.banner_image %>
-            <div class="card__image-top" style="background-image: url(<%= current_participatory_process.banner_image.url %>)"></div>
+          <% if current_participatory_space.banner_image %>
+            <div class="card__image-top" style="background-image: url(<%= current_participatory_space.banner_image.url %>)"></div>
           <% end %>
 
           <div class="card__content">

data/decidim-core/app/views/pages/home/_hero.html.erb

@@ -13,7 +13,7 @@
     </div>
     <div class="row">
       <div class="columns small-centered small-6 medium-4 mediumlarge-3">
-        <%= link_to t('.participate'), participatory_processes_path, class: "hero-cta button expanded large button--sc" %>
+        <%= link_to t('.participate'), decidim_participatory_processes.participatory_processes_path, class: "hero-cta button expanded large button--sc" %>
       </div>
     </div>
   </div>

data/decidim-core/app/views/pages/home/_highlighted_processes.html.erb

@@ -7,12 +7,12 @@
         <% highlighted_participatory_processes.each do |process| %>
           <div class="column">
             <article class="card card--process card--mini">
-              <%= link_to participatory_process_path(process), class: "card__link" do %>
+              <%= link_to decidim_participatory_processes.participatory_process_path(process), class: "card__link" do %>
                 <div class="card__image-top"
                      style="background-image:url(<%= process.hero_image.url %>)"></div>
               <% end %>
               <div class="card__content">
-                <%= link_to participatory_process_path(process), class: "card__link" do %>
+                <%= link_to decidim_participatory_processes.participatory_process_path(process), class: "card__link" do %>
                   <h4 class="card__title"><%= translated_attribute process.title %></h4>
                 <% end %>
                 <% if process.active_step %>
@@ -31,7 +31,7 @@
   <div class="row">
     <div class="columns small-centered small-12
                 smallmedium-8 medium-6 large-4">
-      <%= link_to t(".see_all_processes"), participatory_processes_path, class: "button expanded hollow button--sc home-section__cta" %>
+      <%= link_to t(".see_all_processes"), decidim_participatory_processes.participatory_processes_path, class: "button expanded hollow button--sc home-section__cta" %>
     </div>
   </div>
 </section>

data/decidim-core/config/locales/ca.yml

@@ -1,3 +1,4 @@
+---
 ca:
   activemodel:
     attributes:
@@ -28,7 +29,7 @@ ca:
         user_group_phone: Telèfon de l'organització
   booleans:
     'false': 'No'
-    'true': 'Sí'
+    'true': Sí
   carrierwave:
     errors:
       image_too_big: La imatge és massa gran
@@ -126,6 +127,14 @@ ca:
         back_home: Tornar a l'inici
         content_doesnt_exist: Aquesta adreça és incorrecta o ha estat eliminada.
         title: No s'ha trobat la pàgina que busques
+    events:
+      email_event:
+        email_greeting: Hola %{user_name},
+        email_intro: 'Hi ha hagut una actualització a "%{resource_title}". Es pot veure en aquesta pàgina:'
+        email_outro: Has rebut aquesta notificació perquè que segueixes "%{resource_title}". El pots deixar de seguir al link anterior.
+        email_subject: Una actualització a %{resource_title}
+      notification_event:
+        notification_title: S'ha produït un esdeveniment a <a href="%{resource_path}">%{resource_title}</a>.
     export_mailer:
       export:
         ready: S'adjunta una versió comprimida de l'exportació.
@@ -152,26 +161,32 @@ ca:
         project: Projectes
         proposal: propostes
         result: Resultats
+    follows:
+      create:
+        button: Seguir
+        error: Hi ha hagut un error seguint aquest recurs.
+      destroy:
+        button: Deixar de seguir
+        error: Hi ha hagut un error deixar seguint aquest recurs.
     forms:
       current_file: Fitxer actual
       current_image: Imatge actual
       default_image: Imatge predeterminada
       errors:
         error: Hi ha un error en aquest camp.
+      remove_this_file: Eliminar aquest arxiu
     managed_users:
       expired_session: La sessió de suplantació actual ha caducat.
     menu:
       home: Inici
       more_information: Més informació
-      processes: Processos
     newsletter_mailer:
       newsletter:
         note: Has rebut aquest missatge perquè estàs subscrit a butlletins de notícies a %{organization_name}. Pots canviar la configuració a la teva <a href="%{link}">pàgina de notificacions</a>.
     notifications_settings:
       show:
-        comments_notifications: Vull rebre notificacions quan algú comenta a les meves publicacions.
+        email_on_notification: Vull rebre un correu electrònic cada vegada que rebi una notificació.
         newsletter_notifications: Vull rebre informació sobre activitat rellevant
-        replies_notifications: Vull rebre notificacions per correu electrònic quan algú respon als meus comentaris.
         update_notifications_settings: Guardar canvis
       update:
         error: Hi ha hagut un error en actualitzar la configuració de les notificacions.
@@ -184,43 +199,6 @@ ca:
     pages:
       index:
         title: Més informació
-    participatory_process_groups:
-      show:
-        group_participatory_processes: Processos per a %{group}
-        title: Grup de processos participatius
-    participatory_process_steps:
-      index:
-        process_steps: Fases del procés
-        title: Fases del procés participatiu
-    participatory_processes:
-      index:
-        title: Processos participatius
-      participatory_process_groups:
-        none: cap
-      scopes:
-        global: Àmbit global
-      show:
-        developer_group: Grup promotor
-        end_date: Data de finalització
-        local_area: Àrees municipals
-        participatory_scope: Àmbit participatiu
-        participatory_structure: Estructura participativa
-        scope: Àmbit
-        target: A qui va dirigit?
-      statistics:
-        answers_count: Respostes
-        comments_count: Comentaris
-        headline: Activitat
-        meetings_count: Trobades
-        orders_count: Vots
-        pages_count: Pàgines
-        processes_count: Processos
-        projects_count: Projectes
-        proposals_count: Propostes
-        results_count: Resultats
-        surveys_count: Enquestes
-        users_count: Participants
-        votes_count: Suports
     reported_mailer:
       hide:
         hello: Hola %{name},
@@ -236,8 +214,6 @@ ca:
       create:
         error: S'ha produït un error en denunciar. Torna-ho a intentar.
         success: La denúncia s'ha creat amb èxit i serà revisada per un administrador.
-    scopes:
-      global: Àmbit global
     shared:
       action_authorization_modal:
         incomplete:
@@ -293,6 +269,7 @@ ca:
           El teu compte no es crearà fins que no accedeixis a l'enllaç de sota i triïs la teva contrasenya.
         invited_you_as_admin: "%{invited_by} t'ha convidat com un administrador de %{application}, pots acceptar-ho mitjançant el següent enllaç."
         someone_invited_you: Algú t'ha convidat a %{application}, pots acceptar la invitació amb l'enllaç a continuació.
+        you_are_now_admin: Ara ets administrador
       invite_admin:
         subject: Has estat convidat a gestionar %{organization}
       invite_collaborator:
@@ -324,11 +301,13 @@ ca:
   layouts:
     decidim:
       cookie_warning:
-        description_html: "Aquest lloc web fa servir cookies pròpies i de tercers per millorar l’experiència de navegació, i oferir continguts i serveis d’interès.\nEn continuar la navegació entenem que s’accepta la nostra política de cookies. Per a més informació consulta %{link}."
+        description_html: |-
+          Aquest lloc web fa servir cookies pròpies i de tercers per millorar l’experiència de navegació, i oferir continguts i serveis d’interès.
+          En continuar la navegació entenem que s’accepta la nostra política de cookies. Per a més informació consulta %{link}.
         link_label: aquí
         ok: Hi estic d'acord
       footer:
-        made_with_open_source: 'Web feta amb <a target="_blank" href="https://github.com/decidim/decidim">programari lliure</a>.'
+        made_with_open_source: Web feta amb <a target="_blank" href="https://github.com/decidim/decidim">programari lliure</a>.
       header:
         close_menu: Tancar menú
         navigation: Navegació
@@ -338,37 +317,13 @@ ca:
         close_session: Tanca la sessió
         description_html: Esteu suplantant l'usuari <b>%{user_name}</b>.
         expire_time_html: La vostra sessió caducarà en <b><span class="minutes">%{minutes}</span> minutes</b>.
-      participatory_process_groups:
-        participatory_process_group:
-          browse: Explorar
-      participatory_process_widgets:
-        show:
-          active_step: Fase activa
-          take_part: Participa
-      participatory_processes:
-        index:
-          promoted_processes: Processos destacats
-        no_processes_yet:
-          no_processes_yet: Encara no hi ha cap procés participatiu!
-        order_by_processes:
-          processes:
-            one: "%{count} procés"
-            other: "%{count} processos"
-        participatory_process:
-          active_step: 'Fase actual:'
-          take_part: Participa
-        promoted_process:
-          active_step: 'Fase actual:'
-          more_info: Més informació
-          take_part: Participa
-      process_header:
-        process_menu_item: El procés
-        unfold: Desplegar
-      process_header_steps:
-        step: Fase %{current} de %{total}
-        view_steps: Veure les fases
+      notifications_dashboard:
+        mark_all_as_read: Marca tots com a llegits
+        no_notifications: Encara no hi ha notificacions.
+        title: Notificacions
       user_menu:
         admin_dashboard: Tauler d'administració
+        notifications: Notificacions
         profile: El meu compte
         sign_out: Surt
       user_profile: