table_sortable 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 3a484255d4071117e14633714581e5392da418bd
-  data.tar.gz: 063b9bcd1e5dab7c85b8473f06d9b9349351df36
+  metadata.gz: bb3b153304402456414d809c4ebb4f20598912e1
+  data.tar.gz: 1bb7b72fbc3b9052bbd93da005e81f4a37dcf43d
 SHA512:
-  metadata.gz: cff13059ff3aa2f36bed53861db9ce00eef623b90a7fc18a233c4523cba19a724ed5b3fc803fcf5687d4ddc2476f5c8356b7af10ceb42d1438a045aed7db177d
-  data.tar.gz: 847dabaa7a749389d95c0a945e2de623d974732ddcc2a357f0d1ecf7f47f9bba9faf1590fec9121b29208aa02bee1b88f9ef53944b0eefc605711eea92b88554
+  metadata.gz: 54e7d680129b165ffe901e66135fb9ada66214c6696eb5b9b7e3d8c3f702cb161443bf53f769e737216e5eb62645c07cac1f4dceb5179263b06a9fc6ce5f733e
+  data.tar.gz: 762d3c06491fcc61f56c069b72e8a1820740bb987b3ee897b8f2dae52b48cebdfd62afede63175f8f70f11fe7270a15027c84288e9550fc1740dc1bed3b3d4f9

data/.idea/.rakeTasks

@@ -4,4 +4,4 @@ You are allowed to:
 1. Remove rake task
 2. Add existing rake tasks
 To add existing rake tasks automatically delete this file and reload the project.
---><RakeGroup description="" fullCmd="" taksId="rake"><RakeTask description="Build table_sortable-0.1.8.gem into the pkg directory" fullCmd="build" taksId="build" /><RakeTask description="Remove any temporary products" fullCmd="clean" taksId="clean" /><RakeTask description="Remove any generated files" fullCmd="clobber" taksId="clobber" /><RakeTask description="Build and install table_sortable-0.1.8.gem into system gems" fullCmd="install" taksId="install" /><RakeGroup description="" fullCmd="" taksId="install"><RakeTask description="Build and install table_sortable-0.1.8.gem into system gems without network access" fullCmd="install:local" taksId="local" /></RakeGroup><RakeTask description="Create tag v0.1.8 and build and push table_sortable-0.1.8.gem to Rubygems" fullCmd="release[remote]" taksId="release[remote]" /><RakeTask description="Run tests" fullCmd="test" taksId="test" /><RakeTask description="" fullCmd="default" taksId="default" /><RakeTask description="" fullCmd="release" taksId="release" /><RakeGroup description="" fullCmd="" taksId="release"><RakeTask description="" fullCmd="release:guard_clean" taksId="guard_clean" /><RakeTask description="" fullCmd="release:rubygem_push" taksId="rubygem_push" /><RakeTask description="" fullCmd="release:source_control_push" taksId="source_control_push" /></RakeGroup></RakeGroup></Settings>
+--><RakeGroup description="" fullCmd="" taksId="rake"><RakeTask description="Build table_sortable-0.2.0.gem into the pkg directory" fullCmd="build" taksId="build" /><RakeTask description="Remove any temporary products" fullCmd="clean" taksId="clean" /><RakeTask description="Remove any generated files" fullCmd="clobber" taksId="clobber" /><RakeTask description="Build and install table_sortable-0.2.0.gem into system gems" fullCmd="install" taksId="install" /><RakeGroup description="" fullCmd="" taksId="install"><RakeTask description="Build and install table_sortable-0.2.0.gem into system gems without network access" fullCmd="install:local" taksId="local" /></RakeGroup><RakeTask description="Create tag v0.2.0 and build and push table_sortable-0.2.0.gem to Rubygems" fullCmd="release[remote]" taksId="release[remote]" /><RakeTask description="Run tests" fullCmd="test" taksId="test" /><RakeTask description="" fullCmd="default" taksId="default" /><RakeTask description="" fullCmd="release" taksId="release" /><RakeGroup description="" fullCmd="" taksId="release"><RakeTask description="" fullCmd="release:guard_clean" taksId="guard_clean" /><RakeTask description="" fullCmd="release:rubygem_push" taksId="rubygem_push" /><RakeTask description="" fullCmd="release:source_control_push" taksId="source_control_push" /></RakeGroup></RakeGroup></Settings>

data/.idea/table_sortable.iml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <module type="RUBY_MODULE" version="4">
   <component name="ModuleRunConfigurationManager">
-    <configuration default="false" name="All specs in spec: table_sortable" type="RSpecRunConfigurationType" factoryName="RSpec" temporary="true">
+    <configuration default="false" name="All specs in spec: table_sortable" type="RSpecRunConfigurationType" factoryName="RSpec">
       <predefined_log_file id="RUBY_RSPEC" enabled="true" />
       <module name="table_sortable" />
       <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="RUBY_ARGS" VALUE="-e $stdout.sync=true;$stderr.sync=true;load($0=ARGV.shift)" />
@@ -34,7 +34,7 @@
       <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="FULL_BACKTRACE" VALUE="false" />
       <method />
     </configuration>
-    <configuration default="false" name="Run spec 'proc_spec': table_sortable" type="RSpecRunConfigurationType" factoryName="RSpec" temporary="true">
+    <configuration default="false" name="Run spec 'filter_spec': table_sortable" type="RSpecRunConfigurationType" factoryName="RSpec">
       <predefined_log_file id="RUBY_RSPEC" enabled="true" />
       <module name="table_sortable" />
       <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="RUBY_ARGS" VALUE="-e $stdout.sync=true;$stderr.sync=true;load($0=ARGV.shift)" />
@@ -53,7 +53,7 @@
         </COVERAGE_PATTERN>
       </EXTENSION>
       <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="TESTS_FOLDER_PATH" VALUE="" />
-      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="TEST_SCRIPT_PATH" VALUE="$MODULE_DIR$/spec/lib/table_sortable/concerns/proc_spec.rb" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="TEST_SCRIPT_PATH" VALUE="$MODULE_DIR$/spec/lib/table_sortable/column/filter_spec.rb" />
       <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="SPEC_RUNNER_PATH" VALUE="" />
       <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="TEST_FILE_MASK" VALUE="**/*_spec.rb" />
       <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="SPEC_EXAMPLE_NAME" VALUE="" />
