browsercms 3.0.6 → 3.1.0

data/doc/app/classes/Cms/MenuHelper.html

@@ -80,7 +80,8 @@
       <h3 class="section-bar">Methods</h3>
 
       <div class="name-list">
-      <a href="#M000302">render_menu</a>&nbsp;&nbsp;
+      <a href="#M000342">menu_items</a>&nbsp;&nbsp;
+      <a href="#M000341">render_menu</a>&nbsp;&nbsp;
       </div>
     </div>
 
@@ -102,42 +103,52 @@
     <div id="methods">
       <h3 class="section-bar">Public Instance methods</h3>
 
-      <div id="method-M000302" class="method-detail">
-        <a name="M000302"></a>
+      <div id="method-M000342" class="method-detail">
+        <a name="M000342"></a>
 
         <div class="method-heading">
-          <a href="#M000302" class="method-signature">
-          <span class="method-name">render_menu</span><span class="method-args">(options={})</span>
+          <a href="#M000342" class="method-signature">
+          <span class="method-name">menu_items</span><span class="method-args">(options = {})</span>
           </a>
         </div>
       
         <div class="method-description">
           <p>
-This will render a menu based on the page With no options passed, it will
-render a menu that shows all the child sections of the root and then it
-will show the path of decendent sections all the way to the current page.
-The resulting HTML is a DIV with a UL in it. Each LI will have an A in it.
-If the item is a <a href="../Section.html">Section</a>, the HREF of the A
-will be the URL of the first non-archived page that is a direct child of
-that <a href="../Section.html">Section</a>. Hidden pages will not show up,
-but if the first page in a <a href="../Section.html">Section</a> is hidden,
-it will be used as the URL for that <a href="../Section.html">Section</a>.
-This is commonly done to have a page for a <a
-href="../Section.html">Section</a> and avoid having duplicates in the
-navigation.
+This will render generate an array-of-hashes tree structure based on the
+page, which can be passed to <a
+href="MenuHelper.html#M000341">render_menu</a> in order to generate a menu.
 </p>
 <p>
-You can change the behavior with the following options:
+With no options passed, it will generate a structure that includes all the
+child sections of the root and then it will include the path of decendent
+sections all the way to the current page.
+</p>
+<p>
+Hidden pages will not be included, but if the first page in a <a
+href="../Section.html">Section</a> is hidden, it will be used as the URL
+for that <a href="../Section.html">Section</a>. This is commonly done to
+have a page for a <a href="../Section.html">Section</a> and avoid having
+duplicates in the navigation.
+</p>
+<p>
+You can change the behavior with the following options, all of these are
+optional:
 </p>
 <h4>Options</h4>
 <ul>
-<li><tt>:page</tt> - What page should be used. If this value is omitted, the
-value in @page will be used.
+<li><tt>:page</tt> - What page should be used as the current page. If this
+value is omitted, the value in @page will be used.
+
+</li>
+<li><tt>:path</tt> - This will be used to look up a section and that section
+will used to generate the menu structure. The current page will still be
+the value of the page option or @page. Note that this is the path to a
+section, not a path to a page.
 
 </li>
 <li><tt>:from_top</tt> - 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 section that are direct children of the root
+means show all nodes that are direct children of the root
 
 </li>
 <li><tt>:depth</tt> - How many levels deep should the tree go, relative to
@@ -146,12 +157,12 @@ current page. If a value is supplied, the tree will be that many levels
 underneath from_top deep.
 
 </li>
-<li><tt>:class</tt> - The CSS Class that will be applied to the div. The
-default value is &quot;menu&quot;.
+<li><tt>:limit</tt> - Limits the number of top-level elements that will be
+included in the list
 
 </li>
 <li><tt>:show_all_siblings</tt> - Passing true for this option will make all
-sibilings appear in the tree. the default is false, in which case only the
+sibilings appear in the tree. The default is false, in which case only the
 siblings of nodes within the open path will appear.
 
 </li>
@@ -165,151 +176,185 @@ are on the Baltimore Ravens page. If you&#8216;re not a footbal fan, see <a
 href="http://sports.yahoo.com/nfl/teams">sports.yahoo.com/nfl/teams</a>
 </p>
 <pre>
