Module: RailsAdmin::ApplicationHelper

Includes:
Support::I18n
Included in:
FormBuilder, MainController
Defined in:
app/helpers/rails_admin/application_helper.rb

Instance Method Summary collapse

Methods included from Support::I18n

#abbr_day_names, #abbr_month_names, #date_format, #day_names, #month_names

Instance Method Details

#action(key, abstract_model = nil, object = nil) ⇒ Object 



26
27
28
 
# File 'app/helpers/rails_admin/application_helper.rb', line 26

def action(key, abstract_model = nil, object = nil)
  RailsAdmin::Config::Actions.find(key, controller: controller, abstract_model: abstract_model, object: object)
end

#actions(scope = :all, abstract_model = nil, object = nil) ⇒ Object 



30
31
32
 
# File 'app/helpers/rails_admin/application_helper.rb', line 30

def actions(scope = :all, abstract_model = nil, object = nil)
  RailsAdmin::Config::Actions.all(scope, controller: controller, abstract_model: abstract_model, object: object)
end

#authorized?(action_name, abstract_model = nil, object = nil) ⇒ Boolean

Returns:

  • (Boolean) 


15
16
17
18
 
# File 'app/helpers/rails_admin/application_helper.rb', line 15

def authorized?(action_name, abstract_model = nil, object = nil)
  object = nil if object.try :new_record?
  action(action_name, abstract_model, object).try(:authorized?)
end

#breadcrumb(action = @action, _acc = []) ⇒ Object 



125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
 
# File 'app/helpers/rails_admin/application_helper.rb', line 125

def breadcrumb(action = @action, _acc = [])
  begin
    (parent_actions ||= []) << action
  end while action.breadcrumb_parent && (action = action(*action.breadcrumb_parent)) # rubocop:disable Lint/Loop

  content_tag(:ol, class: 'breadcrumb') do
    parent_actions.collect do |a|
      am = a.send(:eval, 'bindings[:abstract_model]')
      o = a.send(:eval, 'bindings[:object]')
      content_tag(:li, class: current_action?(a, am, o) && 'active') do
        crumb = begin
          if !current_action?(a, am, o)
            if a.http_methods.include?(:get)
              link_to rails_admin.url_for(action: a.action_name, controller: 'rails_admin/main', model_name: am.try(:to_param), id: (o.try(:persisted?) && o.try(:id) || nil)), class: 'pjax' do
                wording_for(:breadcrumb, a, am, o)
              end
            else
              content_tag(:span, wording_for(:breadcrumb, a, am, o))
            end
          else
            wording_for(:breadcrumb, a, am, o)
          end
        end
        crumb
      end
    end.reverse.join.html_safe
  end
end

#bulk_menu(abstract_model = @abstract_model) ⇒ Object 



170
171
172
173
174
175
176
177
178
179
180
181
182
183
 
# File 'app/helpers/rails_admin/application_helper.rb', line 170

def bulk_menu(abstract_model = @abstract_model)
  actions = actions(:bulkable, abstract_model)
  return '' if actions.empty?
  content_tag :li, class: 'dropdown', style: 'float:right' do
    content_tag(:a, class: 'dropdown-toggle', data: {toggle: 'dropdown'}, href: '#') { t('admin.misc.bulk_menu_title').html_safe + ' ' + '<b class="caret"></b>'.html_safe } +
      content_tag(:ul, class: 'dropdown-menu', style: 'left:auto; right:0;') do
        actions.collect do |action|
          content_tag :li do
            link_to wording_for(:bulk_link, action, abstract_model), '#', class: 'bulk-link', data: {action: action.action_name}
          end
        end.join.html_safe
      end
  end.html_safe
end

#capitalize_first_letter(wording) ⇒ Object 



7
8
9
10
11
12
13
 
# File 'app/helpers/rails_admin/application_helper.rb', line 7

def capitalize_first_letter(wording)
  return nil unless wording.present? && wording.is_a?(String)

  wording = wording.dup
  wording[0] = wording[0].mb_chars.capitalize.to_s
  wording
