openproject/config/routes.rb

#-- encoding: UTF-8
#-- copyright
# ChiliProject is a project management system.
#
# Copyright (C) 2010-2011 the ChiliProject Team
#
# 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.
#
# See doc/COPYRIGHT.rdoc for more details.
#++
OpenProject::Application.routes.draw do
  root :to => 'welcome#index', :as => 'home'

  match '/login'  => 'account#login',  :as => 'signin'
  match '/logout' => 'account#logout', :as => 'signout'

  match '/roles/workflow/:id/:role_id/:tracker_id' => 'roles#workflow'
  match '/help/:ctrl/:page' => 'help#index'

  # only providing routes for journals when there are multiple subclasses of journals
  # all subclasses will look for the journals routes
  resources :journals, :only => [:edit, :update]

  # REVIEW: review those wiki routes
  resource :wiki_menu_item, :path_prefix => "projects/:project_id/wiki/:id", :only => [:edit, :update]
  get   'projects/:project_id/wiki/new' => 'wiki#new', :as => 'wiki_new'
  post  'projects/:project_id/wiki/new' => 'wiki#create', :as => 'wiki_create'
  post  'projects/:project_id/wiki/preview' => 'wiki#preview', :as => 'wiki_preview'
  get   'projects/:project_id/wiki/:id/new' => 'wiki#new_child', :as => 'wiki_new_child'
  get   'projects/:project_id/wiki/:id/toc' => 'wiki#index', :as => 'wiki_page_toc'
  post  'projects/:id/wiki' => 'wikis#edit'
  match 'projects/:id/wiki/destroy' => 'wikis#destroy'

  # generic route for adding/removing watchers
  # looks to be ressourceful
  scope ':object_type/:object_id', :constraints => { :object_type => /issues|messages|boards|wikis|wiki_pages|news/,
                                                     :object_id => /\d+/ } do
    resources :watchers, :only => [:new]

    match '/watch' => 'watchers#watch', :via => :post
    match '/unwatch' => 'watchers#unwatch', :via => :delete
  end

  resources :watchers, :only => [:destroy]

  # TODO: remove
  scope "issues" do
    match 'changes' => 'journals#index', :as => 'changes'
  end

  resources :projects, :except => [:edit] do
    member do
      # this route let's you access the project specific settings (by tab)
      #
      #   settings_project_path(@project)
      #     => "/projects/1/settings"
      #
      #   settings_project_path(@project, :tab => 'members')
      #     => "/projects/1/settings/members"
      #
      get 'settings(/:tab)', :action => 'settings', :as => :settings

      get :copy
      post :copy
      put :modules
      put :archive
      put :unarchive

      # Destroy uses a get request to prompt the user before the actual DELETE request
      get :destroy_info, :as => 'confirm_destroy'

    end

    collection do
      get :level_list
    end

    resource :enumerations, :controller => 'project_enumerations', :only => [:update, :destroy]

    resources :documents, :shallow => true

    resources :files, :only => [:index, :new, :create]

    resources :versions, :only => [:new, :create] do
      collection do
        put :close_completed
      end
    end

    # this is only another name for versions#index
    # For nice "road in the url for the index action
    # this could probably be rewritten with a resource :as => 'roadmap'
    match '/roadmap' => 'versions#index', :via => :get

    resources :news, :only => [:index, :new, :create] do
      collection do
        resource :preview, :controller => "news/previews", :only => [:create], :as => "news_preview"
      end
    end

    namespace :time_entries do
      resource :report, :controller => 'reports', :only => [:show]
    end
    resources :time_entries, :controller => 'timelog'

    resources :wiki, :except => [:index, :new, :create] do
      collection do
        get :export
        get :date_index
        get '/index' => 'wiki#index'
      end

      member do
        get '/diff/:version/vs/:version_from' => 'wiki#diff', :as => 'wiki_diff'
        get '/diff(/:version)' => 'wiki#diff', :as => 'wiki_diff'
        get '/annotate/:version' => 'wiki#annotate', :as => 'wiki_annotate'
        match :rename, :via => [:get, :post]
        get :history
        post :preview
        post :protect
        post :add_attachment
        get  :list_attachments
      end
    end
    # as routes for index and show are swapped
    # it is necessary to define the show action later
    # than any other route as it otherwise would
    # work as a catchall for everything under /wiki
    get 'wiki' => "wiki#show"

    namespace :issues do
      resources :gantt, :controller => 'gantts', :only => [:index]
      resources :calendar, :controller => 'calendars', :only => [:index]
    end

    resources :issues, :except => [:show, :edit, :update, :destroy] do
      # should probably belong to :member, but requires :copy_from instead
      # of the default :id
      get ':copy_from/copy', :action => "new", :on => :collection, :as => "copy"

      collection do
        get :all

        match '/report/:detail' => 'issues/reports#report_details', :via => :get
        match '/report' => 'issues/reports#report', :via => :get

        # get a preview of a new issue (i.e. one without an ID)
        match '/new/preview' => 'issues/previews#create', :as => 'preview_new', :via => :post
      end
    end

    resources :activity, :activities, :only => :index, :controller => 'activities'

    resources :boards

    resources :issue_categories, :except => [:index, :show], :shallow => true

    resources :members, :only => [:create, :update, :destroy], :shallow => true do
      get :autocomplete, :on => :collection
    end
  end

  #TODO: evaluate whether this can be turned into a namespace
  scope "admin" do
    match "/projects" => 'admin#projects', :via => :get

    resources :enumerations

    resources :groups do
      member do
        get :autocomplete_for_user
        #this should be put into it's own resource
        match "/members" => 'groups#add_users', :via => :post, :as => 'members_of'
        match "/members/:user_id" => 'groups#remove_user', :via => :delete, :as => 'member_of'
        #this should be put into it's own resource
        match "/memberships/:membership_id" => 'groups#edit_membership', :via => :put, :as => 'membership_of'
        match "/memberships/:membership_id" => 'groups#destroy_membership', :via => :delete, :as => 'membership_of'
        match "/memberships" => 'groups#create_memberships', :via => :post, :as => 'memberships_of'
      end
    end

    resources :roles, :only => [:index, :new, :create, :edit, :update, :destroy] do
      collection do
        put '/' => 'roles#bulk_update'
        get :report
      end
    end

    resources :auth_sources, :ldap_auth_sources do
      member do
        get :test_connection
      end
    end
  end

  # this is to support global actions on issues and
  # for backwards compatibility
  namespace :issues do
    resources :gantt, :controller => 'gantts', :only => [:index]
    resources :calendar, :controller => 'calendars', :only => [:index]

    # have a global autocompleter for issues
    # TODO: make this ressourceful
    match 'auto_complete' => 'auto_completes#issues', :via => [:get, :post], :format => false

    # TODO: separate routes and action for get and post
    match 'context_menu' => 'context_menus#issues', :via => [:get, :post], :format => false

    resource :move, :controller => 'moves', :only => [:new, :create]
  end

  # TODO: remove create as issues should be created scoped under project
  resources :issues, :except => [:new] do
    namespace :time_entries do
      resource :report, :controller => 'reports', :only => [:show]
    end

    resources :time_entries, :controller => 'timelog'

    resources :relations, :controller => 'issue_relations', :only => [:create, :destroy]

    member do
      match '/preview' => 'issues/previews#create', :via => :post
      # this route is defined so that it has precedence of the one defined on the collection
      delete :destroy
    end

    collection do
      get :bulk_edit, :format => false
      put :bulk_update, :format => false

      delete :destroy
    end
  end

  resources :versions, :only => [:show, :edit, :update, :destroy] do
    member do
      get :status_by
    end
  end

  # Misc issue routes. TODO: move into resources
  match '/issues/:id/quoted' => 'journals#new', :id => /\d+/, :via => :post, :as => 'quoted_issue'
  match '/issues/:id/destroy' => 'issues#destroy', :via => :post # legacy

  # Misc journal routes. TODO: move into resources
  match '/journals/:id/diff/:field' => 'journals#diff', :via => :get, :as => 'journal_diff'


  namespace :time_entries do
    resource :report, :controller => 'reports',
      :only => [:show]
  end

  resources :time_entries, :controller => 'timelog'

  resources :activity, :activities, :only => :index, :controller => 'activities'

  resources :users do
    member do
      match '/edit/:tab' => 'users#edit', :via => :get
      match '/memberships/:membership_id/destroy' => 'users#destroy_membership', :via => :post
      match '/memberships/:membership_id' => 'users#edit_membership', :via => :post
      match '/memberships' => 'users#edit_membership', :via => :post
      post :edit_membership
      post :destroy_membership
      get :deletion_info
    end
  end

  resources :boards, :only => [] do
    resources :topics, :controller => 'messages', :except => [:index], :shallow => true do
      collection do
        post :preview
      end

      member do
        get :quote
        post :reply, :as => 'reply_to'
        post :preview
      end
    end
  end

  resources :news, :only => [:index, :destroy, :update, :edit, :show] do
    resources :comments, :controller => 'news/comments', :only => [:create, :destroy], :shallow => true

    resource :preview, :controller => 'news/previews', :only => [:create]
  end

  scope :controller => 'repositories' do
    scope :via => :get do
      match '/projects/:id/repository', :action => :show
      match '/projects/:id/repository/edit', :action => :edit
      match '/projects/:id/repository/statistics', :action => :stats
      match '/projects/:id/repository/revisions', :action => :revisions
      match '/projects/:id/repository/revisions.:format', :action => :revisions
      match '/projects/:id/repository/revisions/:rev', :action => :revision
      match '/projects/:id/repository/revisions/:rev/diff/*path(.:format)', :action => :diff
      match '/projects/:id/repository/revisions/:rev/raw/*path', :action => :entry, :format => 'raw', :rev => /[a-z0-9\.\-_]+/
      match '/projects/:id/repository/revisions/:rev/:action/*path', :rev => /[a-z0-9\.\-_]+/
      match '/projects/:id/repository/raw/*path', :action => :entry, :format => 'raw'
      # TODO: why the following route is required?
      match '/projects/:id/repository/entry/*path', :action => :entry
      match '/projects/:id/repository/:action/*path'
    end

    match '/projects/:id/repository/:action', :via => :post
  end


  resources :attachments, :only => [:show, :destroy], :format => false do
    member do
      scope :via => :get,  :constraints => { :id => /\d+/, :filename => /[^\/]*/ } do
        match 'download(/:filename)' => 'attachments#download', :as => 'download'
        match ':filename' => 'attachments#show'
      end
    end
  end
  # redirect for backwards compatibility
  scope :constraints => { :id => /\d+/, :filename => /[^\/]*/ } do
    match "/attachments/download/:id/:filename" => redirect("/attachments/%{id}/download/%{filename}"), :format => false
    match "/attachments/download/:id" => redirect("/attachments/%{id}/download"), :format => false
  end

  #left old routes at the bottom for backwards compat
  scope :controller => 'repositories' do
    match '/repositories/browse/:id/*path', :action => 'browse', :as => 'repositories_show'
    match '/repositories/changes/:id/*path', :action => 'changes', :as => 'repositories_changes'
    match '/repositories/diff/:id/*path', :action => 'diff', :as => 'repositories_diff'
    match '/repositories/entry/:id/*path', :action => 'entry', :as => 'repositories_entry'
    match '/repositories/annotate/:id/*path', :action => 'annotate', :as => 'repositories_entry'
    match '/repositories/revision/:id/:rev', :action => 'revision'
  end

  scope :controller => 'sys' do
    match '/sys/projects.:format', :action => 'projects', :via => :get
    match '/sys/projects/:id/repository.:format', :action => 'create_project_repository', :via => :post
  end

  # alternate routes for the current user
  scope "my" do
    match '/deletion_info' => 'users#deletion_info', :via => :get, :as => 'delete_my_account_info'
  end

  # Install the default route as the lowest priority.
  match '/:controller(/:action(/:id))'
  match '/robots' => 'welcome#robots', :defaults => { :format => :txt }
  # Used for OpenID
  root :to => 'account#login'
end