-  render_menu
-  # =&gt; &lt;div class=&quot;menu&quot;&gt;
-    &lt;ul&gt;
-      &lt;li id=&quot;section_2&quot; class=&quot;first open&quot;&gt;
-        &lt;a href=&quot;/buf&quot;&gt;AFC&lt;/a&gt;
-        &lt;ul&gt;
-          &lt;li id=&quot;section_3&quot; class=&quot;first&quot;&gt;
-            &lt;a href=&quot;/buf&quot;&gt;East&lt;/a&gt;
-          &lt;/li&gt;
-          &lt;li id=&quot;section_4&quot; class=&quot;open&quot;&gt;
-            &lt;a href=&quot;/bal&quot;&gt;North&lt;/a&gt;
-            &lt;ul&gt;
-              &lt;li id=&quot;page_5&quot; class=&quot;first on&quot;&gt;
-                &lt;a href=&quot;/bal&quot;&gt;Baltimore Ravens&lt;/a&gt;
-              &lt;/li&gt;
-              &lt;li id=&quot;page_6&quot;&gt;
-                &lt;a href=&quot;/cin&quot;&gt;Cincinnati Bengals&lt;/a&gt;
-              &lt;/li&gt;
-              &lt;li id=&quot;page_7&quot;&gt;
-                &lt;a href=&quot;/cle&quot;&gt;Cleveland Browns&lt;/a&gt;
-              &lt;/li&gt;
-              &lt;li id=&quot;page_8&quot; class=&quot;last&quot;&gt;
-                &lt;a href=&quot;/pit&quot;&gt;Pittsburgh Steelers&lt;/a&gt;
-              &lt;/li&gt;
-            &lt;/ul&gt;
-          &lt;/li&gt;
-          &lt;li id=&quot;section_5&quot;&gt;
-            &lt;a href=&quot;/hou&quot;&gt;South&lt;/a&gt;
-          &lt;/li&gt;
-          &lt;li id=&quot;section_6&quot; class=&quot;last&quot;&gt;
-            &lt;a href=&quot;/den&quot;&gt;West&lt;/a&gt;
-          &lt;/li&gt;
-        &lt;/ul&gt;
-      &lt;/li&gt;
-      &lt;li id=&quot;section_7&quot; class=&quot;last&quot;&gt;
-        &lt;a href=&quot;/dal&quot;&gt;NFC&lt;/a&gt;
-      &lt;/li&gt;
-    &lt;/ul&gt;
-  &lt;/div&gt;
-
-  render_menu(:depth =&gt; 2, :show_all_siblings =&gt; true)
-  # =&gt; &lt;div class=&quot;menu&quot;&gt;
-    &lt;ul&gt;
-      &lt;li id=&quot;section_2&quot; class=&quot;first open&quot;&gt;
-        &lt;a href=&quot;/buf&quot;&gt;AFC&lt;/a&gt;
-        &lt;ul&gt;
-          &lt;li id=&quot;section_3&quot; class=&quot;first&quot;&gt;
-            &lt;a href=&quot;/buf&quot;&gt;East&lt;/a&gt;
-          &lt;/li&gt;
-          &lt;li id=&quot;section_4&quot; class=&quot;open&quot;&gt;
-            &lt;a href=&quot;/bal&quot;&gt;North&lt;/a&gt;
-          &lt;/li&gt;
-          &lt;li id=&quot;section_5&quot;&gt;
-            &lt;a href=&quot;/hou&quot;&gt;South&lt;/a&gt;
-          &lt;/li&gt;
-          &lt;li id=&quot;section_6&quot; class=&quot;last&quot;&gt;
-            &lt;a href=&quot;/den&quot;&gt;West&lt;/a&gt;
-          &lt;/li&gt;
-        &lt;/ul&gt;
-      &lt;/li&gt;
-      &lt;li id=&quot;section_7&quot; class=&quot;last&quot;&gt;
-        &lt;a href=&quot;/dal&quot;&gt;NFC&lt;/a&gt;
-        &lt;ul&gt;
-          &lt;li id=&quot;section_8&quot; class=&quot;first&quot;&gt;
-            &lt;a href=&quot;/dal&quot;&gt;East&lt;/a&gt;
-          &lt;/li&gt;
-          &lt;li id=&quot;section_9&quot;&gt;
-            &lt;a href=&quot;/chi&quot;&gt;North&lt;/a&gt;
-          &lt;/li&gt;
-          &lt;li id=&quot;section_10&quot;&gt;
-            &lt;a href=&quot;/atl&quot;&gt;South&lt;/a&gt;
-          &lt;/li&gt;
-          &lt;li id=&quot;section_11&quot; class=&quot;last&quot;&gt;
-            &lt;a href=&quot;/ari&quot;&gt;West&lt;/a&gt;
-          &lt;/li&gt;
-        &lt;/ul&gt;
-      &lt;/li&gt;
-    &lt;/ul&gt;
-  &lt;/div&gt;
+  menu_items
+  # =&gt; [
+    { :id =&gt; &quot;section_2&quot;, :url =&gt; &quot;/buf&quot;, :name =&gt; &quot;AFC&quot;, :children =&gt; [
+      { :id =&gt; &quot;section_3&quot;, :url =&gt; &quot;/buf&quot;, :name =&gt; &quot;East&quot; },
+      { :id =&gt; &quot;section_4&quot;, :url =&gt; &quot;/bal&quot;, :name =&gt; &quot;North&quot;, :children =&gt; [
+        { :id =&gt; &quot;page_5&quot;, :selected =&gt; true, :url =&gt; &quot;/bal&quot;, :name =&gt; &quot;Baltimore Ravens&quot; },
+        { :id =&gt; &quot;page_6&quot;, :url =&gt; &quot;/cin&quot;, :name =&gt; &quot;Cincinnati Bengals&quot; },
+        { :id =&gt; &quot;page_7&quot;, :url =&gt; &quot;/cle&quot;, :name =&gt; &quot;Cleveland Browns&quot; },
+        { :id =&gt; &quot;page_8&quot;, :url =&gt; &quot;/pit&quot;, :name =&gt; &quot;Pittsburgh Steelers&quot; }
+      ] },
+      { :id =&gt; &quot;section_9&quot;, :url =&gt; &quot;/hou&quot;, :name =&gt; &quot;South&quot; },
+      { :id =&gt; &quot;section_10}&quot;, :url =&gt; &quot;/den&quot;, :name =&gt; &quot;West&quot; }
+      ] },
+    { :id =&gt; &quot;section_11&quot;, :url =&gt; &quot;/dal&quot;, :name =&gt; &quot;NFC&quot; }
+  ]
+
+  menu_items(:depth =&gt; 2, :show_all_siblings =&gt; true)
+  # =&gt; [
+    { :id =&gt; &quot;section_2&quot;, :url =&gt; &quot;/buf&quot;, :name =&gt; &quot;AFC&quot;, :children =&gt; [
+        { :id =&gt; &quot;section_3&quot;, :url =&gt; &quot;/buf&quot;, :name =&gt; &quot;East&quot; },
+        { :id =&gt; &quot;section_4&quot;, :url =&gt; &quot;/bal&quot;, :name =&gt; &quot;North&quot; },
+        { :id =&gt; &quot;section_5&quot;, :url =&gt; &quot;/hou&quot;, :name =&gt; &quot;South&quot; },
+        { :id =&gt; &quot;section_6&quot;, :url =&gt; &quot;/den&quot;, :name =&gt; &quot;West&quot; }
+      ] },
+    { :id =&gt; &quot;section_7&quot;, :url =&gt; &quot;/dal&quot;, :name =&gt; &quot;NFC&quot;, :children =&gt; [
+        { :id =&gt; &quot;section_8&quot;, :url =&gt; &quot;/dal&quot;, :name =&gt; &quot;East&quot; },
+        { :id =&gt; &quot;section_9&quot;, :url =&gt; &quot;/chi&quot;, :name =&gt; &quot;North&quot; },
+        { :id =&gt; &quot;section_10&quot;, :url =&gt; &quot;/atl&quot;, :name =&gt; &quot;South&quot; },
+        { :id =&gt; &quot;section_11&quot;, :url =&gt; &quot;/ari&quot;, :name =&gt; &quot;West&quot; }
+      ] }
+  ]
 </pre>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000302-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000302-source">
+            onclick="toggleCode('M000342-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000342-source">
 <pre>
