EdShareCollections
EdShare | ||
Supported EPrints Versions 3.2 Project Started 2009 Project Webpage http://edshare.org.uk
|
Contents
Introduction
Collections allow users to group and arbitary set of eprints together. They have their own workflow and workflow component for selecting EPrints to add to the collection. They appear in search results in browse views and go through the normal inbox->buffer->archive->retire life cycle. They can also be configured to have custom abstract pages.
The collections plugin is part of EdShare suite. It is based on code developed in EdShare and LanguageBox. The goal of this project is to produce a package that allows the easy installation of the collections functionality on a vanilla EPrints installation.
Installation
You can install Collections onto 3.3 series EPrints repository using the EPrints Bazaar. It should be listed in Admin > EPrints Bazaar > Available.
Authors
The original collections code was developed by Sebastien Francois and Patrick McSweeney. Updates and the 3.1.3 version of the package have been made by Marcus Ramsden based upon the original collections code. Collections were packaged for the bazaar by Patrick McSweeney
The Source
The current definitive source can be found on GitHub at https://github.com/patrickmcsweeney/Collections
Copyright
EdShare Collections, University of Southampton ©2009
This plugin is released under the terms of the GNU General Public License v3 GNU General Public License v3.
Post installation configuration
At the time of writing (May 2013) collections render in the same way as any other item in the repository but they have been written to have this behaviour overwritten.
x_collections.pl you can see the following two lines
#overwrite collection_render in order to make a custom render method for collections $c->{collection_render} = $c->{eprint_render};
this can be replaced with:
$c->{collection_render} = sub { my( $eprint, $session, $preview ) = @_; #special rendering for collections goes here return( $page, $title, $links ); # these three are dom fragments (same as eprint_render) }
For some idea of what you might want to do here you might use to take inspiration from eprint_render.pl - code here: https://github.com/eprints/eprints/blob/master/lib/defaultcfg/cfg.d/eprint_render.pl
Old Stuff
For EPrints 3.2 installation instructions head to EdShareCollectionsInstallation. We dont really support the 3.2 version any more but we will still answer questions about it.
Note the EPrints 3.2 package ships with Bookmarks included. Bookmarks have been rewritten for EPrints 3.3 and are available as a seperate bazaar package with seperate documented.