Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse code

Vendor will_paginate

  • Loading branch information...
commit 6b69bc5a671c85eb1b791d020e36108dc8db66a2 1 parent 9bfe331
Pratik lifo authored

Showing 47 changed files with 3,555 additions and 4 deletions. Show diff stats Hide diff stats

  1. +0 2  config/environment.rb
  2. +4 2 init.rb
  3. +43 0 vendor/plugins/will_paginate/.manifest
  4. +139 0 vendor/plugins/will_paginate/CHANGELOG.rdoc
  5. +18 0 vendor/plugins/will_paginate/LICENSE
  6. +107 0 vendor/plugins/will_paginate/README.rdoc
  7. +53 0 vendor/plugins/will_paginate/Rakefile
  8. BIN  vendor/plugins/will_paginate/examples/apple-circle.gif
  9. +69 0 vendor/plugins/will_paginate/examples/index.haml
  10. +92 0 vendor/plugins/will_paginate/examples/index.html
  11. +90 0 vendor/plugins/will_paginate/examples/pagination.css
  12. +91 0 vendor/plugins/will_paginate/examples/pagination.sass
  13. +1 0  vendor/plugins/will_paginate/init.rb
  14. +90 0 vendor/plugins/will_paginate/lib/will_paginate.rb
  15. +16 0 vendor/plugins/will_paginate/lib/will_paginate/array.rb
  16. +144 0 vendor/plugins/will_paginate/lib/will_paginate/collection.rb
  17. +43 0 vendor/plugins/will_paginate/lib/will_paginate/core_ext.rb
  18. +264 0 vendor/plugins/will_paginate/lib/will_paginate/finder.rb
  19. +170 0 vendor/plugins/will_paginate/lib/will_paginate/named_scope.rb
  20. +37 0 vendor/plugins/will_paginate/lib/will_paginate/named_scope_patch.rb
  21. +9 0 vendor/plugins/will_paginate/lib/will_paginate/version.rb
  22. +408 0 vendor/plugins/will_paginate/lib/will_paginate/view_helpers.rb
  23. +21 0 vendor/plugins/will_paginate/test/boot.rb
  24. +143 0 vendor/plugins/will_paginate/test/collection_test.rb
  25. +8 0 vendor/plugins/will_paginate/test/console
  26. +22 0 vendor/plugins/will_paginate/test/database.yml
  27. +473 0 vendor/plugins/will_paginate/test/finder_test.rb
  28. +3 0  vendor/plugins/will_paginate/test/fixtures/admin.rb
  29. +14 0 vendor/plugins/will_paginate/test/fixtures/developer.rb
  30. +13 0 vendor/plugins/will_paginate/test/fixtures/developers_projects.yml
  31. +15 0 vendor/plugins/will_paginate/test/fixtures/project.rb
  32. +6 0 vendor/plugins/will_paginate/test/fixtures/projects.yml
  33. +29 0 vendor/plugins/will_paginate/test/fixtures/replies.yml
  34. +7 0 vendor/plugins/will_paginate/test/fixtures/reply.rb
  35. +38 0 vendor/plugins/will_paginate/test/fixtures/schema.rb
  36. +10 0 vendor/plugins/will_paginate/test/fixtures/topic.rb
  37. +30 0 vendor/plugins/will_paginate/test/fixtures/topics.yml
  38. +2 0  vendor/plugins/will_paginate/test/fixtures/user.rb
  39. +35 0 vendor/plugins/will_paginate/test/fixtures/users.yml
  40. +37 0 vendor/plugins/will_paginate/test/helper.rb
  41. +43 0 vendor/plugins/will_paginate/test/lib/activerecord_test_case.rb
  42. +75 0 vendor/plugins/will_paginate/test/lib/activerecord_test_connector.rb
  43. +11 0 vendor/plugins/will_paginate/test/lib/load_fixtures.rb
  44. +179 0 vendor/plugins/will_paginate/test/lib/view_test_process.rb
  45. +59 0 vendor/plugins/will_paginate/test/tasks.rake
  46. +373 0 vendor/plugins/will_paginate/test/view_test.rb
  47. +21 0 vendor/plugins/will_paginate/will_paginate.gemspec
2  config/environment.rb
@@ -10,6 +10,4 @@
10 10 :session_key => '_tolk_session',
11 11 :secret => 'f2d72b63242db79df080031c60159a419981cc6c066e961405c1a86c5c38ba56c960d6de171dc4cf985f1544c00466400abf0aac2ce1cbdb726f6127d304fb07'
12 12 }
13   -
14   - config.gem 'will_paginate', '~> 2.3.12'
15 13 end
6 init.rb
... ... @@ -1,4 +1,6 @@
1 1 Mime::Type.register_alias "text/yaml", :yml
2 2
3   -gem 'will_paginate', '~> 2.3.12'
4   -require 'will_paginate'
  3 +will_paginate = File.join(File.dirname(__FILE__), 'vendor/plugins/will_paginate')
  4 +$: << File.join(will_paginate, 'lib')
  5 +
  6 +require $: << File.join(will_paginate, 'init')
43 vendor/plugins/will_paginate/.manifest
... ... @@ -0,0 +1,43 @@
  1 +CHANGELOG.rdoc
  2 +LICENSE
  3 +README.rdoc
  4 +Rakefile
  5 +examples/apple-circle.gif
  6 +examples/index.haml
  7 +examples/index.html
  8 +examples/pagination.css
  9 +examples/pagination.sass
  10 +init.rb
  11 +lib/will_paginate.rb
  12 +lib/will_paginate/array.rb
  13 +lib/will_paginate/collection.rb
  14 +lib/will_paginate/core_ext.rb
  15 +lib/will_paginate/finder.rb
  16 +lib/will_paginate/named_scope.rb
  17 +lib/will_paginate/named_scope_patch.rb
  18 +lib/will_paginate/version.rb
  19 +lib/will_paginate/view_helpers.rb
  20 +test/boot.rb
  21 +test/collection_test.rb
  22 +test/console
  23 +test/database.yml
  24 +test/finder_test.rb
  25 +test/fixtures/admin.rb
  26 +test/fixtures/developer.rb
  27 +test/fixtures/developers_projects.yml
  28 +test/fixtures/project.rb
  29 +test/fixtures/projects.yml
  30 +test/fixtures/replies.yml
  31 +test/fixtures/reply.rb
  32 +test/fixtures/schema.rb
  33 +test/fixtures/topic.rb
  34 +test/fixtures/topics.yml
  35 +test/fixtures/user.rb
  36 +test/fixtures/users.yml
  37 +test/helper.rb
  38 +test/lib/activerecord_test_case.rb
  39 +test/lib/activerecord_test_connector.rb
  40 +test/lib/load_fixtures.rb
  41 +test/lib/view_test_process.rb
  42 +test/tasks.rake
  43 +test/view_test.rb
