Changing the Browse Display Table in DSpace

You can find instructions for this in the DSpace documentation and Wiki - but I thought I'd document the process from start to finish, so you can see all the steps in one place. Right. The example I'll give is to add a new column ("Citation") to the browse results table. Note these instructions apply to the JSPUI only.
These changes can be made through the DSpace configuration files, without changing the DSpace source code.

1. Edit [dspace-source]/dspace/config/dspace.cfg
Add:

webui.browse.index.n = citation : metadata : dc.identifier.citation : text

where:
n is the index number (note index numbers must be consecutive and incremented by one)
I have used spaces between sections in the index value to clearly show the syntax with colons.
Add:

webui.itemlist.columns = dc.date.issued(date), dc.title, dc.contributor.*, dc.identifier.citation

You can add any of your browse indexes here, in any order. Note that I don't have a "thumbnail" column as the first column, so I had to set:

webui.browse.thumbnail.show = false

But you may wish to have a thumbnail ("Preview") column, in which case you would set this to true and set "thumbnail" as the first value in webui.itemlist.columns.


2. Edit [dspace-source]/dspace/modules/jspui/src/main/resources/Messages.properties
Add:

browse.type.metadata.citation = Citation

and:

itemlist.dc.identifer.citation = Citation

and:

browse.menu.citation = Citation

Of course, change the relevant values to suit your metadata field and display order preferences.

NOTE: Creating this index also automatically adds a browse button to collection and community pages. If you DO NOT WANT this, you can add code to collection-home.jsp and community-home.jsp files to remove this button.

3. Rebuild and Redeploy DSpace
As the 'dspace' user:

cd [dspace-source]/dspace

mvn clean package

cd target/dspace-x.x.x-build.dir (where x.x.x is your version number)

ant update (ant init_configs will NOT copy Messages.properties across, hence the use of update)

4. Re-index
For the changes to take effect, your data needs to be re-indexed:

[dspace-install-dir]/bin/index-init

This may take some time to run. Note, you may need to also restart Tomcat.