@@ -67,7 +67,7 @@
       <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="FULL_BACKTRACE" VALUE="false" />
       <method />
     </configuration>
-    <configuration default="false" name="Run spec 'filter_spec': table_sortable" type="RSpecRunConfigurationType" factoryName="RSpec" temporary="true">
+    <configuration default="false" name="Run spec 'proc_spec': table_sortable" type="RSpecRunConfigurationType" factoryName="RSpec">
       <predefined_log_file id="RUBY_RSPEC" enabled="true" />
       <module name="table_sortable" />
       <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="RUBY_ARGS" VALUE="-e $stdout.sync=true;$stderr.sync=true;load($0=ARGV.shift)" />
@@ -86,7 +86,7 @@
         </COVERAGE_PATTERN>
       </EXTENSION>
       <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="TESTS_FOLDER_PATH" VALUE="" />
-      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="TEST_SCRIPT_PATH" VALUE="$MODULE_DIR$/spec/lib/table_sortable/column/filter_spec.rb" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="TEST_SCRIPT_PATH" VALUE="$MODULE_DIR$/spec/lib/table_sortable/concerns/proc_spec.rb" />
       <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="SPEC_RUNNER_PATH" VALUE="" />
       <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="TEST_FILE_MASK" VALUE="**/*_spec.rb" />
       <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="SPEC_EXAMPLE_NAME" VALUE="" />
@@ -100,7 +100,7 @@
       <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="FULL_BACKTRACE" VALUE="false" />
       <method />
     </configuration>
-    <configuration default="false" name="TableSortable::Controller filter_and_sort filters using a single filter: table_sortable" type="RSpecRunConfigurationType" factoryName="RSpec" temporary="true">
+    <configuration default="false" name="TableSortable::Controller filter_and_sort filters using a single filter: table_sortable" type="RSpecRunConfigurationType" factoryName="RSpec">
       <predefined_log_file id="RUBY_RSPEC" enabled="true" />
       <module name="table_sortable" />
       <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="RUBY_ARGS" VALUE="-e $stdout.sync=true;$stderr.sync=true;load($0=ARGV.shift)" />
@@ -133,7 +133,7 @@
       <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="FULL_BACKTRACE" VALUE="false" />
       <method />
     </configuration>
-    <configuration default="false" name="TableSortable::Controller filter_and_sort sorts a record set based on the column to sort: table_sortable" type="RSpecRunConfigurationType" factoryName="RSpec" temporary="true">
+    <configuration default="false" name="TableSortable::Controller filter_and_sort sorts a record set based on the column to sort: table_sortable" type="RSpecRunConfigurationType" factoryName="RSpec">
       <predefined_log_file id="RUBY_RSPEC" enabled="true" />
       <module name="table_sortable" />
       <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="RUBY_ARGS" VALUE="-e $stdout.sync=true;$stderr.sync=true;load($0=ARGV.shift)" />
@@ -174,11 +174,8 @@
     </content>
     <orderEntry type="jdk" jdkName="RVM: ruby-2.4.1 [tablesortable]" jdkType="RUBY_SDK" />
     <orderEntry type="sourceFolder" forTests="false" />
