Module: ApplicationHelper

Includes:
Admin::RegionsHelper, LocalTime
Defined in:
app/helpers/application_helper.rb

Instance Method Summary collapse

Methods included from LocalTime

#adjust_time

Instance Method Details

#admin ⇒ Object 



143
144
145
 
# File 'app/helpers/application_helper.rb', line 143

def admin
  Radiant::AdminUI.instance
end

#admin? ⇒ Boolean

Returns:

  • (Boolean) 


81
82
83
 
# File 'app/helpers/application_helper.rb', line 81

def admin?
  current_user and current_user.admin?
end

#available_locales_select ⇒ Object 



163
164
165
 
# File 'app/helpers/application_helper.rb', line 163

def available_locales_select
  [[t('select.default'),'']] + Radiant::AvailableLocales.locales
end

#body_classes ⇒ Object 



151
152
153
 
# File 'app/helpers/application_helper.rb', line 151

def body_classes
  @body_classes ||= []
end

#clean(url) ⇒ Object 



68
69
70
71
 
# File 'app/helpers/application_helper.rb', line 68

def clean(url)
  uri = URI.parse(url)
  uri.path.gsub(%r{/+}, '/').gsub(%r{/$}, '')
end

#config ⇒ Object 



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

def config
  Radiant::Config
end

#current_item?(item) ⇒ Boolean

Returns:

  • (Boolean) 


44
45
46
47
48
49
50
51
 
# File 'app/helpers/application_helper.rb', line 44

def current_item?(item)
  if item.tab && item.tab.many? {|i| current_url?(i.relative_url) }
    # Accept only stricter URL matches if more than one matches
    current_page?(item.url)
  else
    current_url?(item.relative_url)
  end
end

#current_tab?(tab) ⇒ Boolean

Returns:

  • (Boolean) 


53
54
55
56
 
# File 'app/helpers/application_helper.rb', line 53

def current_tab?(tab)
  @current_tab ||= tab if tab.any? {|item| current_url?(item.relative_url) }
  @current_tab == tab
end

#current_url?(options) ⇒ Boolean

Returns:

  • (Boolean) 


58
59
60
61
62
63
64
65
66
 
# File 'app/helpers/application_helper.rb', line 58

def current_url?(options)
  url = case options
  when Hash
    url_for options
  else
    options.to_s
  end
  request.request_uri =~ Regexp.new('^' + Regexp.quote(clean(url)))
end

#default_page_title ⇒ Object 



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

def default_page_title
  title + ' - ' + subtitle
end

#designer? ⇒ Boolean

Returns:

  • (Boolean) 


85
86
87
 
# File 'app/helpers/application_helper.rb', line 85

def designer?
  current_user and (current_user.designer? or current_user.admin?)
end

#filter_options_for_select(selected = nil) ⇒ Object 



147
148
149
 
# File 'app/helpers/application_helper.rb', line 147

def filter_options_for_select(selected=nil)
  options_for_select([[t('select.none'), '']] + TextFilter.descendants_names, selected)
end

#focus(field_name) ⇒ Object 



89
90
91
 
# File 'app/helpers/application_helper.rb', line 89

def focus(field_name)
  javascript_tag "Field.activate('#{field_name}');"
end

#gravatar_url(email, options = {}) ⇒ Object

Returns a Gravatar URL associated with the email parameter. See: douglasfshearer.com/blog/gravatar-for-ruby-and-ruby-on-rails



180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
 
# File 'app/helpers/application_helper.rb', line 180

def gravatar_url(email, options={})
  # Default to highest rating. Rating can be one of G, PG, R X.
  options[:rating] ||= "G"
  
  # Default size of the image.
  options[:size] ||= "32px"
  
  # Default image url to be used when no gravatar is found
  # or when an image exceeds the rating parameter.
  default_avatar_url = "#{request.protocol}#{request.host_with_port}#{ActionController::Base.relative_url_root}/images/admin/avatar_#{([options[:size].to_i] * 2).join('x')}.png"
  options[:default] ||= default_avatar_url
  
  unless email.blank?
    # Build the Gravatar url.
    url = '//gravatar.com/avatar/'
    url << "#{Digest::MD5.new.update(email)}?"
    url << "rating=#{options[:rating]}" if options[:rating]
    url << "&size=#{options[:size]}" if options[:size]
    url << "&default=#{options[:default]}" if options[:default]
    url
  else
    default_avatar_url
  end
end

#image(name, options = {}) ⇒ Object 



135
136
137
 
# File 'app/helpers/application_helper.rb', line 135

def image(name, options = {})
  image_tag(append_image_extension("admin/#{name}"), options)
end

#image_submit(name, options = {}) ⇒ Object 



139
140
141
 
# File 'app/helpers/application_helper.rb', line 139

def image_submit(name, options = {})
  image_submit_tag(append_image_extension("admin/#{name}"), options)
end

#logged_in? ⇒ Boolean

Returns:

  • (Boolean) 


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

def logged_in?
  !current_user.nil?
end

#meta_errors? ⇒ Boolean

Returns:

  • (Boolean) 


123
124
125
 
# File 'app/helpers/application_helper.rb', line 123

def meta_errors?
  false
end

#meta_label ⇒ Object 



127
128
129
 
# File 'app/helpers/application_helper.rb', line 127

def meta_label
  meta_errors? ? 'Less' : 'More'
end

#meta_visible(symbol) ⇒ Object 



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

