|
WARP from the user's perspective:
When the user clicks on your library's web page link for eReserve, this script takes the user to a page that lists the professor's names who have items on eReserve. When a professor's name is clicked, the class numbers show for which there are eReserve items. When the class number is clicked, the article titles show, ending with a dot pdf. When a title is clicked, the article in Adobe Acrobat format displays.
WARP has the following features:
1. WARP is written in Perl and is portable to any UNIX, Linux, NT/2000 or Novell Netware platforms.
2. WARP checks the IP address of the person making the inquiry. If it does not belong to your home institution, then a "request denied" web page is returned.
3. If the user is coming from an authorized IP address, then the script reads the file structure for the names of the professors, class numbers and article names along with the "padding" of your library's web pages' layout (background, logos, etc).
4. Accomodations are made for Netscape's preferences vs. Internet Explorer's (spaces in the file names, individual display quirks, etc).
5. The eReserve Manager creates the directories (prof names, class numbers) on the web server network drive and the script puts those same professor names and class numbers on the web page.
6. The eReserve Manager can click and drag the pdf files from the workstation's hard drive where the Acrobat scanned article was first stored to the network drive's class number directory where the pdf article title will immediately display.
7. EReserve can be managed by deleting the pdf files on the network drive but keeping the files on the local workstation in case the professor wants to have them available during a later semester.
Be sure to follow your institution's fair use copyright eReserve policy.
The WARP zip file includes warpREADME.html, reserve.pl, and cgi-lib.pl.
Installation Instructions
1. Librarians will need the help of their web server administrators and network administrators.
2. Rename the "generalwebserverdirectory" in reserve.pl (in six places) to whatever the main user directory is called on your web server. The web server administrator should add a subdirectory /library to that main user directory and should give access to those two directories to whomever maintains the library web site.
3. The network administrator needs to map the /library directory on the web server to a network drive within the account of the person who maintains the library website (hopefully a librarian) and also within the account of the person who maintains the library eReserve. If the drive the web server is mapped to is the maintainer's J: drive, then J:\ would be the web server's /generalwebserverdirectory. J:\library would be the web server's /generalwebserverdirectory/library directory. If network mapping is not available in your library context, there are other ways to move files, such as via FTP or Network Neighborhood.
4. Change the IP address examples in reserve.pl within the first if statement, if ( $ENV{REMOTE_ADDR} !~ /(111.11.)|(222.222.2)|(333.33.)|(444.444.4.44)/ ) {
print "Location: $redirect_url\n\n"; exit; } to all the IP ranges for your institution. Users trying to access from IP addresses not listed will be rejected.
5. Create a web page called reject.html that matches your library's web site's look and feel and says something like, "Due to copyright laws, ereserve pages are available only for authenticated users."
Place the reject.html in the /generalwebserverdirectory and change this line, $redirect_url = "http://web.myschool.edu/reject.html"; in the reserve.pl file to match the URL of your web server.
6. Create a web page that matches your library's web site's look and feel, and name the title of the page something like "MyLibrary's Ereserve [Arranged by Professor Name and Class Number]." Divide the file in half. The part of the html code that goes before the professors' names, class numbers and pdf files name header.txt. The part of the html code that goes after the professors' names, class numbers and pdf files name footer.txt. Put both of these files in the /library directory (if J: is your network mapped drive, they go in J:\library.
7. The web server administrator needs to put the reserve.pl and cgi-lib.pl files in the /perl directory (or other required or configurable directory assigned to run perl scripts) on the web server.
8. Test. Create a directory on your mapped network drive (e.g., J:\) using a professor's name in the \library subdirectory and a class number (e.g., LibSci201) within the professorname directory. Copy a pdf file into the classnumber directory. In a browser, go to the URL http://web.myschool.edu/perl/reserve.pl. The professor's name should appear on the web page. Click on the professor's name and the class number should appear. Click on the class number and the pdf file should appear.
9. Test. Access from an authenticated IP address (an IP in one of the IP ranges listed in step 4 above). Try to access from an unauthenticated IP address (any IP not listed in step 4 above) and examine the reject.html page that appears. If all these steps work, you're up and running.
10. Create an introductory web page to ereserve that has a copyright warning on it. For an example, see http://library.olivet.edu/ereserve.html. Put the link to http://web.myschool.edu/perl/reserve.pl on it as the place where students will access ereserve.
|