Editing Adding new views (section)

===Worked example: browse by organisational structure===

By default, EPrints has a ''divisions'' metadata field which allows authors to associate their deposits with the divisions (units, faculties, schools, departments, institutes, centres..) that were involved in producing their item (for example, the author's department, and the departments of any co-authors). This worked example allows visitors to browse the repository content by division.

Open the views configuration file:

 /opt/eprints3/archives/ARCHIVEID/cfg/cfg.d/views.pl

Add the following definition to the browse_views setting:

 $c->{browse_views} = [
        {
                id => "year",
                ...
        },
        {
                id => "subjects",
                ...
        },
        {
                id => "divisions",
                fields => "divisions",
                order => "-date/title",
                hideempty => 1,
        },
 ];

Save the file and generate the new view pages (this will also re-generate any existing views defined in the views configuration file):

 bin/generate_views ARCHIVEID --verbose

Open the view page in a Web browser:

 http://your.repository.url/view/

The view page lists all the available views. You should see your new views on the list:

[[Image:View_page2.png|frame|none|The view page lists available views]]

'''Fixing the undefined phrase warning''' The new view may appear on the views page with an ''undefined phrase'' warning (you may also notice a similar warning message when running generate_views):

 ["viewname_eprint_divisions" not defined]

Each view you create needs to be assigned a ''human-readable'' name, which EPrints will use on the view Web pages.

Edit the language-specific phrases file for view names:

 /opt/eprints3/archives/ARCHIVEID/cfg/lang/en/phrases/views.xml

Add an appropriate phrase which describes the new view, for example:

 <epp:phrase id="viewname_eprint_divisions">Division</epp:phrase>

Save the phrases file and regenerate the view pages:

 bin/generate_views ARCHIVEID --verbose