zammad/app/helpers/knowledge_base_breadcrumb_helper.rb

# Copyright (C) 2012-2024 Zammad Foundation, https://zammad-foundation.org/

module KnowledgeBaseBreadcrumbHelper
  def render_breadcrumb_if_needed(knowledge_base, object, alternative)
    objects = if object.is_a? Array
                calculate_breadcrumb_nonpath(object)
              else
                calculate_breadcrumb_path(object, alternative)
              end

    return if objects.empty?

    render 'knowledge_base/public/breadcrumb', { objects:, knowledge_base: }
  end

  def calculate_breadcrumb_path(object, alternative)
    objects = calculate_breadcrumb_to_category(object&.parent)

    last = if alternative.present? && alternative.translations.any?
             Translation.translate(system_locale_via_uri&.locale, 'Alternative Translations')
           else
             object
           end

    objects + [last].compact
  end

  def calculate_breadcrumb_nonpath(object)
    [object]
  end

  def calculate_breadcrumb_to_category(category)
    return [] if category.blank?

    output = [find_category(category)]

    parent = category
    while (parent = find_category(parent&.parent_id))
      output << parent
    end

    output.compact.reverse
  end

  def breadcrumb_path_for(object, locale = params.fetch(:locale))
    case object
    in KnowledgeBase
      help_root_path(locale:)
    in KnowledgeBase::Category
      help_category_path(object.translation, locale:)
    in KnowledgeBase::Answer
      help_answer_path(object.category.translation, object.translation, locale:)
    in [:tag, tag_name]
      help_tag_path(locale, tag_name)
    else
      nil
    end
  end

  def breadcrumb_text_for(object)
    case object
    when HasTranslations
      object.translation.title
    when Array
      object[1]
    else
      object
    end
  end
end