kaminari 0.10.1 → 0.10.2

data/CHANGELOG

@@ -1,3 +1,9 @@
+== 0.10.2
+
+* Added :param_name option to the pagination helper #10 [ivanvr]
+  Example:
+  = paginate @users, :param_name => :pagina
+
 == 0.10.1
 
 * Fixed a bug that the whole <nav> section was not rendered in some cases

data/README.rdoc

@@ -27,9 +27,9 @@ The pagination helper outputs the HTML5 <nav> tag by default. Plus, the helper s
 
 == Supported versions
 
-* Ruby 1.8.7, 1.9.2, 1.9.3
+* Ruby 1.8.7, 1.9.2, 1.9.3 (trunk)
 
-* Rails 3.0.x, 3.1
+* Rails 3.0.x, 3.1 (edge)
 
 * Haml 3
 
@@ -47,16 +47,16 @@ Then bundle:
 
 === Query Basics
 
-* the +:page+ scope
+* the +page+ scope
 
   To fetch the 7th page of users (default +per_page+ is 25)
     User.page(7)
 
-* the +:per+ scope
+* the +per+ scope
 
   To show a lot more users per each page (change the +per_page+ value)
     User.page(7).per(50)
-  Note that the +:per+ scope is not directly defined on the models but is just a method defined on the page scope. This is absolutely reasonable because you will never actually use +per_page+ without specifying the +page+ number.
+  Note that the +per+ scope is not directly defined on the models but is just a method defined on the page scope. This is absolutely reasonable because you will never actually use +per_page+ without specifying the +page+ number.
 
 === Configuring default +per_page+ value for each model
 
@@ -87,28 +87,33 @@ Then bundle:
 
 * specifing the "inner window" size (4 by default)
 
-  This would output something like <tt>... 5 6 7 8 9 ...</tt> when 7 is the current page.
     <%= paginate @users, :window => 2 %>
+  This would output something like <tt>... 5 6 7 8 9 ...</tt> when 7 is the current page.
 
 * specifing the "outer window" size (1 by default)
 
-  This would output something like <tt>1 2 3 4 ...(snip)... 17 18 19 20</tt> while having 20 pages in total.
     <%= paginate @users, :outer_window => 3 %>
+  This would output something like <tt>1 2 3 4 ...(snip)... 17 18 19 20</tt> while having 20 pages in total.
 
-* outer window can be separetely specified by +left+ +right+ (1 by default)
+* outer window can be separetely specified by +left+, +right+ (1 by default)
 
-  This would output something like <tt>1 ...(snip)... 18 19 20</tt> while having 20 pages in total.
     <%= paginate @users, :left => 0, :right => 2 %>
+  This would output something like <tt>1 ...(snip)... 18 19 20</tt> while having 20 pages in total.
 
-* extra parameters (+:params+) for the links
+* changing the parameter name (:+param_name+) for the links
+
+    <%= paginate @users, :param_name => :pagina
+  This would modify the query parameter name on each links.
+
+* extra parameters (:+params+) for the links
 
-  This would modify each link's +url_option+. +:controller+ and +:action+ might be the keys in common.
     <%= paginate @users, :params => {:controller => 'foo', :action => 'bar'}
+  This would modify each link's +url_option+. :+controller+ and :+action+ might be the keys in common.
 
 * Ajax links (crazy simple, but works perfectly!)
 
-  This would add <tt>data-remote="true"</tt> to all the links inside.
     <%= paginate @users, :remote => true %>
+  This would add <tt>data-remote="true"</tt> to all the links inside.
 
 === I18n and labels
 
@@ -129,14 +134,15 @@ Kaminari includes a handy template generator.
 * to edit your paginator
 
   Run the generator first,
-  % rails g kaminari:views default
+    % rails g kaminari:views default
 
   then edit the partials in your app's <tt>app/views/kaminari/</tt> directory.
 
 * for Haml users
+
   Haml templates generator is also available by adding the <tt>-e haml</tt> option (this is automatically invoked when the default template_engine is set to Haml).
 
-  % rails g kaminari:views default -e haml
+    % rails g kaminari:views default -e haml
 
 * themes
 

data/VERSION

@@ -1 +1 @@
-0.10.1
+0.10.2

data/kaminari.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{kaminari}
-  s.version = "0.10.1"
+  s.version = "0.10.2"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Akira Matsuda"]
-  s.date = %q{2011-02-21}
+  s.date = %q{2011-02-22}
   s.description = %q{Kaminari is a Scope & Engine based clean and powerful and customizable and sophisticated paginator for Rails 3}
   s.email = %q{ronnie@dio.jp}
   s.extra_rdoc_files = [

data/lib/kaminari/helpers/action_view_extension.rb

@@ -14,10 +14,11 @@ module Kaminari
       # * <tt>:left</tt> - The "left outer window" size (1 by default).
       # * <tt>:right</tt> - The "right outer window" size (1 by default).
       # * <tt>:params</tt> - url_for parameters for the links (:controller, :action, etc.)
+      # * <tt>:param_name</tt> - parameter name for page number in the links (:page by default)
       # * <tt>:remote</tt> - Ajax? (false by default)
       # * <tt>:ANY_OTHER_VALUES</tt> - Any other hash key & values would be directly passed into each tag as :locals value.
       def paginate(scope, options = {}, &block)
-        Kaminari::Helpers::PaginationRenderer.new self, options.reverse_merge(:current_page => scope.current_page, :num_pages => scope.num_pages, :per_page => scope.limit_value, :remote => false)
+        Kaminari::Helpers::PaginationRenderer.new self, options.reverse_merge(:current_page => scope.current_page, :num_pages => scope.num_pages, :per_page => scope.limit_value, :param_name => :page, :remote => false)
       end
     end
   end

data/lib/kaminari/helpers/tags.rb

@@ -19,6 +19,7 @@ module Kaminari
     class Tag
       def initialize(template, options = {}) #:nodoc:
         @template, @options = template, template.options.merge(options)
+        @param_name = @options.delete :param_name
       end
 
       def to_s(locals = {}) #:nodoc:
@@ -47,7 +48,7 @@ module Kaminari
       end
 
       def page_url_for(page)
-        @template.url_for @template.params.merge(:page => (page <= 1 ? nil : page))
+        @template.url_for @template.params.merge(@param_name => (page <= 1 ? nil : page))
       end
     end
 

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: kaminari
 version: !ruby/object:Gem::Version 
-  hash: 53
+  hash: 51
   prerelease: 
   segments: 
   - 0
   - 10
-  - 1
-  version: 0.10.1
+  - 2
+  version: 0.10.2
 platform: ruby
 authors: 
 - Akira Matsuda
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-02-21 00:00:00 +09:00
+date: 2011-02-22 00:00:00 +09:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency