Frequently Asked Questions

This script is so configurable it can get very confusing; just remember that these are all options. You can just insert your affiliate code and AWS keys, plop this script on your server, and it will run. If you decide to configure it; take it slowly, change one thing at a time, and study the examples. If all else fails check out the Support Forum.

How do I alter the results of the script?

Through how you link to the script. The available URL options are listed here.

You take the initial URL of the script and add the variables after it with the first variable preceded by ? and subsequent variables preceded by &, replacing any spaces with a plus sign.


How do I customize the HTML output of the script?

Template files. Simple text files containing the HTML and variables you want my script to use to match your site's look and feel. These are used in sets with different sets each in their own subfolder of the templates folder. Each set of templates has files with specific names, each of which are used to create output at different points in the script. You can use as many sets as you would like so that 1 script can display different items in different ways. Please study the default template files for the proper use of the variables.

page.template contains the HTML to display the final page.
At a minimum this file must contain %%products_html%% as it contains all of the products using the HTML from the products.template.
The available variables for use in page.template are listed here.

products.template contains the HTML you want applied to each product.
The available variables for use in products.template are listed here.

item.template contains the HTML to display an individual item.
This is the big one; there are lots of things you can display about an item. The available variables for use in item.template are listed here.

larger_image.templates contains the HTML to display an the large image from Amazon.
The available variables for use in larger_image.template are listed here.

Additional Templates:

sellersearch.template - variables
sellerprofile.template - variables
thirdparty_products.template - variables
browse_menu.template - variables
nav_menu.template - variables
blended.template - variables
shopping_cart.template - variables
customer_reviews.template - exactly like item.template

You specify which set of templates to use in the URL with templates followed by the name of the subfolder, like templates=Default. You can even specify one set of templates to display the page and with link_templates another set to be used with any link that is clicked on that page.

How do I use options in the templates to further customize the HTML output?

The options and the HTML they effect are enclosed in a special comment tag.

<!--apf &option1=value&option2=value! HTML here !-->

Notice the exclamation points, they separate the different parts of the command. <!--apf tells the script that options will follow. All options must be proceeded by an & to separate them and the last option is indicated by following it with an !. Anything following that ! through !--> is considered the HTML you want to control. If the option doesn't contain HTML, like for including a text file, the exclamation points still need to be there.

These options are demonstrated with this Web Services search. Note that there are now TABLE rows!

How do I change the language?

Languages work like the templates. Simple text files of all the variables that contain the text the script displays that does not come from Amazon. If you wish to create your own language file please use the default English files as a starting point and be sure and send me a copy so we can share it with others. I would like to provide as many different languages as possible.

You specify which language to use in the URL with language.

To display multiple languages in HTML there is a special charset (character set) called Unicode. This is the format that Amazon sends their results in and so it is what my script uses. To use accented characters in the language files you must use Unicode entities. Entities are just &#(a number);. I wrote a script to display the characters and show the entity for each so you can use them in your language file - Unicode Generator.

How do I display more results?

Amazon usually only returns 10 products per page. But you can add variables to your page.template that will display links to more results.

%%see_next%% will display a link to the next page of products
%%see_prev%% will display a link to the previous page
%%see_total%% will display the total number of pages
%%see_index%% will display a "Google" type index of pages

What other options are there?

If you really want to know everything you can do with the script read the Amazon Products Feed Variables page.

What about international versions?,, and are currently supported. The code is in place to support Japan but because of the language barrier it hasn't been tested. You can select which location to use in the URL by using &locale=us, &locale=uk, or &locale=de. I plan to support CA when a feed is available and maybe other sites if the language barrier can be overcome.

Where is the best place to get support and/or discuss this script?

You can discuss this script at Amazon Products Feed Support Forum

The latest version of this script can always be found at Sourceforge.