-     <span class="ruby-comment cmt"># File app/helpers/cms/menu_helper.rb, line 111</span>
-111:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">render_menu</span>(<span class="ruby-identifier">options</span>={})
-112:       <span class="ruby-comment cmt">#Intialize parameters</span>
-113:       <span class="ruby-identifier">page</span> = <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:page</span>] <span class="ruby-operator">||</span> <span class="ruby-ivar">@page</span>
-114:       <span class="ruby-identifier">from_top</span> = <span class="ruby-identifier">options</span>.<span class="ruby-identifier">has_key?</span>(<span class="ruby-identifier">:from_top</span>) <span class="ruby-operator">?</span> <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:from_top</span>].<span class="ruby-identifier">to_i</span> <span class="ruby-operator">:</span> <span class="ruby-value">0</span>
-115:       <span class="ruby-identifier">depth</span> = <span class="ruby-identifier">options</span>.<span class="ruby-identifier">has_key?</span>(<span class="ruby-identifier">:depth</span>) <span class="ruby-operator">?</span> <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:depth</span>].<span class="ruby-identifier">to_i</span> <span class="ruby-operator">:</span> <span class="ruby-value">1.0</span><span class="ruby-operator">/</span><span class="ruby-value">0</span>
-116:       <span class="ruby-identifier">id</span> = <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:id</span>] <span class="ruby-operator">||</span> <span class="ruby-value str">&quot;menu&quot;</span>
-117:       <span class="ruby-identifier">css_class</span> = <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:class</span>] <span class="ruby-operator">||</span> <span class="ruby-value str">&quot;menu&quot;</span>
-118:       <span class="ruby-identifier">show_all_siblings</span> = <span class="ruby-operator">!</span><span class="ruby-operator">!</span>(<span class="ruby-identifier">options</span>[<span class="ruby-identifier">:show_all_siblings</span>])
-119: 
-120:       <span class="ruby-identifier">html</span> = <span class="ruby-node">&quot;&lt;div id=\&quot;#{id}\&quot; class=\&quot;#{css_class}\&quot;&gt;\n&quot;</span>
-121:       
-122:       <span class="ruby-identifier">ancestors</span> = <span class="ruby-identifier">page</span>.<span class="ruby-identifier">ancestors</span>
-123:       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">from_top</span> <span class="ruby-operator">&gt;</span> <span class="ruby-identifier">ancestors</span>.<span class="ruby-identifier">size</span>
-124:         <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">html</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value str">&quot;&lt;/div&gt;\n&quot;</span>
-125:       <span class="ruby-keyword kw">else</span>
-126:         <span class="ruby-identifier">ancestors</span> = <span class="ruby-identifier">page</span>.<span class="ruby-identifier">ancestors</span>[<span class="ruby-identifier">from_top</span><span class="ruby-operator">..</span><span class="ruby-value">-1</span>]
-127:       <span class="ruby-keyword kw">end</span>
-128:       
-129:       <span class="ruby-comment cmt">#We are defining a recursive lambda that takes the top-level sections</span>
-130:       <span class="ruby-comment cmt">#d is the current depth</span>
-131:       <span class="ruby-identifier">fn</span> = <span class="ruby-identifier">lambda</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">nodes</span>, <span class="ruby-identifier">d</span><span class="ruby-operator">|</span>
-132:         <span class="ruby-identifier">indent</span> = (<span class="ruby-identifier">d</span><span class="ruby-operator">-</span><span class="ruby-value">1</span>)<span class="ruby-operator">*</span><span class="ruby-value">4</span>
-133:         <span class="ruby-identifier">html</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value str">&quot;&lt;ul&gt;\n&quot;</span>.<span class="ruby-identifier">indent</span>(<span class="ruby-identifier">indent</span><span class="ruby-operator">+</span><span class="ruby-value">2</span>)
-134:         <span class="ruby-identifier">nodes</span>.<span class="ruby-identifier">each_with_index</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">sn</span>, <span class="ruby-identifier">i</span><span class="ruby-operator">|</span>
-135: 
-136:           <span class="ruby-comment cmt">#Construct the CSS classes that the LI should have</span>
-137:           <span class="ruby-identifier">classes</span> = [<span class="ruby-node">&quot;depth-#{d}&quot;</span>]
-138:           <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">i</span> <span class="ruby-operator">==</span> <span class="ruby-value">0</span>
-139:             <span class="ruby-identifier">classes</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value str">&quot;first&quot;</span>
-140:           <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">i</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">nodes</span>.<span class="ruby-identifier">size</span><span class="ruby-operator">-</span><span class="ruby-value">1</span>
-141:             <span class="ruby-identifier">classes</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value str">&quot;last&quot;</span>
-142:           <span class="ruby-keyword kw">end</span>
-143:           <span class="ruby-identifier">classes</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value str">&quot;open&quot;</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">ancestors</span>.<span class="ruby-identifier">include?</span>(<span class="ruby-identifier">sn</span>.<span class="ruby-identifier">node</span>)
-144:           <span class="ruby-identifier">classes</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value str">&quot;on&quot;</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">page</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">sn</span>.<span class="ruby-identifier">node</span>
-145:           <span class="ruby-identifier">cls</span> = <span class="ruby-identifier">classes</span>.<span class="ruby-identifier">empty?</span> <span class="ruby-value">? </span><span class="ruby-keyword kw">nil</span> <span class="ruby-operator">:</span> <span class="ruby-identifier">classes</span>.<span class="ruby-identifier">join</span>(<span class="ruby-value str">&quot; &quot;</span>)
+     <span class="ruby-comment cmt"># File app/helpers/cms/menu_helper.rb, line 106</span>
+106:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">menu_items</span>(<span class="ruby-identifier">options</span> = {})
+107:       <span class="ruby-comment cmt"># Intialize parameters</span>
+108:       <span class="ruby-identifier">selected_page</span> = <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:page</span>] <span class="ruby-operator">||</span> <span class="ruby-ivar">@page</span>
+109:       <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">selected_page</span>
+110:       
+111:       <span class="ruby-comment cmt"># Path to the section</span>
+112:       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">options</span>.<span class="ruby-identifier">has_key?</span>(<span class="ruby-identifier">:path</span>)
+113:         <span class="ruby-identifier">section_for_path</span> = <span class="ruby-constant">Section</span>.<span class="ruby-identifier">find_by_path</span>(<span class="ruby-identifier">options</span>[<span class="ruby-identifier">:path</span>])
+114:         <span class="ruby-identifier">raise</span> <span class="ruby-node">&quot;Could not find section for path '#{options[:path]}'&quot;</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">section_for_path</span>
+115:         <span class="ruby-identifier">ancestors</span> = <span class="ruby-identifier">section_for_path</span>.<span class="ruby-identifier">ancestors</span>(<span class="ruby-identifier">:include_self</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-keyword kw">true</span>)
+116:       <span class="ruby-keyword kw">else</span>
+117:         <span class="ruby-identifier">ancestors</span> = <span class="ruby-identifier">selected_page</span>.<span class="ruby-identifier">ancestors</span>
+118:       <span class="ruby-keyword kw">end</span>
+119:       
+120:       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">options</span>.<span class="ruby-identifier">has_key?</span>(<span class="ruby-identifier">:from_top</span>)
+121:         <span class="ruby-identifier">ancestors</span> = <span class="ruby-identifier">ancestors</span>[<span class="ruby-identifier">options</span>[<span class="ruby-identifier">:from_top</span>].<span class="ruby-identifier">to_i</span><span class="ruby-operator">..</span><span class="ruby-value">-1</span>] <span class="ruby-operator">||</span> []
+122:       <span class="ruby-keyword kw">end</span>
+123:       
+124:       <span class="ruby-identifier">depth</span> = <span class="ruby-identifier">options</span>.<span class="ruby-identifier">has_key?</span>(<span class="ruby-identifier">:depth</span>) <span class="ruby-operator">?</span> <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:depth</span>].<span class="ruby-identifier">to_i</span> <span class="ruby-operator">:</span> <span class="ruby-value">1.0</span><span class="ruby-operator">/</span><span class="ruby-value">0</span>
+125:       <span class="ruby-identifier">show_all_siblings</span> = <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:show_all_siblings</span>] <span class="ruby-operator">||</span> <span class="ruby-keyword kw">false</span>
+126:       
+127:       <span class="ruby-comment cmt"># We are defining a recursive lambda that takes the top-level sections</span>
+128:       <span class="ruby-identifier">fn</span> = <span class="ruby-identifier">lambda</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">section_nodes</span>, <span class="ruby-identifier">current_depth</span><span class="ruby-operator">|</span>
+129:         <span class="ruby-identifier">section_nodes</span>.<span class="ruby-identifier">map</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">section_node</span><span class="ruby-operator">|</span>
+130:           <span class="ruby-identifier">node</span> = <span class="ruby-identifier">section_node</span>.<span class="ruby-identifier">node</span>
+131:           
+132:           <span class="ruby-identifier">item</span> = {}
+133:           <span class="ruby-identifier">item</span>[<span class="ruby-identifier">:id</span>] = <span class="ruby-node">&quot;#{section_node.node_type.underscore}_#{section_node.node_id}&quot;</span>
+134:           
+135:           <span class="ruby-comment cmt"># If we are showing a section item, we want to use the path for the first page</span>
+136:           <span class="ruby-identifier">page</span> = <span class="ruby-identifier">section_node</span>.<span class="ruby-identifier">section?</span> <span class="ruby-value">? </span><span class="ruby-identifier">node</span>.<span class="ruby-identifier">first_page_or_link</span> <span class="ruby-operator">:</span> <span class="ruby-identifier">node</span>
+137:           <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">section_node</span>.<span class="ruby-identifier">section?</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">page</span>
+138:             <span class="ruby-identifier">item</span>[<span class="ruby-identifier">:selected</span>] = <span class="ruby-keyword kw">true</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">page</span>.<span class="ruby-identifier">hidden?</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">selected_page</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">page</span>
+139:           <span class="ruby-keyword kw">else</span>
+140:             <span class="ruby-identifier">item</span>[<span class="ruby-identifier">:selected</span>] = <span class="ruby-keyword kw">true</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">selected_page</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">page</span>
+141:           <span class="ruby-keyword kw">end</span>
+142:          
+143:           <span class="ruby-identifier">item</span>[<span class="ruby-identifier">:url</span>] = <span class="ruby-identifier">page</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">page</span>.<span class="ruby-identifier">path</span> <span class="ruby-operator">||</span> <span class="ruby-value str">'#'</span>
+144:           <span class="ruby-identifier">item</span>[<span class="ruby-identifier">:name</span>] = <span class="ruby-identifier">node</span>.<span class="ruby-identifier">name</span>
+145:           <span class="ruby-identifier">item</span>[<span class="ruby-identifier">:target</span>] = <span class="ruby-value str">&quot;_blank&quot;</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">page</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-identifier">:new_window?</span>) <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">page</span>.<span class="ruby-identifier">new_window?</span>
 146:           
