Installation & Usage

1. DECIDE ON APPROACH: Decide how you wish to use this web service. Broadly speaking you have two options:
1. Include results in existing php pages using the provided functions (easiest)
2. Include results in existing pages using SSI or javascript
3. Advanced: Use the programming language for your site (eg, perl, php, asp, jsp) to either include awsoapclient where you wish on your page, or write your own SOAP client and call the methods detailed in the API



2. CONFIGURE:
1. Copy all files in the root of the zip file to the place on your web site where you wish to run this program. If you wish you can copy nusoap.php to wherever you normally keep library files, as long as that is included in your include path. If in doubt, just copy to the same directory as awsoapclient



2. Configure your awsoapclient, by running the install program.
   
   
3. BUILD/MODIFY TEMPLATES: Modify existing templates in this distribution to fit your site, or create new ones..



1. To create search forms:

   Either add <?php awsearchform();?> to your php page OR
    

   1. Build a form and set the action as awsoapclient.php or the page containing your function calls.
   2. Include a hidden field with name="action" and value="awSearchProducts"
   3. To restrict a search to a particular merchant in your data set include a field named mid, which will be posted with the form contents
   4. To restrict a search to a particular merchant in your data set include a field named catid, which will be posted with the form contents. This can be useful for refining search results
   5. To include a drop down list of the top level categories in your database, use the tag <aw:searchform:catlist /> within the select tag. You may want to add an 'all' option.eg,<select name="catid"><option value="">All</option><aw:searchform:catlist></select>
   
   
   
2. To create browse/search result pages
1. Alter the templates included in the distribution or create your own using the template reference



4. ADD FUNCTION CALLS TO EXISTING PAGES
5. TEST YOUR SETUP by opening http://yoursite.com/path/to/awsoapclient.xxx?action=awBrowseProducts in your favourite web browser

Help on Setting File Permissions on Unix

You can change file permissions either by logging into a system using telnet or ssh or by using any popular ftp program eg, WS_FTP, CuteFTP.

To do using an ftp program, right-click on the file on the server and select 'chmod'. You should then allow owner, group and other to write to this file by selecting the appropriate options. In some ftp programs, you may have to do something other than right-click on the file; search your program's documentation for chmod for details on how to do it.

To use telnet or ssh, login to the machine and then issue the chmod command

chmod 777 awsoapclientconfig.inc.php

Help on Setting File Permissions on Windows

The exact procedure for this will depend on your version of windows but below is a generic guide:

1. Open windows explorer and browse to wherever you have put the files in this distribution
2. Right-click on awsoapclientconfig.inc.php
3. Ensure that 'hidden' and 'read-only' are UNCHECKED
4. On XP, 2000 Server and NT, you can further modify permissions using the 'security' tab