An author profile is a page that showcases the author’s biography and provides links to content that the author contributed to.
- A web user interface where administrators can create, update and delete author profiles
- Author profiles can be created for any author appearing in the DSpace metadata, it is not bound to EPeople (user accounts).
- A separate entry in the public DSpace navigation "View author profiles" that lists the created author profiles. This is parallel to the existing "browse by authors". Browse by authors will still show all metadata entries for authors, while the "view author profiles" only lists those authors for which a profile has been created.
- An icon that shows up in the Discovery author facet to give users easy access to author profiles when searching
Checklist: this is when you're done
Use case and high level benefits
Describe which need the contribution is fulfilling and why it was originally created. Screenshots are always nice and will make people enthusiastic about your contribution.
Is enabled by default in the current pull request, but this could change, if it does we need to add install documentation.
Working with author profiles
Creating an author profile
Only members of the Administrative group can create author profiles, this was done because at the moment there is no way to link a certain author metadata value to a registered user account.
When logged in as administrator the "Create new author profile" link becomes available in the sidebar. This link directs the administrator to the 'Create new author profile' page, displayed below. The semantics of each field are explained on the page. The fields 'Last name', 'First name', 'Author values used for finding records' and 'Email address' are required. The other fields are optional by default (this can always be changed in the configuration).
Editing author profiles
Once an author profile has been created it will become available on the following pages:
- Item pages
- Search results
- Faceted navigation
Author profiles can be reached by clicking on the author icon located next to the author's name. Non administrative users will only have access to the public profiles. An administrator can edit an author profile by navigation to the author profile and clicking the Edit this author profile link.
When an administrator is editing an authors profile a link will be added on top of the page that will allow the administrator to view the profile with the changes made (unsaved changes will be lost).
Deleting an author profile
When logged in as administrator go to the edit page of an author profile, at the bottom below the save button there will be link with which you can delete an author profile.
Displaying author profiles
Author profile "home" page
The main view displaying an author profile is shown below, it displays not only the author profile but also all submissions in which the person was author or coauthor.
Author profile browse page
The browse by author profiles link is available in the Browse sidebar. The browse by author profile view offers all available author profiles. Private author profiles will only be displayed if the logged in user belongs to the Administrative group.
Discovery author sidebar facet
When the sidebar facets are displayed the author profile icons are displayed next to the authors that have an author profile.
Technical Implementation Details
How to use warnings
Author profiles is currently only available for the XMLUI.
DSpace core model changes
Before author profiles the DSpace domain (DSpace Objects) consisted of the following objects: Community, Collection, Item, Bundle, Bitstream (a file), Group & EPerson. All these core domain objects have metadata and authorization policies can be linked to these objects.
By creating a new DSpace Object class AuthorProfile we could keep the author profile table very lightweight. The table author profile only contains an identifier, this identifier is then used to link to authorizations policies & metadata. An additional database table is used to link the author profile picture to a bitstream.
The fields which can be entered in the edit profile page can be edited in the dspace.dir/config/spring/author-profile-edit-page.xml file. This configuration file allows you to indicate which fields are required, repeatable, add new fields, ...
TODO: Discuss the configuration in detail
Where should I put my page? (DELETE this section from template when finished)
Here is a very short introduction to the hierarchy of the documentation. when in doubt, put your page straight under Using DSpace.
- Installing DSpace
- Upgrading DSpace
- Using DSpace: documentation that applies to a working, functional DSpace
- System Administration: activities and diagnostic to restore your DSpace to a full working state, or to maintain it that it stays that way.
- Command Line Operations: important page that you can edit if your new contribution introduces any new command line operations.
- DSpace reference: glossary, overviews, often linking out to other parts of the documentation for more detail