-147:           <span class="ruby-identifier">html</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-node">%Q{&lt;li id=&quot;#{sn.node_type.underscore}_#{sn.node.id}&quot;#{cls ? &quot; class=\&quot;#{cls}\&quot;&quot; : ''}&gt;\n}</span>.<span class="ruby-identifier">indent</span>(<span class="ruby-identifier">indent</span><span class="ruby-operator">+</span><span class="ruby-value">4</span>)
-148:           
-149:           <span class="ruby-comment cmt">#Figure out what this link for this node should be</span>
-150:           <span class="ruby-comment cmt">#If it is a page, then the page will simply be used</span>
-151:           <span class="ruby-comment cmt">#But if is a page, we call the first_page_or_link method</span>
-152:           <span class="ruby-identifier">p</span> = <span class="ruby-identifier">sn</span>.<span class="ruby-identifier">node_type</span> <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;Section&quot;</span> <span class="ruby-operator">?</span> <span class="ruby-identifier">sn</span>.<span class="ruby-identifier">node</span>.<span class="ruby-identifier">first_page_or_link</span> <span class="ruby-operator">:</span> <span class="ruby-identifier">sn</span>.<span class="ruby-identifier">node</span>
-153:           <span class="ruby-identifier">html</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-node">%Q{&lt;a href=&quot;#{p ? p.path : '#'}&quot;#{(p.respond_to?(:new_window) &amp;&amp; p.new_window?) ? ' target=&quot;_blank&quot;' : ''}&gt;#{sn.node.name}&lt;/a&gt;\n}</span>.<span class="ruby-identifier">indent</span>(<span class="ruby-identifier">indent</span><span class="ruby-operator">+</span><span class="ruby-value">6</span>)
-154:           
-155:           <span class="ruby-comment cmt">#Now if this is a section, we do the child nodes, </span>
-156:           <span class="ruby-comment cmt">#but only if the show_all_siblings parameter is true, </span>
-157:           <span class="ruby-comment cmt">#or if this section is one of the current page's ancestors</span>
-158:           <span class="ruby-comment cmt">#and also if the current depth is less than the target depth</span>
-159:           <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">sn</span>.<span class="ruby-identifier">node_type</span> <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;Section&quot;</span> <span class="ruby-operator">&amp;&amp;</span> (<span class="ruby-identifier">show_all_siblings</span> <span class="ruby-operator">||</span> <span class="ruby-identifier">ancestors</span>.<span class="ruby-identifier">include?</span>(<span class="ruby-identifier">sn</span>.<span class="ruby-identifier">node</span>)) <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">d</span> <span class="ruby-operator">&lt;</span> <span class="ruby-identifier">depth</span>
-160:             <span class="ruby-identifier">fn</span>.<span class="ruby-identifier">call</span>(<span class="ruby-identifier">sn</span>.<span class="ruby-identifier">node</span>.<span class="ruby-identifier">visible_child_nodes</span>, <span class="ruby-identifier">d</span><span class="ruby-operator">+</span><span class="ruby-value">1</span>)
-161:           <span class="ruby-keyword kw">end</span>
-162:           
-163:           <span class="ruby-identifier">html</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value str">%Q{&lt;/li&gt;\n}</span>.<span class="ruby-identifier">indent</span>(<span class="ruby-identifier">indent</span><span class="ruby-operator">+</span><span class="ruby-value">4</span>)
-164:           
-165:         <span class="ruby-keyword kw">end</span>
-166:         <span class="ruby-identifier">html</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value str">&quot;&lt;/ul&gt;\n&quot;</span>.<span class="ruby-identifier">indent</span>(<span class="ruby-identifier">indent</span><span class="ruby-operator">+</span><span class="ruby-value">2</span>)
-167:       <span class="ruby-keyword kw">end</span>
-168:       <span class="ruby-identifier">fn</span>.<span class="ruby-identifier">call</span>(<span class="ruby-identifier">ancestors</span>.<span class="ruby-identifier">first</span>.<span class="ruby-identifier">visible_child_nodes</span>, <span class="ruby-value">1</span>) <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">ancestors</span>.<span class="ruby-identifier">first</span>.<span class="ruby-identifier">blank?</span>
-169:       <span class="ruby-identifier">html</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value str">&quot;&lt;/div&gt;\n&quot;</span>
-170:     <span class="ruby-keyword kw">end</span>
+147:           <span class="ruby-comment cmt"># Now if this is a section, we do the child nodes, </span>
+148:           <span class="ruby-comment cmt"># but only if the show_all_siblings parameter is true, </span>
+149:           <span class="ruby-comment cmt"># or if this section is one of the current page's ancestors</span>
+150:           <span class="ruby-comment cmt"># and also if the current depth is less than the target depth</span>
+151:           <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">section_node</span>.<span class="ruby-identifier">section?</span> <span class="ruby-operator">&amp;&amp;</span>
+152:              <span class="ruby-identifier">current_depth</span> <span class="ruby-operator">&lt;</span> <span class="ruby-identifier">depth</span> <span class="ruby-operator">&amp;&amp;</span>
+153:              (<span class="ruby-identifier">show_all_siblings</span> <span class="ruby-operator">||</span> <span class="ruby-identifier">ancestors</span>.<span class="ruby-identifier">include?</span>(<span class="ruby-identifier">node</span>)) <span class="ruby-operator">&amp;&amp;</span>
+154:              <span class="ruby-operator">!</span><span class="ruby-identifier">node</span>.<span class="ruby-identifier">visible_child_nodes</span>.<span class="ruby-identifier">empty?</span>
+155:             <span class="ruby-identifier">item</span>[<span class="ruby-identifier">:children</span>] = <span class="ruby-identifier">fn</span>.<span class="ruby-identifier">call</span>(<span class="ruby-identifier">node</span>.<span class="ruby-identifier">visible_child_nodes</span>, <span class="ruby-identifier">current_depth</span> <span class="ruby-operator">+</span> <span class="ruby-value">1</span>)
+156:           <span class="ruby-keyword kw">end</span>
+157:           
+158:           <span class="ruby-identifier">item</span>
+159:         <span class="ruby-keyword kw">end</span>
+160:       <span class="ruby-keyword kw">end</span>
+161:       
+162:       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">ancestors</span>.<span class="ruby-identifier">empty?</span>
+163:         []
+164:       <span class="ruby-keyword kw">else</span>
+165:         <span class="ruby-identifier">fn</span>.<span class="ruby-identifier">call</span>(<span class="ruby-identifier">ancestors</span>.<span class="ruby-identifier">first</span>.<span class="ruby-identifier">visible_child_nodes</span>(<span class="ruby-identifier">:limit</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:limit</span>]), <span class="ruby-value">1</span>)
+166:       <span class="ruby-keyword kw">end</span>
+167:     <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+
+      <div id="method-M000341" class="method-detail">
+        <a name="M000341"></a>
+
+        <div class="method-heading">
+          <a href="#M000341" class="method-signature">
+          <span class="method-name">render_menu</span><span class="method-args">(options = {})</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+Renders a menu. There are two options, neither are required:
+</p>
+<h4>Options</h4>
+<ul>
+<li><tt>:items</tt> - The items which should appear in the menu. This defaults
+to calling <a href="MenuHelper.html#M000342">menu_items</a> which generates
+items automatically based on the current page. But you can use this option
+to pass in a custom menu structure.
+
+</li>
+<li><tt>:partial</tt> - The partial used to render the menu. By default this is
+&quot;partials/menu&quot;, which can be customised through the CMS. The
+partial gets a local variable <tt>items</tt>.
+
+</li>
+</ul>
+<h4>Structure of items</h4>
+<p>
+The items should be an array of hashes, in a tree. Each hash can have the
+following keys (name and url are required, others are optional):
+</p>
+<ul>
+<li><tt>:name</tt> - The name which appears in the menu
+
+</li>
+<li><tt>:url</tt> - The URL to link to
+
+</li>
+<li><tt>:id</tt> - The id for the menu item
+
+</li>
+<li><tt>:selected</tt> - Boolean value to indicate whether the menu item is the
+current page
+
+</li>
+<li><tt>:target</tt> - The target attribute for the link
+
+</li>
+<li><tt>:children</tt> - An array of hashes containing the child menu items.
+This is where the tree structure comes in.
+
+</li>
+</ul>
+<p>
+Edge Cases:
+</p>
+<pre>
+  If both @page and :items are nil/empty, this will return an empty string. This might happen if used on an CMS
+  rendered page, where @page isn't set.
+</pre>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000341-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000341-source">
+<pre>
+    <span class="ruby-comment cmt"># File app/helpers/cms/menu_helper.rb, line 29</span>
+29:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">render_menu</span>(<span class="ruby-identifier">options</span> = {})
+30:       <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:items</span>] <span class="ruby-operator">||=</span> <span class="ruby-identifier">menu_items</span>(<span class="ruby-identifier">options</span>)
+31:       <span class="ruby-keyword kw">return</span> <span class="ruby-value str">&quot;&quot;</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:items</span>]
+32: 
+33:       <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:partial</span>] <span class="ruby-operator">||=</span> <span class="ruby-value str">&quot;cms/menus/menu&quot;</span>
+34:       <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:id</span>] <span class="ruby-operator">||=</span> <span class="ruby-value str">&quot;menu&quot;</span>
+35:       <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:class</span>] <span class="ruby-operator">||=</span> <span class="ruby-value str">&quot;menu&quot;</span>
+36:       <span class="ruby-identifier">render</span> <span class="ruby-identifier">:partial</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:partial</span>], <span class="ruby-identifier">:locals</span> =<span class="ruby-operator">&gt;</span> { <span class="ruby-identifier">:items</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:items</span>], <span class="ruby-identifier">:css_id</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:id</span>], <span class="ruby-identifier">:css_class</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:class</span>] }
+37:     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>

