WordPress.org

How do I change the size of my Carousel widget?

You can set 'height' and 'width' parameters to resize your widget. For e.g., to get a 400x150 widget, I would do something like this:<br/><br/> [carousel width="400" height="150"] <br/><br/> Valid combinations of Width x Height are: 120x500, 160x600, 400x150, 500x175, 600x200

What is the 'shuffleProducts' parameter?

Sometimes you want your user to see a different set of products each time the widget is rendered. Setting 'shuffleProducts="True"' ensures that the items in your Carousel are shuffled before they're presented to the user.

What is the 'showBorder' parameter?

If you want to add a thin border around your Carousel widget, you can set 'showBorder="True"'.

How do I create a Carousel containing products from from Amazon.co.uk?

Add the parameter marketplace="GB". Valid values for market place are: JP, FR, DE, GB, US, CA

Where can I get all the Amazon categories?

To get a list of valid categories, see the 'SearchIndex' column on this page: http://docs.amazonwebservices.com/AWSECommerceService/2008-06-26/DG/index.html?APPNDX_SearchIndexValues.html

Anything else I should know?

If you want to get real crazy, you can specify 'browseNode="XYZ"' in addition to 'category="ABC"'. This allows you to search within specific categories at Amazon. For example:<br/><br/> [carousel list="NewReleases" category="Books" browseNode="18"] <br/><br/> displays the latest releases from the 'Mystery and Thrillers' section within Books!

Similary, <br/><br/> [carousel keywords="microwaves" category="Kitchen" browseNode="361395011"] <br/><br/> searches for "microwaves" within the 'Home & Appliance' section within the Kitchen store.

To get the list of browseNodes associates with each category, you'll need to do a bit of snooping around with Amazon's e-commerce APIs. Alternatively, you can drill-down into the relevant browse node at this website: http://www.browsenodes.com/node--2000.html

One last thing. Can you tell me all the valid parameters for quick, easy reference?

Sure, use this table to select parameters that'll help you customize your Carousel widget:<br/> List of Parameters. (I couldn't quite figure out how to get a Table on this page so you'll have to click on this link above to get the parameter list. Sorry :(

I can't get the widget to show up in my sidebar. Instead of the widget, I see the plugin code in the sidebar. How do I fix this?

WordPress doesn't directly let you use shortcodes in the sidebar. Since this plugin uses shortcodes, you can't add this widget to the sidebar 'out-of-the-box'. However, there is a trivially easy 1-line fix for this! Follow these steps: (Note: The steps below have been quoted from http://englishmike.net/2008/07/07/wordpress-quick-tips-3adding-a-shortcode-to-a-sidebar-widget/)

1. Login to your blog's administration pages and go to the Theme Editor - i.e. select Design >> Theme Editor from the admin menu.
2. Look in the list of Template Files on the right of the page for one called Theme Functions or functions.php and click on it to load it into the editor.
3. Find a place between the tags which is not in the middle one of the functions that may already be in the file (the very top or bottom of the file are both good places) and add the following line:<br/> add_filter('widget_text', 'do_shortcode');
4. Click on the Update File button to save the modified template.

That's all you need to do. Now any shortcodes you add to a sidebar widget will show up correctly.

Ok, one FINAL question before I'm sold. I love the Carousel widget. Any plans on doing this for other Amazon widgets on http://widgets.amazon.com/?

If there's enough interest in getting the MP3 Clips widget, Slideshow widget, My Favorites or Search widget, drop me a line at dogbertq8@gmail.com and I'll build another plugin for those widgets.