2013-08-01 10:33:49 +08:00
# Redmine - project management software
# Copyright (C) 2006-2013 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
class MenuError < StandardError #:nodoc:
end
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
@current_menu_item || = menu_items [ controller_name . to_sym ] [ :actions ] [ action_name . to_sym ] ||
menu_items [ controller_name . to_sym ] [ :default ]
end
# Redirects user to the menu item of the given project
# Returns false if user is not authorized
def redirect_to_project_menu_item ( project , name )
item = Redmine :: MenuManager . items ( :project_menu ) . detect { | i | i . name . to_s == name . to_s }
if item && User . current . allowed_to? ( item . url , project ) && ( item . condition . nil? || item . condition . call ( project ) )
redirect_to ( { item . param = > project } . merge ( item . url ) )
return true
end
false
end
end
module MenuHelper
# Returns the current menu item name
def current_menu_item
controller . current_menu_item
end
2013-09-14 09:51:26 +08:00
2013-08-01 10:33:49 +08:00
# Renders the application main menu
def render_main_menu ( project )
2013-08-30 09:34:21 +08:00
render_menu ( ( project && ! project . new_record? ) ? :project_menu : :application_menu , project )
2013-08-01 10:33:49 +08:00
end
def display_main_menu? ( project )
menu_name = project && ! project . new_record? ? :project_menu : :application_menu
Redmine :: MenuManager . items ( menu_name ) . children . present?
end
def render_menu ( menu , project = nil )
links = [ ]
menu_items_for ( menu , project ) do | node |
links << render_menu_node ( node , project )
end
links . empty? ? nil : content_tag ( 'ul' , links . join ( " \n " ) . html_safe )
end
2014-05-23 17:07:58 +08:00
def bootstrap_render_menu ( menu , project = nil )
links = [ ]
menu_items_for ( menu , project ) do | node |
links << render_menu_node ( node , project )
end
s = ''
# s = "<ul class = 'nav navbar-nav navbar-right'> "
s << links . join ( " \n " )
# s << "</ul>"
links . empty? ? nil : s . html_safe
end
2013-08-01 10:33:49 +08:00
def render_menu_node ( node , project = nil )
if node . children . present? || ! node . child_menus . nil?
return render_menu_node_with_children ( node , project )
else
caption , url , selected = extract_node_details ( node , project )
return content_tag ( 'li' ,
render_single_menu_node ( node , caption , url , selected ) )
end
end
def render_menu_node_with_children ( node , project = nil )
caption , url , selected = extract_node_details ( node , project )
html = [ ] . tap do | html |
html << '<li>'
# Parent
html << render_single_menu_node ( node , caption , url , selected )
# Standard children
standard_children_list = " " . html_safe . tap do | child_html |
node . children . each do | child |
child_html << render_menu_node ( child , project )
end
end
html << content_tag ( :ul , standard_children_list , :class = > 'menu-children' ) unless standard_children_list . empty?
# Unattached children
unattached_children_list = render_unattached_children_menu ( node , project )
html << content_tag ( :ul , unattached_children_list , :class = > 'menu-children unattached' ) unless unattached_children_list . blank?
html << '</li>'
end
return html . join ( " \n " ) . html_safe
end
# Returns a list of unattached children menu items
def render_unattached_children_menu ( node , project )
return nil unless node . child_menus
" " . html_safe . tap do | child_html |
unattached_children = node . child_menus . call ( project )
# Tree nodes support #each so we need to do object detection
if unattached_children . is_a? Array
unattached_children . each do | child |
child_html << content_tag ( :li , render_unattached_menu_item ( child , project ) )
end
else
raise MenuError , " :child_menus must be an array of MenuItems "
end
end
end
def render_single_menu_node ( item , caption , url , selected )
link_to ( h ( caption ) , url , item . html_options ( :selected = > selected ) )
end
def render_unattached_menu_item ( menu_item , project )
raise MenuError , " :child_menus must be an array of MenuItems " unless menu_item . is_a? MenuItem
if User . current . allowed_to? ( menu_item . url , project )
link_to ( h ( menu_item . caption ) ,
menu_item . url ,
menu_item . html_options )
end
end
def menu_items_for ( menu , project = nil )
items = [ ]
Redmine :: MenuManager . items ( menu ) . root . children . each do | node |
if allowed_node? ( node , User . current , project )
if block_given?
yield node
else
items << node # TODO: not used?
end
end
end
return block_given? ? nil : items
end
def extract_node_details ( node , project = nil )
item = node
url = case item . url
when Hash
project . nil? ? item . url : { item . param = > project } . merge ( item . url )
when Symbol
send ( item . url )
else
item . url
end
caption = item . caption ( project )
return [ caption , url , ( current_menu_item == item . name ) ]
end
# Checks if a user is allowed to access the menu item by:
#
# * Checking the url target (project only)
# * Checking the conditions of the item
def allowed_node? ( node , user , project )
if project && user && ! user . allowed_to? ( node . url , project )
return false
end
if node . condition && ! node . condition . call ( project )
# Condition that doesn't pass
return false
end
return true
end
end
class << self
def map ( menu_name )
@items || = { }
mapper = Mapper . new ( menu_name . to_sym , @items )
if block_given?
yield mapper
else
mapper
end
end
def items ( menu_name )
@items [ menu_name . to_sym ] || MenuNode . new ( :root , { } )
end
end
class Mapper
def initialize ( menu , items )
items [ menu ] || = MenuNode . new ( :root , { } )
@menu = menu
@menu_items = items [ menu ]
end
# Adds an item at the end of the menu. Available options:
# * param: the parameter name that is used for the project id (default is :id)
# * if: a Proc that is called before rendering the item, the item is displayed only if it returns true
# * caption that can be:
# * a localized string Symbol
# * a String
# * a Proc that can take the project as argument
# * before, after: specify where the menu item should be inserted (eg. :after => :activity)
# * parent: menu item will be added as a child of another named menu (eg. :parent => :issues)
# * children: a Proc that is called before rendering the item. The Proc should return an array of MenuItems, which will be added as children to this item.
# eg. :children => Proc.new {|project| [Redmine::MenuManager::MenuItem.new(...)] }
# * last: menu item will stay at the end (eg. :last => true)
# * html_options: a hash of html options that are passed to link_to
def push ( name , url , options = { } )
options = options . dup
if options [ :parent ]
subtree = self . find ( options [ :parent ] )
if subtree
target_root = subtree
else
target_root = @menu_items . root
end
else
target_root = @menu_items . root
end
# menu item position
if first = options . delete ( :first )
target_root . prepend ( MenuItem . new ( name , url , options ) )
elsif before = options . delete ( :before )
if exists? ( before )
target_root . add_at ( MenuItem . new ( name , url , options ) , position_of ( before ) )
else
target_root . add ( MenuItem . new ( name , url , options ) )
end
elsif after = options . delete ( :after )
if exists? ( after )
target_root . add_at ( MenuItem . new ( name , url , options ) , position_of ( after ) + 1 )
else
target_root . add ( MenuItem . new ( name , url , options ) )
end
elsif options [ :last ] # don't delete, needs to be stored
target_root . add_last ( MenuItem . new ( name , url , options ) )
else
target_root . add ( MenuItem . new ( name , url , options ) )
end
end
# Removes a menu item
def delete ( name )
if found = self . find ( name )
@menu_items . remove! ( found )
end
end
# Checks if a menu item exists
def exists? ( name )
@menu_items . any? { | node | node . name == name }
end
def find ( name )
@menu_items . find { | node | node . name == name }
end
def position_of ( name )
@menu_items . each do | node |
if node . name == name
return node . position
end
end
end
end
class MenuNode
include Enumerable
attr_accessor :parent
attr_reader :last_items_count , :name
def initialize ( name , content = nil )
@name = name
@children = [ ]
@last_items_count = 0
end
def children
if block_given?
@children . each { | child | yield child }
else
@children
end
end
# Returns the number of descendants + 1
def size
@children . inject ( 1 ) { | sum , node | sum + node . size }
end
def each & block
yield self
children { | child | child . each ( & block ) }
end
# Adds a child at first position
def prepend ( child )
add_at ( child , 0 )
end
# Adds a child at given position
def add_at ( child , position )
raise " Child already added " if find { | node | node . name == child . name }
@children = @children . insert ( position , child )
child . parent = self
child
end
# Adds a child as last child
def add_last ( child )
add_at ( child , - 1 )
@last_items_count += 1
child
end
# Adds a child
def add ( child )
position = @children . size - @last_items_count
add_at ( child , position )
end
alias :<< :add
# Removes a child
def remove! ( child )
@children . delete ( child )
@last_items_count -= + 1 if child && child . last
child . parent = nil
child
end
# Returns the position for this node in it's parent
def position
self . parent . children . index ( self )
end
# Returns the root for this node
def root
root = self
root = root . parent while root . parent
root
end
end
class MenuItem < MenuNode
include Redmine :: I18n
attr_reader :name , :url , :param , :condition , :parent , :child_menus , :last
def initialize ( name , url , options )
raise ArgumentError , " Invalid option :if for menu item ' #{ name } ' " if options [ :if ] && ! options [ :if ] . respond_to? ( :call )
raise ArgumentError , " Invalid option :html for menu item ' #{ name } ' " if options [ :html ] && ! options [ :html ] . is_a? ( Hash )
raise ArgumentError , " Cannot set the :parent to be the same as this item " if options [ :parent ] == name . to_sym
raise ArgumentError , " Invalid option :children for menu item ' #{ name } ' " if options [ :children ] && ! options [ :children ] . respond_to? ( :call )
@name = name
@url = url
@condition = options [ :if ]
@param = options [ :param ] || :id
@caption = options [ :caption ]
@html_options = options [ :html ] || { }
# Adds a unique class to each menu item based on its name
@html_options [ :class ] = [ @html_options [ :class ] , @name . to_s . dasherize ] . compact . join ( ' ' )
@parent = options [ :parent ]
@child_menus = options [ :children ]
@last = options [ :last ] || false
super @name . to_sym
end
def caption ( project = nil )
if @caption . is_a? ( Proc )
c = @caption . call ( project ) . to_s
c = @name . to_s . humanize if c . blank?
c
else
if @caption . nil?
l_or_humanize ( name , :prefix = > 'label_' )
else
@caption . is_a? ( Symbol ) ? l ( @caption ) : @caption
end
end
end
def html_options ( options = { } )
if options [ :selected ]
o = @html_options . dup
o [ :class ] += ' selected'
o
else
@html_options
end
end
end
end
end