active_admin_csv_import 1.2.1 → 1.3.0

data/app/views/admin/csv/_instructions.html.erb

@@ -4,6 +4,7 @@
         default: 'Import %{resource_name} from a CSV File' ) %>
 </h3>
 <ul>
-  <li><%= t('.file_type', default: "Save a CSV as 'Windows Comma Separated' from Excel.") %></li>
-  <li><%= t('.must_have_headings', columns: @required_columns.to_sentence, default: "Your CSV should have the following column headings: %{columns}. The order doesn't matter.") %></li>
+  <li><%= t('.file_type', default: "Save a CSV as 'Windows Comma Separated' from Excel if you're on Mac, or 'CSV' otherwise.") %></li>
+  <li><%= t('.must_have_headings', columns: @required_columns.map(&:to_s).map(&:humanize).to_sentence, default: "Your CSV should have the following column headings: %{columns}. The order doesn't matter.") %></li>
+  <li><%= link_to(t('.example_link', default: "Download an example"), url_for(:controller => controller_name, :action => 'example_csv')) %></li>
 </ul>

data/lib/active_admin_csv_import/dsl.rb

@@ -1,16 +1,32 @@
+require 'csv'
+
 module ActiveAdminCsvImport
   module DSL
 
     def csv_importable(options={})
 
+      # All columns
+      columns = options[:columns] ||= active_admin_config.resource_class.columns.map(&:name) - ["id", "updated_at", "created_at"]
+
+      # Required columns. A subset of all columns. A client-side validation error is raised if one of these is not found.
+      required_columns = options[:required_columns] ||= columns
+
       action_item :only => :index do
         link_to "Import #{active_admin_config.resource_name.to_s.pluralize}", :action => 'import_csv'
       end
 
+      # Returns an example CSV based on the columns expected for import.
+      collection_action :example_csv do
+        csv_column_names = CSV.generate do |csv|
+          csv << columns.map(&:to_s).map(&:humanize)
+        end
+        send_data(csv_column_names, :type => 'text/csv; charset=utf-8; header=present', :filename => active_admin_config.resource_class.name.to_s.pluralize + ".csv")
+      end
+
       # Shows the form and JS which accepts a CSV file, parses it and posts each row to the server.
       collection_action :import_csv do
-        @columns           = options[:columns] ||= active_admin_config.resource_class.columns.map(&:name) - ["id", "updated_at", "created_at"]
-        @required_columns  = options[:required_columns] ||= @columns
+        @columns           = columns
+        @required_columns  = required_columns
 
         @post_path  = options[:path].try(:call)
         @post_path ||= collection_path + "/import_rows"

data/lib/active_admin_csv_import/version.rb

@@ -1,3 +1,3 @@
 module ActiveAdminCsvImport
-  VERSION = "1.2.1"
+  VERSION = "1.3.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: active_admin_csv_import
 version: !ruby/object:Gem::Version
-  version: 1.2.1
+  version: 1.3.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-01-07 00:00:00.000000000 Z
+date: 2014-01-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
-  requirement: &70301211983820 !ruby/object:Gem::Requirement
+  requirement: &70339062483560 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: '3.1'
   type: :runtime
   prerelease: false
-  version_requirements: *70301211983820
+  version_requirements: *70339062483560
 - !ruby/object:Gem::Dependency
   name: railties
-  requirement: &70301211983180 !ruby/object:Gem::Requirement
+  requirement: &70339062497880 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,7 +32,7 @@ dependencies:
         version: '3.1'
   type: :runtime
   prerelease: false
-  version_requirements: *70301211983180
+  version_requirements: *70339062497880
 description: CSV import for Active Admin capable of handling CSV files too large to
   import via direct file upload to Heroku
 email: