Skip to content
A basic editor for samvera objects.
Branch: master
Clone or download
Trey Pendragon
Trey Pendragon Merge pull request #161 from jrgriffiniii/issues-157-jrgriffiniii-rub…
…y-2.5.1-rails-5.2.0

Updating the Travis CI build matrix to use Ruby releases 2.5.1 and 2.4.4 along with Rails releases 5.2.1, 5.1.6, and 5.0.7
Latest commit 9aa8428 Aug 17, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
app
config
lib
solr/config
spec
.gitignore
.rspec
.rubocop.yml
.rubocop_todo.yml
.travis.yml
CODE_OF_CONDUCT.md
CONTRIBUTING.md
Gemfile
History.md
LICENSE.txt
README.md
Rakefile
SUPPORT.md
hydra-editor.gemspec

README.md

HydraEditor

Code: Gem Version Build Status Coverage Status

Docs: Contribution Guidelines Apache 2.0 License

Jump in: Slack Status

What is hydra-editor?

A basic metadata editor for Rails applications based on hydra-head.

Product Owner & Maintenance

hydra-editor is a Core Component of the Samvera community. The documentation for what this means can be found here.

Product Owner

jrgriffiniii

Help

The Samvera community is here to help. Please see our support guide.

Getting Started

To use add to your gemfile:

gem 'hydra-editor'

Then run:

bundle install

Next generate the bootstrap form layouts:

rails generate simple_form:install --bootstrap

And to config/routes.rb add:

  mount HydraEditor::Engine => '/'

(Note: You do not have to mount the engine if you do not intend to use the engine's default routes.)

In your initialization set HydraEditor.models

# config/initializers/hydra_editor.rb
HydraEditor.models = ["RecordedAudio", "PdfModel"]

You can customize the names of your fields/models by adding to your translation file:

# config/locales/en.yml
en:
  hydra_editor:
    form:
      model_label:
        PdfModel: "PDF"
        RecordedAudio: "audio"

  simple_form:
    labels:
      image:
        dateCreated: "Date Created"
        sub_location: "Holding Sub-location"

Create a form object for each of your models.

# app/forms/recorded_audio_form.rb
class RecordedAudioForm
  include HydraEditor::Form
  self.model_class = RecordedAudio
  self.terms = [] # Terms to be edited
  self.required_fields = [] # Required fields
end

Add the javascript by adding this line to your app/assets/javascript/application.js:

//= require hydra-editor/hydra-editor

Add the stylesheets by adding this line to your app/assets/stylesheets/application.css:

 *= require hydra-editor/hydra-editor

(Note: The Javascript includes require Blacklight and must be put after that.)

Updating to 4.0.0

  • SimpleForm is supported from release 3.2.0 onwards
  • #to_model now returns self (previously it was the value of @model):
      class MyForm
        include HydraEditor::Form
        self.model_class = MyModel
        self.terms = [:title, :creator]
        # [...]
      end
      # [...]
      some_work = MyModel.new(title: ['Black holes: The Reith Lectures.'], creator: 'S.W. Hawking')
      some_form = MyForm.new(some_work)
      # [...]
      some_form.to_model
      # => #<MyForm:0x00007fd5b2fd1468 @attributes={"id"=>nil, "title"=>["Black holes: The Reith Lectures."], "creator"=>"S.W. Hawking"}, @model=#<MyModel id: nil, title: ["Black holes: The Reith Lectures."], creator: "S.W. Hawking">>
  • When a form field for a single value is empty, it now returns a nil value (as opposed to an empty String):
      class MyForm
        include HydraEditor::Form
        self.model_class = MyModel
        self.terms = [:title, :creator]
        # [...]
      end
    
      # [...]
      values = MyForm.model_attributes(
        title: ['On the distribution of values of angles determined by coplanar points.'],
        creator: ''
      )
      values['creator']
      # => nil

Other customizations

By default hydra-editor provides a RecordsController with :new, :create, :edit, and :update actions implemented in the included RecordsControllerBehavior module, and a RecordsHelper module with methods implemented in RecordsHelperBehavior. If you are mounting the engine and using its routes, you can override the controller behaviors by creating your own RecordsController:

class RecordsController < ApplicationController
  include RecordsControllerBehavior

  # You custom code
end

If you are not mounting the engine or using its default routes, you can include RecordsControllerBehavior in your own controller and add the appropriate routes to your app's config/routes.rb.

Acknowledgments

This software has been developed by and is brought to you by the Samvera community. Learn more at the Samvera website.

Samvera Logo

You can’t perform that action at this time.