will_paginate-bootstrap5

This is a fork of the original will_paginate-bootstrap gem (thank you for the 10 years I used this gem, btw!!!).

The original gem is no longer maintained, so this fork allows me to ensure usage of the LinkRenderer.

Rails 7+'s new built-in pagination offers the paginate method (and more), but seems to not yet include a defined LinkRenderer.

This gem integrates the Bootstrap pagination component with the will_paginate pagination gem.

Just like will_paginate, Rails and Sinatra are supported.

Install

For projects using Bundler (like Rails 7+):
- add gem 'will_paginate-bootstrap5' to Gemfile (and then run bundle install).
  - (this works without needing to add gem 'will_paginate' to Gemfile)
Otherwise:
- gem install will_paginate-bootstrap5

Add Bootstrap CSS to your project
- For Rails 7+ projects, use one of the following options:
  - install the boostrap gem
  - manually download bootstrap.css from the bootstrap website and save it under [your repo]/vendor/assets/stylesheets
    - add //= link_tree ../../../vendor/assets/stylesheets .css to app/assets/config/manifest.js so it gets compiled by sprockets/asset pipeline
  - add bootstrap's CDN url within the <head> of your app/views/layout.html.erb
  - pin the CDN in your config/importmap.rb
In your view, use the renderer: BootstrapPagination::Rails option with the will_paginate helper, for example:

<%= will_paginate @collection, renderer: BootstrapPagination::Rails %>

Load the Bootstrap CSS in your template.
require "will_paginate-bootstrap" in your Sinatra app.
In your view, use the renderer: BootstrapPagination::Sinatra option with the will_paginate helper, for example:

<%= will_paginate @collection, renderer: BootstrapPagination::Sinatra %>

Starting at version 1.0, this gem no longer supports Bootstrap 2.

Bootstrap 2 users can use version 0.2.5 of the original gem, which was the last version to offer Bootstrap 2 support.