-    <orderEntry type="library" scope="PROVIDED" name="actioncable (v5.1.1, RVM: ruby-2.4.1 [tablesortable]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="actionmailer (v5.1.1, RVM: ruby-2.4.1 [tablesortable]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="actionpack (v5.1.1, RVM: ruby-2.4.1 [tablesortable]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="actionview (v5.1.1, RVM: ruby-2.4.1 [tablesortable]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="activejob (v5.1.1, RVM: ruby-2.4.1 [tablesortable]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="activemodel (v5.1.1, RVM: ruby-2.4.1 [tablesortable]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="activerecord (v5.1.1, RVM: ruby-2.4.1 [tablesortable]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="activesupport (v5.1.1, RVM: ruby-2.4.1 [tablesortable]) [gem]" level="application" />
@@ -190,20 +187,14 @@
     <orderEntry type="library" scope="PROVIDED" name="erubi (v1.6.0, RVM: ruby-2.4.1 [tablesortable]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="factory_girl (v4.8.0, RVM: ruby-2.4.1 [tablesortable]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="factory_girl_rails (v4.8.0, RVM: ruby-2.4.1 [tablesortable]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="globalid (v0.4.0, RVM: ruby-2.4.1 [tablesortable]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="i18n (v0.8.1, RVM: ruby-2.4.1 [tablesortable]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="loofah (v2.0.3, RVM: ruby-2.4.1 [tablesortable]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="mail (v2.6.5, RVM: ruby-2.4.1 [tablesortable]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="method_source (v0.8.2, RVM: ruby-2.4.1 [tablesortable]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="mime-types (v3.1, RVM: ruby-2.4.1 [tablesortable]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="mime-types-data (v3.2016.0521, RVM: ruby-2.4.1 [tablesortable]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="mini_portile2 (v2.1.0, RVM: ruby-2.4.1 [tablesortable]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="minitest (v5.10.2, RVM: ruby-2.4.1 [tablesortable]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="nio4r (v2.1.0, RVM: ruby-2.4.1 [tablesortable]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="nokogiri (v1.7.2, RVM: ruby-2.4.1 [tablesortable]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="rack (v2.0.3, RVM: ruby-2.4.1 [tablesortable]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="rack-test (v0.6.3, RVM: ruby-2.4.1 [tablesortable]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="rails (v5.1.1, RVM: ruby-2.4.1 [tablesortable]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="rails-dom-testing (v2.0.3, RVM: ruby-2.4.1 [tablesortable]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="rails-html-sanitizer (v1.0.3, RVM: ruby-2.4.1 [tablesortable]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="railties (v5.1.1, RVM: ruby-2.4.1 [tablesortable]) [gem]" level="application" />
@@ -213,13 +204,9 @@
     <orderEntry type="library" scope="PROVIDED" name="rspec-expectations (v3.6.0, RVM: ruby-2.4.1 [tablesortable]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="rspec-mocks (v3.6.0, RVM: ruby-2.4.1 [tablesortable]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="rspec-support (v3.6.0, RVM: ruby-2.4.1 [tablesortable]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="sprockets (v3.7.1, RVM: ruby-2.4.1 [tablesortable]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="sprockets-rails (v3.2.0, RVM: ruby-2.4.1 [tablesortable]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="sqlite3 (v1.3.13, RVM: ruby-2.4.1 [tablesortable]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="thor (v0.19.4, RVM: ruby-2.4.1 [tablesortable]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="thread_safe (v0.3.6, RVM: ruby-2.4.1 [tablesortable]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="tzinfo (v1.2.3, RVM: ruby-2.4.1 [tablesortable]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="websocket-driver (v0.6.5, RVM: ruby-2.4.1 [tablesortable]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="websocket-extensions (v0.1.2, RVM: ruby-2.4.1 [tablesortable]) [gem]" level="application" />
   </component>
 </module>

data/README.md

@@ -135,13 +135,253 @@ That's it! The results fetched from the server are now filtered, sorted and pagi
 
 For full documentation of the usage of tableSorter.js please go [here](https://mottie.github.io/tablesorter/docs/index.html) for the very popular fork by mottie, or [here](http://tablesorter.com/docs/) for the original version of the plugin.
 
-Of course there are many more configuration options that make TableSortable flexible and adaptable. For those, please see [advanced configuration](#advanced-configuration)
+Of course there are many more configuration options that make TableSortable flexible and adaptable. For those, please see [advanced configuration](#advanced-configuration).
 
 ## Advanced Configuration
-Coming soon...
+
+TableSortable has several advanced configuration settings, which allow for a more fine-grained control over its behaviour.
+
+- [define_column](#define_column)
+- [define_column_order](#define_column_order)
+- [define_column_offset](#define_column_offset)
+
+#### define_column  
+
+TableSortable lets you define the columns one by one with many custom attributes, using the `define_column` method.
+```ruby
+#controllers/users_controller.rb
+class UsersController < ApplicationController
+  include TableSortable
+  
+  define_column :full_name, 
+                 value: -> (user) {"#{user.first_name} #{user.last_name}"}
+  define_column :email
+end
+```
+##### Syntax: `define_column column_name, [arguments]`  
+
+- `column_name` <sub>(required)</sub>  
+    A symbol representing the column_name. Can be anything, but should usually be the same as the column name. 
+- `arguments` <sub>(optional)</sub>  
+    - `value: (symbol|proc)`  
+        <sub>default: same as column name</sub>   
+        Accepts either a symbol representing a method that the record responds to, like an ActiveRecord attribute, 
+        or a proc the returns the record's value. for example:
+        ```ruby
+        define_column :full_name, 
+                      value: -> (user) {"#{user.first_name} #{user.last_name}"}
+        ```
+    - `content: (symbol|proc)`  
+        <sub>default: same as value</sub>   
+        Works the same way as `value`, but allows specifying a different value to be displayed in the table cells.
+        The difference between `value` and `content` is that the former determines the value by which the scope will be filtered and sorted,
+        while the latter only affects the displayed cell contents.
+        ```ruby
+        define_column :full_name, 
+                      value:   -> (user) {"#{user.first_name} #{user.last_name}"},
+                      content: -> (user) {"#{user.last_name}, #{user.first_name}"}
+        ```
+    - `label: (string)`  
+        <sub>default: 'Titleized' version of the column name</sub>   
+        Allows specifying a string to be used as the column label, displayed at the table header.
+    - `placeholder: (string|false)`  
+        <sub>default: same as label</sub>  
+        Allows specifying a string to be used as a placeholder for the column's filter input field.
+        You may also specify `false`, in which case no placeholder will be displayed.
+    - `filter: (proc|false)`  
+        <sub>default: free case-insensitive text search on the column's value</sub>   
+        By default, the column will be filtered according to the column's value. However, you may specify a proc to perform the search on that column. 
+        The proc itself can contain either ActiveRecord operations (eg. `where`) or array operations (eg. `select`), 
+        and will be passed the current filter query when run.
+        ```ruby
+        define_column :full_name, 
+                      filter: ->(query) {where('LOWER(CONCAT(first_name," ", last_name)) LIKE (?)', "%#{query.downcase}%")}
+        ```
+        If no filtering is to be performed on that column you can set it to `false`. When using TableSortable's [view helpers](#view-helpers),
+        this also means that no filter input will be shown on that column.
+    - `filter_method: (:array|:active_record)`  
+        <sub>default: automatically detects method based on the record given</sub>   
+        Determines whether the default filter function relies on an ActiveRecord `where` method or an Array `select` method.  
+        When no method and no filters are supplied, TableSortable will check if the column_name corresponds to a database column of the record. 
+        If it does, it will use an ActiveRecord `where` method, otherwise it will perform an array `select` operation.  
+        _Only applies when no `filter` option has been specified._
+        - `:array` <sub>(default)</sub>  
+            Filter using the `select` method. While being slower, it selects based on the column's value, whatever it might be, and so fits every scenario.
+        - `:active_record`  
+            Filter using the `where` method. While being faster, it only applies to cases where the column name matches the database column name. 
+    - `filter_initial_value: (string)`
+        <sub>default: nil</sub>   
+        You may specify an initial filter query for each column.
+    - `sort: (proc|false)`  
+        <sub>default: sorting based on the column's value</sub>   
+        By default, the record set will be sorted according to the selected column's value. 
+        However, you may specify a proc to perform the sorting when this column is selected as the sort base. 
+        The proc itself can contain either ActiveRecord operations (eg. `order`) or array operations (eg. `sort`), 
+        and will be passed the current sort order as a symbol (`:asc` or `:desc`) when run.
+        ```ruby
+        define_column :full_name, 
+                      sort: -> (sort_order) { sort{ |a,b| (sort_order == :asc ? a : b) <=> (sort_order == :asc ? b : a) } }
+        ```
+        If no sorting is to be performed based on that column you can set it to `false`. When using TableSortable's [view helpers](#view-helpers),
+        this also means that no sorting handle will be shown on the client side on that column as well.
+    - `sort_method: (:array|:active_record)`  
+        <sub>default: :array</sub>   
+        Determines whether the default sort function relies on an ActiveRecord `order` method or an Array `sort` method.  
+        When no method and no filters are supplied, TableSortable will check if the column_name corresponds to a database column of the record. 
+        If it does, it will use an ActiveRecord `order` method, otherwise it will perform an array `sort` operation.  
+        _Only applies when no `sort` option has been specified._
+        - `:array` <sub>(default)</sub>  
+            Sort using the `sort` method. While being slower, it sorts based on the column's value, whatever it might be, and so fits every scenario.
+        - `:active_record`  
+            Sort using the `order` method. While being faster, it only applies to cases where the column name matches the database column name. 
+    - `template: (string)`  
+        <sub>default: same as column_name</sub>  
+        Allows setting a custom template name to look for when rendering the header or column contents. For more information see [view helpers](#view-helpers).
+
+##### Dynamic Column Definitions
+
+If the column definitions themselves need to be dynamic (eg. if you're using 
+dynamic fields in your model) you can also use `define column` in a `before action` callback like this
+```ruby
+#controllers/users_controller.rb
+  
+  before_action :define_columns
+
+  private
+  
+  def define_columns
+    @user.custom_fields.each do |cf|
+      define_column cf, 
+                    value: -> (user) {user.get_custom_field(cf)}
+    end
+  end
+```
+
+#### define_column_order  
+Columns are displayed in the order they are defined using `define_method`. If you wish, you may override this order by specifying your own using the `define_column_order` method.  
+It also allows hiding columns that you need to include in the filtering and sorting process, eg. when you want to have an external search box filtering based on a column that you don't necessarily want to display.
+##### Syntax: `define_column_order column1, [column2], [column3] ...`  
+```ruby
+#controllers/users_controller.rb
+#define a full_name column, allowing to create a custom search box that operates on the 4th column
+define_columns :first_name, :last_name, :email, :full_name
+define_column_order :last_name, :first_name, :email
+```
+#### define_column_offset  
+Sometimes you wish to manually add columns in the views before adding the defined TableSortable columns, eg. to have a checkbox next to each row.  
+```erb
+<!-- views/users/index.html.erb -->
+<table id="usersTable" data-query="<%= users_path %>">
+    <thead>
+        <tr></tr>   <!-- EXTRA COLUMN -->
+        <tr>
+            <%= table_sortable_headers %>
+        </tr>
+    </thead>
+    <tbody>
+    </tbody>
+</table>
+
+<!-- views/users/_user_row.html.erb -->
+<tr> <%= check_box_tag :checked %> </tr>   <!-- EXTRA COLUMN -->
+<tr>
+    <%= table_sortable_columns user %>
+</tr>
+```
+Since the column numbers that appear in tableSorter.js' ajax request will represent their actual number, you should let TableSortable know that the columns you defined are offset.  
+So, in the above case you should define an offset of 1.
+
+##### Syntax: `define_column_offset offset`  
+```ruby
+define_column_offset 1
+```
+You may define it either using the `define_column_offset` method shown above, 
+or using the all inclusive `define_columns` method, as an `offset: <integer>` argument.
+```ruby
+define_column :first_name, :last_name, :email, offset: 1
+```
 
 ### View Helpers
-Coming soon...
+TableSortable offers several view helpers, to help maintain the connection between the view layer and the controller layer, and make your code DRYer and less error prone.
+- [table_sortable_headers](#table_sortable_headers)
+- [table_sortable_columns](#table_sortable_columns)
+- [table_sortable_pager](#table_sortable_pager)
+
+#### table_sortable_headers
+##### Syntax: `table_sortable_headers [html_attributes]`  
+Renders the table header columns, each one inside a \<th> tag.  
+Notice that it _does not_ wrap a \<tr> tag around the headers, allowing you to add columns before of after TableSortable's headers. 
+
+It also renders data attributes that let tableSorter.js know the columns behaviour:
+- `data-filter="false"` if the column's `filter` attribute is set to `false`.
+- `data-sorter="false"` if the column's `sort` attribute is set to `false`.
+- `data-placeholder="?"` if a placeholder has been defined (defaults to be the same as the column's label).
+- `data-value="?"` if an initial filter value has been defined.
+
+You may also specify any html attribute, as well as additional data attributes to be added to each \<th> element.
+```erb
+<tr> <%= table_sortable_headers class: 'text-center' %> </tr>
+```
+
+If you wish to render your own version of a specific header (eg. to add an icon), 
+you may create a partial inside a `table_sortable` folder nested inside the controller's views folder. The partial should be named according to the following naming scheme:  
+`_<template>_header.html`, with `template` corresponding to the column's template attribute.  
+Notice that in this case you need to manually specify the different data attributes that correspond to the behaviour you wish this column to have.
+
+The view will be supplied with two locals:
+- `label`: the column's label
+- `column`: the TableSortable::Column object
+
+Here is an example of a full name header partial, which includes a font-awesome icon:
+```erb
+<!-- views/users/table_sortable/_full_name_header.html.erb -->
+<th data-placeholder="<%= column.placeholder %>"> 
+    <i class="fa fa-user" aria-hidden="true"></i>
+    <%= label %> 
+</th>
+```
+
+By using the template attribute you may render several columns using the same template.
+
+_Notice that whether using slim or erb, you must include .html before the extension._
+
+#### table_sortable_columns
+##### Syntax: `table_sortable_columns record, [html_attributes]`  
+Renders the table columns for a specific `record`, each one inside a \<td> tag.  
+Notice that it _does not_ wrap a \<tr> tag around the headers, allowing you to add columns before of after TableSortable's columns. 
+
+It also renders data attributes that let tableSorter.js know the columns behaviour:
+- `data-text="?"` if the column's `value` attribute is different than the column's `content` attribute, the value will be set in the `data-text` attribute, and the content will be displayed inside the \<td> element.
+
+You may also specify any html attribute, as well as additional data attributes to be added to each \<td> element.
+```erb
+<tr> <%= table_sortable_columns @user, class: 'text-info' %> </tr>
+```
+
+If you wish to render your own version of a specific column (eg. to include a link inside of it), 
+you may create a partial inside a `table_sortable` folder nested inside the controller's views folder. The partial should be named according to the following naming scheme:  
+`_<template>_column.html`, with `template` corresponding to the column's template attribute.  
+Notice that in this case you need to manually specify the different data attributes that correspond to the behaviour you wish this column to have.
+
+The view will be supplied with four locals:
+- `source`: the source ActiveRecord object
+- `content`: the column's content to be displayed
+- `value`: the column's value
+- `column`: the TableSortable::Column object
+
+Here is an example of a full name column partial, in which the name links to the edit_user_path:
+```erb
+<!-- views/users/table_sortable/_full_name_column.html.erb -->
+<td> 
+    <%= link_to content, edit_user_path(source) %> 
+</td>
+```
+By using the template attribute you may render several columns using the same template.
+
+_Notice that whether using slim, haml or erb, you must include .html before the extension._
+
+#### table_sortable_pager
+documentation coming soon...
 
 ## Development
 

data/lib/table_sortable/column/filter.rb

@@ -3,18 +3,20 @@ module TableSortable
     class Filter
       include TableSortable::Concerns::Proc
 
-      attr_accessor :query
+      attr_accessor :query, :default_value
 
       def initialize(*args)
-        super :filter, *args
+        options = args.extract_options!
+        @default_value = options[:filter_initial_value]
+        super :filter, options
       end
 
       def array_proc
-        -> (value, col=nil) { select{|record| value.downcase.in? col.value(record).to_s.downcase} }
+        -> (value, col=nil) { select{|record| col.value(record).to_s.downcase.include? value.downcase} }
       end
 
-      def sql_proc
-        -> (value, col=nil) { where("LOWER(?) LIKE (?)", filter.to_s.underscore, "%#{value.to_s.downcase}%") }
+      def active_record_proc
+        -> (value, col=nil) { where("LOWER(#{col.name.to_s.underscore}) LIKE (?)", "%#{value.to_s.downcase}%") }
       end
 
       def proc_wrapper(proc)

data/lib/table_sortable/column/sorter.rb

@@ -13,8 +13,8 @@ module TableSortable
         -> (sort_order, col=nil) { sort{ |a,b| col.value(sort_order == :asc ? a : b) <=> col.value(sort_order == :asc ? b : a) } }
       end
 
-      def sql_proc
-        -> (sort_order, col=nil) { order(sorter => sort_order) }
+      def active_record_proc
+        -> (sort_order, col=nil) { order(col.name.to_s.underscore => sort_order) }
       end
 
       def proc_wrapper(proc)

data/lib/table_sortable/column.rb

@@ -1,20 +1,27 @@
 module TableSortable
   class Column
 
-    attr_reader :name, :label, :filter, :sorter, :template, :placeholder
+    attr_reader :name, :label, :filter, :sorter, :template, :placeholder, :content#, :sort_priority
 
     def initialize(col_name, *options)
 
       options = options.extract_options!
       value = options[:value] || col_name
+      content = options[:content] || value
       label = options[:label] || (options[:label] == false ? '' : col_name.to_s.titleize)
-      placeholder = options[:placeholder] || (options[:placeholder] == false ? false : label)
+      placeholder = options[:placeholder] || (options[:placeholder] == false ? nil : label)
+      # priority = options[:priority]
       template = options[:template] || col_name
 
+      # filter_defaultAttrib (data-value)
+      # data-sorter (=false?)
+
       @name = col_name
-      @value = value.is_a?(Proc) ? value : -> (record) { record.send(value) }
+      @value = value.respond_to?(:call) ? value : -> (record) { record.send(value) }
+      @content = content.respond_to?(:call) ? content : -> (record) { record.send(content) }
       @label = label
       @placeholder = placeholder
+      # @sort_priority = sort_priority
       @template = template
       @filter = TableSortable::Column::Filter.new(options.merge(:column => self) )
       @sorter = TableSortable::Column::Sorter.new(options.merge(:column => self) )
@@ -25,6 +32,10 @@ module TableSortable
       record.instance_eval(&@value) unless @value.nil?
     end
 
+    def content(record)
+      record.instance_eval(&@content) unless @content.nil?
+    end
+
   end
 
 end

data/lib/table_sortable/concerns/proc.rb

@@ -4,7 +4,7 @@ module TableSortable
       extend ActiveSupport::Concern
 
       included do
-        attr_reader :proc, :method, :column, :type
+        attr_reader :proc, :column, :type
       end
 
       def initialize(option_name, *options)
@@ -12,8 +12,8 @@ module TableSortable
         unless options[option_name] == false
           @type = option_name
           @column = options[:column]
-          the_proc = options[option_name] || @column.name if @column
-          @method = options["#{option_name.to_s}_method".to_sym] || :array
+          the_proc = options[option_name] || @column.name
+          @method = options["#{option_name.to_s}_method".to_sym] || :autodetect
           if the_proc.respond_to? :call
             @proc = proc_wrapper(the_proc)
             @method = detect_method(@proc)
@@ -21,19 +21,35 @@ module TableSortable
             case @method
               when :array
                 @proc = array_proc
-              when :sql
-                @proc = sql_proc
+              when :active_record
+                @proc = active_record_proc
             end
           end
         end
       end
 
-      def detect_method(proc)
+      def detect_method(proc, scope = nil)
         begin
           [].instance_exec('', &proc)
           method = :array
         rescue NoMethodError
-          method = :sql
+          method = :active_record
+        end
+        method
+      end
+
+      def method(record = nil)
+        return @method if record.nil?
+        if @method == :autodetect
+          if record.class.columns.map{|col| col.name.to_sym}.include? @column.name
+            method = :active_record
+            @proc = active_record_proc
+          else
+            method = :array
+            @proc = array_proc
+          end
+        else
+          method = @method
         end
         method
       end
@@ -46,7 +62,7 @@ module TableSortable
         raise NotImplementedError
       end
 
-      def sql_proc
+      def active_record_proc
         raise NotImplementedError
       end
 

data/lib/table_sortable/controller.rb

@@ -18,7 +18,7 @@ module TableSortable
           columns.each do |column|
             define_column column
           end
-          self.column_offset = column_offset
+          define_column_offset column_offset
         end
       end
 
@@ -27,6 +27,18 @@ module TableSortable
           define_column *args
         end
       end
+
+      def define_column_order(order)
+        before_action do
+          define_column_order order
+        end
+      end
+
+      def define_column_offset(offset)
+        before_action do
+          define_column_offset offset
+        end
+      end
     end
 
     def define_column(col_name, *options)
@@ -34,14 +46,26 @@ module TableSortable
       @columns.add(col_name, options)
     end
 
+    def define_column_order(*order)
+      @column_order = order
+    end
+
+    def define_column_offset(offset)
+      @column_offset = offset
+    end
+
+    def columns
+      @columns.sort_by(column_order)
+    end
+
     private
 
     def filter_and_sort(scope, params = nil)
       populate_params(params)
 
       actions = [->(records) { records }]
-      ordered_actions.reverse.each_with_index do |action, i|
-        actions << ->(records) { action.used? ? actions[i].call(action.run(records)) : actions[i].call(records) }
+      ordered_actions(scope.first).reverse.each_with_index do |action, i|
+        actions << ->(records) { action.used? ? (actions[i].call(action.run(records))) : actions[i].call(records) }
       end
       scope = actions.last.call(scope)
       if @query_params.page
@@ -53,17 +77,13 @@ module TableSortable
 
     def initialize_table_sortable
       @columns = TableSortable::Columns.new
-      self.column_offset = 0
-    end
-
-    def columns
-      @columns.sort_by(display_order)
+      define_column_offset 0
     end
 
-    def ordered_actions
+    def ordered_actions(record = nil)
       filter_actions =  @columns.map{|col| col.filter }
       sort_actions =    @columns.map{|col| col.sorter }
-      (filter_actions+sort_actions).sort{ |a,b| (a.method && b.method) ? (b.method <=> a.method) : a.method ? 1 : -1 }
+      (filter_actions+sort_actions).sort{ |a,b| (a.method(record) && b.method(record)) ? (a.method(record) <=> b.method(record)) : b.method(record) ? 1 : -1 }
     end
 
     def populate_params(params = nil)
@@ -72,8 +92,7 @@ module TableSortable
 
     public
 
-    attr_writer :filter_order, :sort_order
-    attr_accessor :display_order, :column_offset
+    attr_reader :column_order, :column_offset
 
   end
 end

data/lib/table_sortable/railtie.rb

@@ -0,0 +1,9 @@
+# lib/my_gem/railtie.rb
+require 'table_sortable/view_helpers'
+module TableSortable
+  class Railtie < Rails::Railtie
+    initializer 'table_sortable.view_helpers' do
+      ActionView::Base.send :include, ViewHelpers
+    end
+  end
+end

data/lib/table_sortable/version.rb

@@ -1,3 +1,3 @@
 module TableSortable
-  VERSION = "0.2.0"
+  VERSION = "0.3.0"
 end

data/lib/table_sortable/view_helpers.rb

@@ -0,0 +1,67 @@
+module TableSortable
+  module ViewHelpers
+
+    def table_sortable_pager(*args)
+      options = args.extract_options!
+
+      pagination_class =    options[:wrapper_class]       || 'pagination'
+      page_display_class =  options[:page_display_class]  || 'pagedisplay'
+      item_wrapper_class =  options[:item_wrapper_class]
+      item_class =          options[:item_class]
+      first_item =          options[:first]               || '<<'
+      prev_item =           options[:prev]                || '<'
+      next_item =           options[:next]                || '>'
+      last_item =           options[:last]                || '>>'
+
+      content_tag :ul, class:pagination_class do
+        content_tag(:li, link_to(first_item,  '#', class: ([item_class] + ['first']).flatten.compact.join(' ')),            class: item_wrapper_class)+
+        content_tag(:li, link_to(prev_item,   '#', class: ([item_class] + ['prev'] ).flatten.compact.join(' ')),            class: item_wrapper_class)+
+        content_tag(:li, content_tag(:span,   nil, class: ([item_class] + [page_display_class]).flatten.compact.join(' ')), class: item_wrapper_class)+
+        content_tag(:li, link_to(next_item,   '#', class: ([item_class] + ['next'] ).flatten.compact.join(' ')),            class: item_wrapper_class)+
+        content_tag(:li, link_to(last_item,   '#', class: ([item_class] + ['last'] ).flatten.compact.join(' ')),            class: item_wrapper_class)
+      end.html_safe
+    end
+
+    def table_sortable_headers(html_options = {})
+      controller.columns.map do |col|
+        th_options = {}
+        th_options['data-placeholder'] = col.placeholder if col.placeholder
+        # th_options['data-priority'] = col.sort_priority if col.sort_priority
+        th_options['data-filter'] = 'false' if col.filter.disabled?
+        th_options['data-sorter'] = 'false' if col.sorter.disabled?
+        th_options['data-value'] = col.filter.default_value if col.filter.default_value
+        th_options.merge!(html_options)
+
+        begin
+          render partial: "#{controller_path}/table_sortable/#{col.template}_header.html",
+                 locals: {label: col.label,
+                          column: col}
+        rescue ActionView::MissingTemplate
+          content_tag :th, th_options do
+            col.label
+          end
+        end
+      end.join.html_safe
+    end
+
+    def table_sortable_columns(record, html_options = {})
+      controller.columns.map do |col|
+        td_options = {}
+        td_options['data-text'] = col.value(record) if col.value(record) != col.content(record)
+        td_options.merge!(html_options)
+
+        begin
+          render partial: "#{controller_path}/table_sortable/#{col.template}_column.html",
+                 locals: {content: col.content(record),
+                          value: col.value(record),
+                          source: record,
+                          column: col}
+        rescue ActionView::MissingTemplate
+          content_tag :td, td_options do
+            col.value(record)
+          end
+        end
+      end.join.html_safe
+    end
+  end
+end

data/lib/table_sortable.rb

@@ -1,6 +1,4 @@
-require 'rails/engine'
 require 'active_support/concern'
-require 'action_controller'
 
 module TableSortable
 
@@ -11,11 +9,10 @@ module TableSortable
   PAGE = 'page'
   PAGESIZE = 'pagesize'
 
-  class Engine < Rails::Engine; end
+  # class Engine < Rails::Engine; end
 
 end
 
-
 class TableSortableError < StandardError; end
 
 require 'table_sortable/concerns/proc'
@@ -26,4 +23,5 @@ require 'table_sortable/result'
 require 'table_sortable/columns'
 require 'table_sortable/version'
 require 'table_sortable/controller'
-require 'table_sortable/query_params'
+require 'table_sortable/query_params'
+require 'table_sortable/railtie' if defined?(Rails)

data/spec/concerns/proc_class_spec.rb

@@ -1,14 +1,14 @@
 shared_examples_for 'proc_class' do |parameter_name|
   include_context 'shared stuff'
 
-  let(:dummy_class) { described_class.new(parameter_name => ->(x) {x}) }
+  let(:dummy_class) { described_class.new(parameter_name => ->(x) {x}, column: dummy_col) }
 
   it 'includes TableSortable::Concerns::Proc' do
     expect(described_class.included_modules).to include TableSortable::Concerns::Proc
   end
   it 'defines methods of its own' do
     expect(dummy_class.array_proc).to respond_to :call
-    expect(dummy_class.sql_proc).to respond_to :call
+    expect(dummy_class.active_record_proc).to respond_to :call
     expect(dummy_class.send(:proc_wrapper, -> {x})).to respond_to :call
     expect(dummy_class).to respond_to :run
     expect(dummy_class).to respond_to :used?

data/spec/controllers/test_controller_spec.rb

@@ -1,3 +1,6 @@
+require 'action_controller'
+
+
 module Test
   class Controller < ActionController::Base
 

data/spec/lib/table_sortable/concerns/proc_spec.rb

@@ -9,7 +9,7 @@ describe TableSortable::Concerns::Proc do
         -> (x) {x * 2}
       end
 
-      def sql_proc
+      def active_record_proc
         -> (x) {x * 3}
       end
 
@@ -33,34 +33,29 @@ describe TableSortable::Concerns::Proc do
       context 'it is an sql proc' do
         it 'should detect it as sql' do
           proc = proc_class.new(:proc, column: TableSortable::Column.new(:proc), proc: -> (value) { where(name: value) } )
-          expect(proc.method).to eq :sql
+          expect(proc.method).to eq :active_record
         end
       end
       context 'it is an array proc' do
         it 'should detect it as array' do
-          proc = proc_class.new(:proc, proc: -> (value) { select{|record| record.name == value} } )
+          proc = proc_class.new(:proc, column: dummy_col, proc: -> (value) { select{|record| record.name == value} } )
           expect(proc.method).to eq :array
         end
       end
     end
     context 'given no proc' do
-      it 'should use array proc' do
-        expect(dummy_proc.method).to eq :array
+      it 'should set method to autodetect' do
+        expect(dummy_proc.method).to eq :autodetect
       end
       context '_method: option' do
-        context 'not provided' do
-          it 'should replace it with array_proc' do
-            expect(5.instance_eval(&dummy_proc.proc)).to eq 5.instance_eval(&dummy_proc.array_proc)
-          end
-        end
-        context '== :sql' do
-          it 'should replace it with sql_proc' do
-            dummy_proc = proc_class.new(:proc, column: TableSortable::Column.new(:proc), proc_method: :sql)
-            expect(5.instance_eval(&dummy_proc.proc)).to eq 5.instance_eval(&dummy_proc.sql_proc)
+        context '== :active_record' do
+          it 'should replace it with active_record_proc' do
+            dummy_proc = proc_class.new(:proc, column: TableSortable::Column.new(:proc), proc_method: :active_record)
+            expect(5.instance_eval(&dummy_proc.proc)).to eq 5.instance_eval(&dummy_proc.active_record_proc)
           end
         end
         context '== :array' do
-          it 'should replace it with sql_proc' do
+          it 'should replace it with active_record_proc' do
             dummy_proc = proc_class.new(:proc, column: TableSortable::Column.new(:proc), proc_method: :array)
             expect(5.instance_eval(&dummy_proc.proc)).to eq 5.instance_eval(&dummy_proc.array_proc)
           end
@@ -73,7 +68,7 @@ describe TableSortable::Concerns::Proc do
     context 'given a proc containing an sql method' do
       it 'should detect it as sql' do
         proc_to_detect = -> (filter_value) { where(name: filter_value) }
-        expect(dummy_proc.detect_method(proc_to_detect)).to eq :sql
+        expect(dummy_proc.detect_method(proc_to_detect)).to eq :active_record
       end
     end
     context 'given a proc containing an array method' do

data/spec/lib/table_sortable/controller_spec.rb

@@ -6,23 +6,22 @@ describe TableSortable::Controller do
     controller.instance_eval('initialize_table_sortable')
     controller
   end
-  let :controller_with_columns do
 
+  let :controller_with_columns do
     controller.send(:define_column,
-                    :first_name,
-                    filter: -> (value) { where('UPPER(first_name) LIKE (?)', "%#{value.upcase}%") },
-                    sort: -> (sort_order) { order(:first_name => sort_order) })
-
+                    :first_name)#,
+                    # filter: -> (value) { where('UPPER(first_name) LIKE (?)', "%#{value.upcase}%") },
+                    # sort: -> (sort_order) { order(:first_name => sort_order) })
     controller.send(:define_column,
                     :last_name,
-                    filter: -> (value) { select{|record| value.downcase.in? record.last_name.downcase }},
+                    filter: -> (value) { select{|record| record.last_name.downcase.include? value.downcase }},
                     sort: -> (sort_order) { sort{ |a,b| (sort_order == :asc ? a : b).last_name <=> (sort_order == :asc ? b : a).last_name }})
-
+    controller.send(:define_column,
+                    :full_name)
     controller.send(:define_column,
                     :email,
                     filter: -> (value) { where('UPPER(email) LIKE (?)', "%#{value.upcase}%") },
                     sort: -> (sort_order) { order(:email => sort_order) })
-
     controller
   end
 
@@ -50,7 +49,7 @@ describe TableSortable::Controller do
 
   context 'ordered_actions' do
     it 'orders sql actions before array filters' do
-      expect(controller_with_columns.send(:ordered_actions).map{|action| action.method}).to eq [:sql, :sql, :sql, :sql, :array, :array]
+      expect(controller_with_columns.send(:ordered_actions).map{|action| action.method}).to eq [:active_record, :active_record, :array, :array, :autodetect, :autodetect, :autodetect, :autodetect]
     end
   end
 
@@ -67,7 +66,7 @@ describe TableSortable::Controller do
       sort_by_first_name = controller_with_columns.send(:filter_and_sort, User.all, {TableSortable::PAGESIZE => '10', TableSortable::PAGE => '0', TableSortable::SCOL => {'0' => TableSortable::SORT_ASC}})
       expect(sort_by_first_name.pluck(:first_name)).to eq %w(Aaron Bob David Jim)
 
-      sort_by_email = controller_with_columns.send(:filter_and_sort, User.all, {TableSortable::PAGESIZE => '10', TableSortable::PAGE => '0', TableSortable::SCOL => {'2' => TableSortable::SORT_ASC}})
+      sort_by_email = controller_with_columns.send(:filter_and_sort, User.all, {TableSortable::PAGESIZE => '10', TableSortable::PAGE => '0', TableSortable::SCOL => {'3' => TableSortable::SORT_ASC}})
       expect(sort_by_email.pluck(:first_name)).to eq %w(Jim David Bob Aaron)
     end
     context "sort order parameter equals #{TableSortable::SORT_DESC}" do
@@ -76,6 +75,8 @@ describe TableSortable::Controller do
         expect(sort_by_last_name_desc.pluck(:first_name)).to eq %w(Aaron Jim Bob David)
       end
     end
+    it 'detects whether to use an active_record or array filter' do
 
+    end
   end
 end

data/spec/support/models/user.rb

@@ -1 +1,7 @@
-class User < ActiveRecord::Base ; end
+class User < ActiveRecord::Base
+
+
+  def full_name
+    "#{first_name} #{last_name}"
+  end
+end

data/table_sortable.gemspec

@@ -10,7 +10,7 @@ Gem::Specification.new do |spec|
   spec.email         = ["davidovoded@gmail.com"]
 
   spec.summary       = 'Use jquery-tablesorter.js with server side filtering, pagination and sorting'
-  spec.description   = 'Use jquery-tablesorter.js with server side filtering, pagination and sorting'
+  spec.description   = "TableSortable adds multi-column, server-side filtering, sorting and pagination to the tableSorter jQuery plugin, so you don't have to worry about interpreting the query parameters, combining multiple queries, columns to sort by, or figuring out how to send the correct page back to the client. It is a Rails backend complementation to the frontend tableSorter.js."
   spec.homepage      = 'https://github.com/odedd/table_sortable'
   spec.license       = "MIT"
 
@@ -34,5 +34,7 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "rspec", "~> 3.4"
   spec.add_development_dependency "sqlite3", "~> 1.3"
   spec.add_development_dependency "factory_girl_rails", "~> 4.8"
-  spec.add_dependency "rails", '~> 5.1', '>= 5.1.1'
+  spec.add_development_dependency "activerecord", '~> 5.1', '>= 5.1.1'
+  spec.add_dependency "railties", '~> 5.1', '>= 5.1.1'
+  # spec.add_dependency "activesupport", '~> 5.1', '>= 5.1.1'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: table_sortable
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Oded Davidov
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-05-31 00:00:00.000000000 Z
+date: 2017-06-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -81,7 +81,27 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '4.8'
 - !ruby/object:Gem::Dependency
-  name: rails
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.1.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.1.1
+- !ruby/object:Gem::Dependency
+  name: railties
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
@@ -100,8 +120,11 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 5.1.1
-description: Use jquery-tablesorter.js with server side filtering, pagination and
-  sorting
+description: TableSortable adds multi-column, server-side filtering, sorting and pagination
+  to the tableSorter jQuery plugin, so you don't have to worry about interpreting
+  the query parameters, combining multiple queries, columns to sort by, or figuring
+  out how to send the correct page back to the client. It is a Rails backend complementation
+  to the frontend tableSorter.js.
 email:
 - davidovoded@gmail.com
 executables: []
@@ -123,12 +146,6 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
-- app/helpers/table_sortable_helper.rb
-- app/views/table_sortable/_columns.slim
-- app/views/table_sortable/_field.slim
-- app/views/table_sortable/_header.slim
-- app/views/table_sortable/_headers.slim
-- app/views/table_sortable/_pager.slim
 - bin/console
 - bin/setup
 - lib/table_sortable.rb
@@ -140,8 +157,10 @@ files:
 - lib/table_sortable/controller.rb
 - lib/table_sortable/process.rb
 - lib/table_sortable/query_params.rb
+- lib/table_sortable/railtie.rb
 - lib/table_sortable/result.rb
 - lib/table_sortable/version.rb
+- lib/table_sortable/view_helpers.rb
 - spec/concerns/proc_class_spec.rb
 - spec/controllers/test_controller_spec.rb
 - spec/lib/table_sortable/column/filter_spec.rb

data/app/helpers/table_sortable_helper.rb

@@ -1,15 +0,0 @@
-module TableSortableHelper
-
-  def table_sortable_pager
-    render 'table_sortable/pager'
-  end
-
-  def table_sortable_headers
-    render 'table_sortable/headers'
-  end
-
-  def table_sortable_columns(record)
-    render 'table_sortable/columns', record: record
-  end
-
-end

data/app/views/table_sortable/_columns.slim

@@ -1,3 +0,0 @@
-- columns.each do |col|
-  - options = {value: col.value(record), source: record, column: col}
-  = render("#{controller_path}/table_sortable/#{col.template}_field", options) rescue render('table_sortable/field', options)

data/app/views/table_sortable/_field.slim

@@ -1 +0,0 @@
-td = value

data/app/views/table_sortable/_header.slim

@@ -1,2 +0,0 @@
-th*{'data-filter' => column.filter.disabled? ? 'false' : false, 'data-placeholder'=>column.placeholder }
-  = label

data/app/views/table_sortable/_headers.slim

@@ -1,3 +0,0 @@
-- columns.each do |col|
-  - options = {label: col.label, column: col}
-  = render("#{controller_path}/table_sortable/#{col.template}_header", options) rescue render('table_sortable/header', options)

data/app/views/table_sortable/_pager.slim

@@ -1,42 +0,0 @@
-.nav aria-label="Table Navigation"
-  ul.pagination
-    li.page-item
-      a.page-link.first = fa_icon 'fast-backward'
-    li.page-item
-      a.page-link.prev = fa_icon 'step-backward'
-    li.page-item
-      span.page-link.pagedisplay
-    li.page-item
-      a.page-link.next = fa_icon 'step-forward'
-    li.page-item
-      a.page-link.last = fa_icon 'fast-forward'
-
-
-/<nav aria-label="Page navigation example">
-/  <ul class="pagination">
-/    <li class="page-item">
-/      <a class="page-link" href="#" aria-label="Previous">
-/        <span aria-hidden="true">&laquo;</span>
-/        <span class="sr-only">Previous</span>
-/      </a>
-/    </li>
-/    <li class="page-item"><a class="page-link" href="#">1</a></li>
-/    <li class="page-item"><a class="page-link" href="#">2</a></li>
-/    <li class="page-item"><a class="page-link" href="#">3</a></li>
-/    <li class="page-item">
-/      <a class="page-link" href="#" aria-label="Next">
-/        <span aria-hidden="true">&raquo;</span>
-/        <span class="sr-only">Next</span>
-/      </a>
-/    </li>
-/  </ul>
-/</nav>
-
-/.row
-/  .col.text-right
-/    .pagination.my-0.justify-content-center
-/      a.first.ml-1 = fa_icon 'fast-backward'
-/      a.prev = fa_icon 'step-backward'
-/      span.mx-1.pagedisplay
-/      a.ml-1.next = fa_icon 'step-forward'
-/      a.last = fa_icon 'fast-forward'