summaryrefslogtreecommitdiff
path: root/vendor/plugins/will_paginate/README.rdoc
diff options
context:
space:
mode:
authorerdgeist <erdgeist@erdgeist.org>2026-06-24 04:13:16 +0200
committererdgeist <erdgeist@erdgeist.org>2026-06-24 04:13:16 +0200
commite0a7e0fec760ba12c8067a37e10c96f1f05876e2 (patch)
treed0cf745592a46aee4d4913911fd34c7c24515220 /vendor/plugins/will_paginate/README.rdoc
parent6424e10be5a89f175a74c71c55660412a169b8b8 (diff)
Stage 1 complete: Rails 2.3.5 to Rails 3.2.22.5 upgrade
- Converted plugins to gems (Gemfile) - Updated config structure (application.rb, boot.rb, environment.rb) - Converted routes to Rails 3 DSL - Converted named_scope to scope throughout models - Converted find(:all, :conditions) to where() chains - Fixed has_many :order to use ordering scope - Updated session store and secret token configuration - Fixed exception_notification middleware configuration - Patched Ruby 2.4 / Rails 3.2 incompatibilities: - Integer/Float duration arithmetic (ActiveSupport) - Arel visit_Integer for PostgreSQL adapter - create_database String/Integer coercion - ActionController consider_all_requests_local - Migrated taggings schema for acts-as-taggable-on - Replaced dynamic_form gem with custom form_error_messages helper - Fixed Rails 3 block helper syntax (form_for, form_tag, fields_for) - Fixed admin layout yield - Updated test suite for Rails 3 APIs
Diffstat (limited to 'vendor/plugins/will_paginate/README.rdoc')
-rw-r--r--vendor/plugins/will_paginate/README.rdoc107
1 files changed, 0 insertions, 107 deletions
diff --git a/vendor/plugins/will_paginate/README.rdoc b/vendor/plugins/will_paginate/README.rdoc
deleted file mode 100644
index 2a412f51..00000000
--- a/vendor/plugins/will_paginate/README.rdoc
+++ /dev/null
@@ -1,107 +0,0 @@
1= WillPaginate
2
3Pagination is just limiting the number of records displayed. Why should you let
4it get in your way while developing, then? This plugin makes magic happen. Did
5you ever want to be able to do just this on a model:
6
7 Post.paginate :page => 1, :order => 'created_at DESC'
8
9... and then render the page links with a single view helper? Well, now you
10can.
11
12Some resources to get you started:
13
14* {Installation instructions}[http://github.com/mislav/will_paginate/wikis/installation]
15 on {the wiki}[http://github.com/mislav/will_paginate/wikis]
16* Your mind reels with questions? Join our
17 {Google group}[http://groups.google.com/group/will_paginate].
18* {How to report bugs}[http://github.com/mislav/will_paginate/wikis/report-bugs]
19
20
21== Example usage
22
23Use a paginate finder in the controller:
24
25 @posts = Post.paginate_by_board_id @board.id, :page => params[:page], :order => 'updated_at DESC'
26
27Yeah, +paginate+ works just like +find+ -- it just doesn't fetch all the
28records. Don't forget to tell it which page you want, or it will complain!
29Read more on WillPaginate::Finder::ClassMethods.
30
31Render the posts in your view like you would normally do. When you need to render
32pagination, just stick this in:
33
34 <%= will_paginate @posts %>
35
36You're done. (You can find the option list at WillPaginate::ViewHelpers.)
37
38How does it know how much items to fetch per page? It asks your model by calling
39its <tt>per_page</tt> class method. You can define it like this:
40
41 class Post < ActiveRecord::Base
42 cattr_reader :per_page
43 @@per_page = 50
44 end
45
46... or like this:
47
48 class Post < ActiveRecord::Base
49 def self.per_page
50 50
51 end
52 end
53
54... or don't worry about it at all. WillPaginate defines it to be <b>30</b> by default.
55But you can always specify the count explicitly when calling +paginate+:
56
57 @posts = Post.paginate :page => params[:page], :per_page => 50
58
59The +paginate+ finder wraps the original finder and returns your resultset that now has
60some new properties. You can use the collection as you would with any ActiveRecord
61resultset. WillPaginate view helpers also need that object to be able to render pagination:
62
63 <ol>
64 <% for post in @posts -%>
65 <li>Render `post` in some nice way.</li>
66 <% end -%>
67 </ol>
68
69 <p>Now let's render us some pagination!</p>
70 <%= will_paginate @posts %>
71
72More detailed documentation:
73
74* WillPaginate::Finder::ClassMethods for pagination on your models;
75* WillPaginate::ViewHelpers for your views.
76
77
78== Authors and credits
79
80Authors:: Mislav Marohnić, PJ Hyett
81Original announcement:: http://errtheblog.com/post/929
82Original PHP source:: http://www.strangerstudios.com/sandbox/pagination/diggstyle.php
83
84All these people helped making will_paginate what it is now with their code
85contributions or just simply awesome ideas:
86
87Chris Wanstrath, Dr. Nic Williams, K. Adam Christensen, Mike Garey, Bence
88Golda, Matt Aimonetti, Charles Brian Quinn, Desi McAdam, James Coglan, Matijs
89van Zuijlen, Maria, Brendan Ribera, Todd Willey, Bryan Helmkamp, Jan Berkel,
90Lourens Naudé, Rick Olson, Russell Norris, Piotr Usewicz, Chris Eppstein,
91Denis Barushev, Ben Pickles.
92
93
94== Usable pagination in the UI
95
96There are some CSS styles to get you started in the "examples/" directory. They
97are {showcased online here}[http://mislav.caboo.se/static/will_paginate/].
98
99More reading about pagination as design pattern:
100
101* {Pagination 101}[http://kurafire.net/log/archive/2007/06/22/pagination-101]
102* {Pagination gallery}[http://www.smashingmagazine.com/2007/11/16/pagination-gallery-examples-and-good-practices/]
103* {Pagination on Yahoo Design Pattern Library}[http://developer.yahoo.com/ypatterns/parent.php?pattern=pagination]
104
105Want to discuss, request features, ask questions? Join the
106{Google group}[http://groups.google.com/group/will_paginate].
107