Sha256: a515cf1b2da3f97f5ed82d6956031eb93b3cd9b12e9d8f066ae513e6f8059ac7

Contents?: true

Size: 1.99 KB

Versions: 10

Compression:

Stored size: 1.99 KB

Contents

# frozen_string_literal: true

module Decidim
  # A Helper to render and link to resources.
  module ResourceHelper
    # Gets the classes linked to the given class for the `current_component`, and formats
    # them in a nice way so that they can be used in a form. Resulting format looks like
    # this, considering the given class is related to `Decidim::Meetings::Meeting`:
    #
    #   [["decidim/meetings/meeting", "Meetings"]]
    #
    # This method is intended to be used as a check to render the filter or not. Use the
    # `linked_classes_filter_values_for(klass)` method to get the form filter collection
    # values.
    #
    # klass - The class that will have its linked resources formatted.
    #
    # Returns an Array of Arrays of Strings.
    # Returns an empty Array if no links are found.
    def linked_classes_for(klass)
      return [] unless klass.respond_to?(:linked_classes_for)

      klass.linked_classes_for(current_component).map do |k|
        [k.underscore, content_tag(:span, t(k.demodulize.underscore, scope: "decidim.filters.linked_classes"))]
      end
    end

    # Uses the `linked_classes_for(klass)` helper method to find the linked classes,
    # and adds a default value to it so that it can be used directly in a form.
    #
    # Example:
    #
    #   <% if linked_classes_for(klass).any? %>
    #     <%= form.collection_check_boxes :related_to, linked_classes_filter_values_for(klass), :first, :last %>
    #   <% end %>
    #
    # klass - The class that will have its linked resources formatted.
    #
    # Returns an Array of Arrays of Strings.
    def linked_classes_filter_values_for(klass)
      [["", content_tag(:span, t("all", scope: "decidim.filters.linked_classes"))]] + linked_classes_for(klass)
    end

    # Returns an instance of ResourceLocatorPresenter with the given resource
    def resource_locator(resource)
      return resource.resource_locator if resource.respond_to?(:resource_locator)

      ::Decidim::ResourceLocatorPresenter.new(resource)
    end
  end
end

Version data entries

10 entries across 10 versions & 1 rubygems

Version Path
decidim-core-0.30.0.rc3 app/helpers/decidim/resource_helper.rb
decidim-core-0.30.0.rc2 app/helpers/decidim/resource_helper.rb
decidim-core-0.30.0.rc1 app/helpers/decidim/resource_helper.rb
decidim-core-0.29.2 app/helpers/decidim/resource_helper.rb
decidim-core-0.29.1 app/helpers/decidim/resource_helper.rb
decidim-core-0.29.0 app/helpers/decidim/resource_helper.rb
decidim-core-0.29.0.rc4 app/helpers/decidim/resource_helper.rb
decidim-core-0.29.0.rc3 app/helpers/decidim/resource_helper.rb
decidim-core-0.29.0.rc2 app/helpers/decidim/resource_helper.rb
decidim-core-0.29.0.rc1 app/helpers/decidim/resource_helper.rb