Module: RailsAdmin::ApplicationHelper

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

Instance Method Summary collapse

Instance Method Details

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



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

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



24
25
26
# File 'app/helpers/rails_admin/application_helper.rb', line 24

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)


5
6
7
8
# File 'app/helpers/rails_admin/application_helper.rb', line 5

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


138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
# File 'app/helpers/rails_admin/application_helper.rb', line 138

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

  (:ol, class: 'breadcrumb') do
    parent_actions.collect do |a|
      am = a.send(:eval, 'bindings[:abstract_model]')
      o = a.send(:eval, 'bindings[:object]')
      (:li, class: ['breadcrumb-item', current_action?(a, am, o) && 'active']) do
        if current_action?(a, am, o)
          wording_for(:breadcrumb, a, am, o)
        elsif 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)) do
            wording_for(:breadcrumb, a, am, o)
          end
        else
          (:span, wording_for(:breadcrumb, a, am, o))
        end
      end
    end.reverse.join.html_safe
  end
end

#bulk_menu(abstract_model = @abstract_model) ⇒ Object



187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
# File 'app/helpers/rails_admin/application_helper.rb', line 187

def bulk_menu(abstract_model = @abstract_model)
  actions = actions(:bulkable, abstract_model)
  return '' if actions.empty?

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

#current_actionObject



10
11
12
# File 'app/helpers/rails_admin/application_helper.rb', line 10

def current_action
  params[:action].in?(%w[create new]) ? 'create' : 'update'
end

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

Returns:

  • (Boolean)


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

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


28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
# File 'app/helpers/rails_admin/application_helper.rb', line 28

def edit_user_link
  return nil unless _current_user.try(:email).present?
  return nil unless (abstract_model = RailsAdmin.config(_current_user.class).abstract_model)

  edit_action = action(:edit, abstract_model, _current_user)
  authorized = edit_action.try(:authorized?)
  content = edit_user_link_label

  if authorized
    edit_url = rails_admin.url_for(
      action: edit_action.action_name,
      model_name: abstract_model.to_param,
      controller: 'rails_admin/main',
      id: _current_user.id,
    )

    link_to content, edit_url, class: 'nav-link'
  else
     :span, content, class: 'nav-link'
  end
end

#flash_alert_class(flash_key) ⇒ Object



203
204
205
206
207
208
209
210
# File 'app/helpers/rails_admin/application_helper.rb', line 203

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

#handle_asset_dependency_errorObject



212
213
214
215
216
217
218
219
220
221
222
# File 'app/helpers/rails_admin/application_helper.rb', line 212

def handle_asset_dependency_error
  yield
rescue LoadError => e
  if /sassc/.match?(e.message)
    e = e.exception <<~MSG
      #{e.message}
      RailsAdmin requires the gem sassc-rails, make sure to put `gem 'sassc-rails'` to Gemfile.
    MSG
  end
  raise e
end

#image_tag(source, options = {}) ⇒ Object



225
226
227
228
229
230
231
# File 'app/helpers/rails_admin/application_helper.rb', line 225

def image_tag(source, options = {})
  if %w[ActiveStorage::Variant ActiveStorage::VariantWithRecord ActiveStorage::Preview].include? source.class.to_s
    super main_app.route_for(ActiveStorage.resolve_model_to_route, source), options
  else
    super
  end
end

#logout_methodObject



63
64
65
66
67
# File 'app/helpers/rails_admin/application_helper.rb', line 63

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

  :delete
end

#logout_pathObject



50
51
52
53
54
55
56
57
58
59
60
61
# File 'app/helpers/rails_admin/application_helper.rb', line 50

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


82
83
84
85
86
87
88
89
90
91
92
93
94
95
# File 'app/helpers/rails_admin/application_helper.rb', line 82

def main_navigation
  nodes_stack = RailsAdmin::Config.visible_models(controller: controller)
  node_model_names = nodes_stack.collect { |c| c.abstract_model.model_name }
  parent_groups = nodes_stack.group_by { |n| n.parent&.to_s }

  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 parent_groups, nodes

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

    collapsible_stack(label, 'main', li_stack)
  end.join.html_safe
end

parent => :root, :collection, :member perf matters here (no action view trickery)



164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
# File 'app/helpers/rails_admin/application_helper.rb', line 164

def menu_for(parent, abstract_model = nil, object = nil, only_icon = false)
  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_class = ['nav-item', 'icon', "#{action.key}_#{parent}_link"].
               concat(action.enabled? ? [] : ['disabled'])
    (:li, {class: li_class}.merge(only_icon ? {title: wording, rel: 'tooltip'} : {})) do
      label = (:i, '', {class: action.link_icon}) + ' ' + (:span, wording, (only_icon ? {style: 'display:none'} : {}))
      if action.enabled? || !only_icon
        href =
          if action.enabled?
            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))
          else
            'javascript:void(0)'
          end
        (:a, label, {href: href, target: action.link_target, class: ['nav-link', current_action?(action) && 'active', !action.enabled? && 'disabled'].compact}.merge(action.turbo? ? {} : {data: {turbo: 'false'}}))
      else
        (:span, label)
      end
    end
  end.join(' ').html_safe
end


121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
# File 'app/helpers/rails_admin/application_helper.rb', line 121

def navigation(parent_groups, nodes, level = 0)
  nodes.collect do |node|
    abstract_model = node.abstract_model
    model_param = abstract_model.to_param
    url         = rails_admin.url_for(action: :index, controller: 'rails_admin/main', model_name: model_param)
    nav_icon = node.navigation_icon ? %(<i class="#{node.navigation_icon}"></i>).html_safe : ''
    css_classes = ['nav-link']
    css_classes.push("nav-level-#{level}") if level > 0
    css_classes.push('active') if @action && current_action?(@action, model_param)
    li =  :li, data: {model: model_param} do
      link_to nav_icon + " " + node.label_plural, url, class: css_classes.join(' ')
    end
    child_nodes = parent_groups[abstract_model.model_name]
    child_nodes ? li + navigation(parent_groups, child_nodes, level + 1) : li
  end.join.html_safe
end

#root_navigationObject



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

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 : ''
       :li do
        link_to nav_icon + " " + wording_for(:menu, node), url, class: "nav-link"
      end
    end.join.html_safe
    label ||= t('admin.misc.root_navigation')

    collapsible_stack(label, 'action', li_stack)
  end.join.html_safe
end

#static_navigationObject



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

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

  label = RailsAdmin::Config.navigation_static_label || t('admin.misc.navigation_static_label')
  collapsible_stack(label, 'static', li_stack) || ''
end

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



69
70
71
72
73
74
75
76
77
78
79
80
# File 'app/helpers/rails_admin/application_helper.rb', line 69

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

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