searchlogic 1.5.3

data/lib/searchlogic/helpers/control_types/link.rb

@@ -0,0 +1,310 @@
+module Searchlogic
+  module Helpers
+    # = Control Type Helpers
+    #
+    # The purpose of these helpers is to make ordering and paginating data, in your view, a breeze. Everyone has their own flavor of displaying data, so I made these helpers extra flexible, just for you.
+    #
+    # === Tutorial
+    #
+    # Check out my tutorial on how to implement searchlogic into a rails app: http://www.binarylogic.com/2008/9/7/tutorial-pagination-ordering-and-searching-with-searchlogic
+    #
+    # === How it's organized
+    #
+    # If we break it down, you can do 4 different things with your data in your view:
+    #
+    # 1. Order your data by a single column or an array of columns
+    # 2. Descend or ascend your data
+    # 3. Change how many items are on each page
+    # 4. Paginate through your data
+    #
+    # Each one of these actions comes with 3 different types of helpers:
+    #
+    # 1. Link - A single link for a single value. Requires that you pass a value as the first parameter.
+    # 2. Links - A group of single links.
+    # 3. Select - A select with choices that perform an action once selected. Basically the same thing as a group of links, but just as a select form element
+    # 4. Remote - lets you prefix any of these helpers with "remote_" and it will use the built in rails ajax helpers. I highly recommend unobstrusive javascript though, using jQuery.
+    #
+    # === Examples
+    #
+    # Sometimes the best way to explain something is with some examples. Let's pretend we are performing these actions on a User model. Check it out:
+    #
+    #   order_by_link(:name)
+    #   => produces a single link that when clicked will order by the name column, and each time its clicked alternated between "ASC" and "DESC"
+    #
+    #   order_by_links
+    #   => produces a group of links for all of the columns in your users table, each link is basically order_by_link(column.name)
+    #
+    #   order_by_select
+    #   => produces a select form element with all of the user's columns as choices, when the value is change (onchange) it will act as if they clicked a link.
+    #   => This is just order_by_links as a select form element, nothing fancy
+    #
+    # What about paginating? I got you covered:
+    #
+    #   page_link(2)
+    #   => creates a link to page 2
+    #
+    #   page_links
+    #   => creates a group of links for pages, similar to a flickr style of pagination
+    #
+    #   page_select
+    #   => creates a drop down instead of a group of links. The user can select the page in the drop down and it will be as if they clicked a link for that page.
+    #
+    # You can apply the _link, _links, or _select to any of the following: order_by, order_as, per_page, page. You have your choice on how you want to set up the interface. For more information and options on these individual
+    # helpers check out their source files. Look at the sub modules under this one (Ex: Searchlogic::Helpers::ControlTypes::Select)
+    module ControlTypes
+      # = Link Control Types
+      #
+      # These helpers make ordering and paginating your data a breeze in your view. They only produce links.
+      module Link
+        # Creates a link for ordering data by a column or columns
+        #
+        # === Example uses for a User class that has many orders
+        #
+        #   order_by_link(:first_name)
+        #   order_by_link([:first_name, :last_name])
+        #   order_by_link({:orders => :total})
+        #   order_by_link([{:orders => :total}, :first_name])
+        #   order_by_link(:id, :text => "Order Number", :html => {:class => "order_number"})
+        #
+        # What's nifty about this is that the value gets "serialized", if it is not a string or a symbol, so that it can be passed via a param in the url. Searchlogic will automatically try to "unserializes" this value and use it. This allows you
+        # to pass complex objects besides strings and symbols, such as arrays and hashes. All of the hard work is done for you.
+        #
+        # Another thing to keep in mind is that this will alternate between "asc" and "desc" each time it is clicked.
+        #
+        # === Options
+        # * <tt>:text</tt> -- default: column_name.to_s.humanize, text for the link
+        # * <tt>:desc_indicator</tt> -- default: &nbsp;&#9660;, the indicator that this column is descending
+        # * <tt>:asc_indicator</tt> -- default: &nbsp;&#9650;, the indicator that this column is ascending
+        # * <tt>:html</tt> -- html arrtributes for the <a> tag.
+        #
+        # === Advanced Options
+        # * <tt>:params_scope</tt> -- default: :search, this is the scope in which your search params will be preserved (params[:search]). If you don't want a scope and want your options to be at base level in params such as params[:page], params[:per_page], etc, then set this to nil.
+        # * <tt>:search_obj</tt> -- default: @#{params_scope}, this is your search object, everything revolves around this. It will try to infer the name from your params_scope. If your params_scope is :search it will try to get @search, etc. If it can not be inferred by this, you need to pass the object itself.
+        # * <tt>:params</tt> -- default: nil, Additional params to add to the url, must be a hash
+        # * <tt>:exclude_params</tt> -- default: nil, params you want to exclude. This is nifty because it does a "deep delete". So you can pass {:param1 => {:param2 => :param3}} and it will make sure param3 does not get included. param1 and param2 will not be touched. This also accepts an array or just a symbol or string.
+        # * <tt>:search_params</tt> -- default: nil, Additional search params to add to the url, must be a hash. Adds the options into the :params_scope.
+        # * <tt>:exclude_search_params</tt> -- default: nil, Same as :exclude_params but for the :search_params.
+        def order_by_link(order_by, options = {})
+          add_order_by_link_defaults!(order_by, options)
+          html = searchlogic_state(options)
+          
+          if !options[:is_remote]
+            html += link_to(options[:text], options[:url], options[:html])
+          else
+            html += link_to_remote(options[:text], options[:remote].merge(:url => options[:url]), options[:html])
+          end
+          
+          html
+        end
+        
+        # Creates a link for ascending or descending data.
+        #
+        # === Example uses
+        #
+        #   order_as_link("asc")
+        #   order_as_link("desc")
+        #   order_as_link("asc", :text => "Ascending", :html => {:class => "ascending"})
+        #
+        # === Options
+        # * <tt>:text</tt> -- default: column_name.to_s.humanize, text for the link
+        # * <tt>:html</tt> -- html arrtributes for the <a> tag.
+        #
+        # === Advanced Options
+        # * <tt>:params_scope</tt> -- default: :search, this is the scope in which your search params will be preserved (params[:search]). If you don't want a scope and want your options to be at base level in params such as params[:page], params[:per_page], etc, then set this to nil.
+        # * <tt>:search_obj</tt> -- default: @#{params_scope}, this is your search object, everything revolves around this. It will try to infer the name from your params_scope. If your params_scope is :search it will try to get @search, etc. If it can not be inferred by this, you need to pass the object itself.
+        # * <tt>:params</tt> -- default: nil, Additional params to add to the url, must be a hash
+        # * <tt>:exclude_params</tt> -- default: nil, params you want to exclude. This is nifty because it does a "deep delete". So you can pass {:param1 => {:param2 => :param3}} and it will make sure param3 does not get included. param1 and param2 will not be touched. This also accepts an array or just a symbol or string.
+        # * <tt>:search_params</tt> -- default: nil, Additional search params to add to the url, must be a hash. Adds the options into the :params_scope.
+        # * <tt>:exclude_search_params</tt> -- default: nil, Same as :exclude_params but for the :search_params.
+        def order_as_link(order_as, options = {})
+          add_order_as_link_defaults!(order_as, options)
+          html = searchlogic_state(options)
+          
+          if !options[:is_remote]
+            html += link_to(options[:text], options[:url], options[:html])
+          else
+            html += link_to_remote(options[:text], options[:remote].merge(:url => options[:url]), options[:html])
+          end
+          
+          html
+        end
+        
+        # This is similar to order_by_link but with a small difference. The best way to explain priority ordering is with an example. Let's say you wanted to list products on a page. You have "featured" products
+        # that you want to show up first, no matter what. This is what this is all about. It makes ordering by featured products a priority, then searching by price, quantity, etc. is the same as it has always been.
+        #
+        # The difference between order_by_link and priority_order_by_link is that priority_order_by_link it just a switch. Turn it on or turn it off. You don't neccessarily want to flip between ASC and DESC. If you do
+        # then you should just incorporate this into your regular order_by, like: order_by_link [:featured, :price]
+        #
+        # === Example uses for a User class that has many orders
+        #
+        #   priority_order_by_link(:featured, "DESC")
+        #   order_by_link([:featured, :created_at], "ASC")
+        #   order_by_link({:orders => :featured}, "ASC")
+        #   order_by_link([{:orders => :featured}, :featured], "ASC")
+        #   order_by_link(:featured, "ASC", :text => "Featured", :html => {:class => "featured_link"})
+        #
+        # === Options
+        # * <tt>:activate_text</tt> -- default: "Show #{column_name.to_s.humanize} first"
+        # * <tt>:deactivate_text</tt> -- default: "Don't show #{column_name.to_s.humanize} first", text for the link, text for the link
+        # * <tt>:column_name</tt> -- default: column_name.to_s.humanize, automatically inferred by what you are ordering by and is added into the active_text and deactive_text strings.
+        # * <tt>:text</tt> -- default: :activate_text or :deactivate_text depending on if its active or not, Overwriting this will make this text stay the same, no matter way. A good alternative would be "Toggle featured first"
+        # * <tt>:html</tt> -- html arrtributes for the <a> tag.
+        #
+        # === Advanced Options
+        # * <tt>:params_scope</tt> -- default: :search, this is the scope in which your search params will be preserved (params[:search]). If you don't want a scope and want your options to be at base level in params such as params[:page], params[:per_page], etc, then set this to nil.
+        # * <tt>:search_obj</tt> -- default: @#{params_scope}, this is your search object, everything revolves around this. It will try to infer the name from your params_scope. If your params_scope is :search it will try to get @search, etc. If it can not be inferred by this, you need to pass the object itself.
+        # * <tt>:params</tt> -- default: nil, Additional params to add to the url, must be a hash
+        # * <tt>:exclude_params</tt> -- default: nil, params you want to exclude. This is nifty because it does a "deep delete". So you can pass {:param1 => {:param2 => :param3}} and it will make sure param3 does not get included. param1 and param2 will not be touched. This also accepts an array or just a symbol or string.
+        # * <tt>:search_params</tt> -- default: nil, Additional search params to add to the url, must be a hash. Adds the options into the :params_scope.
+        # * <tt>:exclude_search_params</tt> -- default: nil, Same as :exclude_params but for the :search_params.
+        def priority_order_by_link(priority_order_by, priority_order_as, options = {})
+          add_priority_order_by_link_defaults!(priority_order_by, priority_order_as, options)
+          html = searchlogic_state(options)
+          
+          if !options[:is_remote]
+            html += link_to(options[:text], options[:url], options[:html])
+          else
+            html += link_to_remote(options[:text], options[:remote].merge(:url => options[:url]), options[:html])
+          end
+          
+          html
+        end
+        
+        # Creates a link for limiting how many items are on each page
+        #
+        # === Example uses
+        #
+        #   per_page_link(200)
+        #   per_page_link(nil) # => Show all
+        #   per_page_link(nil, :text => "All", :html => {:class => "show_all"})
+        #
+        # As you can see above, passing nil means "show all" and the text will automatically revert to "show all"
+        #
+        # === Options
+        # * <tt>:html</tt> -- html arrtributes for the <a> tag.
+        #
+        # === Advanced Options
+        # * <tt>:params_scope</tt> -- default: :search, this is the scope in which your search params will be preserved (params[:search]). If you don't want a scope and want your options to be at base level in params such as params[:page], params[:per_page], etc, then set this to nil.
+        # * <tt>:search_obj</tt> -- default: @#{params_scope}, this is your search object, everything revolves around this. It will try to infer the name from your params_scope. If your params_scope is :search it will try to get @search, etc. If it can not be inferred by this, you need to pass the object itself.
+        # * <tt>:params</tt> -- default: nil, Additional params to add to the url, must be a hash
+        # * <tt>:exclude_params</tt> -- default: nil, params you want to exclude. This is nifty because it does a "deep delete". So you can pass {:param1 => {:param2 => :param3}} and it will make sure param3 does not get included. param1 and param2 will not be touched. This also accepts an array or just a symbol or string.
+        # * <tt>:search_params</tt> -- default: nil, Additional search params to add to the url, must be a hash. Adds the options into the :params_scope.
+        # * <tt>:exclude_search_params</tt> -- default: nil, Same as :exclude_params but for the :search_params.
+        def per_page_link(per_page, options = {})
+          add_per_page_link_defaults!(per_page, options)
+          html = searchlogic_state(options)
+          
+          if !options[:is_remote]
+            html += link_to(options[:text], options[:url], options[:html])
+          else
+            html += link_to_remote(options[:text], options[:remote].merge(:url => options[:url]), options[:html])
+          end
+          
+          html
+        end
+        
+        # Creates a link for changing to a sepcific page of your data
+        #
+        # === Example uses
+        #
+        #   page_link(2)
+        #   page_link(1)
+        #   page_link(5, :text => "Fifth page", :html => {:class => "fifth_page"})
+        #
+        # === Options
+        # * <tt>:text</tt> -- default: column_name.to_s.humanize, text for the link
+        # * <tt>:html</tt> -- html arrtributes for the <a> tag.
+        #
+        # === Advanced Options
+        # * <tt>:params_scope</tt> -- default: :search, this is the scope in which your search params will be preserved (params[:search]). If you don't want a scope and want your options to be at base level in params such as params[:page], params[:per_page], etc, then set this to nil.
+        # * <tt>:search_obj</tt> -- default: @#{params_scope}, this is your search object, everything revolves around this. It will try to infer the name from your params_scope. If your params_scope is :search it will try to get @search, etc. If it can not be inferred by this, you need to pass the object itself.
+        # * <tt>:params</tt> -- default: nil, Additional params to add to the url, must be a hash
+        # * <tt>:exclude_params</tt> -- default: nil, params you want to exclude. This is nifty because it does a "deep delete". So you can pass {:param1 => {:param2 => :param3}} and it will make sure param3 does not get included. param1 and param2 will not be touched. This also accepts an array or just a symbol or string.
+        # * <tt>:search_params</tt> -- default: nil, Additional search params to add to the url, must be a hash. Adds the options into the :params_scope.
+        # * <tt>:exclude_search_params</tt> -- default: nil, Same as :exclude_params but for the :search_params.
+        def page_link(page, options = {})
+          add_page_link_defaults!(page, options)
+          html = searchlogic_state(options)
+          
+          if !options[:is_remote]
+            html += link_to(options[:text], options[:url], options[:html])
+          else
+            html += link_to_remote(options[:text], options[:remote].merge(:url => options[:url]), options[:html])
+          end
+          
+          html
+        end
+        
+        private
+          def add_order_by_link_defaults!(order_by, options = {})
+            add_searchlogic_control_defaults!(options)
+            searchlogic_add_class!(options[:html], Config.helpers.order_by_link_class_name)
+            ordering_by_this = searchlogic_ordering_by?(order_by, options)
+            searchlogic_add_class!(options[:html], "ordering") if ordering_by_this
+            options[:text] ||= determine_order_by_text(order_by)
+            options[:asc_indicator] ||= Config.helpers.order_by_link_asc_indicator
+            options[:desc_indicator] ||= Config.helpers.order_by_link_desc_indicator
+            options[:text] += options[:search_obj].desc? ? options[:desc_indicator] : options[:asc_indicator] if ordering_by_this
+            options[:url] = searchlogic_params(options.merge(:search_params => {:order_by => order_by}))
+            options
+          end
+          
+          def add_order_as_link_defaults!(order_as, options = {})
+            add_searchlogic_control_defaults!(options)
+            searchlogic_add_class!(options[:html], Config.helpers.order_as_link_class_name)
+            options[:text] ||= order_as.to_s
+            options[:url] = searchlogic_params(options.merge(:search_params => {:order_as => order_as}))
+            options
+          end
+          
+          def add_priority_order_by_link_defaults!(priority_order_by, priority_order_as, options = {})
+            add_searchlogic_control_defaults!(options)
+            searchlogic_add_class!(options[:html], Config.helpers.priority_order_by_link_class_name)
+            options[:column_name] ||= determine_order_by_text(priority_order_by).downcase 
+            options[:activate_text] ||= Config.helpers.priority_order_by_link_activate_text % options[:column_name]
+            options[:deactivate_text] ||= Config.helpers.priority_order_by_link_deactivate_text % options[:column_name]
+            active = deep_stringify(options[:search_obj].priority_order_by) == deep_stringify(priority_order_by) && options[:search_obj].priority_order_as == priority_order_as
+            options[:text] ||= active ? options[:deactivate_text] : options[:activate_text]
+            if active
+              options.merge!(:search_params => {:priority_order_by => nil, :priority_order_as => nil})
+            else
+              options.merge!(:search_params => {:priority_order_by => priority_order_by, :priority_order_as => priority_order_as})
+            end
+            options[:url] = searchlogic_params(options)
+            options
+          end
+          
+          def add_per_page_link_defaults!(per_page, options = {})
+            add_searchlogic_control_defaults!(options)
+            searchlogic_add_class!(options[:html], Config.helpers.per_page_link_class_name)
+            options[:text] ||= per_page.to_s
+            options[:url] = searchlogic_params(options.merge(:search_params => {:per_page => per_page}))
+            options
+          end
+          
+          def add_page_link_defaults!(page, options = {})
+            add_searchlogic_control_defaults!(options)
+            searchlogic_add_class!(options[:html], Config.helpers.page_link_class_name)
+            options[:text] ||= page.to_s
+            options[:url] = searchlogic_params(options.merge(:search_params => {:page => page}))
+            options
+          end
+          
+          def determine_order_by_text(column_name, relationship_name = nil)
+            case column_name
+            when String, Symbol
+              relationship_name.blank? ? column_name.to_s.titleize : "#{relationship_name.to_s.titleize} #{column_name.to_s.titleize}"
+            when Array
+              determine_order_by_text(column_name.first)
+            when Hash
+              k = column_name.keys.first
+              v = column_name.values.first
+              determine_order_by_text(v, k)
+            end
+          end
+      end
+    end
+  end
+end
+
+ActionController::Base.helper Searchlogic::Helpers::ControlTypes::Link if defined?(ActionController)

