Module: ProjectsHelper

Defined in:
app/helpers/projects_helper.rb

Overview

Redmine - project management software Copyright (C) 2006-2017 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.

Since:

  • 0.4.0

Instance Method Summary collapse

Instance Method Details

#format_version_sharing(sharing) ⇒ Object

Since:

  • 0.9.0



98
99
100
101
 
# File 'app/helpers/projects_helper.rb', line 98

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

#parent_project_select_tag(project) ⇒ Object

Since:

  • 0.9.0



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

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=''>&nbsp;</option>" if project.allowed_parents.include?(nil)
  options << project_tree_options_for_select(project.allowed_parents.compact, :selected => selected)
  content_tag('select', options.html_safe, :name => 'project[parent_id]', :id => 'project_parent_id')
end

#project_default_assigned_to_options(project) ⇒ Object

Since:

  • 3.4.0



93
94
95
96
 
# File 'app/helpers/projects_helper.rb', line 93

def project_default_assigned_to_options(project)
  assignable_users = (project.assignable_users.to_a + [project.default_assigned_to]).uniq.compact
  principals_options_for_select(assignable_users, project.default_assigned_to)
end

#project_default_version_options(project) ⇒ Object

Since:

  • 3.2.0



85
86
87
88
89
90
91
 
# File 'app/helpers/projects_helper.rb', line 85

def project_default_version_options(project)
  versions = project.shared_versions.open.to_a
  if project.default_version && !versions.include?(project.default_version)
    versions << project.default_version
  end
  version_options_for_select(versions, project.default_version)
end

#project_settings_tabs ⇒ Object

Since:

  • 0.6.0



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

def project_settings_tabs
  tabs = [{:name => 'info', :action => :edit_project, :partial => 'projects/edit', :label => :label_project},
          {:name => 'members', :action => :manage_members, :partial => 'projects/settings/members', :label => :label_member_plural},
          {:name => 'issues', :action => :edit_project, :module => :issue_tracking, :partial => 'projects/settings/issues', :label => :label_issue_tracking},
          {:name => 'versions', :action => :manage_versions, :partial => 'projects/settings/versions', :label => :label_version_plural,
            :url => {:tab => 'versions', :version_status => params[:version_status], :version_name => params[:version_name]}},
          {:name => 'categories', :action => :manage_categories, :partial => 'projects/settings/issue_categories', :label => :label_issue_category_plural},
          {:name => 'repositories', :action => :manage_repository, :partial => 'projects/settings/repositories', :label => :label_repository_plural},
          {:name => 'boards', :action => :manage_boards, :partial => 'projects/settings/boards', :label => :label_board_plural},
          {:name => 'activities', :action => :manage_project_activities, :partial => 'projects/settings/activities', :label => :label_time_tracking}
          ]
  tabs.
    select {|tab| User.current.allowed_to?(tab[:action], @project)}.
    select {|tab| tab[:module].nil? || @project.module_enabled?(tab[:module])}
end

#render_api_includes(project, api) ⇒ Object

Since:

  • 2.6.0



116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
 
# File 'app/helpers/projects_helper.rb', line 116

def render_api_includes(project, api)
  api.array :trackers do
    project.trackers.each do |tracker|
      api.tracker(:id => tracker.id, :name => tracker.name)
    end
  end if include_in_api_response?('trackers')

  api.array :issue_categories do
    project.issue_categories.each do |category|
      api.issue_category(:id => category.id, :name => category.name)
    end
  end if include_in_api_response?('issue_categories')

  api.array :time_entry_activities do
    project.activities.each do |activity|
      api.time_entry_activity(:id => activity.id, :name => activity.name)
    end
  end if include_in_api_response?('time_entry_activities')

  api.array :enabled_modules do
    project.enabled_modules.each do |enabled_module|
      api.enabled_module(:id => enabled_module.id, :name => enabled_module.name)
    end
  end if include_in_api_response?('enabled_modules')
end

#render_boards_tree(boards, parent = nil, level = 0, &block) ⇒ Object

Since:

  • 3.3.0



103
104
105
106
107
108
109
110
111
112
113
114
 
# File 'app/helpers/projects_helper.rb', line 103

def render_boards_tree(boards, parent=nil, level=0, &block)
  selection = boards.select {|b| b.parent == parent}
  return '' if selection.empty?

  s = ''.html_safe
  selection.each do |board|
    node = capture(board, level, &block)
    node << render_boards_tree(boards, board, level+1, &block)
    s << content_tag('div', node)
  end
  content_tag('div', s, :class => 'sort-level')
end

#render_project_action_links ⇒ Object

Since:

  • 2.5.1



51
52
53
54
55
56
57
 
# File 'app/helpers/projects_helper.rb', line 51

def render_project_action_links
  links = "".html_safe
  if User.current.allowed_to?(:add_project, nil, :global => true)
    links << link_to(l(:label_project_new), new_project_path, :class => 'icon icon-add')
  end
  links
end

#render_project_hierarchy(projects) ⇒ Object

Renders the projects index

Since:

  • 0.9.0



60
61
62
63
64
65
66
67
68
 
# File 'app/helpers/projects_helper.rb', line 60

def render_project_hierarchy(projects)
  render_project_nested_lists(projects) do |project|
    s = link_to_project(project, {}, :class => "#{project.css_classes} #{User.current.member_of?(project) ? 'icon icon-fav my-project' : nil}")
    if project.description.present?
      s << content_tag('div', textilizable(project.short_description, :project => project), :class => 'wiki description')
    end
    s
  end
end

#version_options_for_select(versions, selected = nil) ⇒ Object

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

Since:

  • 0.9.0



71
72
73
74
75
76
77
78
79
80
81
82
83
 
# File 'app/helpers/projects_helper.rb', line 71

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

  selected = selected.is_a?(Version) ? selected.id : selected
  if grouped.keys.size > 1
    grouped_options_for_select(grouped, selected)
  else
    options_for_select((grouped.values.first || []), selected)
  end
end