Difference between revisions of "EdShareCollectionsInstallation"

From EPrints Documentation
Jump to: navigation, search
(Extract Package)
m (add categories)
 
(50 intermediate revisions by 6 users not shown)
Line 1: Line 1:
==Introduction==
 
The collections module is part of [[OneShare]]. 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==
+
EdShare on EPrints 3.2 is no longer available to download.
  
'''As with all package installations it is important to remember to backup your installation of EPrints before continuing.'''
 
  
===Extract Package===
+
'''The latest version of the fully supported EdShare, running on EPrints 3.3, is only available from EPrints Services.'''
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''.
+
Please visit http://www.eprints.org/uk/index.php/openeducation/ for further information or email K.Terrell@soton.ac.uk
  
===Install CGI Scripts===
 
Link the collections CGI scripts to the EPrints CGI directory:
 
  
ln -s /opt/eprints3/archives/ARCHIVEID/cgi/collectionselect/ /opt/eprints3/cgi/
+
[[Category:Obsolete]]
 
+
[[Category:EdShare]]
===Edit Core Files===
+
[[Category:Eprints3.2]]
 
 
====perl_lib/EPrints/Plugin/Screen/EPrint.pm====
 
Look for the workflow subroutine in this file and comment out the following line:
 
 
 
$self->{processor}->{$cache_id} = EPrints::Workflow->new( $self->{session}, "default", %opts );
 
 
 
Then add in the following two lines:
 
 
 
my $workflow_id = $self->workflow_id;
 
$self->{processor}->{$cache_id} = EPrints::Workflow->new( $self->{session}, $workflow_id, %opts );
 
 
 
Finally after the workflow subroutine add the following subroutine;
 
 
 
sub workflow_id
 
{
 
        return 'default';
 
}
 
 
 
===Update Database Tables===
 
The OneShare collections package requires an additional database field. To get this setup all you need to do is run;
 
 
 
bin/epadmin update_database_structure ARCHIVEID
 
 
 
===Restart Web Server===
 
Once you have completed all of these previous steps, you will need to restart your web server in the usual fashion.
 
 
 
==Dependency Information==
 
 
 
===Required By===
 
The OneShare Collections package is required by the following OneShare packages;
 
 
 
[[OneShareBookmarks|OneShare Bookmarks]]
 
 
 
==Testing==
 
 
 
# Login as a user to your EPrints install and go to the ''Manage Deposits'' page. There should be a new button labelled ''Create Collection''.
 
# First ensure that you can still create an EPrint in the usual manner using ''New Item''.
 
# Head back to the ''Manage Deposits'' page and choose ''Create Collection''.
 
# Give your collection a name.
 
# Search for an EPrint and add it to the collection, it should appear in a list in the ''Items In The Collection'' section.
 
# Remove that EPrint from the collection by clearing the tick next to it, the list should now be empty.
 
# Add an EPrint from My Deposits.
 
# Submit the Collection and deposit it in the standard way.
 
# Go to the appropriate resource page for the published collection and ensure that there is the correct number of items in the collection.
 
 
 
==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