Details
Major Description
The linked PR introduces the following new features:
- ability for an institution to define and use an arbitrary number of custom copyright options
- enabled/disabled via sakai.property "copyright.useCustom", which defaults to false
- custom copyright options are defined via /content/content-copyright/impl/src/bundle/org/sakaiproject/content/copyright/copyright.properties
- ability to force users to explicitly select copyright status for files
- enabled/disabled via sakai.property "copyright.requireChoice", which defaults to false
- works with both default and custom copyright options
- if set to true, inputs a "Please select a copyright status" entry in the copyright drop down (always first element in the list)
- client and server side validation to reject saving the resource if the drop down was not set to a value other than the "Please select..."
- adds the copyright drop down form field to the upload resources form (accessed from both the Resources tool and the Drop Box tool)
- one drop down, setting applies to all files uploaded
- previously was only present on the 'Edit Details' form
The linked PR also includes refactoring existing copyright code, removing old and unused copyright sakai.properties, and improved documentation of the current state of valid copyright sakai.properties in default.sakai.properties.
The following sakai.properties have been added:
# SAK-39953 - use custom copyright options rather than the predefined list # NOTE: define your custom copyright options in /content/content-copyright/impl/src/bundle/org/sakaiproject/content/copyright/copyright.properties # NOTE: examples are defined in the above file, with the keys 'custom.copyright.#'; define as many or as few as needed by your institution # DEFAULT: false # copyright.useCustom=true # SAK-39953 - require users to explicity define the copyright status for uploaded files in the Resources tool # NOTE: does not require any other copyright sakai.properties to be set (works with defaults, copyright.types and custom copyright) # DEFAULT: false # copyright.requireChoice=true
The following sakai.properties have been removed:
## NOTE: these copyright properties may not be valid anymore - 8 Sept 2011 # default.copyright=Copyright status is not yet determined. # default.copyright.alert=true # fairuse.url=http://fairuse.stanford.edu # newcopyrightinput=true
- default.copyright was made obsolete via
KNL-1399(and re-implemented in the linked PR) - default.copyright.alert was some legacy property, not really sure what it once did
- fairuse.url from sakai.properties was not being used; the functionality of overriding the default value was moved into message bundles (/content/content-tool/tool/src/bundle/right.properties) some time ago, so I provided some more documentation there about what it does and how to customize it properly
- newcopyrightinput was another legacy property not being used; not sure what it once did
- for all of the above: removed some lingering code in /content/ project that was still referencing these and sticking them in the STATE but never actually using it