data/lib/searchlogic/helpers/control_types/links.rb

@@ -0,0 +1,241 @@
+module Searchlogic
+  module Helpers
+    module ControlTypes
+      module Links
+        # Creates a group of links that order the data by a column or columns. All that this does is loop through the :choices option and call order_by_link and then glue it all together.
+        #
+        # === Examples
+        #
+        #   order_by_links
+        #   order_by_links(:choices => [:name, {:orders => {:line_items => :total}}, :email])
+        #
+        # === Options
+        #
+        # Please look at order_by_link. All options there are applicable here and are passed onto each option.
+        #
+        # * <tt>:choices</tt> -- default: the models column names, the choices to loop through when calling order_by_link
+        def order_by_links(options = {})
+          add_order_by_links_defaults!(options)
+          links_options = options.deep_dup
+          links_options.delete(:choices)
+          html = ""
+          options[:choices].each do |choice|
+            link_options = links_option.deep_dup
+            text, value = option_text_and_value(choice)
+            link_options[:text] ||= text
+            html += order_by_link(value, link_options)
+          end
+          html
+        end
+        
+        # Creates a group of links that ascend or descend the data. All that this does is loop through the :choices option and call order_as_link and then glue it all together.
+        #
+        # === Examples
+        #
+        #   order_as_links
+        #   order_as_links(:choices => [:ascending, :descending])
+        #
+        # === Options
+        #
+        # Please look at order_as_link. All options there are applicable here and are passed onto each option.
+        #
+        # * <tt>:choices</tt> -- default: ["asc", "desc"], the choices to loop through when calling order_as_link
+        def order_as_links(options = {})
+          add_order_as_links_defaults!(options)
+          links_options = options.deep_dup
+          links_options.delete(:choices)
+          html = ""
+          options[:choices].each do |choice|
+            link_options = links_option.deep_dup
+            text, value = option_text_and_value(choice)
+            link_options[:text] ||= text
+            html += order_as_link(value, link_options)
+          end
+          html
+        end
+        
+        # Creates a group of links that limit how many items are on each page. All that this does is loop through the :choices option and call per_page_link and then glue it all together.
+        #
+        # === Examples
+        #
+        #   per_page_links
+        #   per_page_links(:choices => [25, 50, nil])
+        #
+        # === Options
+        #
+        # Please look at per_page_link. All options there are applicable here and are passed onto each option.
+        #
+        # * <tt>:choices</tt> -- default: [["10 per page", 10], ["25 per page", 25], ["50 per page", 50], ["100 per page", 100], ["150 per page", 150], ["200 per page", 200], ["Show all", nil]]
+        def per_page_links(options = {})
+          add_per_page_links_defaults!(options)
+          links_options = options.deep_dup
+          links_options.delete(:choices)
+          html = ""
+          options[:choices].each do |choice|
+            link_options = links_options.deep_dup
+            text, value = option_text_and_value(choice)
+            link_options[:text] ||= text
+            searchlogic_add_class!(link_options[:html], Config.helpers.order_by_links_ordering_by_class_name) if link_options[:search_obj].per_page == value
+            html += per_page_link(value, link_options)
+          end
+          html
+        end
+        
+        # Creates a group of links that paginate through the data. Kind of like a flickr page navigation. This one has some nifty options.
+        #
+        # === Examples
+        #
+        #   page_links
+        #   page_links(:first => "<< First", :last => "Last >>")
+        #
+        # === Classes and tags
+        #
+        # If the user is on the current page they will get a <span> tag, not an <a> tag. If they are on the first page the "first" and "prev" options will be a <span> also. The same goes
+        # for "next" and "last" if the user is on the last page. Other than that each element will come with a CSS class so you can style it to your liking. Somtimes the easiest way to understand this
+        # Is to either look at the example (linked in the README) or try it out and view the HTML source. It's pretty simple, but here are the explanations:
+        #
+        # * <tt>page</tt> - This is in *every* element, span or a.
+        # * <tt>first_page</tt> - This is for the "first page" element only.
+        # * <tt>prev_page</tt> - This is for the "prev page" element only.
+        # * <tt>current_page</tt> - This is for the current page element
+        # * <tt>next_page</tt> - This is for the "next page" element only.
+        # * <tt>last_page</tt> - This is for the "last page" element only.
+        # * <tt>disabled_page</tt> - Any element that is a span instead of an a tag.
+        #
+        # === Options
+        #
+        # Please look at per_page_link. All options there are applicable here and are passed onto each option.
+        #
+        # * <tt>:inner_spread</tt> -- default: 3, set to nil to show all pages, set 0 to show no page links. This represents how many choices available on each side of the current page
+        # * <tt>:outer_spread</tt> -- default: 1, set to nil to disable, set to 0 show no outer spread but the separator will still be present. This represents how many choices are in the "outer" spread.
+        # * <tt>:prev</tt> -- default: "< Prev", set to nil to omit. This is an extra link on the left side of the page links that will go to the previous page
+        # * <tt>:next</tt> -- default: "Next >", set to nil to omit. This is an extra link on the right side of the page links that will go to the next page
+        # * <tt>:first</tt> -- default: nil, set to nil to omit. This is an extra link on thefar left side of the page links that will go to the first page
+        # * <tt>:last</tt> -- default: nil, set to nil to omit. This is an extra link on the far right side of the page links that will go to the last page
+        def page_links(options = {})
+          add_page_links_defaults!(options)
+          return if options[:last_page] <= 1
+          
+          inner_spread_start = inner_spread_end = lower_gap = lower_outer_spread_start = lower_outer_spread_end = upper_gap = upper_outer_spread_start = upper_outer_spread_end = 0
+          if !options[:inner_spread].blank?
+            inner_spread_start = options[:current_page] - options[:inner_spread]
+            inner_spread_start = options[:first_page] if inner_spread_start < options[:first_page]
+            inner_spread_end = options[:current_page] + options[:inner_spread]
+            inner_spread_end = options[:last_page] if inner_spread_end > options[:last_page]
+            
+            if !options[:outer_spread].blank?
+              lower_gap = inner_spread_start - options[:first_page]
+              if lower_gap > 0
+                lower_outer_spread_start = options[:first_page]
+                lower_outer_spread_end = options[:outer_spread] > lower_gap ? lower_gap : options[:outer_spread]
+              end
+              
+              upper_gap = options[:last_page] - inner_spread_end
+              if upper_gap > 0
+                upper_outer_spread_start = options[:last_page] - (options[:outer_spread] > upper_gap ? upper_gap : options[:outer_spread]) + 1
+                upper_outer_spread_end = options[:last_page]
+              end
+            end
+          else
+            inner_spread_start = options[:first_page]
+            inner_spread_end = options[:last_page]
+          end
+          
+          html = ""
+          html += span_or_page_link(:first, options.deep_dup, options[:current_page] == options[:first_page]) if options[:first]
+          html += span_or_page_link(:prev, options.deep_dup, options[:current_page] == options[:first_page]) if options[:prev]
+          
+          if lower_gap > 0
+            (lower_outer_spread_start..lower_outer_spread_end).each { |page| html += span_or_page_link(page, options.deep_dup, false) }
+            html += content_tag(:span, "&hellip;", options[:html]) if (inner_spread_start - lower_outer_spread_end) > 1
+          end
+          
+          (inner_spread_start..inner_spread_end).each { |page| html += span_or_page_link(page, options.deep_dup, page == options[:current_page]) }
+          
+          if upper_gap > 0
+            html += content_tag(:span, "&hellip;", options[:html]) if (upper_outer_spread_start - inner_spread_end) > 1
+            (upper_outer_spread_start..upper_outer_spread_end).each { |page| html += span_or_page_link(page, options.deep_dup, false) }
+          end
+          
+          html += span_or_page_link(:next, options.deep_dup, options[:current_page] == options[:last_page]) if options[:next]
+          html += span_or_page_link(:last, options.deep_dup, options[:current_page] == options[:last_page]) if options[:last]
+          html
+        end
+        
+        private
+          def add_order_by_links_defaults!(options)
+            add_searchlogic_control_defaults!(options)
+            options[:choices] ||= options[:search_obj].klass.column_names.map(&:humanize)
+            options
+          end
+          
+          def add_order_as_links_defaults!(options)
+            add_searchlogic_control_defaults!(options)
+            options[:choices] = [:asc, :desc]
+            options
+          end
+          
+          def add_per_page_links_defaults!(options)
+            add_searchlogic_control_defaults!(options)
+            options[:choices] ||= Config.helpers.per_page_links_choices.dup
+            if !options[:search_obj].per_page.blank? && !choices_include?(options[:choices], options[:search_obj].per_page)
+              options[:choices] << ["#{options[:search_obj].per_page} per page", options[:search_obj].per_page]
+              options[:choices].sort! do |a, b|
+                a_value = (a.is_a?(Array) ? a.last : a).to_i
+                return -1 if a_value == 0
+                b_value = (b.is_a?(Array) ? b.last : b).to_i
+                a_value <=> b_value
+              end
+            end
+            options
+          end
+          
+          def choices_include?(choices, includes)
+            choices.each do |choice|
+              value = choice.is_a?(Array) ? choice.last : choice
+              return true if value == includes
+            end
+            false
+          end
+          
+          def add_page_links_defaults!(options)
+            add_searchlogic_control_defaults!(options)
+            options[:first_page] ||= 1
+            options[:last_page] ||= options[:search_obj].page_count
+            options[:current_page] ||= options[:search_obj].page
+            options[:inner_spread] = Config.helpers.page_links_inner_spread unless options.has_key?(:inner_spread)
+            options[:outer_spread] = Config.helpers.page_links_outer_spread unless options.has_key?(:outer_spread)
+            options[:prev] = Config.helpers.page_links_prev unless options.has_key?(:prev)
+            options[:next] = Config.helpers.page_links_next unless options.has_key?(:next)
+            options[:first] = Config.helpers.page_links_first unless options.has_key?(:first)
+            options[:last] = Config.helpers.page_links_last unless options.has_key?(:last)
+            options
+          end
+          
+          def span_or_page_link(name, options, span)
+            text = ""
+            page = 0
+            case name
+            when Fixnum
+              text = name
+              page = name
+              searchlogic_add_class!(options[:html], Config.helpers.page_links_current_page_class_name) if span
+            else
+              text = options[name]
+              page = options[:search_obj].send("#{name}_page")
+              searchlogic_add_class!(options[:html], Config.helpers.send("page_links_#{name}_page_class_name"))
+            end
+            
+            if span
+              searchlogic_add_class!(options[:html], Config.helpers.page_links_disabled_class_name)
+              searchlogic_add_class!(options[:html], Config.helpers.page_link_class_name)
+            end
+            options[:text] = text
+            span ? content_tag(:span, text, options[:html]) : page_link(page, options)
+          end
+      end
+    end
+  end
+end
+
+ActionController::Base.helper Searchlogic::Helpers::ControlTypes::Links if defined?(ActionController)