paginate_me 0.0.2 → 0.0.3

data/README.markdown

@@ -0,0 +1,68 @@
+<h1>Paginate Me</h1>
+
+**Adam Rensel's Code**
+
+<p>Paginate me is a Ruby Gem that adds simple pagination functionality to views.</p>
+
+
+
+<h2>Usage:</h2>
+<p>users_controller.rb</p>
+
+<pre>class UsersController &lt; ApplicationController
+	def index
+		@title = "All Users"
+
+	 paginate_me :users
+	end
+end</pre>
+
+<p>index.haml</p>
+
+<pre>= paginate_for :users do |p|
+  = p.link_to_first
+	= p.link_to_next
+	= p.page_out_of_total
+	= p.link_to_previous
+	= p.link_to_last</pre>
+<p>Results in: </p>
+    <div class="paginate_me users"> 
+      <a href="/users/page/10" class="first" title="first">First</a> 
+              
+      <a href="/users/page/10" class="next" title="next">Next</a> 
+              
+      <span>2 of 10</span> 
+              
+      <a href="/users/page/10" class="previous" title="previous">Previous</a> 
+              
+      <a href="/users/page/10" class="last" title="last">Last</a> 
+    </div>
+
+<h2>Options for paginate_me(item, options ={})</h2>
+* :url - The plugin builds it's base path from the item passed in according to standard rails routing resource format. A different base url can be passed in instead. /users/page/:page_number (/users is the base_url)
+* :per_page - results per page, defaults to 10
+* :params_var - variable set in routes that will hold the current page number ex: <code>match "/users/page/:page", :to => "users#index"</code> :page is the :params_var
+
+
+<h2>Options for paginate_for(item, options = {}, &block)</h2>
+* :class - add classes to div container tag
+* :slug - slug used for url, defaults to 'page', the controller will use the slug in the 'params' variable by default as well.
+
+
+<h2>Paginate Links</h2>
+* link_to_first(options={}) - label for first button, goes to page 1 
+* link_to_next(options={}) - label for next button, increments page by +1
+* link_to_previous(options={}) - label for previous button subtracts pages by -1
+* link_to_last(options={}) - goes to the last page available, based on total count
+  <p> **options** </p>
+    * :name - name of link
+    * :class - classes for link pass an array for multiple classes
+    * :title - title for link
+
+<h2>Information Output</h2>
+* page_out_of_total - formats pagination info '1 of 10' standard rails 'content_tag' options apply
+
+<h2>Additional Information</h2>
+* If multiple pagination is needed on one page, for example at the top and bottom of the list, the block of paginate links only needs to be passed to the first 'paginate_for' The additional 'paginate_for' will use the same block, or new blocks can be passed if a different look is required
+* Make sure you add the correct routes to your routes.rb. For example if your passing in :users and are using a standard resource routing setup, you will need:<code>match "/users/page/:page", :to => "users#index"</code>
+

data/lib/paginate_me/paginate.rb

@@ -4,12 +4,13 @@ module PaginateMe
         model_name = item.to_s
         model = model_name.singularize.camelize.constantize
 
-        @options = {}
-        @options[:base_url] = options[:url] || method("#{model_name}_path").call
-        @options[:per_page] = options[:per_page] || 10
+        @options = options
+        @options[:params_var] ||= :page 
+        @options[:base_url] ||= method("#{model_name}_path").call
+        @options[:per_page] ||= 10
         @options[:page_total] = (model.count / @options[:per_page].to_f).ceil
-        @options[:current_page] = self.params['page'].to_i || options[:page].to_i || 1
-        
+        @options[:current_page] = self.params[@options[:params_var]].to_i || 1
+  
         current_page = @options[:current_page]
         page_total = @options[:page_total]
 
@@ -50,43 +51,38 @@ module PaginateMe
 
       def initialize(options)
 
-        @slug = options[:slug] || "page"
-
+        @slug = options[:slug] ||= "page"
         @base_url = options[:base_url]
         @per_page = options[:per_page]
         @page_total = options[:page_total]
         @current_page = options[:current_page]
 
         @next_page = (@current_page >= @page_total ? @current_page : @current_page + 1).to_s
-        @prev_page = (@current_page <= 1 ? @current_page : @current_page - 1).to_s     
+        @prev_page = (@current_page <= 1 ? @current_page : @current_page - 1).to_s   
       end
 
       def link_to_next(options = {})
         options[:name] ||= "Next"
 
-        add_to_template paginate_link_to @page_total, options if 
-                          @current_page < @page_total
+        add_to_template paginate_link_to @next_page, options if @current_page < @page_total
       end
 
       def link_to_previous(options = {})
         options[:name] ||= "Previous"
 
