Difference between revisions of "EPrints 3.4.5"

From EPrints Documentation
Jump to: navigation, search
(New Dependencies)
(Release Notes: Known issues should be own section)
 
(10 intermediate revisions by 3 users not shown)
Line 1: Line 1:
This page contains information about the provisional EPrints v3.4.5 tag and release on GitHub.
+
{{releasenotes}}
  
== Provisional Release Notes ==
+
== Release Notes ==
[https://github.com/eprints/eprints3.4/releases/tag/v3.4.5-rc1 EPrints 3.4.5 release candidate 1] is now available on GitHub. Full release is planned for release shortly.
+
EPrints 3.4.5 is now available on [https://github.com/eprints/eprints3.4/releases/tag/v3.4.5 GitHub] and [https://files.eprints.org/2789/ files.eprints.org].
 
* '''Zero codename:''' Smoothie Squall
 
* '''Zero codename:''' Smoothie Squall
 
* '''Publications flavour codename:''' Kombucha Hypercane (1.5)
 
* '''Publications flavour codename:''' Kombucha Hypercane (1.5)
  
 
=== New Dependencies ===
 
=== New Dependencies ===
<tt>html2text</tt> OS package required instead of <tt>elinks</tt>.
+
<tt>html2text</tt> RPM / DEB required instead of <tt>elinks</tt>.
  
 
Check earlier dependencies for [[EPrints 3.4.4]] and before.
 
Check earlier dependencies for [[EPrints 3.4.4]] and before.
Line 27: Line 27:
 
* [https://github.com/eprints/eprints3.4/issues/237 Improves "request copy" security].
 
* [https://github.com/eprints/eprints3.4/issues/237 Improves "request copy" security].
 
* [https://github.com/eprints/eprints3.4/issues/311 Ensures <code>SameSite=Strict</code> for all cookies].
 
* [https://github.com/eprints/eprints3.4/issues/311 Ensures <code>SameSite=Strict</code> for all cookies].
 +
* Better force HTTPS when generating repository URLs.
  
 
==== General Improvements ====
 
==== General Improvements ====
Line 68: Line 69:
 
* [https://github.com/eprints/eprints3.4/issues/322 Allow different phrases to be used for field names dependent on eprint's type].
 
* [https://github.com/eprints/eprints3.4/issues/322 Allow different phrases to be used for field names dependent on eprint's type].
 
* [https://github.com/eprints/eprints3.4/issues/326 Allows date input fields to be rendered shorter].
 
* [https://github.com/eprints/eprints3.4/issues/326 Allows date input fields to be rendered shorter].
 +
* Improves rendering/hiding of missing subjects depending on <code>render_quiet</code>.
 +
* Adds data-row... attributes to compound/multiple field renders.
 
* Various improvements to POD documentation.
 
* Various improvements to POD documentation.
  
Line 109: Line 112:
 
* [https://github.com/eprints/eprints3.4/commit/ffd9b53079bc6969ba17671552aefd5b5d511c66|Removes unnecessary field defaults. Better restricts digits for int fields].
 
* [https://github.com/eprints/eprints3.4/commit/ffd9b53079bc6969ba17671552aefd5b5d511c66|Removes unnecessary field defaults. Better restricts digits for int fields].
 
* [https://github.com/eprints/eprints3.4/pull/325 Fixes ARIA typo in upload form].
 
* [https://github.com/eprints/eprints3.4/pull/325 Fixes ARIA typo in upload form].
 +
* [https://github.com/eprints/eprints3.4/issues/329 Fixes use of fieldsets in input/search from to make it easier and more consistent when modifying CSS].
 +
* [https://github.com/eprints/eprints3.4/issues/330 Deal with UTF8-MB4 characters that would break database queries].
 +
* Makes user menu bar and footer more responsive to page width.
 +
* Fixes word-wrapping overflow on homepage description list.
 
* Various improvements to the <code>tidy_pids</code> script.
 
* Various improvements to the <code>tidy_pids</code> script.
 
* Various typos
 
* Various typos
 +
 +
== Known Issues ==
 +
 +
=== Long time to add <tt>requester_userid</tt> field to access data object ===
 +
Adding new columns to a database table that already contains a lot of records can take a long time.  The access table for EPrints can often have tens of millions of records.  At such a size adding a new column can take in the order of hours.  EPrints 3.4.5 add the new field <tt>requester_userid</tt>.  This is intended to capture the logged in user that is viewing or downloading an eprint/document.  This is useful for Open Education repositories that have different access permissions.  However, if you have a large access table you may want to [https://github.com/eprints/eprints3.4/commit/79683e8dadda91f5d4862b23fa7bd80bcdee081d apply this patch] from the [https://github.com/eprints/eprints3.4/issues/333 GitHub issue].
 +
 +
=== Subject search does not work in workflows ===
 +
If you have a subject field which renders as a subject tree in a workflow, the search form will not work.  This is due to the [https://github.com/eprints/eprints3.4/issues/246 fix for ensuring Xapian respect a MetaField's <tt>text_index</tt> value].  This has the consequence of not indexing the <tt>ancestors</tt> field for subjects.  This is used by the search to filter out subjects that are not part of the subject sub-tree for a particular MetaField.  [https://github.com/eprints/eprints3.4/commit/3fbd47ccc0d9e66514455c693b62b902790e3326 This patch] fixes [https://github.com/eprints/eprints3.4/issues/411 the issue].  However, you will also need to re-index all subjects:
 +
EPRINTS_PATH/bin/epadmin reindex ARCHIVE_ID subject
 +
 +
=== Approved document requests still force user to login ===
 +
This issue was caused by setting the <code>samesite</code> attribute for the <code>eprints_doc_request</code> cookie to <code>Strict</code>, this cookie is intended to allow the user to access the restricted document for the remainder of their session.  Changing this attributes means some browsers (e.g. Firefox) still send the user to a login page even when clicking the approved request link in the email they received.  This is because the change made to the cookie prevents its from being stored because <code>/cgi/process_request</code> never fully serves a page.  [https://github.com/eprints/eprints3.4/commit/278b5e599dc9f6aa1e4a20f3b211afabb2a4ea9a This patch] fixes the [https://github.com/eprints/eprints3.4/issues/413 the issue].
 +
 +
== Planned Development ==
 +
See [[EPrints 3.4.6]]
  
 
[[Category:Eprints3.4]]
 
[[Category:Eprints3.4]]
[[Category:Planned Releases]]
+
[[Category:Releases]]

Latest revision as of 10:31, 13 November 2024

Release Notes

3.4 | 3.4.1 | 3.4.2 | 3.4.3 | 3.4.4 | 3.4.5 | 3.4.6


3.3 | 3.3.5 | 3.3.6 | 3.3.7 | 3.3.8 | 3.3.9 | 3.3.10 | 3.3.11 | 3.3.13 | 3.3.14 | 3.3.15 | 3.3.16


3.2.0 | 3.2.1 | 3.2.2 | 3.2.3 | 3.2.4 | 3.2.5 | 3.2.6 | 3.2.7 | 3.2.8 | 3.2.9


3.1.0

Release Notes

EPrints 3.4.5 is now available on GitHub and files.eprints.org.

  • Zero codename: Smoothie Squall
  • Publications flavour codename: Kombucha Hypercane (1.5)

New Dependencies

html2text RPM / DEB required instead of elinks.

Check earlier dependencies for EPrints 3.4.4 and before.

Changes Since 3.4.4

New Functionality

Security and Privacy Improvements

General Improvements

Bug Fixes

Known Issues

Long time to add requester_userid field to access data object

Adding new columns to a database table that already contains a lot of records can take a long time. The access table for EPrints can often have tens of millions of records. At such a size adding a new column can take in the order of hours. EPrints 3.4.5 add the new field requester_userid. This is intended to capture the logged in user that is viewing or downloading an eprint/document. This is useful for Open Education repositories that have different access permissions. However, if you have a large access table you may want to apply this patch from the GitHub issue.

Subject search does not work in workflows

If you have a subject field which renders as a subject tree in a workflow, the search form will not work. This is due to the fix for ensuring Xapian respect a MetaField's text_index value. This has the consequence of not indexing the ancestors field for subjects. This is used by the search to filter out subjects that are not part of the subject sub-tree for a particular MetaField. This patch fixes the issue. However, you will also need to re-index all subjects:

EPRINTS_PATH/bin/epadmin reindex ARCHIVE_ID subject

Approved document requests still force user to login

This issue was caused by setting the samesite attribute for the eprints_doc_request cookie to Strict, this cookie is intended to allow the user to access the restricted document for the remainder of their session. Changing this attributes means some browsers (e.g. Firefox) still send the user to a login page even when clicking the approved request link in the email they received. This is because the change made to the cookie prevents its from being stored because /cgi/process_request never fully serves a page. This patch fixes the the issue.

Planned Development

See EPrints 3.4.6