Class: Redmine::MenuManager::MenuItem

Inherits:
MenuNode
  • Object
show all
Includes:
I18n
Defined in:
lib/redmine/menu_manager.rb

Instance Attribute Summary collapse

Attributes inherited from MenuNode

#last_items_count

Instance Method Summary collapse

Methods included from I18n

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

Methods inherited from MenuNode

#add, #add_at, #add_last, #children, #each, #position, #prepend, #remove!, #root, #size

Constructor Details

#initialize(name, url, options = {}) ⇒ MenuItem

Returns a new instance of MenuItem.

Raises:

  • (ArgumentError)

385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
# File 'lib/redmine/menu_manager.rb', line 385

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]
  @permission = options[:permission]
  @permission ||= false if options.key?(:permission)
  @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

Instance Attribute Details

#child_menusObject (readonly)

Returns the value of attribute child_menus


383
384
385
# File 'lib/redmine/menu_manager.rb', line 383

def child_menus
  @child_menus
end

#conditionObject (readonly)

Returns the value of attribute condition


383
384
385
# File 'lib/redmine/menu_manager.rb', line 383

def condition
  @condition
end

#lastObject (readonly)

Returns the value of attribute last


383
384
385
# File 'lib/redmine/menu_manager.rb', line 383

def last
  @last
end

#nameObject (readonly)

Returns the value of attribute name


383
384
385
# File 'lib/redmine/menu_manager.rb', line 383

def name
  @name
end

#paramObject (readonly)

Returns the value of attribute param


383
384
385
# File 'lib/redmine/menu_manager.rb', line 383

def param
  @param
end

#parentObject (readonly)

Returns the value of attribute parent


383
384
385
# File 'lib/redmine/menu_manager.rb', line 383

def parent
  @parent
end

#permissionObject (readonly)

Returns the value of attribute permission


383
384
385
# File 'lib/redmine/menu_manager.rb', line 383

def permission
  @permission
end

#urlObject (readonly)

Returns the value of attribute url


383
384
385
# File 'lib/redmine/menu_manager.rb', line 383

def url
  @url
end

Instance Method Details

#allowed?(user, project) ⇒ Boolean

Checks if a user is allowed to access the menu item by:

  • Checking the permission or the url target (project only)

  • Checking the conditions of the item


434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
# File 'lib/redmine/menu_manager.rb', line 434

def allowed?(user, project)
  if user && project
    if permission
      unless user.allowed_to?(permission, project)
        return false
      end
    elsif permission.nil? && url.is_a?(Hash)
      unless user.allowed_to?(url, project)
        return false
      end
    end
  end
  if condition && !condition.call(project)
    # Condition that doesn't pass
    return false
  end
  return true
end

#caption(project = nil) ⇒ Object


406
407
408
409
410
411
412
413
414
415
416
417
418
# File 'lib/redmine/menu_manager.rb', line 406

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

#html_options(options = {}) ⇒ Object


420
421
422
423
424
425
426
427
428
# File 'lib/redmine/menu_manager.rb', line 420

def html_options(options={})
  if options[:selected]
    o = @html_options.dup
    o[:class] += ' selected'
    o
  else
    @html_options
  end
end