Skip to content
This repository

Pagination library for Rails 3, Sinatra, Merb, DataMapper, and more

Merge pull request #358 from phuesler/dm_total_entries

Support paginate(:total_entries => n) for DataMapper
latest commit ca7d45f955
Mislav Marohnić authored
Octocat-spinner-32 lib Support paginate(:total_entries => n) for dm February 05, 2014
Octocat-spinner-32 script test against Rails 4.0.0.rc2 and Rails 4.1 (edge) September 16, 2013
Octocat-spinner-32 spec Support paginate(:total_entries => n) for dm February 05, 2014
Octocat-spinner-32 .gitignore fix view specs with Rails 3.0.0.beta3 April 16, 2010
Octocat-spinner-32 .rspec setup continuous integration testing with Travis-CI July 28, 2011
Octocat-spinner-32 .travis.yml don't build Rails 4 against Ruby 1.8, 1.9.2 June 21, 2013
Octocat-spinner-32 Gemfile test against Rails 4.0.0.rc2 and Rails 4.1 (edge) September 16, 2013
Octocat-spinner-32 Gemfile.lock test against Rails 4.0.0.rc2 and Rails 4.1 (edge) June 21, 2013
Octocat-spinner-32 Gemfile.rails-edge test against Rails 4.0.0.rc2 and Rails 4.1 (edge) September 16, 2013
Octocat-spinner-32 Gemfile.rails-edge.lock test against Rails 4.0.0.rc2 and Rails 4.1 (edge) September 16, 2013
Octocat-spinner-32 Gemfile.rails3.0 replace Rake + ruby CI runner with one in bash September 16, 2013
Octocat-spinner-32 Gemfile.rails3.0.lock replace Rake + ruby CI runner with one in bash September 16, 2013
Octocat-spinner-32 Gemfile.rails3.1 replace Rake + ruby CI runner with one in bash September 16, 2013
Octocat-spinner-32 Gemfile.rails3.1.lock test against Rails 4.0.0.rc2 and Rails 4.1 (edge) September 16, 2013
Octocat-spinner-32 Gemfile.rails3.2 test against Rails 4.0.0.rc2 and Rails 4.1 (edge) September 16, 2013
Octocat-spinner-32 Gemfile.rails3.2.lock test against Rails 4.0.0.rc2 and Rails 4.1 (edge) September 16, 2013
Octocat-spinner-32 LICENSE Total rdoc love. Point out that this is framework-agnostic now January 12, 2009
Octocat-spinner-32 README.md clarify that the library works with Rails 4 as well September 23, 2013
Octocat-spinner-32 init.rb mix in Active Record/Action View directly on `require` August 05, 2011
Octocat-spinner-32 will_paginate.gemspec add license information to gemspec September 16, 2013
README.md

will_paginate

will_paginate is a pagination library that integrates with Ruby on Rails, Sinatra, Merb, DataMapper and Sequel.

Installation:

## Gemfile for Rails 3, Rails 4, Sinatra, and Merb
gem 'will_paginate', '~> 3.0'

See installation instructions on the wiki for more info.

Basic will_paginate use

## 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

New in Active Record 3:

# paginate in Active Record now returns a Relation
Post.where(:published => true).paginate(:page => params[:page]).order('id DESC')

# the new, shorter page() method
Post.page(params[:page]).order('created_at DESC')

See the wiki for more documentation. Ask on the group if you have usage questions. Report bugs on GitHub.

Happy paginating.

Something went wrong with that request. Please try again.