Backwards incompatibility

The 3.0 version of will_paginate (also known as the “agnostic” branch) introduces some backwards incompatibility for scripts that hack into will_paginate: extend modules, override methods, subclass LinkRenderer etc. Basically, this version is a total rewrite of the whole library, including tests (which are converted to specs).

Here is a list of changes:

• the directory and modules layout has changed to better support adding of finders or view adapters in the future;
• removed WillPaginate::enable_actionview and ::enable_activerecord methods—also the WillPaginate::enable method doesn’t do anything anymore (kept for compatibility);
• :prev_label view parameter is now :previous_label, old name still functions but it’s deprecated;
• WillPaginate::LinkRenderer (now WillPaginate::ViewHelpers::LinkRenderer) has changed so much that any code that subclassed it or interfaced with it in any way is expected not to work anymore;
• markup for the current page has changed from <span class="current">1</span> to <em>1</em>, you should update your CSS to remove its default italic style;
• the classname for the previous page link has changed from “prev_page” to “previous_page”;
• WillPaginate::Collection#page_count legacy method is no longer supported, any 3rd-party libraries that still implement this method (instead of the new #total_pages) are expected to break.