Class: ProjectsController

Inherits:
ApplicationController show all
Includes:
CustomFieldsHelper, ProjectsHelper, QueriesHelper, RepositoriesHelper, SortHelper
Defined in:
app/controllers/projects_controller.rb

Overview

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

Methods included from SortHelper

#sort_clause, #sort_clear, #sort_header_tag, #sort_init, #sort_link, #sort_name, #sort_update

Methods included from CustomFieldsHelper

#custom_field_formats_for_select, #custom_field_label_tag, #custom_field_tag, #custom_field_tag_for_bulk_edit, #custom_field_tag_with_label, #custom_fields_tabs, #format_value, #show_value

Methods included from QueriesHelper

#column_content, #column_header, #operators_for_select

Methods included from RepositoriesHelper

#bazaar_field_tags, #cvs_field_tags, #darcs_field_tags, #filesystem_field_tags, #format_revision, #git_field_tags, #mercurial_field_tags, #render_changes_tree, #render_changeset_changes, #render_properties, #repository_field_tags, #scm_select_tag, #subversion_field_tags, #to_utf8, #truncate_at_line_break, #with_leading_slash, #without_leading_slash

Methods included from ProjectsHelper

#format_version_sharing, #link_to_version, #parent_project_select_tag, #project_settings_tabs, #render_project_hierarchy, #version_options_for_select

Methods inherited from ApplicationController

accept_key_auth, #accept_key_auth_actions, #api_request?, #authorize, #authorize_global, #check_if_login_required, #check_project_privacy, #delete_broken_cookies, #deny_access, #filename_for_content_disposition, #find_current_user, #find_model_object, #find_project, #find_project_from_association, #invalid_authenticity_token, #logged_user=, model_object, #parse_qvalues, #per_page_option, #redirect_back_or_default, #render_403, #render_404, #render_attachment_warning_if_needed, #render_error, #render_feed, #require_admin, #require_login, #set_localization, #user_setup

Methods included from Redmine::I18n

#current_language, #day_name, #find_language, #format_date, #format_time, included, #l, #l_hours, #l_or_humanize, #ll, #month_name, #set_language_if_valid, #valid_languages

Methods included from Redmine::Search::Controller

#default_search_scope, #default_search_scopes, included

Methods included from Redmine::MenuManager::MenuController

#current_menu_item, included, #menu_items, #redirect_to_project_menu_item

Instance Method Details

- (Object) activity



315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
# File 'app/controllers/projects_controller.rb', line 315

def activity
  @days = Setting.activity_days_default.to_i
  
  if params[:from]
    begin; @date_to = params[:from].to_date + 1; rescue; end
  end

  @date_to ||= Date.today + 1
  @date_from = @date_to - @days
  @with_subprojects = params[:with_subprojects].nil? ? Setting.display_subprojects_issues? : (params[:with_subprojects] == '1')
  @author = (params[:user_id].blank? ? nil : User.active.find(params[:user_id]))
  
  @activity = Redmine::Activity::Fetcher.new(User.current, :project => @project, 
                                                           :with_subprojects => @with_subprojects,
                                                           :author => @author)
  @activity.scope_select {|t| !params["show_#{t}"].nil?}
  @activity.scope = (@author.nil? ? :default : :all) if @activity.scope.empty?

  events = @activity.events(@date_from, @date_to)
  
  if events.empty? || stale?(:etag => [events.first, User.current])
    respond_to do |format|
      format.html { 
        @events_by_day = events.group_by(&:event_date)
        render :layout => false if request.xhr?
      }
      format.atom {
        title = l(:label_activity)
        if @author
          title = @author.name
        elsif @activity.scope.size == 1
          title = l("label_#{@activity.scope.first.singularize}_plural")
        end
        render_feed(events, :title => "#{@project || Setting.app_title}: #{title}")
      }
    end
  end
  
rescue ActiveRecord::RecordNotFound
  render_404
end

- (Object) add

Add a new project



68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
# File 'app/controllers/projects_controller.rb', line 68

def add
  @issue_custom_fields = IssueCustomField.find(:all, :order => "#{CustomField.table_name}.position")
  @trackers = Tracker.all
  @project = Project.new(params[:project])
  if request.get?
    @project.identifier = Project.next_identifier if Setting.sequential_project_identifiers?
    @project.trackers = Tracker.all
    @project.is_public = Setting.default_projects_public?
    @project.enabled_module_names = Setting.default_projects_modules
  else
    @project.enabled_module_names = params[:enabled_modules]
    if validate_parent_id && @project.save
      @project.set_allowed_parent!(params[:project]['parent_id']) if params[:project].has_key?('parent_id')
      # Add current user as a project member if he is not admin
      unless User.current.admin?
        r = Role.givable.find_by_id(Setting.new_project_user_role_id.to_i) || Role.givable.first
        m = Member.new(:user => User.current, :roles => [r])
        @project.members << m
      end
      respond_to do |format|
        format.html { 
          flash[:notice] = l(:notice_successful_create)
          redirect_to :controller => 'projects', :action => 'settings', :id => @project
        }
        format.xml  { head :created, :location => url_for(:controller => 'projects', :action => 'show', :id => @project.id) }
      end
    else
      respond_to do |format|
        format.html
        format.xml  { render :xml => @project.errors, :status => :unprocessable_entity }
      end
    end
  end 
