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) 


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

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

#cms_toolbar ⇒ Object

Add the code to render the CMS toolbar.



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

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.

Note: As of Jan 19, 2010, all render.html.erb templates must handle marking their content as ‘html_safe’. This is bit of a pain, but I can’t figure out how (or if) i can globally do that or not.

Returns:

  • (String) —

    The HTML content for the container.



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

def container(name)
  page_content = instance_variable_get("@_content_for")
  content = page_content[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.



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

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 



18
19
20
 
# File 'app/helpers/cms/page_helper.rb', line 18

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.



9
10
11
12
13
14
15
16
 
# File 'app/helpers/cms/page_helper.rb', line 9

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’).



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

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(h(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, h(current_page.section.name))
  else
    items << content_tag(:li, h(current_page.page_title))
  end
  content_tag(:ul, "\n  #{items.join("\n  ")}\n".html_safe, :class => "breadcrumbs")
end

#render_portlet(name) ⇒ Object 



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

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