summaryrefslogtreecommitdiffstats
path: root/lib/redmine/menu_manager.rb
blob: c801cb3838169f12c80f7c1b6b34855783804a5e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
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
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
# redMine - project management software
# Copyright (C) 2006-2007  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.

module Redmine
  module MenuManager
    module MenuController
      def self.included(base)
        base.extend(ClassMethods)
      end

      module ClassMethods
        @@menu_items = Hash.new {|hash, key| hash[key] = {:default => key, :actions => {}}}
        mattr_accessor :menu_items
        
        # Set the menu item name for a controller or specific actions
        # Examples:
        #   * menu_item :tickets # => sets the menu name to :tickets for the whole controller
        #   * menu_item :tickets, :only => :list # => sets the menu name to :tickets for the 'list' action only
        #   * menu_item :tickets, :only => [:list, :show] # => sets the menu name to :tickets for 2 actions only
        #   
        # The default menu item name for a controller is controller_name by default
        # Eg. the default menu item name for ProjectsController is :projects
        def menu_item(id, options = {})
          if actions = options[:only]
            actions = [] << actions unless actions.is_a?(Array)
            actions.each {|a| menu_items[controller_name.to_sym][:actions][a.to_sym] = id}
          else
            menu_items[controller_name.to_sym][:default] = id
          end
        end
      end
      
      def menu_items
        self.class.menu_items
      end
      
      # Returns the menu item name according to the current action
      def current_menu_item
        menu_items[controller_name.to_sym][:actions][action_name.to_sym] ||
          menu_items[controller_name.to_sym][:default]
      end
    end
    
    module MenuHelper
      # Returns the current menu item name
      def current_menu_item
        @controller.current_menu_item
      end
      
      # Renders the application main menu as a ul element
      def render_main_menu(project)
        links = []
        Redmine::MenuManager.allowed_items(:project_menu, User.current, project).each do |item|
          unless item.condition && !item.condition.call(project)
            links << content_tag('li', 
                       link_to(l(item.caption), {item.param => project}.merge(item.url),
                               :class => (current_menu_item == item.name ? 'selected' : nil)))
          end
        end if project && !project.new_record?
        links.empty? ? nil : content_tag('ul', links.join("\n"))
      end
    end
    
    class << self
      def map(menu_name)
        mapper = Mapper.new
        yield mapper
        @items ||= {}
        @items[menu_name.to_sym] ||= []
        @items[menu_name.to_sym] += mapper.items
      end
      
      def items(menu_name)
        @items[menu_name.to_sym] || []
      end
      
      def allowed_items(menu_name, user, project)
        items(menu_name).select {|item| user && user.allowed_to?(item.url, project)}
      end
    end
    
    class Mapper
      def push(name, url, options={})
        @items ||= []
        @items << MenuItem.new(name, url, options)
      end
      
      def items
        @items
      end
    end
    
    class MenuItem
      attr_reader :name, :url, :param, :condition, :caption
      
      def initialize(name, url, options)
        @name = name
        @url = url
        @condition = options[:if]
        @param = options[:param] || :id
        @caption = options[:caption] || name.to_s.humanize
      end
    end    
  end
end