end

#current_action?(action, abstract_model = @abstract_model, object = @object) ⇒ Boolean

Returns:

  • (Boolean) 


20
21
22
23
24
 
# File 'app/helpers/rails_admin/application_helper.rb', line 20

def current_action?(action, abstract_model = @abstract_model, object = @object)
  @action.custom_key == action.custom_key &&
    abstract_model.try(:to_param) == @abstract_model.try(:to_param) &&
    (@object.try(:persisted?) ? @object.id == object.try(:id) : !object.try(:persisted?))
end

#edit_user_link ⇒ Object 



34
35
36
37
38
39
40
41
42
43
44
 
# File 'app/helpers/rails_admin/application_helper.rb', line 34

def edit_user_link
  return nil unless _current_user.respond_to?(:email)
  return nil unless abstract_model = RailsAdmin.config(_current_user.class).abstract_model
  return nil unless (edit_action = RailsAdmin::Config::Actions.find(:edit, controller: controller, abstract_model: abstract_model, object: _current_user)).try(:authorized?)
  link_to rails_admin.url_for(action: edit_action.action_name, model_name: abstract_model.to_param, id: _current_user.id, controller: 'rails_admin/main') do
    html = []
    html << image_tag("#{(request.ssl? ? 'https://secure' : 'http://www')}.gravatar.com/avatar/#{Digest::MD5.hexdigest _current_user.email}?s=30", alt: '') if RailsAdmin::Config.show_gravatar && _current_user.email.present?
    html << content_tag(:span, _current_user.email)
    html.join.html_safe
  end
end

#flash_alert_class(flash_key) ⇒ Object 



185
186
187
188
189
190
191
192
 
# File 'app/helpers/rails_admin/application_helper.rb', line 185

def flash_alert_class(flash_key)
  case flash_key.to_s
  when 'error'  then 'alert-danger'
  when 'alert'  then 'alert-warning'
  when 'notice' then 'alert-info'
  else "alert-#{flash_key}"
  end
end

#logout_method ⇒ Object 



55
56
57
58
 
# File 'app/helpers/rails_admin/application_helper.rb', line 55

def logout_method
  return [Devise.sign_out_via].flatten.first if defined?(Devise)
  :delete
end

#logout_path ⇒ Object 



46
47
48
49
50
51
52
53
 
# File 'app/helpers/rails_admin/application_helper.rb', line 46

def logout_path
  if defined?(Devise)
    scope = Devise::Mapping.find_scope!(_current_user)
    main_app.send("destroy_#{scope}_session_path") rescue false
  elsif main_app.respond_to?(:logout_path)
    main_app.logout_path
  end
end

#main_navigation ⇒ Object 



73
74
75
76
77
78
79
80
81
82
83
84
85
 
# File 'app/helpers/rails_admin/application_helper.rb', line 73

