Difference between revisions of "EdShareCollectionsInstallation"

From EPrints Documentation
Jump to: navigation, search
(Install CGI Scripts)
m (add categories)
 
(27 intermediate revisions by 6 users not shown)
Line 1: Line 1:
==Introduction==
 
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.
 
  
'''For more details about this plugin see [[EdShareCollections]].'''
+
EdShare on EPrints 3.2 is no longer available to download.
  
==Requirements==
 
The EdShare Collections plugin has been tested and confirmed to run on EPrints 3.1.3.
 
  
==Installation==
+
'''The latest version of the fully supported EdShare, running on EPrints 3.3, is only available from EPrints Services.'''
  
'''As with all package installations it is important to remember to backup your installation of EPrints before continuing.'''
 
  
===Extract Package===
+
Please visit http://www.eprints.org/uk/index.php/openeducation/ for further information or email K.Terrell@soton.ac.uk
The package should be extracted in the appropriate archive directory of your EPrints installation. Run the following commands replacing ''ARCHIVEID'' with the name of the archive you want the collections on, and replace ''VERSION'' with the appropriate version number based on the package you have downloaded;
 
  
cd /opt/eprints3/archives/ARCHIVEID
 
tar -xzf collections-VERSION.tar.gz
 
  
These commands assume that you installed EPrints to ''/opt/eprints3'' substitute this for something else if you installed it elsewhere. Users of the Ubuntu version of EPrints will find that it is installed by default at ''/usr/share/eprints3''.
+
[[Category:Obsolete]]
 
+
[[Category:EdShare]]
===Install CGI Scripts===
+
[[Category:Eprints3.2]]
Link the collections CGI scripts to the EPrints CGI directory:
 
 
 
ln -s /opt/eprints3/archives/ARCHIVEID/cgi/collectionselect/ /opt/eprints3/cgi/
 
ln -s /opt/eprints3/archives/ARCHIVEID/cgi/bookmarks/ /opt/eprints3/cgi/
 
 
 
===Patch Default Workflow===
 
Assuming that you have patch installed on you system then you need to run;
 
 
 
patch -i default_collection_workflow.patch
 
 
 
===Edit Configuration Files===
 
 
 
====archive/ARCHIVEID/cfg/namedsets/eprint====
 
Add <code>collection</code> to the ''types for eprint'' list. The position it is in this list will be the position it will appear when choosing a type in the new item workflow.
 
 
 
====archive/ARCHIVEID/cfg/cfg.d/eprints_warnings.pl====
 
You will need to add an exception here to stop warnings appearing for users when they deposit a collection. A warning will appear because no files have been loaded for the collection but this is fine. If you have not edited this file before look for the following line;
 
 
 
if( @docs == 0 )
 
 
 
Replace it with the following;
 
 
 
if( $eprint->get_type ne 'collection' && @docs == 0 )
 
 
 
This should stop the warning from appearing.
 
 
 
===Restart Web Server===
 
Once you have completed all of these previous steps, you will need to restart your web server in the usual fashion.
 
 
 
==Customisation==
 
A level of customisation is possible with collections. All of the settings for the plugin can be found in ''archives/ARCHIVEID/cfg/cfg.d/z_collection.pl''. The main setting of interest is ''collection_render''. This subroutine is similar to ''eprint_render'' but it does a special case render for collections. A default is supplied but you are free to customise this to your requirements. One thing to note is that the function '''must''' return 3 values. Look at the default ''collection_render'' subroutine for an example.
 
 
 
If you do change the ''collection_render'' subroutine you will need to run the <code>bin/generate_abstracts ARCHIVEID</code> script in order to see any changes you have made reflected in your repository.
 
 
 
There are other settings in the file but you should avoid changing anything below the supplied note unless you know what you are doing.
 
 
 
==Bugs==
 
Please report all bugs to the [http://lslvm-mmr4.ecs.soton.ac.uk/ OneShare Bugtracker]. There is a project setup for OneShare collections called ''OneShare Packages >> Collections''.
 

Latest revision as of 00:25, 12 September 2018

EdShare on EPrints 3.2 is no longer available to download.


The latest version of the fully supported EdShare, running on EPrints 3.3, is only available from EPrints Services.


Please visit http://www.eprints.org/uk/index.php/openeducation/ for further information or email K.Terrell@soton.ac.uk