0
@@ -96,11 +96,23 @@ module WillPaginate
0
       # render HTML for pagination
0
       renderer.to_html
0
     end
0
+
0
+    # Renders a helpful message with numbers of displayed vs. total entries.
0
+    # You can use this as a blueprint for your own, similar helpers.
0
+    #
0
+    #   <%= page_entries_info @posts %>
0
+    #   #-> Displaying entries 6 - 10 of 26 in total
0
+    def page_entries_info(collection)
0
+      %{Displaying entries <b>%d&nbsp;-&nbsp;%d</b> of <b>%d</b> in total} % [
0
+        collection.offset + 1,
0
+        collection.offset + collection.length,
0
+        collection.total_entries
0
+      ]
0
+    end
0
   end
0
 
0
   # This class does the heavy lifting of actually building the pagination
0
-  # links. It is used by +will_paginate+ helper internally, but avoid using it
0
-  # directly (for now) because its API is not set in stone yet.
0
+  # links. It is used by +will_paginate+ helper internally.
0
   class LinkRenderer
0
 
0
     def initialize(collection, options, template)

0
@@ -240,3 +240,18 @@ protected
0
     end
0
   end
0
 end
0
+
0
+class ViewHelpersTest < Test::Unit::TestCase
0
+  include WillPaginate::ViewHelpers
0
+
0
+  def test_page_entries_info
0
+    arr = ('a'..'z').to_a
0
+    collection = arr.paginate :page => 2, :per_page => 5
0
+    assert_equal %{Displaying entries <b>6&nbsp;-&nbsp;10</b> of <b>26</b> in total},
0
+      page_entries_info(collection)
0
+    
0
+    collection = arr.paginate :page => 7, :per_page => 4
0
+    assert_equal %{Displaying entries <b>25&nbsp;-&nbsp;26</b> of <b>26</b> in total},
0
+      page_entries_info(collection)
0
+  end
0
+end