Title: WP-Amazon-Carousel
Author: jeffbert
Published: <strong>2008 年 9 月 12 日</strong>
Last modified: 2010 年 9 月 6 日

---

搜尋外掛

這個外掛**並未在最新的 3 個 WordPress 主要版本上進行測試**。開發者可能不再對這個
外掛進行維護或提供技術支援，並可能會與更新版本的 WordPress 產生使用上的相容性問題。

![](https://s.w.org/plugins/geopattern-icon/wp-amazon-carousel.svg)

# WP-Amazon-Carousel

 由 [jeffbert](https://profiles.wordpress.org/jeffbert/) 開發

[下載](https://downloads.wordpress.org/plugin/wp-amazon-carousel.zip)

 * [詳細資料](https://tw.wordpress.org/plugins/wp-amazon-carousel/#description)
 * [使用者評論](https://tw.wordpress.org/plugins/wp-amazon-carousel/#reviews)
 *  [安裝方式](https://tw.wordpress.org/plugins/wp-amazon-carousel/#installation)
 * [開發資訊](https://tw.wordpress.org/plugins/wp-amazon-carousel/#developers)

 [技術支援](https://wordpress.org/support/plugin/wp-amazon-carousel/)

## 外掛說明

Add slick looking Amazon Carousel widgets to your blog posts in a brain-dead simple
way!
 Just say `[carousel]` to add a Carousel anywhere on your blog.

Amazon Widgets are small Flash-based mini-applications that bring Amazon’s rich 
features right to your website. The Amazon Carousel is a cute looking Flash widget
which lets you showcase products that are relevant to your blog post.

There are many ways to create a Carousel. Here are some:

 1. `[carousel]` 
     This creates a Carousel containing the latest bestselling books 
    from Amazon.
 2. `[carousel marketplace="GB"]` 
     This creates a Carousel containing the latest bestselling
    books from Amazon.co.uk. Valid values for market place are: JP, FR, DE, GB, US,
    CA
 3. `[carousel list="Bestsellers" category="Jewelry"]` 
     This creates a Carousel containing
    the latest bestsellers from the Amazon Jewelry store (http://amazon.com/jewelry).
    Note that you can replace ‘Bestsellers’ with ‘NewReleases’, ‘MostWishedFor’ or ‘
    MostGifted’.
 4. `[carousel keywords="Nintendo Wii" category="VideoGam es"]` 
     This creates a Carousel
    containing ‘Nintendo Wii’ products from the Video Games category at Amazon.
 5. `[carousel asins="B0011Z0YR2,B00137W4P8,B0013G0PG4,B001AUCK52,B001BVXUPY,B001AU6XE6"
    title="My favorite MP3 songs." shuffleProducts="True"]` 
     This creates a Carousel
    titled ‘My favorite MP3 songs’ and contains various MP3 album covers. It shuffles
    the albums so that they appear in a random order each time the widget is displayed.
 6. `[carousel list="NewReleases" category="VideoGames" tag="ohmyki-20" showBorder="
    True"]` 
     This creates a carousel containing the latest new releases from the Video
    Games store at Amazon. The widget will have a black border since we’re setting 
    showBorder to true. Since the ‘tag’ parameter is specified, you will earn an Affiliate
    referral fee for any sales made through this widget. IMPORTANT: As of 9/6/2010,
    10% of your impressions will be tagged with the plugin creator’s tag (wp-carousel-
    20)

You can customize a lot more in your Carousel widget. Check out the FAQ section 
for more details.

## 螢幕擷圖

 * [[
 * Here’s a screenshot of a Carousel widget in action.

## 安裝方式

 1. Upload `wp-amazon-carousel.php` to the `/wp-content/plugins/` directory
 2. Activate the plugin through the ‘Plugins’ menu in WordPress

## 常見問題集

  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 400×150 widget, I would do something like this:

 [carousel width=”400″ height=”150″]

Valid combinations of Width x Height are: 120×500, 160×600, 400×150, 500×175, 600
×200

  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:

 [carousel list=”NewReleases” category=”Books” browseNode=”18″]

displays the latest releases from the ‘Mystery and Thrillers’ section within Books!

Similary,

 [carousel keywords=”microwaves” category=”Kitchen” browseNode=”361395011″]

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:
 [List of Parameters.](https://tw.wordpress.org/plugins/wp-amazon-carousel/listOfParams.html?output_format=md)(
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:
     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.

## 使用者評論

這個外掛目前沒有任何使用者評論。

## 參與者及開發者

以下人員參與了開源軟體〈WP-Amazon-Carousel〉的開發相關工作。

參與者

 *   [ jeffbert ](https://profiles.wordpress.org/jeffbert/)

[將〈WP-Amazon-Carousel〉外掛本地化為台灣繁體中文版](https://translate.wordpress.org/projects/wp-plugins/wp-amazon-carousel)

### 對開發相關資訊感興趣？

任何人均可[瀏覽程式碼](https://plugins.trac.wordpress.org/browser/wp-amazon-carousel/)、
查看 [SVN 存放庫](https://plugins.svn.wordpress.org/wp-amazon-carousel/)，或透過
[RSS](https://plugins.trac.wordpress.org/log/wp-amazon-carousel/?limit=100&mode=stop_on_copy&format=rss)
訂閱[開發記錄](https://plugins.trac.wordpress.org/log/wp-amazon-carousel/)。

## 中繼資料

 *  版本 **1.6**
 *  最後更新 **16 年前**
 *  啟用安裝數 **10+**
 *  WordPress 版本需求 ** 2.5 或更新版本 **
 *  已測試相容的 WordPress 版本 **2.5**
 *  語言
 * [English (US)](https://wordpress.org/plugins/wp-amazon-carousel/)
 * 標籤:
 * [affiliate](https://tw.wordpress.org/plugins/tags/affiliate/)[amazon](https://tw.wordpress.org/plugins/tags/amazon/)
   [carousel](https://tw.wordpress.org/plugins/tags/carousel/)[widget](https://tw.wordpress.org/plugins/tags/widget/)
 *  [進階檢視](https://tw.wordpress.org/plugins/wp-amazon-carousel/advanced/)

## 評分

這個項目尚無任何評論記錄。

[Your review](https://wordpress.org/support/plugin/wp-amazon-carousel/reviews/#new-post)

[查看全部使用者評論](https://wordpress.org/support/plugin/wp-amazon-carousel/reviews/)

## 參與者

 *   [ jeffbert ](https://profiles.wordpress.org/jeffbert/)

## 技術支援

使用者可在技術支援論壇提出意見反應或使用問題。

 [檢視技術支援論壇](https://wordpress.org/support/plugin/wp-amazon-carousel/)

## 贊助

想要支援這個外掛的發展嗎？

 [ 贊助這個外掛 ](http://grabkindle.com/donate.html)