Readme

Author: Gena Maly

README.md

@@ -8,6 +8,10 @@ This is how it looks like
 
 ![Step 2](/screen/step_2.jpg)
 
+![Form 1](/screen/step_2_1.png)
+
+![Form 2](/screen/step_2_2.png)
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -55,6 +59,64 @@ By default inputs are filled with date("yyyy-mm-dd"). If you need time add
 ```data: { show_time: 'true' }```
 
 
+## Using with ActiveAdminDatetimepicker
+
+If you use GEM https://github.com/activeadmin-plugins/active_admin_datetimepicker
+and want apply this plugin to filter-inputs for this gem you need:
+
+First apply ActiveAdminDatetimepicker to any filters your need
+
+```ruby
+filter :time_start, as: :date_time_range
+```
+
+In active_admin.js
+
+Add following lines to JavaScript
+
+```javascript
+$(document).on('ready', function(){
+    $('form.filter_form div.filter_date_time_range').date_range_ext_preset();
+});
+```
+
+Now all you "date_time_range" inputs has button "Set rage"
+
+
+## Custom usage
+
+You can assign "Set range" almost to any input-text-pair filters/forms.
+For example, you have complex form where input-pairs are not close to each other and not standard.
+
+```javascript
+$(document).on('ready', function(){
+  $('.any_jquery_selector').date_range_ext_preset({
+    lteq_input: '.jquery_selector_to_first_input',
+    gteq_input: '.jquery_selector_to_second_input'
+  });
+});
+```
+".any_jquery_selector" is pointed to place where button "Set rage" will appear.
+Set lteq_input and gteq_input to point to inputs if they not near main selector.
+
+
+## Global and local settings
+
+There are several settings, which can be set globally or locally.
+
+Example how to set settings for only specific inputs
+
+```javascript
+$('.any_jquery_selector').date_range_ext_preset({
+ setting_name: "setting_value"
+});
+```
+Example how to set global settings. Write it before $(document).on('ready')
+
+```javascript
+$.fn.date_range_ext_preset.defaults.setting_name = "setting_value"
+```
+
 You can set global defaults in your active_admin.js like this:
 
 ```javascript
@@ -69,4 +131,59 @@ $.fn.date_range_ext_preset.defaults.date_to_human_readable = true
 $.fn.date_range_ext_preset.defaults.show_time = true
 ```
 
-Set dafaults before $(document).on('ready')
+### date_to_human_readable
+
+value: true/false
+
+default: false
+
+This options changes second date to include full date-time of the day, like normal human thinks about time ranges.
+Today true : 2015-06-12 - 2015-06-12
+Today false: 2015-06-12 - 2015-06-13
+
+When normal human say "2015-06-12" hi means "2015-06-12 23:59:59"
+But default behavior in programming is "2015-06-12" = "2015-06-12 00:00:00"
+Be careful with this options. Cause if you change it to "true" you will also need to change your server-side scripts to search "humanize-way".
+
+### show_time
+
+value: true/false
+
+default: false
+
+If true then will show date and time, usually it will be 00:00:00
+
+### hours_offset
+
+values: positive or negative integer
+
+default: 0
+
+To work correctly this plugin needs to detect current date-time. And it uses UTC. But if you need your local timezone or some other time-shift, your can set this option:
+
+Example:
+```javascript
+$.fn.date_range_ext_preset.defaults.hours_offset = +3
+// or
+$.fn.date_range_ext_preset.defaults.hours_offset = -3
+``` 
+
+### inject_method
+
+value: 'wrap' or 'append'
+
+This is how button "Set rage" will be added to DOM-tree. Play with it to choose best place.
+
+
+
+
+
+
+
+
+
+
+
+
+
+

lib/active_admin_date_range_preset.rb

@@ -1,5 +1,5 @@
 require "activeadmin"
-require "active_admin_datetimepicker/version"
+require "active_admin_date_range_preset/version"
 
 module ActiveAdminDateRangePreset
     module Rails