data/doc/app/classes/Cms/PageHelper.html

@@ -80,12 +80,14 @@
       <h3 class="section-bar">Methods</h3>
 
       <div class="name-list">
-      <a href="#M000503">cms_toolbar</a>&nbsp;&nbsp;
-      <a href="#M000501">container</a>&nbsp;&nbsp;
-      <a href="#M000502">container_has_block?</a>&nbsp;&nbsp;
-      <a href="#M000500">current_page</a>&nbsp;&nbsp;
-      <a href="#M000504">render_breadcrumbs</a>&nbsp;&nbsp;
-      <a href="#M000505">render_portlet</a>&nbsp;&nbsp;
+      <a href="#M000551">able_to?</a>&nbsp;&nbsp;
+      <a href="#M000548">cms_toolbar</a>&nbsp;&nbsp;
+      <a href="#M000546">container</a>&nbsp;&nbsp;
+      <a href="#M000547">container_has_block?</a>&nbsp;&nbsp;
+      <a href="#M000545">current_page</a>&nbsp;&nbsp;
+      <a href="#M000544">page_title</a>&nbsp;&nbsp;
+      <a href="#M000549">render_breadcrumbs</a>&nbsp;&nbsp;
+      <a href="#M000550">render_portlet</a>&nbsp;&nbsp;
       </div>
     </div>
 
@@ -107,171 +109,256 @@
     <div id="methods">
       <h3 class="section-bar">Public Instance methods</h3>
 
-      <div id="method-M000503" class="method-detail">
-        <a name="M000503"></a>
+      <div id="method-M000551" class="method-detail">
+        <a name="M000551"></a>
 
         <div class="method-heading">
