will_paginate v2.3 is a pagination plugin for Rails and Active Record.
Installation:
## environment.rb
Rails::Initializer.run do |config|
config.gem 'will_paginate', :version => '~> 2.3.16'
end
See installation instructions on the wiki for more info.
## perform a paginated query:
@posts = Post.paginate(:page => params[:page])
# or, use an explicit "per page" limit:
Post.paginate(:page => params[:page], :per_page => 30)
## render page links in the view:
<%= will_paginate @posts %>
And that's it! You're done. You just need to add some CSS styles to make those pagination links prettier.
You can customize the default "per_page" value:
# for the Post model
class Post
self.per_page = 10
end
# set per_page globally
WillPaginate.per_page = 10
See the wiki for more documentation. Ask on the group if you have usage questions. Report bugs on GitHub.
Happy paginating.