139 vendor/plugins/will_paginate/CHANGELOG.rdoc
Source Rendered
... ... @@ -0,0 +1,139 @@
  1 += 2.3.12, released 2009-12-01
  2 +
  3 +* make view helpers "HTML safe" for Rails 2.3.5 with rails_xss plugin
  4 +
  5 += 2.3.11, released 2009-06-02
  6 +
  7 +* fix `enable_actionpack`
  8 +
  9 += 2.3.10, released 2009-05-21
  10 +
  11 +* count_by_sql: don't use table alias with any adapters starting with "oracle"
  12 +* Add back "AS count_table" alias to `paginate_by_sql` counter SQL
  13 +
  14 += 2.3.9, released 2009-05-29
  15 +
  16 +* remove "AS count_table" alias from `paginate_by_sql` counter SQL
  17 +* Rails 2.3.2 compat: monkeypatch Rails issue #2189 (count breaks has_many :through)
  18 +* fix generation of page URLs that contain the "@" character
  19 +* check for method existance in a ruby 1.8- and 1.9-compatible way
  20 +* load will_paginate view helpers even if ActiveRecord is not loaded
  21 +
  22 +== 2.3.8, released 2009-03-09
  23 +
  24 +* Rails 2.3 compat: query parameter parsing with Rack
  25 +
  26 +== 2.3.7, released 2009-02-09
  27 +
  28 +* Removed all unnecessary &block variables since they cause serious memory damage and lots of subsequent gc runs.
  29 +
  30 +== 2.3.6, released 2008-10-26
  31 +
  32 +* Rails 2.2 fix: stop using `extract_attribute_names_from_match` inernal AR method, it no longer exists
  33 +
  34 +== 2.3.5, released 2008-10-07
  35 +
  36 +* update the backported named_scope implementation for Rails versions older than 2.1
  37 +* break out of scope of paginated_each() yielded block when used on named scopes
  38 +* fix paginate(:from)
  39 +
  40 +== 2.3.4, released 2008-09-16
  41 +
  42 +* Removed gem dependency to Active Support (causes trouble with vendored rails).
  43 +* Rails 2.1: fix a failing test and a deprecation warning.
  44 +* Cope with scoped :select when counting.
  45 +
  46 +== 2.3.3, released 2008-08-29
  47 +
  48 +* Ensure that paginate_by_sql doesn't change the original SQL query.
  49 +* RDoc love (now live at http://gitrdoc.com/mislav/will_paginate/tree/master)
  50 +* Rename :prev_label to :previous_label for consistency. old name still functions but is deprecated
  51 +* ActiveRecord 2.1: Remove :include option from count_all query when it's possible.
  52 +
  53 +== 2.3.2, released 2008-05-16
  54 +
  55 +* Fixed LinkRenderer#stringified_merge by removing "return" from iterator block
  56 +* Ensure that 'href' values in pagination links are escaped URLs
  57 +
  58 +== 2.3.1, released 2008-05-04
  59 +
  60 +* Fixed page numbers not showing with custom routes and implicit first page
  61 +* Try to use Hanna for documentation (falls back to default RDoc template if not)
  62 +
  63 +== 2.3.0, released 2008-04-29
  64 +
  65 +* Changed LinkRenderer to receive collection, options and reference to view template NOT in
  66 + constructor, but with the #prepare method. This is a step towards supporting passing of
  67 + LinkRenderer (or subclass) instances that may be preconfigured in some way
  68 +* LinkRenderer now has #page_link and #page_span methods for easier customization of output in
  69 + subclasses
  70 +* Changed page_entries_info() method to adjust its output according to humanized class name of
  71 + collection items. Override this with :entry_name parameter (singular).
  72 +
  73 + page_entries_info(@posts)
  74 + #-> "Displaying all 12 posts"
  75 + page_entries_info(@posts, :entry_name => 'item')
  76 + #-> "Displaying all 12 items"
  77 +
  78 +== 2.2.3, released 2008-04-26
  79 +
  80 +* will_paginate gem is no longer published on RubyForge, but on
  81 + gems.github.com:
  82 +
  83 + gem sources -a http://gems.github.com/ (you only need to do this once)
  84 + gem install mislav-will_paginate
  85 +
  86 +* extract reusable pagination testing stuff into WillPaginate::View
  87 +* rethink the page URL construction mechanizm to be more bulletproof when
  88 + combined with custom routing for page parameter
  89 +* test that anchor parameter can be used in pagination links
  90 +
  91 +== 2.2.2, released 2008-04-21
  92 +
  93 +* Add support for page parameter in custom routes like "/foo/page/2"
  94 +* Change output of "page_entries_info" on single-page collection and erraneous
  95 + output with empty collection as reported by Tim Chater
  96 +
  97 +== 2.2.1, released 2008-04-08
  98 +
  99 +* take less risky path when monkeypatching named_scope; fix that it no longer
  100 + requires ActiveRecord::VERSION
  101 +* use strings in "respond_to?" calls to work around a bug in acts_as_ferret
  102 + stable (ugh)
  103 +* add rake release task
  104 +
  105 +
  106 +== 2.2.0, released 2008-04-07
  107 +
  108 +=== API changes
  109 +* Rename WillPaginate::Collection#page_count to "total_pages" for consistency.
  110 + If you implemented this interface, change your implementation accordingly.
  111 +* Remove old, deprecated style of calling Array#paginate as "paginate(page,
  112 + per_page)". If you want to specify :page, :per_page or :total_entries, use a
  113 + parameter hash.
  114 +* Rename LinkRenderer#url_options to "url_for" and drastically optimize it
  115 +
  116 +=== View changes
  117 +* Added "prev_page" and "next_page" CSS classes on previous/next page buttons
  118 +* Add examples of pagination links styling in "examples/index.html"
  119 +* Change gap in pagination links from "..." to
  120 + "<span class="gap">&hellip;</span>".
  121 +* Add "paginated_section", a block helper that renders pagination both above and
  122 + below content in the block
  123 +* Add rel="prev|next|start" to page links
  124 +
  125 +=== Other
  126 +
  127 +* Add ability to opt-in for Rails 2.1 feature "named_scope" by calling
  128 + WillPaginate.enable_named_scope (tested in Rails 1.2.6 and 2.0.2)
  129 +* Support complex page parameters like "developers[page]"
  130 +* Move Array#paginate definition to will_paginate/array.rb. You can now easily
  131 + use pagination on arrays outside of Rails:
  132 +
  133 + gem 'will_paginate'
  134 + require 'will_paginate/array'
  135 +
  136 +* Add "paginated_each" method for iterating through every record by loading only
  137 + one page of records at the time
  138 +* Rails 2: Rescue from WillPaginate::InvalidPage error with 404 Not Found by
  139 + default