-          <a href="#M000503" class="method-signature">
+          <a href="#M000551" class="method-signature">
+          <span class="method-name">able_to?</span><span class="method-args">(*perms) {|if current_user.able_to?(*perms)| ...}</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+Determines if the current_user is able to do specific permissions.
+</p>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000551-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000551-source">
+<pre>
+    <span class="ruby-comment cmt"># File app/helpers/cms/page_helper.rb, line 87</span>
+87:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">able_to?</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">perms</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
+88:       <span class="ruby-keyword kw">yield</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">current_user</span>.<span class="ruby-identifier">able_to?</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">perms</span>)
+89:     <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+
+      <div id="method-M000548" class="method-detail">
+        <a name="M000548"></a>
+
+        <div class="method-heading">
+          <a href="#M000548" class="method-signature">
           <span class="method-name">cms_toolbar</span><span class="method-args">()</span>
           </a>
         </div>
       
         <div class="method-description">
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000503-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000503-source">
+            onclick="toggleCode('M000548-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000548-source">
 <pre>
-    <span class="ruby-comment cmt"># File app/helpers/cms/page_helper.rb, line 26</span>
-26:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">cms_toolbar</span>
-27:       <span class="ruby-identifier">instance_variable_get</span>(<span class="ruby-value str">&quot;@content_for_layout&quot;</span>)
-28:     <span class="ruby-keyword kw">end</span>
+    <span class="ruby-comment cmt"># File app/helpers/cms/page_helper.rb, line 34</span>
+34:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">cms_toolbar</span>
+35:       <span class="ruby-identifier">instance_variable_get</span>(<span class="ruby-value str">&quot;@content_for_layout&quot;</span>)
+36:     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
 
-      <div id="method-M000501" class="method-detail">
-        <a name="M000501"></a>
+      <div id="method-M000546" class="method-detail">
+        <a name="M000546"></a>
 
         <div class="method-heading">
-          <a href="#M000501" class="method-signature">
+          <a href="#M000546" class="method-signature">
           <span class="method-name">container</span><span class="method-args">(name)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000501-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000501-source">
+            onclick="toggleCode('M000546-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000546-source">
 <pre>