end

- (Object) add_file



245
246
247
248
249
250
251
252
253
254
255
256
257
258
# File 'app/controllers/projects_controller.rb', line 245

def add_file
  if request.post?
    container = (params[:version_id].blank? ? @project : @project.versions.find_by_id(params[:version_id]))
    attachments = Attachment.attach_files(container, params[:attachments])
    render_attachment_warning_if_needed(container)

    if !attachments.empty? && Setting.notified_events.include?('file_added')
      Mailer.deliver_attachments_added(attachments[:files])
    end
    redirect_to :controller => 'projects', :action => 'list_files', :id => @project
    return
  end
  @versions = @project.versions.sort
end

- (Object) archive



213
214
215
216
217
218
219
220
# File 'app/controllers/projects_controller.rb', line 213

def archive
  if request.post?
    unless @project.archive
      flash[:error] = l(:error_can_not_archive_project)
    end
  end
  redirect_to(url_for(:controller => 'admin', :action => 'projects', :status => params[:status]))
end

- (Object) copy



103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
# File 'app/controllers/projects_controller.rb', line 103

def copy
  @issue_custom_fields = IssueCustomField.find(:all, :order => "#{CustomField.table_name}.position")
  @trackers = Tracker.all
  @root_projects = Project.find(:all,
                                :conditions => "parent_id IS NULL AND status = #{Project::STATUS_ACTIVE}",
                                :order => 'name')
  @source_project = Project.find(params[:id])
  if request.get?
    @project = Project.copy_from(@source_project)
    if @project
      @project.identifier = Project.next_identifier if Setting.sequential_project_identifiers?
    else
      redirect_to :controller => 'admin', :action => 'projects'
    end  
  else
    Mailer.with_deliveries(params[:notifications] == '1') do
      @project = Project.new(params[:project])
      @project.enabled_module_names = params[:enabled_modules]
      if validate_parent_id && @project.copy(@source_project, :only => params[:only])
        @project.set_allowed_parent!(params[:project]['parent_id']) if params[:project].has_key?('parent_id')
        flash[:notice] = l(:notice_successful_create)
        redirect_to :controller => 'admin', :action => 'projects'
      elsif !@project.new_record?
        # Project was created
        # But some objects were not copied due to validation failures
        # (eg. issues from disabled trackers)
        # TODO: inform about that
        redirect_to :controller => 'admin', :action => 'projects'
      end
    end
  end
rescue ActiveRecord::RecordNotFound
  redirect_to :controller => 'admin', :action => 'projects'
end

- (Object) destroy

Delete @project



228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
# File 'app/controllers/projects_controller.rb', line 228

def destroy
  @project_to_destroy = @project
  if request.get?
    # display confirmation view
  else
    if params[:format] == 'xml' || params[:confirm]
      @project_to_destroy.destroy
      respond_to do |format|
        format.html { redirect_to :controller => 'admin', :action => 'projects' }
        format.xml  { head :ok }
      end
    end
  end
  # hide project in layout
  @project = nil
end

- (Object) edit

Edit @project



182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
# File 'app/controllers/projects_controller.rb', line 182

def edit
  if request.get?
  else
    @project.attributes = params[:project]
    if validate_parent_id && @project.save
      @project.set_allowed_parent!(params[:project]['parent_id']) if params[:project].has_key?('parent_id')
      respond_to do |format|
        format.html { 
          flash[:notice] = l(:notice_successful_update)
          redirect_to :action => 'settings', :id => @project
        }
        format.xml  { head :ok }
      end
    else
      respond_to do |format|
        format.html { 
          settings
          render :action => 'settings'
        }
        format.xml  { render :xml => @project.errors, :status => :unprocessable_entity }
      end
    end
  end
end

- (Object) index

Lists visible projects



51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
# File 'app/controllers/projects_controller.rb', line 51

def index
  respond_to do |format|
    format.html { 
      @projects = Project.visible.find(:all, :order => 'lft') 
    }
    format.xml  {
      @projects = Project.visible.find(:all, :order => 'lft')
    }
    format.atom {
      projects = Project.visible.find(:all, :order => 'created_on DESC',
                                            :limit => Setting.feeds_limit.to_i)
      render_feed(projects, :title => "#{Setting.app_title}: #{l(:label_project_latest)}")
    }
  end
end

- (Object) list_files



281
282
283
284
285
286
287
288
289
290
291
# File 'app/controllers/projects_controller.rb', line 281

