blacklight_dates2svg 0.0.1.beta1 → 0.0.1.beta2

data/README.md

@@ -1 +1,81 @@
 # BlacklightDates2SVG
+
+This gem is intended to be installed into Blacklight applications ( https://github.com/projectblacklight/blacklight ) to generate an SVG of date data into a heat-map style grid from date facet data.
+
+![date range heat map](http://i.imgur.com/6dcL09C.png)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'blacklight_dates2svg'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install blacklight_dates2svg
+    
+Add asset references to application.css and application.js.
+
+    $ rails generate blacklight_dates2svg
+
+
+## Components
+
+This gem simply provides the form elements to interact with the SVG grid, the logic to inject the range query into Blacklight's Solr parameters, and brings in a few other gems/plugins to drive the interaction and process the data for Blacklight.
+
+* Dates2SVG gem ( https://github.com/jkeck/dates2svg ) to generate the SVG grid.
+* svgMonthGridSelector jQuery plugin ( https://github.com/jkeck/svgMonthGridSelector ) to drive the interaction with the form elements.
+* date_range_solr_query gem ( https://github.com/jkeck/date_range_solr_query ) to turn the YYYY-MM dates into full date range queries for Solr.
+
+
+## Solr Requirements
+
+The data should be a facet that is a DateField ( http://lucene.apache.org/solr/api/org/apache/solr/schema/DateField.html ).  The facet limit should be set to return all values in the response to drive the SVG grid.  Alternatively you can pass an array of dates in as a :dates option (see Usage below).
+
+## Usage
+
+Once the gem is installed you will need to include the BlacklightDates2SVG module into you search controller (CatalogController by default in Blacklight).
+
+    include BlacklightDates2SVG
+    
+You will need to add 2 lines in the contorller level Blacklight configuration ( configure_blacklight block ).  One to configure the facet (and most likely set :show to false) and another to let the gem know which field is the date field.
+
+    config.add_facet_field 'date_facet', :label => "Date", :show => false
+    config.search_date_field = 'date_facet'
+    
+Now in any helper or view rendered under that controller will have the render_date_range_selector_grid helper method available.
+
+    <%= render_date_range_selector_grid %>
+    
+You can pass all the options described in the [README](https://github.com/jkeck/dates2svg) of the Dates2SVG gem to the render_date_range_selector_grid helper method.
+
+This gem adds an additional :dates option that when passed will ignore the facets in the response and just use the array passed in that option.
+
+    dates = [OpenStruct.new(:value => "2012-03-23", :hits => 836),
+             OpenStruct.new(:value => "2012-02-21", :hits => 584)]
+    
+    svg = render_date_range_selector_grid(:dates => dates)
+    
+## Customizing
+
+There are 4 partials that can be overridden at the application level to customize some markup.
+
+1. [app/views/blacklight_dates2svg/_date_range_selector](https://github.com/jkeck/blacklight_dates2svg/blob/master/app/views/blacklight_dates2svg/_date_range_selector.html.erb) (The main layout) 
+2. [app/views/blacklight_dates2svg/_date_range_grid](https://github.com/jkeck/blacklight_dates2svg/blob/master/app/views/blacklight_dates2svg/_date_range_grid.html.erb) (The SVG grid)
+3. [app/views/blacklight_dates2svg/_date_range_form](https://github.com/jkeck/blacklight_dates2svg/blob/master/app/views/blacklight_dates2svg/_date_range_form.html.erb) (The form elements and the rendering of the legend partial)
+4. [app/views/blacklight_dates2svg/_legend](https://github.com/jkeck/blacklight_dates2svg/blob/master/app/views/blacklight_dates2svg/_legend.html.erb) (The legend)
+
+
+The [svgMonthGridSelector](https://github.com/jkeck/svgMonthGridSelector) jQuery plugin has some defaults that we adhere to.  If you customize the form you may want to instantiate the plugin on your own and pass the necessary options to customize the behavior of the jQuery plugin.
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/lib/blacklight_dates2svg.rb

@@ -22,7 +22,7 @@ module BlacklightDates2SVG
     end
   end
 
-  def render_date_range_selector_grid(options)
+  def render_date_range_selector_grid(options={})
     items = (options[:dates] || @response.facets.select do |facet|
                                   facet.name == blacklight_config.search_date_field
                                 end.first.items)

data/lib/blacklight_dates2svg/version.rb

@@ -1,3 +1,3 @@
 module BlacklightDates2SVG
-  VERSION = "0.0.1.beta1"
+  VERSION = "0.0.1.beta2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: blacklight_dates2svg
 version: !ruby/object:Gem::Version
-  version: 0.0.1.beta1
+  version: 0.0.1.beta2
   prerelease: 6
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-04-12 00:00:00.000000000 Z
+date: 2013-04-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -161,7 +161,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -968421337915451210
+      hash: -4449922145157925452
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements: