Module: Cms::PageHelper

Included in:
ApplicationController
Defined in:
app/helpers/cms/page_helper.rb

Instance Method Summary collapse

Instance Method Details

#able_to?(*perms, &block) ⇒ Boolean

Determines if the current_user is able to do specific permissions.

Returns:

  • (Boolean) 


120
121
122
123
 
# File 'app/helpers/cms/page_helper.rb', line 120

def able_to?(*perms, &block)
  block.call if current_user.able_to?(*perms)
  return ''
end

#cms_content_editor ⇒ Object

Return the JS file to load the configured default WYSIWYG editor

Ideally, this could be improved if sprockets allows for dynamically determining which js library to use.



7
8
9
 
# File 'app/helpers/cms/page_helper.rb', line 7

def cms_content_editor
  "bcms/#{Cms.content_editor}"
end

#cms_toolbar ⇒ Object

Add the code to render the CMS toolbar.



64
65
66
67
68
69
 
# File 'app/helpers/cms/page_helper.rb', line 64

def cms_toolbar
  toolbar = "<iframe src=\"\#{cms.toolbar_path(:page_id => @page.id, :page_version => @page.version, :mode => @mode, :page_toolbar => @show_page_toolbar ? 1 : 0) }\" width=\"100%\" height=\"\#{@show_page_toolbar ? 159 : 100 }px\" frameborder=\"0\" marginwidth=\"0\" marginheight=\"0\" scrolling=\"no\" name=\"cms_toolbar\"></iframe>\n"
  toolbar.html_safe if @show_toolbar
end

#container(name) ⇒ String

Outputs the content of a particular container. If the user is in ‘edit’ mode the container and block controls will be rendered.

Returns:

  • (String) —

    The HTML content for the container.



33
34
35
36
37
38
39
40
 
# File 'app/helpers/cms/page_helper.rb', line 33

def container(name)
  content = content_for(name)
  if logged_in? && @page && @mode == "edit" && current_user.able_to_edit?(@page)
    render :partial => 'cms/pages/edit_container', :locals => {:name => name, :content => content}
  else
    content
  end
end

#container_has_block?(name, &block) ⇒ Boolean

Determine if a given container has any blocks within it. Useful for determine if markup should be conditionally included when a block is present, but not shown if no block was added. For example:

<% unless container_has_block? :sidebar %>

<div id="sidebar">
<%= container :sidebar %>
</div>

<% end %>

Parameters:

  • name (Symbol) —

    The name of the container to check

  • block (Proc)

Returns:

  • (Boolean) —

    True if the container has one or more blocks, or if we are in edit mode. False otherwise.



53
54
55
56
57
58
59
60
61
 
# File 'app/helpers/cms/page_helper.rb', line 53

def container_has_block?(name, &block)
  has_block = (@mode == "edit") || current_page.connectable_count_for_container(name) > 0
  logger.info "mode = #{@mode}, has_block = #{has_block}"
  if block_given?
    concat(capture(&block)) if has_block
  else
    has_block
  end
end

#current_page ⇒ Object 



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

def current_page
  @page
end

#page_title(*args) ⇒ String

Outputs the title for this page. Used by both internal CMS pages, as well as page templates. If not explicitily set,

returns the title of the page.

Parameters:

  • The (String) —

    name this page should be set to.

Returns:

  • (String) —

    The title of the page.



16
17
18
19
20
21
22
23
 
# File 'app/helpers/cms/page_helper.rb', line 16

def page_title(*args)
  if args.first
    # Removed unneeded indirection/fixed issue where @template is frozen in r1.9.1
    @page_title = args.first
  else
    @page_title ? @page_title : current_page.page_title
  end
end

#render_breadcrumbs(options = {}) ⇒ Object

Renders breadcrumbs based on the current_page. This will generate an unordered list representing the current page and all it’s ancestors including the root name of of the site. The UL can be styled via CSS for layout purposes. Each breadcrumb except the last will be linked to the page in question.

If the current_page is nil, it will return an empty string.

Params:

options = A hash of options which determine how the breadcrumbs will be laid out.

Options:

  • :from_top - How many below levels from the root the tree should start at. All sections at this level will be shown. The default is 0, which means show all nodes that are direct children of the root.

  • :show_parent - Determines if the name of the page itself show be shown as a breadcrumb link. Defaults to false, meaning that the parent section of the current page will be the ‘last’ breadcrumb link. (Note: This probably better renamed as ‘show_page’).



89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
 
# File 'app/helpers/cms/page_helper.rb', line 89

def render_breadcrumbs(options={})
  return "" unless current_page

  start = options[:from_top] || 0
  show_parent = options[:show_parent].nil? ? false : options[:show_parent]
  ancestors = current_page.ancestors
  items = []
  ancestors[start..ancestors.size].each_with_index do |sec,i|
    items << content_tag(:li, 
      link_to(sec.name, sec.actual_path), (i == 0 ? {:class => "first"} : {}))
  end
  if !show_parent && current_page.section.path == current_page.path
    items[items.size-1] = content_tag(:li, current_page.section.name)
  else
    items << content_tag(:li, current_page.page_title)
  end
  content_tag(:ul, "\n  #{items.join("\n  ")}\n".html_safe, :class => "breadcrumbs")
end

#render_portlet(name) ⇒ Object 



108
109
110
111
112
113
114
115
116
117
 
# File 'app/helpers/cms/page_helper.rb', line 108

def render_portlet(name)
  portlets = Portlet.all(:conditions => ["name = ?", name.to_s])
  if portlets.size > 1
    @mode == "edit" ? "ERROR: Multiple Portlets with name '#{name}'" : nil
  elsif portlets.empty?
    @mode == "edit" ? "ERROR: No Portlet with name '#{name}'" : nil
  else
    render_connectable(portlets.first)
  end
end