def main_navigation
  nodes_stack = RailsAdmin::Config.visible_models(controller: controller)
  node_model_names = nodes_stack.collect { |c| c.abstract_model.model_name }

  nodes_stack.group_by(&:navigation_label).collect do |navigation_label, nodes|
    nodes = nodes.select { |n| n.parent.nil? || !n.parent.to_s.in?(node_model_names) }
    li_stack = navigation nodes_stack, nodes

    label = navigation_label || t('admin.misc.navigation')

    %(<li class='dropdown-header'>#{capitalize_first_letter label}</li>#{li_stack}) if li_stack.present?
  end.join.html_safe
end

#menu_for(parent, abstract_model = nil, object = nil, only_icon = false) ⇒ Object

parent => :root, :collection, :member



155
156
157
158
159
160
161
162
163
164
165
166
167
168
 
# File 'app/helpers/rails_admin/application_helper.rb', line 155

def menu_for(parent, abstract_model = nil, object = nil, only_icon = false) # perf matters here (no action view trickery)
  actions = actions(parent, abstract_model, object).select { |a| a.http_methods.include?(:get) && a.show_in_menu }
  actions.collect do |action|
    wording = wording_for(:menu, action)
    %(
      <li title="#{wording if only_icon}" rel="#{'tooltip' if only_icon}" class="icon #{action.key}_#{parent}_link #{'active' if current_action?(action)}">
        <a class="#{action.pjax? ? 'pjax' : ''}" href="#{rails_admin.url_for(action: action.action_name, controller: 'rails_admin/main', model_name: abstract_model.try(:to_param), id: (object.try(:persisted?) && object.try(:id) || nil))}">
          <i class="#{action.link_icon}"></i>
          <span#{only_icon ? " style='display:none'" : ''}>#{wording}</span>
        </a>
      </li>
    )
  end.join.html_safe
end

#navigation(nodes_stack, nodes, level = 0) ⇒ Object 



112
113
114
115
116
117
118
119
120
121
122
123
 
# File 'app/helpers/rails_admin/application_helper.rb', line 112

def navigation(nodes_stack, nodes, level = 0)
  nodes.collect do |node|
    model_param = node.abstract_model.to_param
    url         = rails_admin.url_for(action: :index, controller: 'rails_admin/main', model_name: model_param)
    level_class = " nav-level-#{level}" if level > 0
    nav_icon = node.navigation_icon ? %(<i class="#{node.navigation_icon}"></i>).html_safe : ''
    li = content_tag :li, data: {model: model_param} do
      link_to nav_icon + capitalize_first_letter(node.label_plural), url, class: "pjax#{level_class}"
    end
    li + navigation(nodes_stack, nodes_stack.select { |n| n.parent.to_s == node.abstract_model.model_name }, level + 1)
  end.join.html_safe
end

#root_navigation ⇒ Object 



87
88
89
90
91
92
93
94
95
96
97
98
99
100
 
# File 'app/helpers/rails_admin/application_helper.rb', line 87

def root_navigation
  actions(:root).select(&:show_in_sidebar).group_by(&:sidebar_label).collect do |label, nodes|
    li_stack = nodes.map do |node|
      url = rails_admin.url_for(action: node.action_name, controller: "rails_admin/main")
      nav_icon = node.link_icon ? %(<i class="#{node.link_icon}"></i>).html_safe : ''
      content_tag :li do
        link_to nav_icon + " " + wording_for(:menu, node), url, class: "pjax"
      end
    end.join.html_safe
    label ||= t('admin.misc.root_navigation')

    %(<li class='dropdown-header'>#{capitalize_first_letter label}</li>#{li_stack}) if li_stack.present?
  end.join.html_safe
end

#static_navigation ⇒ Object 



102
103
104
105
106
107
108
109
110
 
# File 'app/helpers/rails_admin/application_helper.rb', line 102

def static_navigation
  li_stack = RailsAdmin::Config.navigation_static_links.collect do |title, url|
    content_tag(:li, link_to(title.to_s, url, target: '_blank', rel: 'noopener noreferrer'))
  end.join

  label = RailsAdmin::Config.navigation_static_label || t('admin.misc.navigation_static_label')
  li_stack = %(<li class='dropdown-header'>#{label}</li>#{li_stack}).html_safe if li_stack.present?
  li_stack
end

#wording_for(label, action = @action, abstract_model = @abstract_model, object = @object) ⇒ Object 



60
61
62
63
64
65
66
67
68
69
70
71
 
# File 'app/helpers/rails_admin/application_helper.rb', line 60

def wording_for(label, action = @action, abstract_model = @abstract_model, object = @object)
  model_config = abstract_model.try(:config)
  object = abstract_model && object.is_a?(abstract_model.model) ? object : nil
  action = RailsAdmin::Config::Actions.find(action.to_sym) if action.is_a?(Symbol) || action.is_a?(String)

  capitalize_first_letter I18n.t(
    "admin.actions.#{action.i18n_key}.#{label}",
    model_label: model_config && model_config.label,
    model_label_plural: model_config && model_config.label_plural,
    object_label: model_config && object.try(model_config.object_label_method),
  )
end