18 vendor/plugins/will_paginate/LICENSE
... ... @@ -0,0 +1,18 @@
  1 +Copyright (c) 2007 PJ Hyett and Mislav Marohnić
  2 +
  3 +Permission is hereby granted, free of charge, to any person obtaining a copy of
  4 +this software and associated documentation files (the "Software"), to deal in
  5 +the Software without restriction, including without limitation the rights to
  6 +use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
  7 +the Software, and to permit persons to whom the Software is furnished to do so,
  8 +subject to the following conditions:
  9 +
  10 +The above copyright notice and this permission notice shall be included in all
  11 +copies or substantial portions of the Software.
  12 +
  13 +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  14 +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
  15 +FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
  16 +COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
  17 +IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
  18 +CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
107 vendor/plugins/will_paginate/README.rdoc
Source Rendered
... ... @@ -0,0 +1,107 @@
  1 += WillPaginate
  2 +
  3 +Pagination is just limiting the number of records displayed. Why should you let
  4 +it get in your way while developing, then? This plugin makes magic happen. Did
  5 +you ever want to be able to do just this on a model:
  6 +
  7 + Post.paginate :page => 1, :order => 'created_at DESC'
  8 +
  9 +... and then render the page links with a single view helper? Well, now you
  10 +can.
  11 +
  12 +Some resources to get you started:
  13 +
  14 +* {Installation instructions}[http://github.com/mislav/will_paginate/wikis/installation]
  15 + on {the wiki}[http://github.com/mislav/will_paginate/wikis]
  16 +* Your mind reels with questions? Join our
  17 + {Google group}[http://groups.google.com/group/will_paginate].
  18 +* {How to report bugs}[http://github.com/mislav/will_paginate/wikis/report-bugs]
  19 +
  20 +
  21 +== Example usage
  22 +
  23 +Use a paginate finder in the controller:
  24 +
  25 + @posts = Post.paginate_by_board_id @board.id, :page => params[:page], :order => 'updated_at DESC'
  26 +
  27 +Yeah, +paginate+ works just like +find+ -- it just doesn't fetch all the
  28 +records. Don't forget to tell it which page you want, or it will complain!
  29 +Read more on WillPaginate::Finder::ClassMethods.
  30 +
  31 +Render the posts in your view like you would normally do. When you need to render
  32 +pagination, just stick this in:
  33 +
  34 + <%= will_paginate @posts %>
  35 +
  36 +You're done. (You can find the option list at WillPaginate::ViewHelpers.)
  37 +
  38 +How does it know how much items to fetch per page? It asks your model by calling
  39 +its <tt>per_page</tt> class method. You can define it like this:
  40 +
  41 + class Post < ActiveRecord::Base
  42 + cattr_reader :per_page
  43 + @@per_page = 50
  44 + end
  45 +
  46 +... or like this:
  47 +
  48 + class Post < ActiveRecord::Base
  49 + def self.per_page
  50 + 50
  51 + end
  52 + end
  53 +
  54 +... or don't worry about it at all. WillPaginate defines it to be <b>30</b> by default.
  55 +But you can always specify the count explicitly when calling +paginate+:
  56 +
  57 + @posts = Post.paginate :page => params[:page], :per_page => 50
  58 +
  59 +The +paginate+ finder wraps the original finder and returns your resultset that now has
  60 +some new properties. You can use the collection as you would with any ActiveRecord
  61 +resultset. WillPaginate view helpers also need that object to be able to render pagination:
  62 +
  63 + <ol>
  64 + <% for post in @posts -%>
  65 + <li>Render `post` in some nice way.</li>
  66 + <% end -%>
  67 + </ol>
  68 +
  69 + <p>Now let's render us some pagination!</p>
  70 + <%= will_paginate @posts %>
  71 +
  72 +More detailed documentation:
  73 +
  74 +* WillPaginate::Finder::ClassMethods for pagination on your models;
  75 +* WillPaginate::ViewHelpers for your views.
  76 +
  77 +
  78 +== Authors and credits
  79 +
  80 +Authors:: Mislav Marohnić, PJ Hyett
  81 +Original announcement:: http://errtheblog.com/post/929
  82 +Original PHP source:: http://www.strangerstudios.com/sandbox/pagination/diggstyle.php
  83 +
  84 +All these people helped making will_paginate what it is now with their code
  85 +contributions or just simply awesome ideas:
  86 +
  87 +Chris Wanstrath, Dr. Nic Williams, K. Adam Christensen, Mike Garey, Bence
  88 +Golda, Matt Aimonetti, Charles Brian Quinn, Desi McAdam, James Coglan, Matijs
  89 +van Zuijlen, Maria, Brendan Ribera, Todd Willey, Bryan Helmkamp, Jan Berkel,
  90 +Lourens Naudé, Rick Olson, Russell Norris, Piotr Usewicz, Chris Eppstein,
  91 +Denis Barushev, Ben Pickles.
  92 +
  93 +
  94 +== Usable pagination in the UI
  95 +
  96 +There are some CSS styles to get you started in the "examples/" directory. They
  97 +are {showcased online here}[http://mislav.uniqpath.com/will_paginate/].
  98 +
  99 +More reading about pagination as design pattern:
  100 +
  101 +* {Pagination 101}[http://kurafire.net/log/archive/2007/06/22/pagination-101]
  102 +* {Pagination gallery}[http://www.smashingmagazine.com/2007/11/16/pagination-gallery-examples-and-good-practices/]
  103 +* {Pagination on Yahoo Design Pattern Library}[http://developer.yahoo.com/ypatterns/parent.php?pattern=pagination]
  104 +
  105 +Want to discuss, request features, ask questions? Join the
  106 +{Google group}[http://groups.google.com/group/will_paginate].
  107 +
53 vendor/plugins/will_paginate/Rakefile
... ... @@ -0,0 +1,53 @@
  1 +require 'rubygems'
  2 +begin
  3 + hanna_dir = '/Users/mislav/Projects/Hanna/lib'
  4 + $:.unshift hanna_dir if File.exists? hanna_dir
  5 + require 'hanna/rdoctask'
  6 +rescue LoadError
  7 + require 'rake'
  8 + require 'rake/rdoctask'
  9 +end
  10 +load 'test/tasks.rake'
  11 +
  12 +desc 'Default: run unit tests.'
  13 +task :default => :test
  14 +
  15 +desc 'Generate RDoc documentation for the will_paginate plugin.'
  16 +Rake::RDocTask.new(:rdoc) do |rdoc|
  17 + rdoc.rdoc_files.include('README.rdoc', 'LICENSE', 'CHANGELOG.rdoc').
  18 + include('lib/**/*.rb').
  19 + exclude('lib/will_paginate/named_scope*').
  20 + exclude('lib/will_paginate/array.rb').
  21 + exclude('lib/will_paginate/version.rb')
  22 +
  23 + rdoc.main = "README.rdoc" # page to start on
  24 + rdoc.title = "will_paginate documentation"
  25 +
  26 + rdoc.rdoc_dir = 'doc' # rdoc output folder
  27 + rdoc.options << '--inline-source' << '--charset=UTF-8'
  28 + rdoc.options << '--webcvs=http://github.com/mislav/will_paginate/tree/master/'
  29 +end
  30 +
  31 +desc %{Update ".manifest" with the latest list of project filenames. Respect\
  32 +.gitignore by excluding everything that git ignores. Update `files` and\
  33 +`test_files` arrays in "*.gemspec" file if it's present.}
  34 +task :manifest do
  35 + list = `git ls-files --full-name --exclude=*.gemspec --exclude=.*`.chomp.split("\n")
  36 +
  37 + if spec_file = Dir['*.gemspec'].first
  38 + spec = File.read spec_file
  39 + spec.gsub! /^(\s* s.(test_)?files \s* = \s* )( \[ [^\]]* \] | %w\( [^)]* \) )/mx do
  40 + assignment = $1
  41 + bunch = $2 ? list.grep(/^test\//) : list
  42 + '%s%%w(%s)' % [assignment, bunch.join(' ')]
  43 + end
  44 +
  45 + File.open(spec_file, 'w') { |f| f << spec }
  46 + end
  47 + File.open('.manifest', 'w') { |f| f << list.join("\n") }
  48 +end
  49 +
  50 +task :examples do
  51 + %x(haml examples/index.haml examples/index.html)
  52 + %x(sass examples/pagination.sass examples/pagination.css)
  53 +end
BIN  vendor/plugins/will_paginate/examples/apple-circle.gif
69 vendor/plugins/will_paginate/examples/index.haml
... ... @@ -0,0 +1,69 @@
  1 +!!!
  2 +%html
  3 +%head
  4 + %title Samples of pagination styling for will_paginate
  5 + %link{ :rel => 'stylesheet', :type => 'text/css', :href => 'pagination.css' }
  6 + %style{ :type => 'text/css' }
  7 + :sass
  8 + html
  9 + :margin 0
  10 + :padding 0
  11 + :background #999
  12 + :font normal 76% "Lucida Grande", Verdana, Helvetica, sans-serif
  13 + body
  14 + :margin 2em
  15 + :padding 2em
  16 + :border 2px solid gray
  17 + :background white
  18 + :color #222
  19 + h1
  20 + :font-size 2em
  21 + :font-weight normal
  22 + :margin 0 0 1em 0
  23 + h2
  24 + :font-size 1.4em
  25 + :margin 1em 0 .5em 0
  26 + pre
  27 + :font-size 13px
  28 + :font-family Monaco, "DejaVu Sans Mono", "Bitstream Vera Mono", "Courier New", monospace
  29 +
  30 +- pagination = '<span class="disabled prev_page">&laquo; Previous</span> <span class="current">1</span> <a href="./?page=2" rel="next">2</a> <a href="./?page=3">3</a> <a href="./?page=4">4</a> <a href="./?page=5">5</a> <a href="./?page=6">6</a> <a href="./?page=7">7</a> <a href="./?page=8">8</a> <a href="./?page=9">9</a> <span class="gap">&hellip;</span> <a href="./?page=29">29</a> <a href="./?page=30">30</a> <a href="./?page=2" rel="next" class="next_page">Next &raquo;</a>'
  31 +- pagination_no_page_links = '<span class="disabled prev_page">&laquo; Previous</span> <a href="./?page=2" rel="next" class="next_page">Next &raquo;</a>'
  32 +
  33 +%body
  34 + %h1 Samples of pagination styling for will_paginate
  35 + %p
  36 + Find these styles in <b>"examples/pagination.css"</b> of <i>will_paginate</i> library.
  37 + There is a Sass version of it for all you sassy people.
  38 + %p
  39 + Read about good rules for pagination:
  40 + %a{ :href => 'http://kurafire.net/log/archive/2007/06/22/pagination-101' } Pagination 101
  41 + %p
  42 + %em Warning:
  43 + page links below don't lead anywhere (so don't click on them).
  44 +
  45 + %h2 Unstyled pagination <span style="font-weight:normal">(<i>ewww!</i>)</span>
  46 + %div= pagination
  47 +
  48 + %h2 Digg.com
  49 + .digg_pagination= pagination
  50 +
  51 + %h2 Digg-style, no page links
  52 + .digg_pagination= pagination_no_page_links
  53 + %p Code that renders this:
  54 + %pre= '<code>%s</code>' % %[<%= will_paginate @posts, :page_links => false %>].gsub('<', '&lt;').gsub('>', '&gt;')
  55 +
  56 + %h2 Digg-style, extra content
  57 + .digg_pagination
  58 + .page_info Displaying entries <b>1&nbsp;-&nbsp;6</b> of <b>180</b> in total
  59 + = pagination
  60 + %p Code that renders this:
  61 + %pre= '<code>%s</code>' % %[<div class="digg_pagination">\n <div clas="page_info">\n <%= page_entries_info @posts %>\n </div>\n <%= will_paginate @posts, :container => false %>\n</div>].gsub('<', '&lt;').gsub('>', '&gt;')
  62 +
  63 + %h2 Apple.com store
  64 + .apple_pagination= pagination
  65 +
  66 + %h2 Flickr.com
  67 + .flickr_pagination
  68 + = pagination
  69 + .page_info (118 photos)
92 vendor/plugins/will_paginate/examples/index.html
... ... @@ -0,0 +1,92 @@
  1 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  2 +<html>
  3 +</html>
  4 +<head>
  5 + <title>Samples of pagination styling for will_paginate</title>
  6 + <link href='pagination.css' rel='stylesheet' type='text/css' />
  7 + <style type='text/css'>
  8 + html {
  9 + margin: 0;
  10 + padding: 0;
  11 + background: #999;
  12 + font: normal 76% "Lucida Grande", Verdana, Helvetica, sans-serif; }
  13 +
  14 + body {
  15 + margin: 2em;
  16 + padding: 2em;
  17 + border: 2px solid gray;
  18 + background: white;
  19 + color: #222; }
  20 +
  21 + h1 {
  22 + font-size: 2em;
  23 + font-weight: normal;
  24 + margin: 0 0 1em 0; }
  25 +
  26 + h2 {
  27 + font-size: 1.4em;
  28 + margin: 1em 0 .5em 0; }
  29 +
  30 + pre {
  31 + font-size: 13px;
  32 + font-family: Monaco, "DejaVu Sans Mono", "Bitstream Vera Mono", "Courier New", monospace; }
  33 + </style>
  34 +</head>
  35 +<body>
  36 + <h1>Samples of pagination styling for will_paginate</h1>
  37 + <p>
  38 + Find these styles in <b>"examples/pagination.css"</b> of <i>will_paginate</i> library.
  39 + There is a Sass version of it for all you sassy people.
  40 + </p>
  41 + <p>
  42 + Read about good rules for pagination:
  43 + <a href='http://kurafire.net/log/archive/2007/06/22/pagination-101'>Pagination 101</a>
  44 + </p>
  45 + <p>
  46 + <em>Warning:</em>
  47 + page links below don't lead anywhere (so don't click on them).
  48 + </p>
  49 + <h2>
  50 + Unstyled pagination <span style="font-weight:normal">(<i>ewww!</i>)</span>
  51 + </h2>
  52 + <div>
  53 + <span class="disabled prev_page">&laquo; Previous</span> <span class="current">1</span> <a href="./?page=2" rel="next">2</a> <a href="./?page=3">3</a> <a href="./?page=4">4</a> <a href="./?page=5">5</a> <a href="./?page=6">6</a> <a href="./?page=7">7</a> <a href="./?page=8">8</a> <a href="./?page=9">9</a> <span class="gap">&hellip;</span> <a href="./?page=29">29</a> <a href="./?page=30">30</a> <a href="./?page=2" rel="next" class="next_page">Next &raquo;</a>
  54 + </div>
  55 + <h2>Digg.com</h2>
  56 + <div class='digg_pagination'>
  57 + <span class="disabled prev_page">&laquo; Previous</span> <span class="current">1</span> <a href="./?page=2" rel="next">2</a> <a href="./?page=3">3</a> <a href="./?page=4">4</a> <a href="./?page=5">5</a> <a href="./?page=6">6</a> <a href="./?page=7">7</a> <a href="./?page=8">8</a> <a href="./?page=9">9</a> <span class="gap">&hellip;</span> <a href="./?page=29">29</a> <a href="./?page=30">30</a> <a href="./?page=2" rel="next" class="next_page">Next &raquo;</a>
  58 + </div>
  59 + <h2>Digg-style, no page links</h2>
  60 + <div class='digg_pagination'>
  61 + <span class="disabled prev_page">&laquo; Previous</span> <a href="./?page=2" rel="next" class="next_page">Next &raquo;</a>
  62 + </div>
  63 + <p>Code that renders this:</p>
  64 + <pre>
  65 + <code>&lt;%= will_paginate @posts, :page_links =&gt; false %&gt;</code>
  66 + </pre>
  67 + <h2>Digg-style, extra content</h2>
  68 + <div class='digg_pagination'>
  69 + <div class='page_info'>
  70 + Displaying entries <b>1&nbsp;-&nbsp;6</b> of <b>180</b> in total
  71 + </div>
  72 + <span class="disabled prev_page">&laquo; Previous</span> <span class="current">1</span> <a href="./?page=2" rel="next">2</a> <a href="./?page=3">3</a> <a href="./?page=4">4</a> <a href="./?page=5">5</a> <a href="./?page=6">6</a> <a href="./?page=7">7</a> <a href="./?page=8">8</a> <a href="./?page=9">9</a> <span class="gap">&hellip;</span> <a href="./?page=29">29</a> <a href="./?page=30">30</a> <a href="./?page=2" rel="next" class="next_page">Next &raquo;</a>
  73 + </div>
  74 + <p>Code that renders this:</p>
  75 + <pre>
  76 + <code>&lt;div class="digg_pagination"&gt;
  77 + &lt;div clas="page_info"&gt;
  78 + &lt;%= page_entries_info @posts %&gt;
  79 + &lt;/div&gt;
  80 + &lt;%= will_paginate @posts, :container =&gt; false %&gt;
  81 + &lt;/div&gt;</code>
  82 + </pre>
  83 + <h2>Apple.com store</h2>
  84 + <div class='apple_pagination'>
  85 + <span class="disabled prev_page">&laquo; Previous</span> <span class="current">1</span> <a href="./?page=2" rel="next">2</a> <a href="./?page=3">3</a> <a href="./?page=4">4</a> <a href="./?page=5">5</a> <a href="./?page=6">6</a> <a href="./?page=7">7</a> <a href="./?page=8">8</a> <a href="./?page=9">9</a> <span class="gap">&hellip;</span> <a href="./?page=29">29</a> <a href="./?page=30">30</a> <a href="./?page=2" rel="next" class="next_page">Next &raquo;</a>
  86 + </div>
  87 + <h2>Flickr.com</h2>
  88 + <div class='flickr_pagination'>
  89 + <span class="disabled prev_page">&laquo; Previous</span> <span class="current">1</span> <a href="./?page=2" rel="next">2</a> <a href="./?page=3">3</a> <a href="./?page=4">4</a> <a href="./?page=5">5</a> <a href="./?page=6">6</a> <a href="./?page=7">7</a> <a href="./?page=8">8</a> <a href="./?page=9">9</a> <span class="gap">&hellip;</span> <a href="./?page=29">29</a> <a href="./?page=30">30</a> <a href="./?page=2" rel="next" class="next_page">Next &raquo;</a>
  90 + <div class='page_info'>(118 photos)</div>
  91 + </div>
  92 +</body>
90 vendor/plugins/will_paginate/examples/pagination.css
... ... @@ -0,0 +1,90 @@
  1 +.digg_pagination {
  2 + background: white;
  3 + /* self-clearing method: */ }
  4 + .digg_pagination a, .digg_pagination span {
  5 + padding: .2em .5em;
  6 + display: block;
  7 + float: left;
  8 + margin-right: 1px; }
  9 + .digg_pagination span.disabled {
  10 + color: #999;
  11 + border: 1px solid #DDD; }
  12 + .digg_pagination span.current {
  13 + font-weight: bold;
  14 + background: #2E6AB1;
  15 + color: white;
  16 + border: 1px solid #2E6AB1; }
  17 + .digg_pagination a {
  18 + text-decoration: none;
  19 + color: #105CB6;
  20 + border: 1px solid #9AAFE5; }
  21 + .digg_pagination a:hover, .digg_pagination a:focus {
  22 + color: #003;
  23 + border-color: #003; }
  24 + .digg_pagination .page_info {
  25 + background: #2E6AB1;
  26 + color: white;
  27 + padding: .4em .6em;
  28 + width: 22em;
  29 + margin-bottom: .3em;
  30 + text-align: center; }
  31 + .digg_pagination .page_info b {
  32 + color: #003;
  33 + background: #6aa6ed;
  34 + padding: .1em .25em; }
  35 + .digg_pagination:after {
  36 + content: ".";
  37 + display: block;
  38 + height: 0;
  39 + clear: both;
  40 + visibility: hidden; }
  41 + * html .digg_pagination {
  42 + height: 1%; }
  43 + *:first-child+html .digg_pagination {
  44 + overflow: hidden; }
  45 +
  46 +.apple_pagination {
  47 + background: #F1F1F1;
  48 + border: 1px solid #E5E5E5;
  49 + text-align: center;
  50 + padding: 1em; }
  51 + .apple_pagination a, .apple_pagination span {
  52 + padding: .2em .3em; }
  53 + .apple_pagination span.disabled {
  54 + color: #AAA; }
  55 + .apple_pagination span.current {
  56 + font-weight: bold;
  57 + background: transparent url(apple-circle.gif) no-repeat 50% 50%; }
  58 + .apple_pagination a {
  59 + text-decoration: none;
  60 + color: black; }
  61 + .apple_pagination a:hover, .apple_pagination a:focus {
  62 + text-decoration: underline; }
  63 +
  64 +.flickr_pagination {
  65 + text-align: center;
  66 + padding: .3em; }
  67 + .flickr_pagination a, .flickr_pagination span {
  68 + padding: .2em .5em; }
  69 + .flickr_pagination span.disabled {
  70 + color: #AAA; }
  71 + .flickr_pagination span.current {
  72 + font-weight: bold;
  73 + color: #FF0084; }
  74 + .flickr_pagination a {
  75 + border: 1px solid #DDDDDD;
  76 + color: #0063DC;
  77 + text-decoration: none; }
  78 + .flickr_pagination a:hover, .flickr_pagination a:focus {
  79 + border-color: #003366;
  80 + background: #0063DC;
  81 + color: white; }
  82 + .flickr_pagination .page_info {
  83 + color: #aaa;
  84 + padding-top: .8em; }
  85 + .flickr_pagination .prev_page, .flickr_pagination .next_page {
  86 + border-width: 2px; }
  87 + .flickr_pagination .prev_page {
  88 + margin-right: 1em; }
  89 + .flickr_pagination .next_page {
  90 + margin-left: 1em; }
91 vendor/plugins/will_paginate/examples/pagination.sass
... ... @@ -0,0 +1,91 @@
  1 +.digg_pagination
  2 + :background white
  3 + a, span
  4 + :padding .2em .5em
  5 + :display block
  6 + :float left
  7 + :margin-right 1px
  8 + span.disabled
  9 + :color #999
  10 + :border 1px solid #DDD
  11 + span.current
  12 + :font-weight bold
  13 + :background #2E6AB1
  14 + :color white
  15 + :border 1px solid #2E6AB1
  16 + a
  17 + :text-decoration none
  18 + :color #105CB6
  19 + :border 1px solid #9AAFE5
  20 + &:hover, &:focus
  21 + :color #003
  22 + :border-color #003
  23 + .page_info
  24 + :background #2E6AB1
  25 + :color white
  26 + :padding .4em .6em
  27 + :width 22em
  28 + :margin-bottom .3em
  29 + :text-align center
  30 + b
  31 + :color #003
  32 + :background = #2E6AB1 + 60
  33 + :padding .1em .25em
  34 +
  35 + /* self-clearing method:
  36 + &:after
  37 + :content "."
  38 + :display block
  39 + :height 0
  40 + :clear both
  41 + :visibility hidden
  42 + * html &
  43 + :height 1%
  44 + *:first-child+html &
  45 + :overflow hidden
  46 +
  47 +.apple_pagination
  48 + :background #F1F1F1
  49 + :border 1px solid #E5E5E5
  50 + :text-align center
  51 + :padding 1em
  52 + a, span
  53 + :padding .2em .3em
  54 + span.disabled
  55 + :color #AAA
  56 + span.current
  57 + :font-weight bold
  58 + :background transparent url(apple-circle.gif) no-repeat 50% 50%
  59 + a
  60 + :text-decoration none
  61 + :color black
  62 + &:hover, &:focus
  63 + :text-decoration underline
  64 +
  65 +.flickr_pagination
  66 + :text-align center
  67 + :padding .3em
  68 + a, span
  69 + :padding .2em .5em
  70 + span.disabled
  71 + :color #AAA
  72 + span.current
  73 + :font-weight bold
  74 + :color #FF0084
  75 + a
  76 + :border 1px solid #DDDDDD
  77 + :color #0063DC
  78 + :text-decoration none
  79 + &:hover, &:focus
  80 + :border-color #003366
  81 + :background #0063DC
  82 + :color white
  83 + .page_info
  84 + :color #aaa
  85 + :padding-top .8em
  86 + .prev_page, .next_page
  87 + :border-width 2px
  88 + .prev_page
  89 + :margin-right 1em
  90 + .next_page
  91 + :margin-left 1em
1  vendor/plugins/will_paginate/init.rb
... ... @@ -0,0 +1 @@
  1 +require 'will_paginate'
90 vendor/plugins/will_paginate/lib/will_paginate.rb
... ... @@ -0,0 +1,90 @@
  1 +require 'active_support'
  2 +require 'will_paginate/core_ext'
  3 +
  4 +# = You *will* paginate!
  5 +#
  6 +# First read about WillPaginate::Finder::ClassMethods, then see
  7 +# WillPaginate::ViewHelpers. The magical array you're handling in-between is
  8 +# WillPaginate::Collection.
  9 +#
  10 +# Happy paginating!
  11 +module WillPaginate
  12 + class << self
  13 + # shortcut for <tt>enable_actionpack</tt> and <tt>enable_activerecord</tt> combined
  14 + def enable
  15 + enable_actionpack
  16 + enable_activerecord
  17 + end
  18 +
  19 + # hooks WillPaginate::ViewHelpers into ActionView::Base
  20 + def enable_actionpack
  21 + return if ActionView::Base.instance_methods.include_method? :will_paginate
  22 + require 'will_paginate/view_helpers'
  23 + ActionView::Base.send :include, ViewHelpers
  24 +
  25 + if defined?(ActionController::Base) and ActionController::Base.respond_to? :rescue_responses
  26 + ActionController::Base.rescue_responses['WillPaginate::InvalidPage'] = :not_found
  27 + end
  28 + end
  29 +
  30 + # hooks WillPaginate::Finder into ActiveRecord::Base and classes that deal
  31 + # with associations
  32 + def enable_activerecord
  33 + return if ActiveRecord::Base.respond_to? :paginate
  34 + require 'will_paginate/finder'
  35 + ActiveRecord::Base.send :include, Finder
  36 +
  37 + # support pagination on associations
  38 + a = ActiveRecord::Associations
  39 + returning([ a::AssociationCollection ]) { |classes|
  40 + # detect http://dev.rubyonrails.org/changeset/9230
  41 + unless a::HasManyThroughAssociation.superclass == a::HasManyAssociation
  42 + classes << a::HasManyThroughAssociation
  43 + end
  44 + }.each do |klass|
  45 + klass.send :include, Finder::ClassMethods
  46 + klass.class_eval { alias_method_chain :method_missing, :paginate }
  47 + end
  48 +
  49 + # monkeypatch Rails ticket #2189: "count breaks has_many :through"
  50 + ActiveRecord::Base.class_eval do
  51 + protected
  52 + def self.construct_count_options_from_args(*args)
  53 + result = super
  54 + result[0] = '*' if result[0].is_a?(String) and result[0] =~ /\.\*$/
  55 + result
  56 + end
  57 + end
  58 + end
  59 +
  60 + # Enable named_scope, a feature of Rails 2.1, even if you have older Rails
  61 + # (tested on Rails 2.0.2 and 1.2.6).
  62 + #
  63 + # You can pass +false+ for +patch+ parameter to skip monkeypatching
  64 + # *associations*. Use this if you feel that <tt>named_scope</tt> broke
  65 + # has_many, has_many :through or has_and_belongs_to_many associations in
  66 + # your app. By passing +false+, you can still use <tt>named_scope</tt> in
  67 + # your models, but not through associations.
  68 + def enable_named_scope(patch = true)
  69 + return if defined? ActiveRecord::NamedScope
  70 + require 'will_paginate/named_scope'
  71 + require 'will_paginate/named_scope_patch' if patch
  72 +
  73 + ActiveRecord::Base.send :include, WillPaginate::NamedScope
  74 + end
  75 + end
  76 +
  77 + module Deprecation # :nodoc:
  78 + extend ActiveSupport::Deprecation
  79 +
  80 + def self.warn(message, callstack = caller)
  81 + message = 'WillPaginate: ' + message.strip.gsub(/\s+/, ' ')
  82 + ActiveSupport::Deprecation.warn(message, callstack)
  83 + end
  84 + end
  85 +end
  86 +
  87 +if defined? Rails
  88 + WillPaginate.enable_activerecord if defined? ActiveRecord
  89 + WillPaginate.enable_actionpack if defined? ActionController
  90 +end
16 vendor/plugins/will_paginate/lib/will_paginate/array.rb
... ... @@ -0,0 +1,16 @@
  1 +require 'will_paginate/collection'
  2 +
  3 +# http://www.desimcadam.com/archives/8
  4 +Array.class_eval do
  5 + def paginate(options = {})
  6 + raise ArgumentError, "parameter hash expected (got #{options.inspect})" unless Hash === options
  7 +
  8 + WillPaginate::Collection.create(
  9 + options[:page] || 1,
  10 + options[:per_page] || 30,
  11 + options[:total_entries] || self.length
  12 + ) { |pager|
  13 + pager.replace self[pager.offset, pager.per_page].to_a
  14 + }
  15 + end
  16 +end
144 vendor/plugins/will_paginate/lib/will_paginate/collection.rb
... ... @@ -0,0 +1,144 @@
  1 +module WillPaginate
  2 + # = Invalid page number error
  3 + # This is an ArgumentError raised in case a page was requested that is either
  4 + # zero or negative number. You should decide how do deal with such errors in
  5 + # the controller.
  6 + #
  7 + # If you're using Rails 2, then this error will automatically get handled like
  8 + # 404 Not Found. The hook is in "will_paginate.rb":
  9 + #
  10 + # ActionController::Base.rescue_responses['WillPaginate::InvalidPage'] = :not_found
  11 + #
  12 + # If you don't like this, use your preffered method of rescuing exceptions in
  13 + # public from your controllers to handle this differently. The +rescue_from+
  14 + # method is a nice addition to Rails 2.
  15 + #
  16 + # This error is *not* raised when a page further than the last page is
  17 + # requested. Use <tt>WillPaginate::Collection#out_of_bounds?</tt> method to
  18 + # check for those cases and manually deal with them as you see fit.
  19 + class InvalidPage < ArgumentError
  20 + def initialize(page, page_num)
  21 + super "#{page.inspect} given as value, which translates to '#{page_num}' as page number"
  22 + end
  23 + end
  24 +
  25 + # = The key to pagination
  26 + # Arrays returned from paginating finds are, in fact, instances of this little
  27 + # class. You may think of WillPaginate::Collection as an ordinary array with
  28 + # some extra properties. Those properties are used by view helpers to generate
  29 + # correct page links.
  30 + #
  31 + # WillPaginate::Collection also assists in rolling out your own pagination
  32 + # solutions: see +create+.
  33 + #
  34 + # If you are writing a library that provides a collection which you would like
  35 + # to conform to this API, you don't have to copy these methods over; simply
  36 + # make your plugin/gem dependant on this library and do:
  37 + #
  38 + # require 'will_paginate/collection'
  39 + # # WillPaginate::Collection is now available for use
  40 + class Collection < Array
  41 + attr_reader :current_page, :per_page, :total_entries, :total_pages
  42 +
  43 + # Arguments to the constructor are the current page number, per-page limit
  44 + # and the total number of entries. The last argument is optional because it
  45 + # is best to do lazy counting; in other words, count *conditionally* after
  46 + # populating the collection using the +replace+ method.
  47 + def initialize(page, per_page, total = nil)
  48 + @current_page = page.to_i
  49 + raise InvalidPage.new(page, @current_page) if @current_page < 1
  50 + @per_page = per_page.to_i
  51 + raise ArgumentError, "`per_page` setting cannot be less than 1 (#{@per_page} given)" if @per_page < 1
  52 +
  53 + self.total_entries = total if total
  54 + end
  55 +
  56 + # Just like +new+, but yields the object after instantiation and returns it
  57 + # afterwards. This is very useful for manual pagination:
  58 + #
  59 + # @entries = WillPaginate::Collection.create(1, 10) do |pager|
  60 + # result = Post.find(:all, :limit => pager.per_page, :offset => pager.offset)
  61 + # # inject the result array into the paginated collection:
  62 + # pager.replace(result)
  63 + #
  64 + # unless pager.total_entries
  65 + # # the pager didn't manage to guess the total count, do it manually
  66 + # pager.total_entries = Post.count
  67 + # end
  68 + # end
  69 + #
  70 + # The possibilities with this are endless. For another example, here is how
  71 + # WillPaginate used to define pagination for Array instances:
  72 + #
  73 + # Array.class_eval do
  74 + # def paginate(page = 1, per_page = 15)
  75 + # WillPaginate::Collection.create(page, per_page, size) do |pager|
  76 + # pager.replace self[pager.offset, pager.per_page].to_a
  77 + # end
  78 + # end
  79 + # end
  80 + #
  81 + # The Array#paginate API has since then changed, but this still serves as a
  82 + # fine example of WillPaginate::Collection usage.
  83 + def self.create(page, per_page, total = nil)
  84 + pager = new(page, per_page, total)
  85 + yield pager
  86 + pager
  87 + end
  88 +
  89 + # Helper method that is true when someone tries to fetch a page with a
  90 + # larger number than the last page. Can be used in combination with flashes
  91 + # and redirecting.
  92 + def out_of_bounds?
  93 + current_page > total_pages
  94 + end
  95 +
  96 + # Current offset of the paginated collection. If we're on the first page,
  97 + # it is always 0. If we're on the 2nd page and there are 30 entries per page,
  98 + # the offset is 30. This property is useful if you want to render ordinals
  99 + # side by side with records in the view: simply start with offset + 1.
  100 + def offset
  101 + (current_page - 1) * per_page
  102 + end
  103 +
  104 + # current_page - 1 or nil if there is no previous page
  105 + def previous_page
  106 + current_page > 1 ? (current_page - 1) : nil
  107 + end
  108 +
  109 + # current_page + 1 or nil if there is no next page
  110 + def next_page
  111 + current_page < total_pages ? (current_page + 1) : nil
  112 + end
  113 +
  114 + # sets the <tt>total_entries</tt> property and calculates <tt>total_pages</tt>
  115 + def total_entries=(number)
  116 + @total_entries = number.to_i
  117 + @total_pages = (@total_entries / per_page.to_f).ceil
  118 + end
  119 +
  120 + # This is a magic wrapper for the original Array#replace method. It serves
  121 + # for populating the paginated collection after initialization.
  122 + #
  123 + # Why magic? Because it tries to guess the total number of entries judging
  124 + # by the size of given array. If it is shorter than +per_page+ limit, then we
  125 + # know we're on the last page. This trick is very useful for avoiding
  126 + # unnecessary hits to the database to do the counting after we fetched the
  127 + # data for the current page.
  128 + #
  129 + # However, after using +replace+ you should always test the value of
  130 + # +total_entries+ and set it to a proper value if it's +nil+. See the example
  131 + # in +create+.
  132 + def replace(array)
  133 + result = super
  134 +
  135 + # The collection is shorter then page limit? Rejoice, because
  136 + # then we know that we are on the last page!
  137 + if total_entries.nil? and length < per_page and (current_page == 1 or length > 0)
  138 + self.total_entries = offset + length
  139 + end
  140 +
  141 + result
  142 + end
  143 + end
  144 +end
43 vendor/plugins/will_paginate/lib/will_paginate/core_ext.rb
... ... @@ -0,0 +1,43 @@
  1 +require 'set'
  2 +require 'will_paginate/array'
  3 +
  4 +# helper to check for method existance in ruby 1.8- and 1.9-compatible way
  5 +# because `methods`, `instance_methods` and others return strings in 1.8 and symbols in 1.9
  6 +#
  7 +# ['foo', 'bar'].include_method?(:foo) # => true
  8 +class Array
  9 + def include_method?(name)
  10 + name = name.to_sym
  11 + !!(find { |item| item.to_sym == name })
  12 + end
  13 +end
  14 +
  15 +unless Hash.instance_methods.include_method? :except
  16 + Hash.class_eval do
  17 + # Returns a new hash without the given keys.
  18 + def except(*keys)
  19 + rejected = Set.new(respond_to?(:convert_key) ? keys.map { |key| convert_key(key) } : keys)
  20 + reject { |key,| rejected.include?(key) }
  21 + end
  22 +
  23 + # Replaces the hash without only the given keys.
  24 + def except!(*keys)
  25 + replace(except(*keys))
  26 + end
  27 + end
  28 +end
  29 +
  30 +unless Hash.instance_methods.include_method? :slice
  31 + Hash.class_eval do
  32 + # Returns a new hash with only the given keys.
  33 + def slice(*keys)
  34 + allowed = Set.new(respond_to?(:convert_key) ? keys.map { |key| convert_key(key) } : keys)
  35 + reject { |key,| !allowed.include?(key) }
  36 + end
  37 +
  38 + # Replaces the hash with only the given keys.
  39 + def slice!(*keys)
  40 + replace(slice(*keys))
  41 + end
  42 + end
  43 +end
264 vendor/plugins/will_paginate/lib/will_paginate/finder.rb
... ... @@ -0,0 +1,264 @@
  1 +require 'will_paginate/core_ext'
  2 +
  3 +module WillPaginate
  4 + # A mixin for ActiveRecord::Base. Provides +per_page+ class method
  5 + # and hooks things up to provide paginating finders.
  6 + #
  7 + # Find out more in WillPaginate::Finder::ClassMethods
  8 + #
  9 + module Finder
  10 + def self.included(base)
  11 + base.extend ClassMethods
  12 + class << base
  13 + alias_method_chain :method_missing, :paginate
  14 + # alias_method_chain :find_every, :paginate
  15 + define_method(:per_page) { 30 } unless respond_to?(:per_page)
  16 + end
  17 + end
  18 +
  19 + # = Paginating finders for ActiveRecord models
  20 + #
  21 + # WillPaginate adds +paginate+, +per_page+ and other methods to
  22 + # ActiveRecord::Base class methods and associations. It also hooks into
  23 + # +method_missing+ to intercept pagination calls to dynamic finders such as
  24 + # +paginate_by_user_id+ and translate them to ordinary finders
  25 + # (+find_all_by_user_id+ in this case).
  26 + #
  27 + # In short, paginating finders are equivalent to ActiveRecord finders; the
  28 + # only difference is that we start with "paginate" instead of "find" and
  29 + # that <tt>:page</tt> is required parameter:
  30 + #
  31 + # @posts = Post.paginate :all, :page => params[:page], :order => 'created_at DESC'
  32 + #
  33 + # In paginating finders, "all" is implicit. There is no sense in paginating