Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Rails Admin Import functionality
Ruby

Merge pull request #37 from moonavw/master

fix issue#6, #27 and an issue of related fields mapping not displayed
latest commit 775e061a59
@stephskardal authored

README.md

Request for Contributors / Core Contributors

I apologize for my extreme lack of attention to this repository since it was created. I see that several users have forked this gem and applied updates. I'd be interested in giving access to this main repository for any interested in maintaining it and/or adding features. Please contact me if you are interested at steph at endpoint dot com.

Rails Admin Import functionality

Plugin functionality to add generic import to Rails Admin interface

Installation

  • First, add to Gemfile:

    gem "rails_admin_import"
    
  • Next, mount in your application by adding following line to your config/routes.rb:

    mount RailsAdminImport::Engine => '/rails_admin_import', :as => 'rails_admin_import'
    
  • If you are using cancan, add to ability.rb to specify which models can be imported:

    can :import, [User, Model1, Model2]
    
  • Define configuration in config/initializers/rails_admin_import.rb:

    RailsAdminImport.config do |config| 
      config.model User do
        excluded_fields do
          [:field1, :field2, :field3]
        end
        label :name
        extra_fields do
          [:field3, :field4, :field5]
        end
      end
    end
    
  • (Optional) Define instance methods to be hooked into the import process, if special/additional processing is required on the data:

    # some model
    def before_import_save(row, map)
      # Your custom special sauce          
    end
    
    def after_import_save(row, map)
      # Your custom special sauce          
    end
    
  • "import" action must be added inside config.actions block in main application RailsAdmin configuration: config/initializers/rails_admin.rb.

    config.actions do
      ...
      import
      ...
    end
    

    Refer to RailAdmin documentation on custom actions that must be present in this block.

  • TODO: Right now, import doesn't work for fields ending in s, because inflector fails in models ending in s singularly. Belongs_to and many mapping needs to be updated to use klasses instead of symbols

TODO

  • Testing

Copyright

Copyright (c) 2014 End Point & Steph Skardal. See LICENSE.txt for further details.

Something went wrong with that request. Please try again.