Editing Archive:Files/CoverPDF (section)

==Getting Started==

To activate cover pages, you need to make a small change to the EPrints/Apache/Rewrite.pm module.

 vim /opt/eprints3/perl_lib/EPrints/Apache/Rewrite.pm

Around line 182 find the following code:

 # let it fail if this isn't a real eprint       
 if( !defined $eprint )
 {
     $session->terminate;
     return OK;
 }

Add the following immediately after:

 if( !$thumbnails && $session->get_repository->can_call( "coverpage", "process_request" ) )
 {
     my $ret = $session->get_repository->call( [ "coverpage", "process_request" ], $session, $r, $eprint, $pos, $tail );
     return $ret if defined $ret;
 }

This gives the coverpage extension a chance to look at the request and decide whether a cover page needs to be generated.

Save the file and restart Apache.

You should now find that all PDF documents in your repository have a cover page. If you change the layout or content of the cover page (by editing coverpage.xml), all cover pages should automatically be updated to reflect the change. Also, if the metadata of the record changes the cover page should also automatically update to reflect the new metadata.