Sha256: d6c46d1fa708abba34c497f672013de259e0ded64a1c7fc62e230fd6473dbbc5

Contents?: true

Size: 1.74 KB

Versions: 9

Compression:

Stored size: 1.74 KB

Contents

# frozen_string_literal: true

module Decidim
  module ContentParsers
    # A parser that searches user mentions in content.
    #
    # A word starting with `@` will be considered as a possible mention if
    # they only contains letters, numbers or underscores.
    #
    # @see BaseParser Examples of how to use a content parser
    class UserParser < BaseParser
      # Class used as a container for metadata
      #
      # @!attribute users
      #   @return [Array] an array of Decidim::User mentioned in content
      Metadata = Struct.new(:users)

      # Matches a nickname if contains letters, numbers or underscores.
      MENTION_REGEX = /\B@(\w*)\b/.freeze

      # Replaces found mentions matching a nickname of an existing
      # user in the current organization with a global id. Other
      # mentions found that doesn't match an existing user are
      # returned as is.
      #
      # @return [String] the content with the valid mentions replaced by a global id
      def rewrite
        content.gsub(MENTION_REGEX) do |match|
          users[match[1..-1]]&.to_global_id&.to_s || match
        end
      end

      # (see BaseParser#metadata)
      def metadata
        Metadata.new(existing_users)
      end

      private

      def users
        @users ||= Hash[
          existing_users.map do |user|
            [user.nickname, user]
          end
        ]
      end

      def existing_users
        @existing_users ||= Decidim::User.where(organization: current_organization, nickname: content_nicknames)
      end

      def content_nicknames
        @content_nicknames ||= content.scan(MENTION_REGEX).flatten.uniq
      end

      def current_organization
        @current_organization ||= context[:current_organization]
      end
    end
  end
end

Version data entries

9 entries across 9 versions & 1 rubygems

Version Path
decidim-core-0.23.6 lib/decidim/content_parsers/user_parser.rb
decidim-core-0.23.5 lib/decidim/content_parsers/user_parser.rb
decidim-core-0.23.4 lib/decidim/content_parsers/user_parser.rb
decidim-core-0.23.3 lib/decidim/content_parsers/user_parser.rb
decidim-core-0.23.2 lib/decidim/content_parsers/user_parser.rb
decidim-core-0.23.1 lib/decidim/content_parsers/user_parser.rb
decidim-core-0.23.1.rc1 lib/decidim/content_parsers/user_parser.rb
decidim-core-0.23.0 lib/decidim/content_parsers/user_parser.rb
decidim-core-0.22.0 lib/decidim/content_parsers/user_parser.rb