paginate_me 0.0.1 → 0.0.2

data/README.textile

@@ -0,0 +1,49 @@
+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
+

data/lib/paginate_me/paginate.rb

@@ -9,7 +9,7 @@ module PaginateMe
         @options[:per_page] = 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
-
+        
         current_page = @options[:current_page]
         page_total = @options[:page_total]
 
@@ -26,15 +26,22 @@ module PaginateMe
 
   module PMView
     def paginate_for(item,options = {},&block)
+
+      @page_block = block || @page_block
+      raise ArgumentError, "Missing Block" if @page_block.nil?
+
       model_name = item.to_s
 
       options = options.merge @options
 
+      paginate_classes = options[:class] || model_name
+      paginate_classes = paginate_classes.join " " if paginate_classes.is_a? Array
+
       paginate_builder = PaginateMeBuilder.new(options)
 
-      content = capture(paginate_builder,&block)
+      content = capture(paginate_builder,&@page_block)
 
-      content_tag(:div,content, :class => "paginate_me #{model_name}")
+      content_tag(:div,content, :class => "paginate_me #{paginate_classes}")
     end
     
   end
@@ -43,12 +50,7 @@ module PaginateMe
 
       def initialize(options)
 
-        @first_label = options[:first_label] || "First"
-
-        @next_label = options[:next_label] || "Next"
-        @previous_label = options[:previous_label] || "Previous"
-
-        @last_label = options[:last_label] || "Last"
+        @slug = options[:slug] || "page"
 
         @base_url = options[:base_url]
         @per_page = options[:per_page]
@@ -59,35 +61,51 @@ module PaginateMe
         @prev_page = (@current_page <= 1 ? @current_page : @current_page - 1).to_s     
       end
 
-      def link_to_next
-        add_to_template link_to(@next_label, @base_url + "/page/#{@next_page}", :class => "next") if 
+      def link_to_next(options = {})
+        options[:name] ||= "Next"
+
+        add_to_template paginate_link_to @page_total, options if 
                           @current_page < @page_total
       end
 
-      def link_to_previous
-        add_to_template link_to(@previous_label, @base_url + "/page/#{@prev_page}" , :class => "previous") if 
+      def link_to_previous(options = {})
+        options[:name] ||= "Previous"
+
+        add_to_template paginate_link_to @page_total, options if 
                           @current_page > 1
       end
 
-      def link_to_first
-        add_to_template link_to(@first_label, @base_url + "/page/#{'1'}", :class => "first") if 
+      def link_to_first(options = {})
+        options[:name] ||= "First"
+
+        add_to_template paginate_link_to @page_total, options if 
                           @current_page < @page_total
       end
 
-      def link_to_last
-        add_to_template link_to(@last_label, @base_url + "/page/#{@page_total}" , :class => "last") if 
+      def link_to_last(options = {})
+        options[:name] ||= "Last"
+        
+        add_to_template paginate_link_to @page_total, options if 
                           @current_page > 1
       end
 
-      def page_out_of_total
-        add_to_template "#{@current_page} of #{@page_total}"
+      def page_out_of_total(options = {})
+        content = "#{@current_page} of #{@page_total}"
+        add_to_template content_tag(:span,content, options)
       end
 
       private 
+        def paginate_link_to(page, args)
+          name = args[:name]
+          args[:class] ||= name.downcase
+          args[:title] ||= name.downcase
+          args.delete :name
+          link_to(name, @base_url + "/#{@slug}/#{page}" , args)
+        end
+
         def add_to_template(string)
           template = "\n\t" + string
           template.html_safe
-          string
         end
     end
 end

data/lib/paginate_me/version.rb

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

data/paginate_me.gemspec

@@ -7,9 +7,10 @@ Gem::Specification.new do |s|
   s.version     = PaginateMe::VERSION
   s.authors     = ["Adam Rensel"]
   s.email       = ["adamrensel@gmail.com"]
-  s.homepage    = ""
-  s.summary     = %q{Something}
-  s.description = %q{Its a thing}
+  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.rubyforge_project = "paginate_me"
 

metadata

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