Editing New Features in EPrints 3.1 (section)

== Suggested Changes ==
If upgrading from 3.0 to 3.1, the following changes to your own configuration are suggested to gain the features described above.

=== New Document Formats ===
Added new default document formats: zip, tgz, rtf, xml, ppt, bz2, audio and video. 
* lang/en/phrases/document_formats.xml
* namedsets/document

=== cfg.d/views.pl ===

The "subheadings" option has been '''replaced''' by the variations heading. This only allows one level of subheading but is much faster.

=== lang/en/phrases/views.xml ===

The way the titles of views pages are configured has '''changed'''.

The title of the first page of the view with id "subjects" is now:
 <epp:phrase id="viewtitle_eprint_subjects_menu_1">Browse by Subject and Year</epp:phrase>

if there's a second level menu, configure it with:
 <epp:phrase id="viewtitle_eprint_subjects_menu_2">Browse by Year where Subject is "<epc:pin name="value1" />"</epp:phrase>

The actual list page title is configured like this:
 <epp:phrase id="viewtitle_eprint_subjects_list">Items where Subject is "<epc:pin name="value1" />" and 
 Year is <epc:pin name="value2" /> (Grouped by <epc:pin name="grouping" />)</epp:phrase>

=== cfg.d/indexing.pl ===
A new version of this was added in the 3.0 series, but if you're using an early 3.0 version of this file, then replace it with the one that comes with 3.1 - it's much faster.

=== cfg.d/search.pl ===
* added documents.format to advanced search 
* changed all searches on "userid" to search "userid.username" instead. Another good option might be userid.name or even userid.usertype
* Most earches are now configured by default to show zero results (rather than returning to the search form). The option to add to searches in search.pl is <tt>show_zero_results => 1</tt>. This is handy for people who want to make a saved search, even if there were no results yet,.

=== cfg.d/user_roles.pl ===
* Added the "edit-config" role to admin users.

=== workflows/eprint/default.xml ===
* added "content" to the "Upload" component, as the first field (just before "format").

=== namedsets/eprint_relation ===
This is a new file which describes the options in the new "document.content" field. Add this file if you enabled the field in the workflow.

=== workflows/user/default.xml ===
* Removed item_fields and review_fields from the user workflow as these can now be modified more easily from the screens themselves.
* Added user.roles to the "usertype" stage, so it's only editable by people who can also set the usertype.

=== issues.xml ===
This is a new (optional) configuration file which defines some simple issues to warn about in live eprints.

=== citations/document/default.xml ===
We've designed a nicer document citation format (which appears as the link to the document in the item summary page). It includes information on licenses etc. and is a bit neater. You may wish to replace the one in your repository config with the one from lib/defaultcfg.

=== cfg.d/eprint_fields.pl ===
We applied some of the new Extras render and order methods:
* title field: <tt>'make_single_value_orderkey' => 'EPrints::Extras::english_title_orderkey'</tt> - so when ordering by title, leading "a", "an" and "the" are ignored. If you add this as an upgrade you'll need to run <tt>epadmin reorder <i>repositoryid</i> eprint</tt>
* id_number field: <tt>'render_value' => 'EPrints::Extras::render_possible_doi'</tt> - which links to the DOI resolver if the field looks like a DOI.
* offical_url: <tt>'render_value' => 'EPrints::Extras::render_url_truncate_end'</tt> - this now chops the end of very long URLs for nicer page rendering.
* related_url: <tt>'render_value' => 'EPrints::Extras::render_related_url'</tt> - this is a renderer specifically for this field. It links the word "author", or "publisher", etc. to the URL. If no type is specified, it links the URL (truncated if over 40 chars).