decidim-theme 0.1.4

data/README.md

@@ -0,0 +1,104 @@
+```
+This file is a template for README.md of Octree instances. 
+```
+
+<h1 align="center"><img src="https://github.com/octree-gva/meta/blob/main/decidim/static/header.png?raw=true" alt="Decidim - Octree Participatory democracy on a robust and open source solution"></h1>
+<h4 align="center">
+    <a href="https://www.octree.ch">Octree</a> |
+    <a href="https://octree.ch/en/contact-us/">Contact Us</a> |
+    <a href="https://blog.octree.ch">Our Blog (FR)</a><br/><br/>
+    <a href="https://decidim.org">Decidim</a> |
+    <a href="https://docs.decidim.org/en/">Decidim Docs</a> |
+    <a href="https://meta.decidim.org">Participatory Governance (meta decidim)</a><br/><br/>
+    <a href="https://matrix.to/#/+decidim:matrix.org">Decidim Community (Matrix+Element.io)</a>
+</h4>
+
+
+<br/><br/>
+Want to hack Decidim theme? This repo implements a resilient design system on Decidim, allowing you to bootstrap your new theme. 
+This repository is a __Decidim module__ for Decidim without redesign.
+
+This module is installed by default on all our [voca instances](https://voca.city).
+
+## Installation
+
+Add to your Gemfile: 
+```
+gem "deface", ">= 1.5"
+gem "decidim-theme", git: "https://github.com/decidim/decidim-module-theme"
+```
+
+Import the theme settings:
+```
+// file: app/packs/stylesheets/decidim/_decidim-settings.scss
+@import "stylesheets/decidim/theme/theme_settings"
+```
+
+Add the theme file to override the rest:
+```
+// file: app/packs/stylesheets/decidim/decidim_application.scss
+@import "stylesheets/decidim/theme/theme"
+```
+
+Add preload tags on `head` for fonts, to have less FOUT:
+```
+<!-- file: app/views/layouts/decidim/_head_extra.html.erb -->
+<%= preload_link_tag(asset_pack_path("media/images/Inter-Bold.woff2")) %>
+<%= preload_link_tag(asset_pack_path("media/images/Inter-Regular.woff2")) %>
+<%= preload_link_tag(asset_pack_path("media/images/Inter-SemiBold.woff2")) %>
+```
+
+
+
+# Compatibility
+
+This module is tested with Decidim V.0.26 only.
+0.27 is comming with ruby-3 support soon.
+
+# Develop localy
+
+```
+docker-compose up -d
+```
+
+```
+# Install (first time only)
+docker exec -it decidim-app bundle exec rails db:migrate
+docker exec -it decidim-app bundle exec rails db:seed
+```
+
+
+```
+# Run webpack-dev-server
+docker exec -it decidim-app bin/webpack-dev-server
+```
+
+```
+# Run rails server
+docker exec -it decidim-app bundle exec rails s -b 0.0.0.0
+```
+
+Wait webpack-dev-server has compiled, and go to [localhost:3000](http://localhost:3000).
+
+
+# Core Customizations
+
+In a perfect world, we would need no core customization. We try hard to keep track on our changes and propose them to the core of Decidim. Our goal is always to come back to a mainstream code. We use the Deface gem to mainly:
+
+- Change button classes to have consistent buttons variants.
+- Add class to `wrapper` in [many, many files](./app/overrides/prefix_classes.rb)
+
+
+
+
+<br /><br />
+<h4 align="center">
+    <br /><br />
+    <img src="https://github.com/octree-gva/meta/blob/main/decidim/static/［PROJECT_NAME］/［MOBILE_SCREENSHOTS］.png?raw=true" /><br /><br />
+    <img src="https://github.com/octree-gva/meta/blob/main/decidim/static/［PROJECT_NAME］/［MOBILE_SCREENSHOTS］.png?raw=true" /><br /><br />
+</h4>
+
+<br /><br />
+<p align="center">
+    <img src="https://raw.githubusercontent.com/octree-gva/meta/main/decidim/static/octree_and_decidim.png" height="90" alt="Decidim Installation by Octree" />
+</p>

data/Rakefile

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require "decidim/dev/common_rake"
+
+desc "Generates a dummy app for testing"
+task test_app: "decidim:generate_external_test_app"
+
+desc "Generates a development app."
+task development_app: "decidim:generate_external_development_app"

data/app/cells/decidim/meetings/meeting_cell.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+module Decidim
+    module Meetings
+      # This cell renders the meeting card for an instance of a Meeting
+      # the default size is the Medium Card (:m)
+      # also available the List Item Card (:list_item)
+      class MeetingCell < Decidim::ViewModel
+        include Decidim::SanitizeHelper
+        include MeetingCellsHelper
+        include Cell::ViewModel::Partial
+  
+        def show
+          cell card_size, model, options
+        end
+  
+        private
+  
+        def card_size
+          case @options[:size]
+          when :highlighted_list_item
+            "decidim/meetings/meeting_highlighted_list_item"
+          when :list_item
+            "decidim/meetings/meeting_list_item"
+          when :s
+            "decidim/meetings/meeting_s_overrides"
+          else
+            "decidim/meetings/meeting_m"
+          end
+        end
+  
+        def resource_icon
+          icon "meetings", remove_icon_class: true, width: 40, height: 70
+        end
+  
+        def current_component
+          model.component
+        end
+  
+        def current_participatory_space
+          model.component.participatory_space
+        end
+  
+        def component_settings
+          model.component.settings
+        end
+  
+        def component_name
+          translated_attribute current_component.name
+        end
+  
+        def component_type_name
+          model.class.model_name.human
+        end
+  
+        def participatory_space_name
+          translated_attribute current_participatory_space.title
+        end
+  
+        def participatory_space_type_name
+          translated_attribute current_participatory_space.model_name.human
+        end
+      end
+    end
+  end

data/app/cells/decidim/meetings/meeting_s_overrides/show.erb

@@ -0,0 +1,25 @@
+<div class="card overrides">
+  <div class="p-s">
+    <div class="card__header">
+      <%= link_to meeting_path, class: "card__link" do %>
+        <span class="card__title">
+          <%= title %>
+        </span>
+      <% end %>
+    </div>
+    <div class="card__text">
+      <div class="row collapse text-medium">
+        <time datetime="<%= l(model.start_time, format: :long) %>" class="column medium-4 icon--container upcoming_meetings--time">
+          <%= l start_date, format: :decidim_with_month_name %>
+          &nbsp;-&nbsp;
+          <%= formatted_start_time %>
+        </time>
+        <span class="column medium-8">
+          <%= participatory_space_class_name %>
+          &nbsp;
+          <%= link_to participatory_space_title, participatory_space_path %>
+        </span>
+      </div>
+    </div>
+  </div>
+</div>

data/app/cells/decidim/meetings/meeting_s_overrides_cell.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module Decidim
+    module Meetings
+      # This cell renders the Small (:s) meeting card
+      # for an given instance of a Meeting
+      class MeetingSOverridesCell < MeetingMCell
+        delegate :title, to: :presenter
+  
+        def meeting_path
+          resource_locator(model).path
+        end
+  
+        def participatory_space_class_name
+          model.component.participatory_space.class.model_name.human
+        end
+  
+        def participatory_space_title
+          translated_attribute model.component.participatory_space.title
+        end
+  
+        def participatory_space_path
+          resource_locator(model.component.participatory_space).path
+        end
+  
+        def presenter
+          @presenter ||= Decidim::Meetings::MeetingPresenter.new(model)
+        end
+  
+        private
+  
+        def cache_hash
+          hash = []
+          hash << I18n.locale.to_s
+          hash << model.cache_key_with_version
+          hash << Digest::MD5.hexdigest(model.component.cache_key_with_version)
+          hash << Digest::MD5.hexdigest(resource_image_path) if resource_image_path
+          hash << model.comments_count
+          hash << model.follows_count
+          hash << render_space? ? 1 : 0
+  
+          if current_user
+            hash << current_user.cache_key_with_version
+            hash << current_user.follows?(model) ? 1 : 0
+          end
+          hash << Digest::MD5.hexdigest(model.author.cache_key_with_version)
+          hash << (model.must_render_translation?(current_organization) ? 1 : 0) if model.respond_to?(:must_render_translation?)
+  
+          hash.join(Decidim.cache_key_separator)
+        end
+      end
+    end
+  end

data/app/controllers/decidim/theme/admin/application_controller.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Decidim
+  module Theme
+    module Admin
+      # This controller is the abstract class from which all other controllers of
+      # this engine inherit.
+      #
+      # Note that it inherits from `Decidim::Admin::Components::BaseController`, which
+      # override its layout and provide all kinds of useful methods.
+      class ApplicationController < Decidim::Admin::Components::BaseController
+      end
+    end
+  end
+end

data/app/controllers/decidim/theme/application_controller.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Decidim
+  module Theme
+    # This controller is the abstract class from which all other controllers of
+    # this engine inherit.
+    #
+    # Note that it inherits from `Decidim::Components::BaseController`, which
+    # override its layout and provide all kinds of useful methods.
+    class ApplicationController < Decidim::Components::BaseController
+    end
+  end
+end

data/app/helpers/decidim/theme/application_helper.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Decidim
+  module Theme
+    # Custom helpers, scoped to the theme engine.
+    #
+    module ApplicationHelper
+    end
+  end
+end

data/app/models/decidim/theme/application_record.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Decidim
+  module Theme
+    # Abstract class from which all models in this engine inherit.
+    class ApplicationRecord < ActiveRecord::Base
+      self.abstract_class = true
+    end
+  end
+end

data/app/overrides/insert_javascript_tag.rb

@@ -0,0 +1,6 @@
+Deface::Override.new(
+    :virtual_path => "layouts/decidim/_application",
+    :name => "insert_javascript_tag",
+    :insert_after => 'erb[loud]:contains("data_consent_warning")',
+    :text => "<%= javascript_pack_tag \"decidim_theme_polyfill\", defer: false %>"
+)

data/app/overrides/language_chooser_icon.rb

@@ -0,0 +1,4 @@
+Deface::Override.new(:virtual_path => "layouts/decidim/_language_chooser",
+                     :name => "language_chooser_icon",
+                     :surround => "span[aria-hidden=true]",
+                     :text => "<span class=\"language-chooser-controltext\"><%= icon \"globe\", aria_label: t(\"name\", scope: \"locale\") %> %><%= render_original %></div>")

data/app/overrides/layouts/decidim/_main_footer/replace_content.html.erb.deface

@@ -0,0 +1,96 @@
+<!-- replace '.main-footer' -->
+<footer id="FooterNavigation">    
+    <div id="ActivitiesLink" aria-describedBy="ActivitiesLinkLabel" class="footer_nav footer_nav--more">
+        <strong id="ActivitiesLinkLabel"><%= t(".sections.activities") %></strong>
+        
+        <%= ::Decidim::MenuPresenter.new(
+            :menu,
+            self,
+            element_class: "footer__navitem",
+            active_class: "footer__navitem--active",
+            label: t("layouts.decidim.header.main_menu")
+        ).render do |menu|
+            "heçllo"
+        end %>
+    </div>
+    <nav id="MoreLinks" aria-describedBy="MoreLinksLabel" class="footer_nav footer_nav--more">
+        <strong id="MoreLinksLabel"><%= t(".sections.more") %></strong>
+        <ul>
+            <% if current_user %>
+                <% if allowed_to? :read, :admin_dashboard %>
+                    <li class="footer__navitem"><%= link_to t(".admin_dashboard"), decidim_admin.root_path %></li>
+                <% end %> 
+            <% else %>
+                <li class="footer__navitem"><%= link_to t("layouts.decidim.header.sign_in"), decidim.new_user_session_path %></li>
+                <% if current_organization.sign_up_enabled? %>
+                    <li class="footer__navitem"><%= link_to t("layouts.decidim.header.sign_up"), decidim.new_user_registration_path %></li>
+                <% end %>
+            <% end %>
+
+            <% organization_pages = current_organization.static_pages_accessible_for(current_user) %>
+            <% if organization_pages.any? %>
+                <% current_organization.static_page_topics.where(show_in_footer: true).each do |page_topic| %>
+                    <% topic_pages = page_topic.accessible_pages_for(current_user) %>
+                    <% if topic_pages.any? %>
+                        <li class="footer__navitem"><%= link_to translated_attribute(page_topic.title), decidim.page_path(topic_pages.first) %></li>
+                    <% end %>
+                <% end %>
+
+                <% organization_pages.where(show_in_footer: true).each do |page| %>
+                    <li class="footer__navitem"><%= link_to translated_attribute(page.title), decidim.page_path(page) %></li>
+                <% end %>
+            <% end %>
+            
+            <li class="footer__navitem"><%= link_to t("layouts.decidim.footer.download_open_data"), decidim.open_data_download_path %></li>
+
+            <% if current_user %>
+                <li class="footer__navitem"><%= link_to t(".sign_out"), decidim.destroy_user_session_path, method: :delete, class: "sign-out-link", role: "menuitem" %></li>
+            <% end %>
+        </ul>
+    </nav>
+    <nav id="SocialLinks" aria-describedBy="SocialLinksLabel" class="footer_nav footer_nav--social">
+        <% if current_organization.twitter_handler.present? || current_organization.facebook_handler.present? || current_organization.instagram_handler.present? || current_organization.youtube_handler.present? %>
+            <strong id="SocialLinksLabel"><%= t(".sections.social") %></strong>
+        <% end %>
+        <ul>
+            <% if current_organization.twitter_handler.present? %>
+            <li class="footer__navitem">
+                <a class="footer-social__icon" target="_blank" rel="noopener" href="https://twitter.com/<%= current_organization.twitter_handler %>">
+                    <%= t("layouts.decidim.social_media_links.twitter", organization: translated_attribute(current_organization.name)) %>
+                </a>
+            </li>
+            <% end %>
+            <% if current_organization.facebook_handler.present? %>
+            <li class="footer__navitem">
+                <a class="footer-social__icon" target="_blank" rel="noopener" href="https://www.facebook.com/<%= current_organization.facebook_handler %>">
+                    <%= t("layouts.decidim.social_media_links.facebook", organization: translated_attribute(current_organization.name)) %>
+                </a>
+            </li>
+            <% end %>
+            <% if current_organization.instagram_handler.present? %>
+                <li class="footer__navitem">
+                    <a target="_blank" rel="noopener" href="https://www.instagram.com/<%= current_organization.instagram_handler %>">
+                        <%= t("layouts.decidim.social_media_links.instagram", organization: translated_attribute(current_organization.name)) %>
+                    </a>
+                </li>
+            <% end %>
+            <% if current_organization.youtube_handler.present? %>
+                <li class="footer__navitem">
+                    <a target="_blank" rel="noopener" href="https://www.youtube.com/<%= current_organization.youtube_handler %>">
+                        <%= t("layouts.decidim.social_media_links.youtube", organization: translated_attribute(current_organization.name)) %>
+                    </a>
+                </li>
+            <% end %>
+            <% if current_organization.github_handler.present? %>
+                <li class="footer__navitem">
+                    <a target="_blank" rel="noopener" href="https://www.github.com/<%= current_organization.github_handler %>">
+                        <%= t("layouts.decidim.social_media_links.github", organization: translated_attribute(current_organization.name)) %>
+                    </a>
+                </li>
+            <% end %>
+        </ul>
+    </nav>
+    <nav id="LanguageLinks" class="footer_nav footer_nav--language">
+        <%= render partial: "layouts/decidim/language_chooser" %>
+    </nav>
+</footer>

data/app/overrides/layouts/decidim/_mini_footer/replace_content.html.erb.deface

@@ -0,0 +1,25 @@
+<!-- replace '.mini-footer' -->
+<footer id="FooterCredits" class="credits">
+    <div id="PlatformLicense" class="credits__column credits__column--license">
+        <a rel="license noopener" class="cc-badge"
+            href="http://creativecommons.org/licenses/by-sa/4.0/"
+            target="_blank">
+            <%= image_pack_tag("media/images/cc-by-sa-4.svg", alt: t("layouts.decidim.footer.cc_by_license")) %>
+        </a>
+        <a rel="decidim noopener"
+           href="https://decidim.org/"
+           target="_blank">
+          <%= image_pack_tag("media/images/decidim-initial.svg", alt: t("layouts.decidim.footer.decidim_logo")) %>
+        </a>
+    </div>
+    <div id="MadeWith" class="credits__column credits__column--madewith">
+      <%= t("layouts.decidim.footer.made_with_open_source").html_safe %>
+    </div>
+    <div id="MadeBy" class="credits__column credits__column--madeby">
+        <% if current_organization.official_img_footer.attached? %>
+            <%= link_to current_organization.official_url do %>
+                <%= image_tag current_organization.attached_uploader(:official_img_footer).path, alt: current_organization.name %>
+            <% end %>
+        <% end %>
+    </div>
+</footer>

data/app/overrides/mailer_styles.rb

@@ -0,0 +1,36 @@
+Deface::Override.new(
+    :virtual_path => "layouts/decidim/mailer",
+    :name => "insert_email_css",
+    :replace => 'erb[loud]:contains("decidim_email")',
+    :text => "<%= stylesheet_pack_tag \"decidim_theme_email\" %>"
+)
+Deface::Override.new(
+    :virtual_path => "layouts/decidim/mailer",
+    :name => "email_outlook_spacer_1",
+    :set_attributes => '.spacer td',
+    :attributes => {height: "40"}
+)
+Deface::Override.new(
+    :virtual_path => "layouts/decidim/mailer",
+    :name => "email_center_footer",
+    :set_attributes => '.decidim-logo',
+    :attributes => {style: "text-align: center; padding-right: 16px"}
+)
+Deface::Override.new(
+    :virtual_path => "layouts/decidim/mailer",
+    :name => "email_footer_padding",
+    :set_attributes => '.row.content + .row',
+    :attributes => {height: "16"}
+)
+# Outlook fix: height must be as attribute, without pixel.
+Deface::Override.new(
+    :virtual_path => "layouts/decidim/_mailer_logo",
+    :name => "email_header_image",
+    :replace => 'erb[loud]:contains("image_tag")',
+    :text => "<%= image_tag(
+        organization.attached_uploader(:logo).variant_url(:medium, host: organization.host),
+        style: \"max-height: 50px\",
+        alt: \"\#{organization.name}\",
+        height: \"50\"
+      ) %>"
+)

data/app/overrides/prefix_body.rb

@@ -0,0 +1,10 @@
+##
+# Add classes like .o-sessions--new to all pages, 
+# with .o-<controller name> .o-<controller name>--<action-name>
+#
+Deface::Override.new(
+    :virtual_path => "layouts/decidim/_application",
+    :name => "class_prefixer_application",
+    :add_to_attributes => 'body',
+    :attributes => {:class => "<%= \"o-\" + params[:controller].split(\"/\").last.underscore + \" o-\" + params[:controller].split(\"/\").last.underscore + \"--\" + params[:action] %>"}
+)

data/app/overrides/prefix_classes.rb

@@ -0,0 +1,63 @@
+##
+# takes a long list of views, and insert at the root of the template
+# the reference to the view template, to make the CSS work easier.
+view_index = 0
+{
+    "accountability/results": ["home", "index", "show"],
+    "accountability/versions": ["index", "show"],
+    "assemblies/assemblies": ["index", "show"],
+    "assemblies/assembly_members": ["index"],
+    "blogs/posts": ["index", "show"],
+    "budgets/budgets": ["index"],
+    "budgets/projects": ["index", "show"],
+    # "conferences/conferences": ["index", "show"],
+    # "conferences/conference_program": ["show"],
+    # "conferences/registration_types": ["index"],
+    "account": ["show", "delete"],
+    "devise/sessions": ["new"],
+    "devise/registrations": ["new"],
+    "devise/confirmations": ["new"],
+    "devise/unlocks": ["new"],
+    "devise/invitations": ["edit"],
+    "devise/passwords": ["new", "edit"],
+    "groups": ["edit", "new"],
+    "homepage": ["show"],
+    "last_activities": ["index"],
+    "messaging/conversations": ["index", "new", "show"],
+    "notifications": ["index"],
+    "notifications_settings": ["show"],
+    "pages": ["index", "_tabbed", "_standalone"],
+    "profiles": ["show"],
+    "scopes": ["picker"],
+    "searches": ["index"],
+    "user_activities": ["index"],
+    "user_conversations": ["index", "show"],
+    "user_interests": ["show"],
+    "user_timeline": ["index"],
+    "shared": ["_comments"],
+    "debates/debates": ["index", "new", "show"],
+    "debates/versions": ["index", "show"],
+    "meetings/meetings": ["index", "edit", "new", "show"],
+    "meetings/versions": ["index", "show"],
+    "participatory_processes/participatory_processes": ["index", "show", "all_metrics"],
+    "proposals/proposals": ["edit", "index", "new", "preview", "show", "complete", "compare", "_linked_proposals"],
+    "sortitions/sortitions": ["index", "show"]
+}.each do |module_name, views|
+    css_module_name = "#{module_name}".gsub("/", "-")
+    views.each do |view_name|
+        css_suffix = "#{view_name}".gsub("_","")
+        css_view_name = "m_#{css_module_name}--#{css_suffix}"
+        Deface::Override.new(
+            :virtual_path => "decidim/#{module_name}/#{view_name}",
+            :name => "class_prefixer_#{view_index+=1}",
+            :add_to_attributes => 'div:root,ul:root,article:root,section:root',
+            :attributes => {:class => "m_#{css_module_name} #{css_view_name}"}
+        )
+        Deface::Override.new(
+            :virtual_path => "decidim/#{module_name}/#{view_name}",
+            :name => "section_prefixer_#{view_index+=1}",
+            :add_to_attributes => 'section',
+            :attributes => {:class => "m_#{css_module_name} m_#{css_module_name}--section"}
+        )
+    end
+end

data/app/overrides/prefix_processes_wrapper.rb

@@ -0,0 +1,10 @@
+##
+# Add participatory_process class to the wrapper div
+# in participatory_process layouts.
+# This help us to design info tab and components.
+Deface::Override.new(
+    :virtual_path => "layouts/decidim/participatory_process",
+    :name => "class_prefixer_participatory_process",
+    :add_to_attributes => 'div.wrapper',
+    :attributes => {:class => "o_participatory_process o_participatory_process--layout"}
+)

data/app/packs/entrypoints/decidim_theme_email.js

@@ -0,0 +1 @@
+import "entrypoints/decidim_theme_email.scss"; 

data/app/packs/entrypoints/decidim_theme_email.scss

@@ -0,0 +1,2 @@
+@import "stylesheets/decidim/theme/email.scss";
+

data/app/packs/entrypoints/decidim_theme_polyfill.js

@@ -0,0 +1,5 @@
+import $ from "jquery";
+import "javascripts/has.polyfill.js";
+import "javascripts/empty.polyfill.js";
+require.context("../images", true);
+require.context("../fonts", true);