Module: ProjectsHelper

Included in:
IssuesController, ProjectsController
Defined in:
app/helpers/projects_helper.rb

Overview

redMine - project management software Copyright (C) 2006 Jean-Philippe Lang

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

Instance Method Summary

Instance Method Details

- (Object) format_version_sharing(sharing)



100
101
102
103
# File 'app/helpers/projects_helper.rb', line 100

def format_version_sharing()
   = 'none' unless Version::VERSION_SHARINGS.include?()
  l("label_version_sharing_#{sharing}")
end


19
20
21
22
# File 'app/helpers/projects_helper.rb', line 19

def link_to_version(version, options = {})
  return '' unless version && version.is_a?(Version)
  link_to_if version.visible?, format_version_name(version), { :controller => 'versions', :action => 'show', :id => version }, options
end

- (Object) parent_project_select_tag(project)



38
39
40
41
42
43
44
45
46
47
48
49
50
# File 'app/helpers/projects_helper.rb', line 38

def parent_project_select_tag(project)
  selected = project.parent
  # retrieve the requested parent project
  parent_id = (params[:project] && params[:project][:parent_id]) || params[:parent_id]
  if parent_id
    selected = (parent_id.blank? ? nil : Project.find(parent_id))
  end
  
  options = ''
  options << "<option value=''></option>" if project.allowed_parents.include?(nil)
  options << project_tree_options_for_select(project.allowed_parents.compact, :selected => selected)
  ('select', options, :name => 'project[parent_id]', :id => 'project_parent_id')
end

- (Object) project_settings_tabs



24
25
26
27
28
29
30
31
32
33
34
35
36
# File 'app/helpers/projects_helper.rb', line 24

def project_settings_tabs
  tabs = [{:name => 'info', :action => :edit_project, :partial => 'projects/edit', :label => :label_information_plural},
          {:name => 'modules', :action => :select_project_modules, :partial => 'projects/settings/modules', :label => :label_module_plural},
          {:name => 'members', :action => :manage_members, :partial => 'projects/settings/members', :label => :label_member_plural},
          {:name => 'versions', :action => :manage_versions, :partial => 'projects/settings/versions', :label => :label_version_plural},
          {:name => 'categories', :action => :manage_categories, :partial => 'projects/settings/issue_categories', :label => :label_issue_category_plural},
          {:name => 'wiki', :action => :manage_wiki, :partial => 'projects/settings/wiki', :label => :label_wiki},
          {:name => 'repository', :action => :manage_repository, :partial => 'projects/settings/repository', :label => :label_repository},
          {:name => 'boards', :action => :manage_boards, :partial => 'projects/settings/boards', :label => :label_board_plural},
          {:name => 'activities', :action => :manage_project_activities, :partial => 'projects/settings/activities', :label => :enumeration_activities}
          ]
  tabs.select {|tab| User.current.allowed_to?(tab[:action], @project)}     
end

- (Object) render_project_hierarchy(projects)

Renders a tree of projects as a nested set of unordered lists The given collection may be a subset of the whole project tree (eg. some intermediate nodes are private and can not be seen)



55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
# File 'app/helpers/projects_helper.rb', line 55

def render_project_hierarchy(projects)
  s = ''
  if projects.any?
    ancestors = []
    projects.each do |project|
      if (ancestors.empty? || project.is_descendant_of?(ancestors.last))
        s << "<ul class='projects #{ ancestors.empty? ? 'root' : nil}'>\n"
      else
        ancestors.pop
        s << "</li>"
        while (ancestors.any? && !project.is_descendant_of?(ancestors.last)) 
          ancestors.pop
          s << "</ul></li>\n"
        end
      end
      classes = (ancestors.empty? ? 'root' : 'child')
      s << "<li class='#{classes}'><div class='#{classes}'>" +
             link_to(h(project), {:controller => 'projects', :action => 'show', :id => project}, :class => "project #{User.current.member_of?(project) ? 'my-project' : nil}")
      s << "<div class='wiki description'>#{textilizable(project.short_description, :project => project)}</div>" unless project.description.blank?
      s << "</div>\n"
      ancestors << project
    end
    s << ("</li></ul>\n" * ancestors.size)
  end
  s
end

- (Object) version_options_for_select(versions, selected = nil)

Returns a set of options for a select field, grouped by project.



83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
# File 'app/helpers/projects_helper.rb', line 83

def version_options_for_select(versions, selected=nil)
  grouped = Hash.new {|h,k| h[k] = []}
  versions.each do |version|
    grouped[version.project.name] << [version.name, version.id]
  end
  # Add in the selected
  if selected && !versions.include?(selected)
    grouped[selected.project.name] << [selected.name, selected.id]
  end
  
  if grouped.keys.size > 1
    grouped_options_for_select(grouped, selected && selected.id)
  else
    options_for_select((grouped.values.first || []), selected && selected.id)
  end
end