-        add_to_template paginate_link_to @page_total, options if 
-                          @current_page > 1
+        add_to_template paginate_link_to @prev_page, options if @current_page > 1
       end
 
       def link_to_first(options = {})
         options[:name] ||= "First"
 
-        add_to_template paginate_link_to @page_total, options if 
-                          @current_page < @page_total
+        add_to_template paginate_link_to 1, options if @current_page < @page_total
       end
 
       def link_to_last(options = {})
         options[:name] ||= "Last"
         
-        add_to_template paginate_link_to @page_total, options if 
-                          @current_page > 1
+        add_to_template paginate_link_to @page_total, options if @current_page > 1
       end
 
       def page_out_of_total(options = {})

data/lib/paginate_me/version.rb

@@ -1,3 +1,3 @@
 module PaginateMe
-  VERSION = "0.0.2"
+  VERSION = "0.0.3"
 end

data/paginate_me.gemspec

@@ -7,10 +7,9 @@ Gem::Specification.new do |s|
   s.version     = PaginateMe::VERSION
   s.authors     = ["Adam Rensel"]
   s.email       = ["adamrensel@gmail.com"]
-  s.homepage    = "https://github.com/renz45/paginate_me"
-  s.summary     = %q{Pagination gem for rails 3.1}
-  s.description = %q{Pagination gem which works similar to the form_for rails 
-                    helper, see the README for more information}
+  s.homepage    = ""
+  s.summary     = %q{Something}
+  s.description = %q{Its a thing}
 
   s.rubyforge_project = "paginate_me"
 

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: paginate_me
 version: !ruby/object:Gem::Version 
-  hash: 27
+  hash: 25
   prerelease: 
   segments: 
   - 0
   - 0
-  - 2
-  version: 0.0.2
+  - 3
+  version: 0.0.3
 platform: ruby
 authors: 
 - Adam Rensel
@@ -18,9 +18,7 @@ cert_chain: []
 date: 2011-09-17 00:00:00 Z
 dependencies: []
 
-description: |-
-  Pagination gem which works similar to the form_for rails 
-                      helper, see the README for more information
+description: Its a thing
 email: 
 - adamrensel@gmail.com
 executables: []
@@ -32,14 +30,14 @@ extra_rdoc_files: []
 files: 
 - .gitignore
 - Gemfile
-- README.textile
+- README.markdown
 - Rakefile
 - lib/paginate_me.rb
 - lib/paginate_me/paginate.rb
 - lib/paginate_me/railtie.rb
 - lib/paginate_me/version.rb
 - paginate_me.gemspec
-homepage: https://github.com/renz45/paginate_me
+homepage: ""
 licenses: []
 
 post_install_message: 
@@ -71,6 +69,6 @@ rubyforge_project: paginate_me
 rubygems_version: 1.8.10
 signing_key: 
 specification_version: 3
-summary: Pagination gem for rails 3.1
+summary: Something
 test_files: []
 

data/README.textile

@@ -1,49 +0,0 @@
-h1. Paginate Me
-
-*Adam Rensel's Code*
-
-p. Paginate me is a Ruby Gem that adds simple pagination functionality to views.
-
-
-
-h2. Usage:
-p. users_controller.rb
-
-@class UsersController < ApplicationController
-	def index
-		@title = "All Users"
-
-		paginate_me :users
-	end
-end@
-
-p. index.haml
-
-@= paginate_for :users do |p|
-	= p.link_to_first
-	= p.link_to_next
-	= p.page_out_of_total
-	= p.link_to_previous
-	= p.link_to_last@
-
-h2. Options for paginate_me(item, options ={})
-* :url - The plugin builds it's base path from the item passed in according to standard rails routing resource format. A different base url can be passed in instead. /users/page/:page_number (/users is the base_url)
-* :per_page - results per page, defaults to 10
-
-h2. Options for paginate_for(item, options = {}, &block)
-* :class - add classes to div container tag
-* :slug - slug used for url, defaults to 'page'
-
-h2. Paginate Links
-* link_to_first(options={}) - label for first button, goes to page 1 
-* link_to_next(options={}) - label for next button, increments page by +1
-* link_to_previous(options={}) - label for previous button subtracts pages by -1
-* link_to_last(options={}) - goes to the last page available, based on total count
-** options
-*** :name - name of link
-*** :class - classes for link pass an array for multiple classes
-*** :title - title for link
-
-h2. Information Output
-* page_out_of_total - formats pagination info '1 of 10' standard rails 'content_tag' options apply
-