Editing MePrintsInstall (section)

==Getting Started==

To activate MePrints, you will need to make some changes to your repository setup.

===cfg/cfg.d/plugins.pl===
You can skip this step on MePrints 1.3 and later.

Add the following lines to your cfg/cfg.d/plugins.pl configuration file: to use the MePrints homepage instead instead of the default EPrints "Profile" page:

 $c->{plugins}->{"Screen::User::View"}->{appears}->{key_tools} = undef;
 $c->{plugin_alias_map}->{"Screen::User::View"} = "Screen::User::Homepage";

===cfg/cfg.d/user_fields_automatic.pl===

Add the following lines to your cfg/cfg.d/user_fields_automatic.pl configuration file to update the MePrints public profile page automatically when a user changes his or her profile information, 

<pre>
$c->{user_fields_automatic} = sub {
        

        my $user = @_;

        ...

        if( defined $user->{changed} )
        {
                $user->remove_static();
        }

};
</pre>

===cfg/cfg.d/eprint_fields_automatic.pl===

Add the following line to your cfg/cfg.d/eprint_fields_automatic.pl configuration file so that the MePrints public profile page automatically changes when an EPrint they have deposited is updated.

 $eprint->get_user->remove_static;

===cfg/cfg.d/urls.pl===

To activate the canonical profile URLs, add "/profile/" to the rewrite_exceptions list in your cfg/cfg.d/urls.pl configuration file:

<pre>
$c->{rewrite_exceptions} = [ '/cgi/', '/archive/', '/profile/' ];
</pre>

===cfg/apachevhost.conf===

Add the following directives to your cfg/apachevhost.conf configuration file to enable canonical profile URLs (for example http://myrepository.com/profile/jsmith):

<pre>
<Location "/profile">
  DefaultType 'text/html; charset=UTF-8'
  SetHandler perl-script
  PerlResponseHandler EPrints::Plugin::MePrints::MePrintsHandler
</Location>
  
</pre>

On eprints 3.2 and later you will now need to regenerated your apache conf:
 <eprints_root>/bin/generate_apacheconf --replace <archiveid>

===cfg/workflows/user/default.xml===

Add the following lines to your cfg/workflows/user/default.xml configuration file:

  <stage name="default">
    ...
 
    <component type="Field::Multi">
      <title><epc:phrase ref="user_section_personal" /></title>
      ...
    </component>
 
    <component type="Field::Multi">
      <title><epc:phrase ref="user_section_meprints" /></title>
      <field ref="profile_visibility" required="yes"/>
      <field ref="jobtitle"/>
      <field ref="expertise"/>
      <field ref="biography"/>
      <field ref="qualifications"/>
    </component>

===cfg/citations/user/default.xml===

Replace the default EPrints user citation with the MePrints citation (which includes a thumbnail of the user's profile picture) run:

 cd /opt/eprints3/archives/ARCHIVEID
 cp cfg/citations/user/default_with_thumbnail.xml cfg/citations/user/default.xml

'''Note: if you have already made changes to the default citation, you should examine both files and merge the MePrints changes into default.xml

===Authorship in MePrints===
Meprints 1.1 and later change the definition of ownership in the respository. This means that users who have the same email address as that listed in an items creators field belong to that user once the item enters the archive. This allows users to see statistics about papers they have authored without have to upload their own copy of the paper. You can return this to the eprints default by removing the cfg/cfg.d/authorship_meprints.pl file 

===Confirm Permissions===
The last thing to do before using MePrints is to ensure that the permissions are correct on the ''meprints'' directory. To do this run the following commands, there probably will not be any output from running this command;
 cd archives/ARCHIVEID
 chmod g+wx meprints

If the permissions are not correct then you may encounter errors when using MePrints.