def meta_visible(symbol)
  v = case symbol
  when :meta_more
    not meta_errors?
  when :meta, :meta_less
    meta_errors?
  end
  v ? {} : {:style => "display: none"}
end

#nav_link_to(name, options) ⇒ Object 



73
74
75
76
77
78
79
 
# File 'app/helpers/application_helper.rb', line 73

def nav_link_to(name, options)
  if current_url?(options)
    %{<strong>#{ link_to translate_with_default(name), options }</strong>}
  else
    link_to translate_with_default(name), options
  end
end

#nav_tabs ⇒ Object 



155
156
157
 
# File 'app/helpers/application_helper.rb', line 155

def nav_tabs
  admin.nav
end

#onsubmit_status(model) ⇒ Object 



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

def onsubmit_status(model)
  model.new_record? ? t('creating_status', :model => t(model.class.name.downcase)) : "#{I18n.t('saving_changes')}&#8230;"
end

#pagination_for(list, options = {}) ⇒ Object

returns the usual set of pagination links. options are passed through to will_paginate and a ‘show all’ depagination link is added if relevant.



208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
 
# File 'app/helpers/application_helper.rb', line 208

def pagination_for(list, options={})
  if list.respond_to? :total_pages
    options = {
      :max_per_page => config['pagination.max_per_page'] || 500,
      :depaginate => true
    }.merge(options.symbolize_keys)
    depaginate = options.delete(:depaginate)                                     # supply :depaginate => false to omit the 'show all' link
    depagination_limit = options.delete(:max_per_page)                           # supply :max_per_page => false to include the 'show all' link no matter how large the collection
    html = will_paginate(list, will_paginate_options.merge(options))
    if depaginate && list.total_pages > 1 && (!depagination_limit.blank? || list.total_entries <= depagination_limit.to_i)
      html << content_tag(:div, link_to(t('show_all'), :pp => 'all'), :class => 'depaginate')
    elsif depaginate && list.total_entries > depagination_limit.to_i
      html = content_tag(:div, link_to("paginate", :p => 1), :class => 'pagination')
    end
    html
  end
end

#save_model_and_continue_editing_button(model) ⇒ Object 



40
41
42
 
# File 'app/helpers/application_helper.rb', line 40

def save_model_and_continue_editing_button(model)
  submit_tag t('buttons.save_and_continue'), :name => 'continue', :class => 'button', :accesskey => "s"
end

#save_model_button(model, options = {}) ⇒ Object 



29
30
31
32
33
34
35
36
37
38
 
# File 'app/helpers/application_helper.rb', line 29

def save_model_button(model, options = {})
  model_name = model.class.name.underscore
  human_model_name = model_name.humanize.titlecase
  options[:label] ||= model.new_record? ?
    t('buttons.create', :name => t(model_name, :default => human_model_name), :default => 'Create ' + human_model_name) :
    t('buttons.save_changes', :default => 'Save Changes')
  options[:class] ||= "button"
  options[:accesskey] ||= 'S'
  submit_tag options.delete(:label), options
end

#stylesheet_and_javascript_overrides ⇒ Object 



167
168
169
170
171
172
173
174
175
176
 
# File 'app/helpers/application_helper.rb', line 167

def stylesheet_and_javascript_overrides
  overrides = ''
  if File.exist?("#{Rails.root}/public/stylesheets/admin/overrides.css") || File.exist?("#{Rails.root}/public/stylesheets/sass/admin/overrides.sass")
    overrides << stylesheet_link_tag('admin/overrides')
  end
  if File.exist?("#{Rails.root}/public/javascripts/admin/overrides.js")
    overrides << javascript_include_tag('admin/overrides')
  end
  overrides
end

#subtitle ⇒ Object 



17
18
19
 
# File 'app/helpers/application_helper.rb', line 17

def subtitle
  config['admin.subtitle'] || 'Publishing for Small Teams'
end

#timestamp(time) ⇒ Object 



108
109
110
111
 
# File 'app/helpers/application_helper.rb', line 108

def timestamp(time)
  # time.strftime("%I:%M %p on %B %e, %Y").sub("AM", 'am').sub("PM", 'pm')
  I18n.localize(time, :format => :timestamp)    
end

#title ⇒ Object 



13
14
15
 
# File 'app/helpers/application_helper.rb', line 13

def title
  config['admin.title'] || 'Radiant CMS'
end

#toggle_javascript_for(id) ⇒ Object 



131
132
133
 
# File 'app/helpers/application_helper.rb', line 131

def toggle_javascript_for(id)
  "Element.toggle('#{id}'); Element.toggle('more-#{id}'); Element.toggle('less-#{id}'); return false;"
end

#translate_with_default(name) ⇒ Object 



159
160
161
 
# File 'app/helpers/application_helper.rb', line 159

def translate_with_default(name)
  t(name.underscore.downcase, :default => name)
end

#updated_stamp(model) ⇒ Object 



93
94
95
96
97
98
99
100
101
102
103
104
105
106
 
# File 'app/helpers/application_helper.rb', line 93

def updated_stamp(model)
  unless model.new_record?
    updated_by = (model.updated_by || model.created_by)
    name = updated_by ? updated_by.name : nil
    time = (model.updated_at || model.created_at)
    if name or time
      html = %{<p class="updated_line">#{t('timestamp.last_updated')} } 
      html << %{#{t('timestamp.by')} <strong>#{name}</strong> } if name
      html << %{#{t('timestamp.at')} #{timestamp(time)}} if time
      html << %{</p>}
      html
    end
  end
end