EPrints Documentation - Recent changes [en-gb]

How to control eprint workflow based on a user field

Libjlrs — Fri, 29 May 2026 12:16:22 GMT

Installation for EPrints 3.5

Drn@ecs.soton.ac.uk — Fri, 29 May 2026 10:16:37 GMT

Added initial placeholder text

New page

There are number of changes for how to install EPrints 3.5 compared to earlier versions. For now, please use these instructions rather than the generic instructions on the main [[Installation]] page for installing EPrints 3.5. At some later stage, those instructions will changed to be for EPrints 3.5 and the current instructions move to a "Installation for EPrints 3.4" instructions page.

Installing EPrints on Debian/Ubuntu

Th.lauke@arcor.de — Wed, 27 May 2026 09:35:10 GMT

Debian versions continued, wget installation simplified

EPrints 3.4.8

Drn@ecs.soton.ac.uk — Mon, 18 May 2026 13:04:44 GMT

‎Bug Fixes

YouTube Import

Wr1r25 — Mon, 18 May 2026 08:37:50 GMT

‎Python 3.11+

User talk:Wr1r25

Jb4@ecs.soton.ac.uk — Fri, 15 May 2026 14:43:47 GMT

Welcome!

New page

'''Welcome to ''EPrints Documentation''!'''
We hope you will contribute much and well.
You will probably want to read the [https://www.mediawiki.org/wiki/Special:MyLanguage/Help:Contents help pages].
Again, welcome and have fun! [[User:Jb4@ecs.soton.ac.uk|Jb4@ecs.soton.ac.uk]] ([[User talk:Jb4@ecs.soton.ac.uk|talk]]) 14:43, 15 May 2026 (UTC)

User:Wr1r25

Jb4@ecs.soton.ac.uk — Fri, 15 May 2026 14:43:47 GMT

Creating user page for new user.

New page

A new member of the eprints services team, starting to learn the eprints ecosystem and how it works. Started September, 2025

User:Wr1r25

Jb4@ecs.soton.ac.uk — Fri, 15 May 2026 14:43:47 GMT

User account Wr1r25 was created by Jb4@ecs.soton.ac.uk and password was sent by email

Issues with Installing EPrints on Ubuntu 26.04

Drn@ecs.soton.ac.uk — Wed, 13 May 2026 11:06:35 GMT

Updated info as of 13th May 2026

EPScript/Examples

Drn@ecs.soton.ac.uk — Tue, 12 May 2026 16:05:23 GMT

‎Testing a boolean field: Added advice for unset boolean fields

EPScript/Data Types

Drn@ecs.soton.ac.uk — Tue, 12 May 2026 15:48:07 GMT

‎Booleans

@@ Line 1: / Line 1: @@
-NOTE: This has been written based on my experience of an EPrints 3.3.10 install.
+NOTE: This was originally written based on experience of an EPrints 3.3.10 install. It has been updated following a post on the EP-Tech list ''Restrict sepcific editor only upload in specific divisions'' (May 2026), and seems to work against a v3.4.6 archive.
-== What I was trying to achieve ==
+== Task ==
-We have many 'collections'. Each EPrint belongs to one collection.
+How to control the EPrint workflow, only show options (e.g. divisions/collections) that a user can deposit into? e.g.
-Users can only deposit items into specific collections.
+== Divisions example ==
-How do I control the EPrint workflow to only show the collections that a user can deposit into?
+=== Add field to user, to control the division (or sub-divisions) they can deposit to ===
-== How I did it ==
+=== Add phrases for user field ===
 === Configuration of metafields ===
 *Create a namedset with the collections in it:

@@ Line 5: / Line 5: @@
 == Requirements ==
 * Ubuntu 22.04 LTS and Ubuntu 24.04 LTS (non-LTS versions not recommended)
-* Debian 11 (Bullseye) or Debian 12 (Bookworm) - These are not as comprehensively tested as Ubuntu LTS versions.
+* Debian 11 (Bullseye), Debian 12 (Bookworm) or Debian 13 (Trixie) - These are not as comprehensively tested as Ubuntu LTS versions.
 === Dependencies and Pre-configuration ===
@@ Line 55: / Line 55: @@
   cd /tmp/
   wget https://files.eprints.org/3288/1/eprints-3.4.7.tar.gz
-  tar -xzvf eprints-3.4.7.tar.gz
+  tar xzvf eprints-3.4.7.tar.gz
-Then put in the source code in place:
+If you want a publications flavoured repository, then also:
   mv eprints-3.4.7 /opt/eprints3
   chmod 2775 /opt/eprints3
   chown -R eprints:eprints /opt/eprints3
 == Configuration ==

@@ Line 18: / Line 18: @@
 * [https://github.com/eprints/eprints3.4/pull/512 Adds clear buttons to multiple <code>Compound</code> fields]
 * [https://github.com/eprints/eprints3.4/pull/525 Adds support for rendering time with a given timezone]
 ==== Security and Privacy Improvements ====
 * [https://github.com/eprints/eprints3.4/pull/511 Prevents 'javascript:' URLs from being saved in URL fields]
 * [https://github.com/eprints/eprints3.4/commit/c5884562ed72b31681d3f0308b5987b2564052ad Modifies fix for SetLang referrer misuse]
 ==== General Improvements ====
@@ Line 34: / Line 40: @@
 * [https://github.com/eprints/eprints3.4/issues/527 Improves CRUD API fault tolerance]
 * [https://github.com/eprints/eprints3.4/issues/536 Better specifies MetaField property defaults]
 ==== Bug Fixes ====
@@ Line 42: / Line 62: @@
 * [https://github.com/eprints/eprints3.4/pull/534 Don't add export link elements to deleted item page head]
 * [https://github.com/eprints/eprints3.4/issues/535 Specifies more appropriate <code>empty_value</code>s for <code>Int</code> and <code>Float</code> MetaFields]
-* [https://github.com/eprints/eprints3.4/issues/508 Fixes <code>eval</code> blocks calling user-defined <code>toform</code> or <code>fromform</code> functions to work as effective try/catch blocks.
+* [https://github.com/eprints/eprints3.4/issues/508 Fixes <code>eval</code> blocks calling user-defined <code>toform</code> or <code>fromform</code> functions to work as effective try/catch blocks]
 == Planned Features and Improvements ==

@@ Line 8: / Line 8: @@
 == Installing Dependencies ==
 === Python 3.11+ ===
 === Deno ===
 === yt-dlp-ejs ===
@@ Line 13: / Line 14: @@
 == Useful Scripts ==

@@ Line 1: / Line 1: @@
-As of 10th May 2026, Ubuntu 26.04 is still under testing to determine if EPrints can be successfully installed and if so if there are any issues with doing this, which require a different approach from the general approach for installing EPrints on Debian/Ubuntu Linux.
+As of 13th May 2026, Ubuntu 26.04 is still under testing to determine if EPrints can be successfully installed and if so if there are any issues with doing this, which require a different approach from the general approach for installing EPrints on Debian/Ubuntu Linux.
 ==== Current Issues ====
-; XML library compatability problems : This will first occur at the point where you complete the credentials you want to use for your archive's database whilst you are running <code>bin/epadmin create pub</code>.  It will exhibit itself as either a segmentation fault or an error with the memory allocation (malloc) or free commands.  This is due to EPrints use of the <code>XML:LibXML</code> Perl library that ultimately uses the C library <tt>libxml2</tt>.  As of 10th May 2026, we have yet to defintively determine why this is happening.  [https://github.com/eprints/eprints3.4/issues/509 This GitHub issue] first raised for what appears to be the same issue with FreeBSD 14.3 provides some more detail about this problem.  It is likely this relates to [https://github.com/cpan-authors/XML-LibXML/issues/113 this XML::LibXML GitHub issue], so it may be a while before the libxml-libxml-perl package is updated but the XML::LibXML package on CPAN will likely be updated more promptly. Currently a possible workaround of disabling "expand_entities" and "load_ext_dtd" options in the calls to <code>XML::LibXML->new</code> in perl_lib/EPrints/XML/LibXML.pm on lines 69 and 73 is being evaluated,  However, further testing is still required to determine what impact this temporary mitigation may have on EPrints functionality.
+; XML library compatability problems : This will first occur at the point where you complete the credentials you want to use for your archive's database whilst you are running <code>bin/epadmin create pub</code>.  It will exhibit itself as either a segmentation fault or an error with the memory allocation (malloc) or free commands.  This is due to EPrints use of the <code>XML:LibXML</code> Perl library that ultimately uses the C library <tt>libxml2</tt>.   [https://github.com/eprints/eprints3.4/issues/509 This GitHub issue] first raised for what appears to be the same issue with FreeBSD 14.3 provides some more detail about this problem.  It is likely this relates to [https://github.com/cpan-authors/XML-LibXML/issues/81 this XML::LibXML GitHub issue], which says it has been resolved upstream, which we believe to mean in the libxml2 C library (possibly version 2.15.3).  Ubuntu 26.04 as of 13th May 2026 is still providing libxml2 version 2.15.2, so there will hopefully be an update soon.

@@ Line 18: / Line 18: @@
 == Testing a boolean field ==
-Boolean fields can be <tt>TRUE</tt>, <tt>FALSE</tt> or <tt>NULL</tt>. Just doing a <code>test="boolean_field"</code> isn't enough. Use this:
+Boolean fields can be <tt>TRUE</tt>, <tt>FALSE</tt> or an empty string, the last of which means neither the true or false option has been selected. Just doing a <code>test="boolean_field"</code> isn't enough. Use this:
 <source lang="xml">
   <if test="boolean_field = 'TRUE'">
     ...
   </if>
 </source>

@@ Line 21: / Line 21: @@
 === Booleans ===
-'''BOOLEAN''' is either true or false.
+'''BOOLEAN''' is either 1 (i.e. true) and 0 (i.e false).
 === Dates ===