-    <span class="ruby-comment cmt"># File app/helpers/cms/page_helper.rb, line 7</span>
- 7:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">container</span>(<span class="ruby-identifier">name</span>)
- 8:       <span class="ruby-identifier">content</span> = <span class="ruby-identifier">instance_variable_get</span>(<span class="ruby-node">&quot;@content_for_#{name}&quot;</span>)
- 9:       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">logged_in?</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-ivar">@mode</span> <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;edit&quot;</span>
-10:         <span class="ruby-identifier">render</span> <span class="ruby-identifier">:partial</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-value str">'cms/pages/edit_container'</span>, <span class="ruby-identifier">:locals</span> =<span class="ruby-operator">&gt;</span> {<span class="ruby-identifier">:name</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">name</span>, <span class="ruby-identifier">:content</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">content</span>}
-11:       <span class="ruby-keyword kw">else</span>
-12:         <span class="ruby-identifier">content</span>
-13:       <span class="ruby-keyword kw">end</span>
-14:     <span class="ruby-keyword kw">end</span>
+    <span class="ruby-comment cmt"># File app/helpers/cms/page_helper.rb, line 15</span>
+15:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">container</span>(<span class="ruby-identifier">name</span>)
+16:       <span class="ruby-identifier">content</span> = <span class="ruby-identifier">instance_variable_get</span>(<span class="ruby-node">&quot;@content_for_#{name}&quot;</span>)
+17:       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">logged_in?</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-ivar">@page</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-ivar">@mode</span> <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;edit&quot;</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">current_user</span>.<span class="ruby-identifier">able_to_edit?</span>(<span class="ruby-ivar">@page</span>)
+18:         <span class="ruby-identifier">render</span> <span class="ruby-identifier">:partial</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-value str">'cms/pages/edit_container'</span>, <span class="ruby-identifier">:locals</span> =<span class="ruby-operator">&gt;</span> {<span class="ruby-identifier">:name</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">name</span>, <span class="ruby-identifier">:content</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">content</span>}
+19:       <span class="ruby-keyword kw">else</span>
+20:         <span class="ruby-identifier">content</span>
+21:       <span class="ruby-keyword kw">end</span>
+22:     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
 
-      <div id="method-M000502" class="method-detail">
-        <a name="M000502"></a>
+      <div id="method-M000547" class="method-detail">
+        <a name="M000547"></a>
 
         <div class="method-heading">
-          <a href="#M000502" class="method-signature">
+          <a href="#M000547" class="method-signature">
           <span class="method-name">container_has_block?</span><span class="method-args">(name, &amp;block)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000502-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000502-source">
+            onclick="toggleCode('M000547-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000547-source">
 <pre>
-    <span class="ruby-comment cmt"># File app/helpers/cms/page_helper.rb, line 16</span>
-16:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">container_has_block?</span>(<span class="ruby-identifier">name</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
-17:       <span class="ruby-identifier">has_block</span> = (<span class="ruby-ivar">@mode</span> <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;edit&quot;</span>) <span class="ruby-operator">||</span> <span class="ruby-identifier">current_page</span>.<span class="ruby-identifier">connectable_count_for_container</span>(<span class="ruby-identifier">name</span>) <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span>
-18:       <span class="ruby-identifier">logger</span>.<span class="ruby-identifier">info</span> <span class="ruby-node">&quot;mode = #{@mode}, has_block = #{has_block}&quot;</span>
-19:       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">block_given?</span>
-20:         <span class="ruby-identifier">concat</span>(<span class="ruby-identifier">capture</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">has_block</span>
-21:       <span class="ruby-keyword kw">else</span>
-22:         <span class="ruby-identifier">has_block</span>
-23:       <span class="ruby-keyword kw">end</span>
-24:     <span class="ruby-keyword kw">end</span>
+    <span class="ruby-comment cmt"># File app/helpers/cms/page_helper.rb, line 24</span>
+24:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">container_has_block?</span>(<span class="ruby-identifier">name</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
+25:       <span class="ruby-identifier">has_block</span> = (<span class="ruby-ivar">@mode</span> <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;edit&quot;</span>) <span class="ruby-operator">||</span> <span class="ruby-identifier">current_page</span>.<span class="ruby-identifier">connectable_count_for_container</span>(<span class="ruby-identifier">name</span>) <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span>
+26:       <span class="ruby-identifier">logger</span>.<span class="ruby-identifier">info</span> <span class="ruby-node">&quot;mode = #{@mode}, has_block = #{has_block}&quot;</span>
+27:       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">block_given?</span>
+28:         <span class="ruby-identifier">concat</span>(<span class="ruby-identifier">capture</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">has_block</span>
+29:       <span class="ruby-keyword kw">else</span>
+30:         <span class="ruby-identifier">has_block</span>
+31:       <span class="ruby-keyword kw">end</span>
+32:     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
 
-      <div id="method-M000500" class="method-detail">
-        <a name="M000500"></a>
+      <div id="method-M000545" class="method-detail">
+        <a name="M000545"></a>
 
         <div class="method-heading">
-          <a href="#M000500" class="method-signature">
+          <a href="#M000545" class="method-signature">
           <span class="method-name">current_page</span><span class="method-args">()</span>
           </a>
         </div>
       
         <div class="method-description">
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000500-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000500-source">
+            onclick="toggleCode('M000545-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000545-source">
+<pre>
+    <span class="ruby-comment cmt"># File app/helpers/cms/page_helper.rb, line 11</span>
+11:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">current_page</span>
+12:       <span class="ruby-ivar">@page</span>
+13:     <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+
+      <div id="method-M000544" class="method-detail">
+        <a name="M000544"></a>
+
+        <div class="method-heading">
+          <a href="#M000544" class="method-signature">
+          <span class="method-name">page_title</span><span class="method-args">(*args)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000544-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000544-source">
 <pre>
    <span class="ruby-comment cmt"># File app/helpers/cms/page_helper.rb, line 3</span>
-3:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">current_page</span>
-4:       <span class="ruby-ivar">@page</span>
-5:     <span class="ruby-keyword kw">end</span>
+3:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">page_title</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>)
+4:       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">first</span>
+5:         <span class="ruby-ivar">@controller</span>.<span class="ruby-identifier">instance_variable_get</span>(<span class="ruby-value str">&quot;@template&quot;</span>).<span class="ruby-identifier">instance_variable_set</span>(<span class="ruby-value str">&quot;@page_title&quot;</span>, <span class="ruby-identifier">args</span>.<span class="ruby-identifier">first</span>)
+6:       <span class="ruby-keyword kw">else</span>
+7:         <span class="ruby-ivar">@controller</span>.<span class="ruby-identifier">instance_variable_get</span>(<span class="ruby-value str">&quot;@template&quot;</span>).<span class="ruby-identifier">instance_variable_get</span>(<span class="ruby-value str">&quot;@page_title&quot;</span>)
+8:       <span class="ruby-keyword kw">end</span>
+9:     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
 
-      <div id="method-M000504" class="method-detail">
-        <a name="M000504"></a>
+      <div id="method-M000549" class="method-detail">
+        <a name="M000549"></a>
 
         <div class="method-heading">
-          <a href="#M000504" class="method-signature">
+          <a href="#M000549" class="method-signature">
           <span class="method-name">render_breadcrumbs</span><span class="method-args">(options={})</span>
           </a>
         </div>
       
         <div class="method-description">
+          <p>
+Renders breadcrumbs based on the <a
+href="PageHelper.html#M000545">current_page</a>. This will generate an
+unordered list representing the current page and all it&#8216;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.
+</p>
+<p>
+If the <a href="PageHelper.html#M000545">current_page</a> is nil, it will
+return an empty string.
+</p>
+<h4>Params:</h4>
+<pre>
+  options = A hash of options which determine how the breadcrumbs will be laid out.
+</pre>
+<h4>Options:</h4>
+<ul>
+<li><tt>:from_top</tt> - 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.
+
+</li>
+<li><tt>:show_parent</tt> - 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 &#8216;last&#8217; breadcrumb link.
+(Note: This probably better renamed as &#8216;show_page&#8217;).
+
+</li>
+</ul>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000504-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000504-source">
+            onclick="toggleCode('M000549-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000549-source">
 <pre>
-    <span class="ruby-comment cmt"># File app/helpers/cms/page_helper.rb, line 30</span>
-30:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">render_breadcrumbs</span>(<span class="ruby-identifier">options</span>={})
-31:       <span class="ruby-identifier">start</span> = <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:from_top</span>] <span class="ruby-operator">||</span> <span class="ruby-value">0</span>
-32:       <span class="ruby-identifier">show_parent</span> = <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:show_parent</span>].<span class="ruby-identifier">nil?</span> <span class="ruby-value">? </span><span class="ruby-keyword kw">false</span> <span class="ruby-operator">:</span> <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:show_parent</span>]
-33:       <span class="ruby-identifier">ancestors</span> = <span class="ruby-identifier">current_page</span>.<span class="ruby-identifier">ancestors</span>
-34:       <span class="ruby-identifier">items</span> = []
-35:       <span class="ruby-identifier">ancestors</span>[<span class="ruby-identifier">start</span><span class="ruby-operator">..</span><span class="ruby-identifier">ancestors</span>.<span class="ruby-identifier">size</span>].<span class="ruby-identifier">each_with_index</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">sec</span>,<span class="ruby-identifier">i</span><span class="ruby-operator">|</span>
-36:         <span class="ruby-identifier">items</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">content_tag</span>(<span class="ruby-identifier">:li</span>, 
-37:           <span class="ruby-identifier">link_to</span>(<span class="ruby-identifier">h</span>(<span class="ruby-identifier">sec</span>.<span class="ruby-identifier">name</span>), <span class="ruby-identifier">sec</span>.<span class="ruby-identifier">actual_path</span>), 
-38:           (<span class="ruby-identifier">i</span> <span class="ruby-operator">==</span> <span class="ruby-value">0</span> <span class="ruby-operator">?</span> {<span class="ruby-identifier">:class</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-value str">&quot;first&quot;</span>} <span class="ruby-operator">:</span> {}))
-39:       <span class="ruby-keyword kw">end</span>
-40:       <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-identifier">show_parent</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">current_page</span>.<span class="ruby-identifier">section</span>.<span class="ruby-identifier">path</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">current_page</span>.<span class="ruby-identifier">path</span>
-41:         <span class="ruby-identifier">items</span>[<span class="ruby-identifier">items</span>.<span class="ruby-identifier">size</span><span class="ruby-operator">-</span><span class="ruby-value">1</span>] = <span class="ruby-identifier">content_tag</span>(<span class="ruby-identifier">:li</span>, <span class="ruby-identifier">h</span>(<span class="ruby-identifier">current_page</span>.<span class="ruby-identifier">section</span>.<span class="ruby-identifier">name</span>))
-42:       <span class="ruby-keyword kw">else</span>
-43:         <span class="ruby-identifier">items</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">content_tag</span>(<span class="ruby-identifier">:li</span>, <span class="ruby-identifier">h</span>(<span class="ruby-identifier">current_page</span>.<span class="ruby-identifier">page_title</span>))
-44:       <span class="ruby-keyword kw">end</span>
-45:       <span class="ruby-identifier">content_tag</span>(<span class="ruby-identifier">:ul</span>, <span class="ruby-node">&quot;\n  #{items.join(&quot;\n  &quot;)}\n&quot;</span>, <span class="ruby-identifier">:class</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-value str">&quot;breadcrumbs&quot;</span>)
-46:     <span class="ruby-keyword kw">end</span>
+    <span class="ruby-comment cmt"># File app/helpers/cms/page_helper.rb, line 55</span>
+55:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">render_breadcrumbs</span>(<span class="ruby-identifier">options</span>={})
+56:       <span class="ruby-keyword kw">return</span> <span class="ruby-value str">&quot;&quot;</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">current_page</span>
+57: 
+58:       <span class="ruby-identifier">start</span> = <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:from_top</span>] <span class="ruby-operator">||</span> <span class="ruby-value">0</span>
+59:       <span class="ruby-identifier">show_parent</span> = <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:show_parent</span>].<span class="ruby-identifier">nil?</span> <span class="ruby-value">? </span><span class="ruby-keyword kw">false</span> <span class="ruby-operator">:</span> <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:show_parent</span>]
+60:       <span class="ruby-identifier">ancestors</span> = <span class="ruby-identifier">current_page</span>.<span class="ruby-identifier">ancestors</span>
+61:       <span class="ruby-identifier">items</span> = []
+62:       <span class="ruby-identifier">ancestors</span>[<span class="ruby-identifier">start</span><span class="ruby-operator">..</span><span class="ruby-identifier">ancestors</span>.<span class="ruby-identifier">size</span>].<span class="ruby-identifier">each_with_index</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">sec</span>,<span class="ruby-identifier">i</span><span class="ruby-operator">|</span>
+63:         <span class="ruby-identifier">items</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">content_tag</span>(<span class="ruby-identifier">:li</span>, 
+64:           <span class="ruby-identifier">link_to</span>(<span class="ruby-identifier">h</span>(<span class="ruby-identifier">sec</span>.<span class="ruby-identifier">name</span>), <span class="ruby-identifier">sec</span>.<span class="ruby-identifier">actual_path</span>), 
+65:           (<span class="ruby-identifier">i</span> <span class="ruby-operator">==</span> <span class="ruby-value">0</span> <span class="ruby-operator">?</span> {<span class="ruby-identifier">:class</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-value str">&quot;first&quot;</span>} <span class="ruby-operator">:</span> {}))
+66:       <span class="ruby-keyword kw">end</span>
+67:       <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-identifier">show_parent</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">current_page</span>.<span class="ruby-identifier">section</span>.<span class="ruby-identifier">path</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">current_page</span>.<span class="ruby-identifier">path</span>
+68:         <span class="ruby-identifier">items</span>[<span class="ruby-identifier">items</span>.<span class="ruby-identifier">size</span><span class="ruby-operator">-</span><span class="ruby-value">1</span>] = <span class="ruby-identifier">content_tag</span>(<span class="ruby-identifier">:li</span>, <span class="ruby-identifier">h</span>(<span class="ruby-identifier">current_page</span>.<span class="ruby-identifier">section</span>.<span class="ruby-identifier">name</span>))
+69:       <span class="ruby-keyword kw">else</span>
+70:         <span class="ruby-identifier">items</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">content_tag</span>(<span class="ruby-identifier">:li</span>, <span class="ruby-identifier">h</span>(<span class="ruby-identifier">current_page</span>.<span class="ruby-identifier">page_title</span>))
+71:       <span class="ruby-keyword kw">end</span>
+72:       <span class="ruby-identifier">content_tag</span>(<span class="ruby-identifier">:ul</span>, <span class="ruby-node">&quot;\n  #{items.join(&quot;\n  &quot;)}\n&quot;</span>, <span class="ruby-identifier">:class</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-value str">&quot;breadcrumbs&quot;</span>)
+73:     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
 
-      <div id="method-M000505" class="method-detail">
-        <a name="M000505"></a>
+      <div id="method-M000550" class="method-detail">
+        <a name="M000550"></a>
 
         <div class="method-heading">
-          <a href="#M000505" class="method-signature">
+          <a href="#M000550" class="method-signature">
           <span class="method-name">render_portlet</span><span class="method-args">(name)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000505-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000505-source">
+            onclick="toggleCode('M000550-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000550-source">
 <pre>
-    <span class="ruby-comment cmt"># File app/helpers/cms/page_helper.rb, line 48</span>
-48:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">render_portlet</span>(<span class="ruby-identifier">name</span>)
-49:       <span class="ruby-identifier">portlets</span> = <span class="ruby-constant">Portlet</span>.<span class="ruby-identifier">all</span>(<span class="ruby-identifier">:conditions</span> =<span class="ruby-operator">&gt;</span> [<span class="ruby-value str">&quot;name = ?&quot;</span>, <span class="ruby-identifier">name</span>.<span class="ruby-identifier">to_s</span>])
-50:       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">portlets</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">1</span>
-51:         <span class="ruby-ivar">@mode</span> <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;edit&quot;</span> <span class="ruby-operator">?</span> <span class="ruby-node">&quot;ERROR: Multiple Portlets with name '#{name}'&quot;</span> <span class="ruby-operator">:</span> <span class="ruby-keyword kw">nil</span>
-52:       <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">portlets</span>.<span class="ruby-identifier">empty?</span>
-53:         <span class="ruby-ivar">@mode</span> <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;edit&quot;</span> <span class="ruby-operator">?</span> <span class="ruby-node">&quot;ERROR: No Portlet with name '#{name}'&quot;</span> <span class="ruby-operator">:</span> <span class="ruby-keyword kw">nil</span>
-54:       <span class="ruby-keyword kw">else</span>
-55:         <span class="ruby-identifier">render_connectable</span>(<span class="ruby-identifier">portlets</span>.<span class="ruby-identifier">first</span>)
-56:       <span class="ruby-keyword kw">end</span>
-57:     <span class="ruby-keyword kw">end</span>
+    <span class="ruby-comment cmt"># File app/helpers/cms/page_helper.rb, line 75</span>
+75:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">render_portlet</span>(<span class="ruby-identifier">name</span>)
+76:       <span class="ruby-identifier">portlets</span> = <span class="ruby-constant">Portlet</span>.<span class="ruby-identifier">all</span>(<span class="ruby-identifier">:conditions</span> =<span class="ruby-operator">&gt;</span> [<span class="ruby-value str">&quot;name = ?&quot;</span>, <span class="ruby-identifier">name</span>.<span class="ruby-identifier">to_s</span>])
+77:       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">portlets</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">1</span>
+78:         <span class="ruby-ivar">@mode</span> <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;edit&quot;</span> <span class="ruby-operator">?</span> <span class="ruby-node">&quot;ERROR: Multiple Portlets with name '#{name}'&quot;</span> <span class="ruby-operator">:</span> <span class="ruby-keyword kw">nil</span>
+79:       <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">portlets</span>.<span class="ruby-identifier">empty?</span>
+80:         <span class="ruby-ivar">@mode</span> <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;edit&quot;</span> <span class="ruby-operator">?</span> <span class="ruby-node">&quot;ERROR: No Portlet with name '#{name}'&quot;</span> <span class="ruby-operator">:</span> <span class="ruby-keyword kw">nil</span>
+81:       <span class="ruby-keyword kw">else</span>
+82:         <span class="ruby-identifier">render_connectable</span>(<span class="ruby-identifier">portlets</span>.<span class="ruby-identifier">first</span>)
+83:       <span class="ruby-keyword kw">end</span>
+84:     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>