RubyGems - browsercms - Versions diffs - 3.4.0.rc2 → 3.4.0 - Mend

browsercms 3.4.0.rc2 → 3.4.0

Files changed (776) hide show

data/doc/app/classes/Cms/Behaviors/InstanceMethods.html DELETED Viewed

@@ -1,287 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!DOCTYPE html
-     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
-<head>
-  <title>Module: Cms::Behaviors::InstanceMethods</title>
-  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-  <meta http-equiv="Content-Script-Type" content="text/javascript" />
-  <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
-  <script type="text/javascript">
-  // <![CDATA[
-  function popupCode( url ) {
-    window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
-  }
-  function toggleCode( id ) {
-    if ( document.getElementById )
-      elem = document.getElementById( id );
-    else if ( document.all )
-      elem = eval( "document.all." + id );
-    else
-      return false;
-    elemStyle = elem.style;
-    if ( elemStyle.display != "block" ) {
-      elemStyle.display = "block"
-    } else {
-      elemStyle.display = "none"
-    }
-    return true;
-  }
-  // Make codeblocks hidden by default
-  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
-  // ]]>
-  </script>
-</head>
-<body>
-    <div id="classHeader">
-        <table class="header-table">
-        <tr class="top-aligned-row">
-          <td><strong>Module</strong></td>
-          <td class="class-name-in-header">Cms::Behaviors::InstanceMethods</td>
-        </tr>
-        <tr class="top-aligned-row">
-            <td><strong>In:</strong></td>
-            <td>
-                <a href="../../../files/lib/cms/behaviors/rendering_rb.html">
-                lib/cms/behaviors/rendering.rb
-                </a>
-        <br />
-            </td>
-        </tr>
-        </table>
-    </div>
-  <!-- banner header -->
-  <div id="bodyContent">
-  <div id="contextContent">
-   </div>
-    <div id="method-list">
-      <h3 class="section-bar">Methods</h3>
-      <div class="name-list">
-      <a href="#M000452">assigns_for_view</a>&nbsp;&nbsp;
-      <a href="#M000451">copy_instance_variables_from_controller!</a>&nbsp;&nbsp;
-      <a href="#M000449">perform_render</a>&nbsp;&nbsp;
-      <a href="#M000448">prepare_to_render</a>&nbsp;&nbsp;
-      <a href="#M000450">render_exception=</a>&nbsp;&nbsp;
-      </div>
-    </div>
-  </div>
-    <!-- if includes -->
-    <div id="section">
-    <!-- if method_list -->
-    <div id="methods">
-      <h3 class="section-bar">Public Instance methods</h3>
-      <div id="method-M000449" class="method-detail">
-        <a name="M000449"></a>
-        <div class="method-heading">
-          <a href="#M000449" class="method-signature">
-          <span class="method-name">perform_render</span><span class="method-args">(controller)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000449-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000449-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/cms/behaviors/rendering.rb, line 99</span>
- 99:       <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">perform_render</span>(<span class="ruby-identifier">controller</span>)
-100:         <span class="ruby-keyword kw">return</span> <span class="ruby-node">&quot;Exception: #{@render_exception}&quot;</span> <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@render_exception</span>
-101:         <span class="ruby-keyword kw">unless</span> <span class="ruby-ivar">@controller</span>
-102:           <span class="ruby-comment cmt"># We haven't prepared to render. This should only happen when logged in, as we don't want</span>
-103:           <span class="ruby-comment cmt"># errors to bubble up and prevent the page being edited in that case.</span>
-104:           <span class="ruby-identifier">prepare_to_render</span>(<span class="ruby-identifier">controller</span>)
-105:         <span class="ruby-keyword kw">end</span>
-106:
-107:         <span class="ruby-comment cmt"># Create, Instantiate and Initialize the view</span>
-108:         <span class="ruby-identifier">view_class</span>  = <span class="ruby-constant">Class</span>.<span class="ruby-identifier">new</span>(<span class="ruby-constant">ActionView</span><span class="ruby-operator">::</span><span class="ruby-constant">Base</span>)
-109:         <span class="ruby-identifier">action_view</span> = <span class="ruby-identifier">view_class</span>.<span class="ruby-identifier">new</span>(<span class="ruby-ivar">@controller</span>.<span class="ruby-identifier">view_paths</span>, {}, <span class="ruby-ivar">@controller</span>)
-110:
-111:         <span class="ruby-comment cmt"># Make helpers and instance vars available</span>
-112:         <span class="ruby-identifier">view_class</span>.<span class="ruby-identifier">send</span>(<span class="ruby-identifier">:include</span>, <span class="ruby-ivar">@controller</span>.<span class="ruby-identifier">class</span>.<span class="ruby-identifier">master_helper_module</span>)
-113:         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">$:</span>.<span class="ruby-identifier">detect</span>{<span class="ruby-operator">|</span><span class="ruby-identifier">d</span><span class="ruby-operator">|</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">exists?</span>(<span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span>(<span class="ruby-identifier">d</span>, <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">class</span>.<span class="ruby-identifier">helper_path</span>))}
-114:           <span class="ruby-identifier">view_class</span>.<span class="ruby-identifier">send</span>(<span class="ruby-identifier">:include</span>, <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">class</span>.<span class="ruby-identifier">helper_class</span>)
-115:         <span class="ruby-keyword kw">end</span>
-116:
-117:         <span class="ruby-comment cmt"># We want content_for to be called on the controller's view, not this inner view</span>
-118:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">action_view</span>.<span class="ruby-identifier">content_for</span>(<span class="ruby-identifier">name</span>, <span class="ruby-identifier">content</span>=<span class="ruby-keyword kw">nil</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
-119:           <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">content_for</span>(<span class="ruby-identifier">name</span>, <span class="ruby-identifier">content</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
-120:         <span class="ruby-keyword kw">end</span>
-121:
-122:         <span class="ruby-comment cmt"># Copy instance variables from this renderable object to it's view</span>
-123:         <span class="ruby-identifier">action_view</span>.<span class="ruby-identifier">assigns</span> = <span class="ruby-identifier">assigns_for_view</span>
-124:
-125:         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">respond_to?</span>(<span class="ruby-identifier">:inline_options</span>) <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">inline_options</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">inline_options</span>.<span class="ruby-identifier">has_key?</span>(<span class="ruby-identifier">:inline</span>)
-126:           <span class="ruby-identifier">options</span> = {<span class="ruby-identifier">:locals</span> =<span class="ruby-operator">&gt;</span> {}}.<span class="ruby-identifier">merge</span>(<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">inline_options</span>)
-127:           <span class="ruby-constant">ActionView</span><span class="ruby-operator">::</span><span class="ruby-constant">InlineTemplate</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">options</span>[<span class="ruby-identifier">:inline</span>], <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:type</span>]).<span class="ruby-identifier">render</span>(<span class="ruby-identifier">action_view</span>, <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:locals</span>])
-128:         <span class="ruby-keyword kw">else</span>
-129:           <span class="ruby-identifier">action_view</span>.<span class="ruby-identifier">render</span>(<span class="ruby-identifier">:file</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">class</span>.<span class="ruby-identifier">template_path</span>)
-130:         <span class="ruby-keyword kw">end</span>
-131:       <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000448" class="method-detail">
-        <a name="M000448"></a>
-        <div class="method-heading">
-          <a href="#M000448" class="method-signature">
-          <span class="method-name">prepare_to_render</span><span class="method-args">(controller)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000448-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000448-source">
-<pre>
-    <span class="ruby-comment cmt"># File lib/cms/behaviors/rendering.rb, line 84</span>
-84:       <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">prepare_to_render</span>(<span class="ruby-identifier">controller</span>)
-85:         <span class="ruby-comment cmt"># Give this renderable a reference to the controller</span>
-86:         <span class="ruby-ivar">@controller</span> = <span class="ruby-identifier">controller</span>
-87:
-88:         <span class="ruby-identifier">copy_instance_variables_from_controller!</span>
-89:
-90:         <span class="ruby-comment cmt"># This gives the view a reference to this object</span>
-91:         <span class="ruby-identifier">instance_variable_set</span>(<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">class</span>.<span class="ruby-identifier">instance_variable_name_for_view</span>, <span class="ruby-keyword kw">self</span>)
-92:
-93:         <span class="ruby-comment cmt"># This is like a controller action</span>
-94:         <span class="ruby-comment cmt"># We will call it if you have defined a render method</span>
-95:         <span class="ruby-comment cmt"># but if you haven't we won't</span>
-96:         <span class="ruby-identifier">render</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">respond_to?</span>(<span class="ruby-identifier">:render</span>)
-97:       <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000450" class="method-detail">
-        <a name="M000450"></a>
-        <div class="method-heading">
-          <a href="#M000450" class="method-signature">
-          <span class="method-name">render_exception=</span><span class="method-args">(exception)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000450-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000450-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/cms/behaviors/rendering.rb, line 133</span>
-133:       <span class="ruby-keyword kw">def</span>  <span class="ruby-identifier">render_exception=</span><span class="ruby-identifier">render_exception=</span>(<span class="ruby-identifier">exception</span>)
-134:         <span class="ruby-ivar">@render_exception</span> = <span class="ruby-identifier">exception</span>
-135:       <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <h3 class="section-bar">Protected Instance methods</h3>
-      <div id="method-M000452" class="method-detail">
-        <a name="M000452"></a>
-        <div class="method-heading">
-          <a href="#M000452" class="method-signature">
-          <span class="method-name">assigns_for_view</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000452-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000452-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/cms/behaviors/rendering.rb, line 147</span>
-147:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">assigns_for_view</span>
-148:           (<span class="ruby-identifier">instance_variables</span> <span class="ruby-operator">-</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">class</span>.<span class="ruby-identifier">ivars_to_ignore</span>).<span class="ruby-identifier">inject</span>({}) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">h</span>,<span class="ruby-identifier">k</span><span class="ruby-operator">|</span>
-149:             <span class="ruby-identifier">h</span>[<span class="ruby-identifier">k</span>[<span class="ruby-value">1</span><span class="ruby-operator">..</span><span class="ruby-value">-1</span>]] = <span class="ruby-identifier">instance_variable_get</span>(<span class="ruby-identifier">k</span>)
-150:             <span class="ruby-identifier">h</span>
-151:           <span class="ruby-keyword kw">end</span>
-152:         <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000451" class="method-detail">
-        <a name="M000451"></a>
-        <div class="method-heading">
-          <a href="#M000451" class="method-signature">
-          <span class="method-name">copy_instance_variables_from_controller!</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000451-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000451-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/cms/behaviors/rendering.rb, line 138</span>
-138:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">copy_instance_variables_from_controller!</span>
-139:           <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@controller</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-identifier">:instance_variables_for_rendering</span>)
-140:             <span class="ruby-ivar">@controller</span>.<span class="ruby-identifier">instance_variables_for_rendering</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">iv</span><span class="ruby-operator">|</span>
-141:               <span class="ruby-comment cmt">#logger.info &quot;Copying #{iv} =&gt; #{@controller.instance_variable_get(iv).inspect}&quot;</span>
-142:               <span class="ruby-identifier">instance_variable_set</span>(<span class="ruby-identifier">iv</span>, <span class="ruby-ivar">@controller</span>.<span class="ruby-identifier">instance_variable_get</span>(<span class="ruby-identifier">iv</span>))
-143:             <span class="ruby-keyword kw">end</span>
-144:           <span class="ruby-keyword kw">end</span>
-145:         <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-    </div>
-  </div>
-<div id="validator-badges">
-  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
-</div>
-</body>
-</html>

data/doc/app/classes/Cms/Behaviors/Pagination.html DELETED Viewed

@@ -1,151 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!DOCTYPE html
-     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
-<head>
-  <title>Module: Cms::Behaviors::Pagination</title>
-  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-  <meta http-equiv="Content-Script-Type" content="text/javascript" />
-  <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
-  <script type="text/javascript">
-  // <![CDATA[
-  function popupCode( url ) {
-    window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
-  }
-  function toggleCode( id ) {
-    if ( document.getElementById )
-      elem = document.getElementById( id );
-    else if ( document.all )
-      elem = eval( "document.all." + id );
-    else
-      return false;
-    elemStyle = elem.style;
-    if ( elemStyle.display != "block" ) {
-      elemStyle.display = "block"
-    } else {
-      elemStyle.display = "none"
-    }
-    return true;
-  }
-  // Make codeblocks hidden by default
-  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
-  // ]]>
-  </script>
-</head>
-<body>
-    <div id="classHeader">
-        <table class="header-table">
-        <tr class="top-aligned-row">
-          <td><strong>Module</strong></td>
-          <td class="class-name-in-header">Cms::Behaviors::Pagination</td>
-        </tr>
-        <tr class="top-aligned-row">
-            <td><strong>In:</strong></td>
-            <td>
-                <a href="../../../files/lib/cms/behaviors/pagination_rb.html">
-                lib/cms/behaviors/pagination.rb
-                </a>
-        <br />
-            </td>
-        </tr>
-        </table>
-    </div>
-  <!-- banner header -->
-  <div id="bodyContent">
-  <div id="contextContent">
-   </div>
-    <div id="method-list">
-      <h3 class="section-bar">Methods</h3>
-      <div class="name-list">
-      <a href="#M000436">included</a>&nbsp;&nbsp;
-      </div>
-    </div>
-  </div>
-    <!-- if includes -->
-    <div id="section">
-    <div id="class-list">
-      <h3 class="section-bar">Classes and Modules</h3>
-      Module <a href="Pagination/ClassMethods.html" class="link">Cms::Behaviors::Pagination::ClassMethods</a><br />
-Class <a href="Pagination/Collection.html" class="link">Cms::Behaviors::Pagination::Collection</a><br />
-Class <a href="Pagination/InvalidPage.html" class="link">Cms::Behaviors::Pagination::InvalidPage</a><br />
-    </div>
-    <!-- if method_list -->
-    <div id="methods">
-      <h3 class="section-bar">Public Class methods</h3>
-      <div id="method-M000436" class="method-detail">
-        <a name="M000436"></a>
-        <div class="method-heading">
-          <a href="#M000436" class="method-signature">
-          <span class="method-name">included</span><span class="method-args">(model_class)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000436-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000436-source">
-<pre>
-    <span class="ruby-comment cmt"># File lib/cms/behaviors/pagination.rb, line 5</span>
- 5:       <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">included</span>(<span class="ruby-identifier">model_class</span>)
- 6:         <span class="ruby-identifier">model_class</span>.<span class="ruby-identifier">extend</span>(<span class="ruby-constant">ClassMethods</span>)
- 7:         <span class="ruby-keyword kw">class</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">model_class</span>
- 8:           <span class="ruby-identifier">define_method</span>(<span class="ruby-identifier">:default_per_page</span>) { <span class="ruby-value">15</span> }
- 9:         <span class="ruby-keyword kw">end</span>
-10:       <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-    </div>
-  </div>
-<div id="validator-badges">
-  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
-</div>
-</body>
-</html>

data/doc/app/classes/Cms/Behaviors/Pagination/ClassMethods.html DELETED Viewed

@@ -1,252 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!DOCTYPE html
-     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
-<head>
-  <title>Module: Cms::Behaviors::Pagination::ClassMethods</title>
-  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-  <meta http-equiv="Content-Script-Type" content="text/javascript" />
-  <link rel="stylesheet" href="../../../.././rdoc-style.css" type="text/css" media="screen" />
-  <script type="text/javascript">
-  // <![CDATA[
-  function popupCode( url ) {
-    window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
-  }
-  function toggleCode( id ) {
-    if ( document.getElementById )
-      elem = document.getElementById( id );
-    else if ( document.all )
-      elem = eval( "document.all." + id );
-    else
-      return false;
-    elemStyle = elem.style;
-    if ( elemStyle.display != "block" ) {
-      elemStyle.display = "block"
-    } else {
-      elemStyle.display = "none"
-    }
-    return true;
-  }
-  // Make codeblocks hidden by default
-  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
-  // ]]>
-  </script>
-</head>
-<body>
-    <div id="classHeader">
-        <table class="header-table">
-        <tr class="top-aligned-row">
-          <td><strong>Module</strong></td>
-          <td class="class-name-in-header">Cms::Behaviors::Pagination::ClassMethods</td>
-        </tr>
-        <tr class="top-aligned-row">
-            <td><strong>In:</strong></td>
-            <td>
-                <a href="../../../../files/lib/cms/behaviors/pagination_rb.html">
-                lib/cms/behaviors/pagination.rb
-                </a>
-        <br />
-            </td>
-        </tr>
-        </table>
-    </div>
-  <!-- banner header -->
-  <div id="bodyContent">
-  <div id="contextContent">
-   </div>
-    <div id="method-list">
-      <h3 class="section-bar">Methods</h3>
-      <div class="name-list">
-      <a href="#M000438">count_for_pagination</a>&nbsp;&nbsp;
-      <a href="#M000437">paginate</a>&nbsp;&nbsp;
-      </div>
-    </div>
-  </div>
-    <!-- if includes -->
-    <div id="section">
-    <!-- if method_list -->
-    <div id="methods">
-      <h3 class="section-bar">Public Instance methods</h3>
-      <div id="method-M000437" class="method-detail">
-        <a name="M000437"></a>
-        <div class="method-heading">
-          <a href="#M000437" class="method-signature">
-          <span class="method-name">paginate</span><span class="method-args">(*args, &amp;block)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-This is the main paginating finder.
-</p>
-<h2>Special parameters for paginating finders</h2>
-<ul>
-<li><tt>:page</tt> &#8212; REQUIRED, but defaults to 1 if false or nil
-</li>
-<li><tt>:per_page</tt> &#8212; defaults to <tt>CurrentModel.per_page</tt>
-(which is 30 if not overridden)
-</li>
-<li><tt>:total_entries</tt> &#8212; use only if you manually count total
-entries
-</li>
-<li><tt>:count</tt> &#8212; additional options that are passed on to
-<tt>count</tt>
-</li>
-<li><tt>:finder</tt> &#8212; name of the <a
-href="../../../ActiveRecord.html">ActiveRecord</a> finder used (default:
-&quot;find&quot;)
-</li>
-</ul>
-<p>
-All other options (<tt>conditions</tt>, <tt>order</tt>, &#8230;) are
-forwarded to <tt>find</tt> and <tt>count</tt> calls.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000437-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000437-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/cms/behaviors/pagination.rb, line 131</span>
-131:         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">paginate</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
-132:           <span class="ruby-identifier">options</span> = <span class="ruby-identifier">args</span>.<span class="ruby-identifier">pop</span>
-133:           <span class="ruby-identifier">page</span>, <span class="ruby-identifier">per_page</span>, <span class="ruby-identifier">total_entries</span> = <span class="ruby-identifier">parse_pagination_options</span>(<span class="ruby-identifier">options</span>)
-134:
-135:           <span class="ruby-identifier">finder</span> = (<span class="ruby-identifier">options</span>[<span class="ruby-identifier">:finder</span>] <span class="ruby-operator">||</span> <span class="ruby-value str">'find'</span>).<span class="ruby-identifier">to_s</span>
-136:           <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">finder</span> <span class="ruby-operator">==</span> <span class="ruby-value str">'find'</span>
-137:             <span class="ruby-comment cmt"># an array of IDs may have been given:</span>
-138:             <span class="ruby-identifier">total_entries</span> <span class="ruby-operator">||=</span> (<span class="ruby-constant">Array</span> <span class="ruby-operator">===</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">first</span> <span class="ruby-keyword kw">and</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">first</span>.<span class="ruby-identifier">size</span>)
-139:             <span class="ruby-comment cmt"># :all is implicit</span>
-140:             <span class="ruby-identifier">args</span>.<span class="ruby-identifier">unshift</span>(<span class="ruby-identifier">:all</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">empty?</span>
-141:           <span class="ruby-keyword kw">end</span>
-142:
-143:           <span class="ruby-constant">Collection</span>.<span class="ruby-identifier">create</span>(<span class="ruby-identifier">page</span>, <span class="ruby-identifier">per_page</span>, <span class="ruby-identifier">total_entries</span>) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">pager</span><span class="ruby-operator">|</span>
-144:             <span class="ruby-identifier">count_options</span> = <span class="ruby-identifier">options</span>.<span class="ruby-identifier">except</span> <span class="ruby-identifier">:page</span>, <span class="ruby-identifier">:per_page</span>, <span class="ruby-identifier">:total_entries</span>, <span class="ruby-identifier">:finder</span>
-145:             <span class="ruby-identifier">find_options</span> = <span class="ruby-identifier">count_options</span>.<span class="ruby-identifier">except</span>(<span class="ruby-identifier">:count</span>).<span class="ruby-identifier">update</span>(<span class="ruby-identifier">:offset</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">pager</span>.<span class="ruby-identifier">offset</span>, <span class="ruby-identifier">:limit</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">pager</span>.<span class="ruby-identifier">per_page</span>)
-146:
-147:             <span class="ruby-identifier">args</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">find_options</span>
-148:             <span class="ruby-comment cmt"># @options_from_last_find = nil</span>
-149:             <span class="ruby-identifier">pager</span>.<span class="ruby-identifier">replace</span> <span class="ruby-identifier">send</span>(<span class="ruby-identifier">finder</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">args</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
-150:
-151:             <span class="ruby-comment cmt"># magic counting for user convenience:</span>
-152:             <span class="ruby-identifier">pager</span>.<span class="ruby-identifier">total_entries</span> = <span class="ruby-identifier">count_for_pagination</span>(<span class="ruby-identifier">count_options</span>, <span class="ruby-identifier">args</span>, <span class="ruby-identifier">finder</span>) <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">pager</span>.<span class="ruby-identifier">total_entries</span>
-153:           <span class="ruby-keyword kw">end</span>
-154:         <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <h3 class="section-bar">Protected Instance methods</h3>
-      <div id="method-M000438" class="method-detail">
-        <a name="M000438"></a>
-        <div class="method-heading">
-          <a href="#M000438" class="method-signature">
-          <span class="method-name">count_for_pagination</span><span class="method-args">(options, args, finder)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Does the not-so-trivial job of finding out the total number of entries in
-the database. It relies on the <a
-href="../../../ActiveRecord.html">ActiveRecord</a> <tt>count</tt> method.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000438-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000438-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/cms/behaviors/pagination.rb, line 158</span>
-158:           <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">count_for_pagination</span>(<span class="ruby-identifier">options</span>, <span class="ruby-identifier">args</span>, <span class="ruby-identifier">finder</span>)
-159:             <span class="ruby-identifier">excludees</span> = [<span class="ruby-identifier">:count</span>, <span class="ruby-identifier">:order</span>, <span class="ruby-identifier">:limit</span>, <span class="ruby-identifier">:offset</span>, <span class="ruby-identifier">:readonly</span>]
-160:             <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:select</span>] <span class="ruby-keyword kw">and</span> <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:select</span>] <span class="ruby-operator">=~</span> <span class="ruby-regexp re">/^\s*DISTINCT\b/i</span>
-161:               <span class="ruby-identifier">excludees</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">:select</span> <span class="ruby-comment cmt"># only exclude the select param if it doesn't begin with DISTINCT</span>
-162:             <span class="ruby-keyword kw">end</span>
-163:             <span class="ruby-comment cmt"># count expects (almost) the same options as find</span>
-164:             <span class="ruby-identifier">count_options</span> = <span class="ruby-identifier">options</span>.<span class="ruby-identifier">except</span> <span class="ruby-operator">*</span><span class="ruby-identifier">excludees</span>
-165:
-166:             <span class="ruby-comment cmt"># merge the hash found in :count</span>
-167:             <span class="ruby-comment cmt"># this allows you to specify :select, :order, or anything else just for the count query</span>
-168:             <span class="ruby-identifier">count_options</span>.<span class="ruby-identifier">update</span> <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:count</span>] <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:count</span>]
-169:
-170:             <span class="ruby-comment cmt"># we may have to scope ...</span>
-171:             <span class="ruby-identifier">counter</span> = <span class="ruby-constant">Proc</span>.<span class="ruby-identifier">new</span> { <span class="ruby-identifier">count</span>(<span class="ruby-identifier">count_options</span>) }
-172:
-173:             <span class="ruby-comment cmt"># we may be in a model or an association proxy!</span>
-174:             <span class="ruby-identifier">klass</span> = (<span class="ruby-ivar">@owner</span> <span class="ruby-keyword kw">and</span> <span class="ruby-ivar">@reflection</span>) <span class="ruby-operator">?</span> <span class="ruby-ivar">@reflection</span>.<span class="ruby-identifier">klass</span> <span class="ruby-operator">:</span> <span class="ruby-keyword kw">self</span>
-175:
-176:             <span class="ruby-identifier">count</span> = <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">finder</span>.<span class="ruby-identifier">index</span>(<span class="ruby-value str">'find_'</span>) <span class="ruby-operator">==</span> <span class="ruby-value">0</span> <span class="ruby-keyword kw">and</span> <span class="ruby-identifier">klass</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-identifier">scoper</span> = <span class="ruby-identifier">finder</span>.<span class="ruby-identifier">sub</span>(<span class="ruby-value str">'find'</span>, <span class="ruby-value str">'with'</span>))
-177:                       <span class="ruby-comment cmt"># scope_out adds a 'with_finder' method which acts like with_scope, if it's present</span>
-178:                       <span class="ruby-comment cmt"># then execute the count with the scoping provided by the with_finder</span>
-179:                       <span class="ruby-identifier">send</span>(<span class="ruby-identifier">scoper</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">counter</span>)
-180:                     <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">match</span> = <span class="ruby-regexp re">/^find_(all_by|by)_([_a-zA-Z]\w*)$/</span>.<span class="ruby-identifier">match</span>(<span class="ruby-identifier">finder</span>)
-181:                       <span class="ruby-comment cmt"># extract conditions from calls like &quot;paginate_by_foo_and_bar&quot;</span>
-182:                       <span class="ruby-identifier">attribute_names</span> = <span class="ruby-identifier">extract_attribute_names_from_match</span>(<span class="ruby-identifier">match</span>)
-183:                       <span class="ruby-identifier">conditions</span> = <span class="ruby-identifier">construct_attributes_from_arguments</span>(<span class="ruby-identifier">attribute_names</span>, <span class="ruby-identifier">args</span>)
-184:                       <span class="ruby-identifier">with_scope</span>(<span class="ruby-identifier">:find</span> =<span class="ruby-operator">&gt;</span> { <span class="ruby-identifier">:conditions</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">conditions</span> }, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">counter</span>)
-185:                     <span class="ruby-keyword kw">else</span>
-186:                       <span class="ruby-identifier">counter</span>.<span class="ruby-identifier">call</span>
-187:                     <span class="ruby-keyword kw">end</span>
-188:
-189:             <span class="ruby-identifier">count</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-identifier">:length</span>) <span class="ruby-operator">?</span> <span class="ruby-identifier">count</span>.<span class="ruby-identifier">length</span> <span class="ruby-operator">:</span> <span class="ruby-identifier">count</span>
-190:           <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-    </div>
-  </div>
-<div id="validator-badges">
-  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
-</div>
-</body>
-</html>