Amazon App Installation Instructions

Requirements

• Web Server with PHP 5.x and Zend Framework installed.
• If you are not familiar with server installation and maintenance, talk with your institution’s IT department.
• One possible source of a free and easy to install virtual server is Zend Server Community Edition.

Instructions

1. Go to OCLC’s subversion repository and grab the following files:
   1. demo_config_sample.inc
   2. acq/amazon_order.php
   3. acq/lib/* (all files)
   4. acq/css/* (all files)
2. Place these files on your web server, maintaining the file structure (i.e. demo_config.inc should be on the same level as acq/)
3. Rename demo_config_sample.inc to demo_config.inc
4. Insert the following values in to demo_config.inc
   1. set_include_path
      • the location of Zend/loader.php on your server
   2. INSTITUTION_ID and OCLC_SYMBOL
      • your institution’s WorldCat Registry ID and OCLC Symbol available at the WorldCat Registry
      • when testing your application in the sandbox, the Registry ID and OCLC Symbol are 128807 and OCPSB
   3. WORLDCAT_API_KEY, WMS_WSKEY, WMS_WSKEY_SECRET, P_ID, and P_IDNS
      • since the Amazon Application will update your production data, we recommend that you install and test your application in the OCLC sandbox prior to installing in your production system
      • both sandbox and production key requests should be placed at OCLC Service Config
      • the a principalID (P_ID) and principalIDNS (P_IDNS) will be provided when your key request is approved
   4. AMAZON_KEY, AMAZON_SECRET, and ASSOC_TAG
      • create an account and a key at Amazon Associates
5. Unzip the attached "amazon_app.zip" file and replace the following pieces in the included XML:
   1. YOUR_LIBRARY_NAME
   2. AUTHOR
   3. AUTHOR_EMAIL
   4. PATH_TO_YOUR_APP
6. Follow the instructions on the Developer Network for how to upload an application
   • Upload the file LOCALLY

Testing

To test your application without altering your production data you should set it up to interact with the sandbox. To do this edit demo_config.inc

1. INSTITUTION_ID and OCLC_SYMBOL
   • Registry ID for the sandbox - 128807
   • OCLC Symbol for the sandbox - OCPSB
2. WORLDCAT_API_KEY, WMS_WSKEY, WMS_WSKEY_SECRET, P_ID, and P_IDNS
   • WSkey and secret for the sandbox
   • the a principalID (P_ID) and principalIDNS (P_IDNS) will be provided when your key request is approved
3. You can use order Number PO-2012-16 to test to see if the application is working properly

Attachments: 

amazon_app.zip