File: app/helpers/projects_helper.rb

Overview
Module Structure
Code

Overview

Module Structure

  module: <Toplevel Module>
  module: ProjectsHelper#20
has properties
method: link_to_version / 2 #21
method: project_settings_tabs #26
method: parent_project_select_tag / 1 #40
method: render_project_hierarchy / 1 #57
method: version_options_for_select / 2 #89
method: format_version_sharing / 1 #106

Code

   1  # encoding: utf-8
   2  #
   3  # Redmine - project management software
   4  # Copyright (C) 2006-2011  Jean-Philippe Lang
   5  #
   6  # This program is free software; you can redistribute it and/or
   7  # modify it under the terms of the GNU General Public License
   8  # as published by the Free Software Foundation; either version 2
   9  # of the License, or (at your option) any later version.
  10  #
  11  # This program is distributed in the hope that it will be useful,
  12  # but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  # GNU General Public License for more details.
  15  #
  16  # You should have received a copy of the GNU General Public License
  17  # along with this program; if not, write to the Free Software
  18  # Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  19 
  20  module ProjectsHelper
  21    def link_to_version(version, options = {})
  22      return '' unless version && version.is_a?(Version)
  23      link_to_if version.visible?, format_version_name(version), { :controller => 'versions', :action => 'show', :id => version }, options
  24    end
  25 
  26    def project_settings_tabs
  27      tabs = [{:name => 'info', :action => :edit_project, :partial => 'projects/edit', :label => :label_information_plural},
  28              {:name => 'modules', :action => :select_project_modules, :partial => 'projects/settings/modules', :label => :label_module_plural},
  29              {:name => 'members', :action => :manage_members, :partial => 'projects/settings/members', :label => :label_member_plural},
  30              {:name => 'versions', :action => :manage_versions, :partial => 'projects/settings/versions', :label => :label_version_plural},
  31              {:name => 'categories', :action => :manage_categories, :partial => 'projects/settings/issue_categories', :label => :label_issue_category_plural},
  32              {:name => 'wiki', :action => :manage_wiki, :partial => 'projects/settings/wiki', :label => :label_wiki},
  33              {:name => 'repositories', :action => :manage_repository, :partial => 'projects/settings/repositories', :label => :label_repository_plural},
  34              {:name => 'boards', :action => :manage_boards, :partial => 'projects/settings/boards', :label => :label_board_plural},
  35              {:name => 'activities', :action => :manage_project_activities, :partial => 'projects/settings/activities', :label => :enumeration_activities}
  36              ]
  37      tabs.select {|tab| User.current.allowed_to?(tab[:action], @project)}
  38    end
  39 
  40    def parent_project_select_tag(project)
  41      selected = project.parent
  42      # retrieve the requested parent project
  43      parent_id = (params[:project] && params[:project][:parent_id]) || params[:parent_id]
  44      if parent_id
  45        selected = (parent_id.blank? ? nil : Project.find(parent_id))
  46      end
  47 
  48      options = ''
  49      options << "<option value=''></option>" if project.allowed_parents.include?(nil)
  50      options << project_tree_options_for_select(project.allowed_parents.compact, :selected => selected)
  51      content_tag('select', options.html_safe, :name => 'project[parent_id]', :id => 'project_parent_id')
  52    end
  53 
  54    # Renders a tree of projects as a nested set of unordered lists
  55    # The given collection may be a subset of the whole project tree
  56    # (eg. some intermediate nodes are private and can not be seen)
  57    def render_project_hierarchy(projects)
  58      s = ''
  59      if projects.any?
  60        ancestors = []
  61        original_project = @project
  62        projects.each do |project|
  63          # set the project environment to please macros.
  64          @project = project
  65          if (ancestors.empty? || project.is_descendant_of?(ancestors.last))
  66            s << "<ul class='projects #{ ancestors.empty? ? 'root' : nil}'>\n"
  67          else
  68            ancestors.pop
  69            s << "</li>"
  70            while (ancestors.any? && !project.is_descendant_of?(ancestors.last))
  71              ancestors.pop
  72              s << "</ul></li>\n"
  73            end
  74          end
  75          classes = (ancestors.empty? ? 'root' : 'child')
  76          s << "<li class='#{classes}'><div class='#{classes}'>" +
  77                 link_to_project(project, {}, :class => "project #{User.current.member_of?(project) ? 'my-project' : nil}")
  78          s << "<div class='wiki description'>#{textilizable(project.short_description, :project => project)}</div>" unless project.description.blank?
  79          s << "</div>\n"
  80          ancestors << project
  81        end
  82        s << ("</li></ul>\n" * ancestors.size)
  83        @project = original_project
  84      end
  85      s.html_safe
  86    end
  87 
  88    # Returns a set of options for a select field, grouped by project.
  89    def version_options_for_select(versions, selected=nil)
  90      grouped = Hash.new {|h,k| h[k] = []}
  91      versions.each do |version|
  92        grouped[version.project.name] << [version.name, version.id]
  93      end
  94      # Add in the selected
  95      if selected && !versions.include?(selected)
  96        grouped[selected.project.name] << [selected.name, selected.id]
  97      end
  98 
  99      if grouped.keys.size > 1
 100        grouped_options_for_select(grouped, selected && selected.id)
 101      else
 102        options_for_select((grouped.values.first || []), selected && selected.id)
 103      end
 104    end
 105 
 106    def format_version_sharing(sharing)
 107      sharing = 'none' unless Version::VERSION_SHARINGS.include?(sharing)
 108      l("label_version_sharing_#{sharing}")
 109    end
 110  end