def list_files
  sort_init 'filename', 'asc'
  sort_update 'filename' => "#{Attachment.table_name}.filename",
              'created_on' => "#{Attachment.table_name}.created_on",
              'size' => "#{Attachment.table_name}.filesize",
              'downloads' => "#{Attachment.table_name}.downloads"
              
  @containers = [ Project.find(@project.id, :include => :attachments, :order => sort_clause)]
  @containers += @project.versions.find(:all, :include => :attachments, :order => sort_clause).sort.reverse
  render :layout => !request.xhr?
end

- (Object) modules



207
208
209
210
211
# File 'app/controllers/projects_controller.rb', line 207

def modules
  @project.enabled_module_names = params[:enabled_modules]
  flash[:notice] = l(:notice_successful_update)
  redirect_to :action => 'settings', :id => @project, :tab => 'modules'
end

- (Object) reset_activities



273
274
275
276
277
278
279
# File 'app/controllers/projects_controller.rb', line 273

def reset_activities
  @project.time_entry_activities.each do |time_entry_activity|
    time_entry_activity.destroy(time_entry_activity.parent)
  end
  flash[:notice] = l(:notice_successful_update)
  redirect_to :controller => 'projects', :action => 'settings', :tab => 'activities', :id => @project
end

- (Object) roadmap



293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
# File 'app/controllers/projects_controller.rb', line 293

def roadmap
  @trackers = @project.trackers.find(:all, :order => 'position')
  retrieve_selected_tracker_ids(@trackers, @trackers.select {|t| t.is_in_roadmap?})
  @with_subprojects = params[:with_subprojects].nil? ? Setting.display_subprojects_issues? : (params[:with_subprojects] == '1')
  project_ids = @with_subprojects ? @project.self_and_descendants.collect(&:id) : [@project.id]
  
  @versions = @project.shared_versions.sort
  @versions.reject! {|version| version.closed? || version.completed? } unless params[:completed]
  
  @issues_by_version = {}
  unless @selected_tracker_ids.empty?
    @versions.each do |version|
      issues = version.fixed_issues.visible.find(:all,
                                                 :include => [:project, :status, :tracker, :priority],
                                                 :conditions => {:tracker_id => @selected_tracker_ids, :project_id => project_ids},
                                                 :order => "#{Project.table_name}.lft, #{Tracker.table_name}.position, #{Issue.table_name}.id")
      @issues_by_version[version] = issues
    end
  end
  @versions.reject! {|version| !project_ids.include?(version.project_id) && @issues_by_version[version].blank?}
end

- (Object) save_activities



260
261
262
263
264
265
266
267
268
269
270
271
# File 'app/controllers/projects_controller.rb', line 260

def save_activities
  if request.post? && params[:enumerations]
    Project.transaction do
      params[:enumerations].each do |id, activity|
        @project.update_or_create_time_entry_activity(id, activity)
      end
    end
    flash[:notice] = l(:notice_successful_update)
  end
  
  redirect_to :controller => 'projects', :action => 'settings', :tab => 'activities', :id => @project
end

- (Object) settings



172
173
174
175
176
177
178
179
# File 'app/controllers/projects_controller.rb', line 172

def settings
  @issue_custom_fields = IssueCustomField.find(:all, :order => "#{CustomField.table_name}.position")
  @issue_category ||= IssueCategory.new
  @member ||= @project.members.new
  @trackers = Tracker.all
  @repository ||= @project.repository
  @wiki ||= @project.wiki
end

- (Object) show

Show @project



139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
# File 'app/controllers/projects_controller.rb', line 139

def show
  if params[:jump]
    # try to redirect to the requested menu item
    redirect_to_project_menu_item(@project, params[:jump]) && return
  end
  
  @users_by_role = @project.users_by_role
  @subprojects = @project.children.visible
  @news = @project.news.find(:all, :limit => 5, :include => [ :author, :project ], :order => "#{News.table_name}.created_on DESC")
  @trackers = @project.rolled_up_trackers
  
  cond = @project.project_condition(Setting.display_subprojects_issues?)
  
  @open_issues_by_tracker = Issue.visible.count(:group => :tracker,
                                          :include => [:project, :status, :tracker],
                                          :conditions => ["(#{cond}) AND #{IssueStatus.table_name}.is_closed=?", false])
  @total_issues_by_tracker = Issue.visible.count(:group => :tracker,
                                          :include => [:project, :status, :tracker],
                                          :conditions => cond)
  
  TimeEntry.visible_by(User.current) do
    @total_hours = TimeEntry.sum(:hours, 
                                 :include => :project,
                                 :conditions => cond).to_f
  end
  @key = User.current.rss_key
  
  respond_to do |format|
    format.html
    format.xml
  end
end

- (Object) unarchive



222
223
224
225
# File 'app/controllers/projects_controller.rb', line 222

def unarchive
  @project.unarchive if request.post? && !@project.active?
  redirect_to(url_for(:controller => 'admin', :action => 'projects', :status => params[:status]))
end