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
Octocat-spinner-32 script test against Rails 4.0.0.rc2 and Rails 4.1 (edge)
Octocat-spinner-32 spec Support paginate(:total_entries => n) for dm
Octocat-spinner-32 .gitignore fix view specs with Rails 3.0.0.beta3
Octocat-spinner-32 .rspec setup continuous integration testing with Travis-CI
Octocat-spinner-32 .travis.yml don't build Rails 4 against Ruby 1.8, 1.9.2
Octocat-spinner-32 Gemfile test against Rails 4.0.0.rc2 and Rails 4.1 (edge)
Octocat-spinner-32 Gemfile.lock test against Rails 4.0.0.rc2 and Rails 4.1 (edge)
Octocat-spinner-32 Gemfile.rails-edge test against Rails 4.0.0.rc2 and Rails 4.1 (edge)
Octocat-spinner-32 Gemfile.rails-edge.lock test against Rails 4.0.0.rc2 and Rails 4.1 (edge)
Octocat-spinner-32 Gemfile.rails3.0 replace Rake + ruby CI runner with one in bash
Octocat-spinner-32 Gemfile.rails3.0.lock replace Rake + ruby CI runner with one in bash
Octocat-spinner-32 Gemfile.rails3.1 replace Rake + ruby CI runner with one in bash
Octocat-spinner-32 Gemfile.rails3.1.lock test against Rails 4.0.0.rc2 and Rails 4.1 (edge)
Octocat-spinner-32 Gemfile.rails3.2 test against Rails 4.0.0.rc2 and Rails 4.1 (edge)
Octocat-spinner-32 Gemfile.rails3.2.lock test against Rails 4.0.0.rc2 and Rails 4.1 (edge)
Octocat-spinner-32 LICENSE Total rdoc love. Point out that this is framework-agnostic now
Octocat-spinner-32 README.md clarify that the library works with Rails 4 as well
Octocat-spinner-32 init.rb mix in Active Record/Action View directly on `require`
Octocat-spinner-32 will_paginate.gemspec add license information to gemspec
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.