Sufia 4.3.1

NOTE: The 4.3.0 release was yanked because it was not ready for release.

The 4.3.1 release of Sufia includes the ability to store users' ORCID identifiers and display them in the user profile, and includes enhancements to usage statistics. It also includes support for Blacklight 5.8 and a good number of bugfixes. Thanks to @Cam156, @mtribone, @val99erie, @awead, @mistydemeo, and @mjgiarlo for their work on this release. See below for a complete changelog.

Upgrade notes

Rails 4 is recommended. You may also need to follow the upgrade paths for dependent gems such as Devise. You can use the generators and other tools provided by those gems to perform the necessary upgrades.

From Sufia 3.x and prior

Update your dependencies to use the latest Sufia 4 version and run the provided 4.0 upgrade generator

bundle update sufia
rails generate sufia:upgrade400

You will need to ensure your binstubs are present. Prior to Rails 4, this was done using bundler

bundle install --binstubs

In Rails 4, you can regenerate them without using bunder

bundle config --delete bin 
rake rails:update:bin

You may optionally ignore or include these in your git repo. Edit your .gitignore file accordingly.

From Sufia 4.2.0

To upgrade from 4.2.0 to 4.3.1, pin Sufia to version 4.3.1 in your Gemfile, then update your dependencies, generate the new database migrations required for user stats & ORCID, and then apply those migrations:

bundle update sufia
rails generate sufia:models:cached_stats
rails generate sufia:models:user_stats
rails generate sufia:models:orcid_field
rake db:migrate

If your application has any Blacklight-based catalog controllers, you may want to add the following lines within the configure_blacklight block:

    config.view.gallery.partials = [:index_header, :index]
    config.view.slideshow.partials = [:index]

You may additionally need to upgrade your version of bootstrap-sass. 3.1.1.1 is not compatible with this version of Sufia. If you see the error, File to import not found or unreadable: bootstrap-sprockets. run:

bundle update bootstrap-sass

Known Issues

Changes to the avatars may prevent migrations from running. To resolve this, update the add_avatars_to_users migration as follows:

class AddAvatarsToUsers < ActiveRecord::Migration
  def self.up
    add_column :users, "avatar_file_name",    :string
    add_column :users, "avatar_content_type", :string
    add_column :users, "avatar_file_size",    :integer
    add_column :users, "avatar_updated_at",   :datetime
  end

  def self.down
    remove_column :users, "avatar_file_name"
    remove_column :users, "avatar_content_type"
    remove_column :users, "avatar_file_size"
    remove_column :users, "avatar_updated_at"
  end
end

You could optionally write a separate migration that makes these changes for you.

Changes

v4.2.0...v4.3.1

• Adds an ORCID field to the user model. [Michael J. Giarlo]
• Display file stats for user. Feature #9305 [Valerie Maher]
• Upgrade to Blacklight 5.8 [Adam Wead]
• Styles count for views and downloads, refs #9672 [Michael Tribone]
• More facets modal defaults to numerical sort [Adam Wead]
• Adding select2 name look up to permissions form for GenericFile and Batch. [Carolyn Cole]
• Adding blacklight gallery default views to catalog controller to match with the new installer. [Carolyn Cole]
• Making sure the modal is actually sorted numerically and allow some files to be on the second page for sure by adding the key in more than one time for the first page. [Carolyn Cole]
• Views should not use the invalid Agent schema.org class [Michael J. Giarlo]
• Fixing a bug that the home page crashes when a featured work has been destroyed [Carolyn Cole]
• Fixes button size and alignment issues with metadata and upload forms, refs #9569 [Michael Tribone]
• Disable check all instead of making it disappear. User testing indicated this was confusing [Carolyn Cole]
• Updated dev notes [Valerie Maher]
• README should not implicitly suggest an outdated version of Sufia. (Inspired by #719 -- thx, @mistydemeo!) [Michael J. Giarlo]