Doozly Affiliate Box for Amazon

开发者	pixel4you
更新时间	2026年9月15日 03:05
PHP版本:	7.2 及以上
WordPress版本:	7.1
版权:	GPLv2 or later
版权网址:	版权信息

下载

2.27.2 2.28.0 2.28.1 2.28.2

详情介绍:

Affiliate Box for Amazon puts a clean, responsive product box anywhere on your site. You build a box once on the Product Boxes screen and paste one short line into a post — [affiliate_box box="a7f3k2c9"]. The box shows the product image, title, price, star rating and a clearly labelled affiliate link. Because the product lives in one place rather than in the post text, the same box can appear in twenty posts and still be changed once. That is also what makes it possible to keep the price honest: a price written into a post is a price nobody ever revisits. Connect your Amazon Creators API credential and the plugin fills the box for you: paste an ASIN, press Fetch from Amazon, and title, image, price and rating arrive from Amazon. Without a credential everything still works — you type the values yourself. The plugin is built for Amazon Associates. You enter a separate Associates Tracking ID for each marketplace you are enrolled in, point a box at any store with the marketplace attribute, and the right ID is appended to every outbound link — falling back to the marketplace you nominate whenever a target store has none of its own. What you get

Product Boxes — search Amazon or paste an ASIN, and the fields fill themselves. Save the box, copy its one-line shortcode, and change the price in one place for every page that shows it.
Amazon API — the Creators API fills title, image and price from an ASIN or a keyword search. One credential per region, stored encrypted.
Marketplaces — one Associates Tracking ID per store, with a warning when an ID does not match the store it is filed under.
A block and a widget — add Affiliate Box in the editor and pick your box from a list; the real box appears while you choose. For sidebars there is a widget as well, defaulting to the narrow layout.

Features

A block for the editor — no key to copy and nothing to type. The [affiliate_box] shortcode still works everywhere it always did: the classic editor, Elementor, and the shortcode or text widget of every common page builder.
Every active Amazon Associates marketplace (22 stores): US, CA, MX, BR, UK, IE, DE, FR, IT, ES, NL, BE, SE, PL, TR, AE, SA, EG, IN, SG, JP, AU.
Per-marketplace ASINs, images and titles — the same product usually carries a different ASIN in each store.
Star ratings and review counts, typed in by you. Amazon accepts a request for them and answers without them, so no plugin can fill these reliably - see the FAQ.
Guaranteed fallback: a marketplace with no Tracking ID of its own borrows the one from your fallback marketplace — which store that is, you choose. Start on amazon.in alone and add the United States later without disturbing anything.
Five layouts, each named with the size it takes: In post (640 px), Sidebar (400 px), Compact (640 × 78 px) — a single line for naming a product without cutting the paragraph in half — Button only (auto × 38 px), just the call to action for after a paragraph that already named the product, and Hero (960 px), wide with a bigger picture and a line in small capitals above the name for the pick at the top of a review.
Three image sizes, colour pickers for button, background and title, customisable button text.
Built-in FTC affiliate disclosure, on by default.
Outbound links carry rel="nofollow noopener sponsored".
The stylesheet loads only on pages that use the shortcode.
Fully responsive, respects prefers-reduced-motion, keyboard focus visible throughout.
Fully translatable (text domain doozly-affiliate-box-for-amazon).

Shortcode reference Every attribute is optional, but a useful box needs at least asin (or url) plus title and image. Anything left empty falls back to the value set under Settings → Affiliate Box. In almost every case you want the short form: [affiliate_box box="a7f3k2c9"] shows a box you built on the Product Boxes screen, and the Shortcode column there hands you the finished line. The attributes below let a post carry the product data itself instead; they are still read, so older posts keep working, but nothing needs writing by hand any more. With box set, the product details always come from the saved box. Only layout, image_size, bg_color and button_text can be overridden per post — otherwise the price in a post would go stale again, which is the problem the saved box solves. | Attribute | Values | Default | Description | | --- | --- | --- | --- | | box | Key of a saved box, e.g. a7f3k2c9 | (empty) | Shows a box built on the Product Boxes screen. With this set, every product detail comes from the saved box and only layout, image_size, bg_color and button_text are read from the shortcode. The Shortcode column on that screen hands you the finished line. | | asin | Amazon ASIN, e.g. B08N5WRWNW | (empty) | Product ID. The link is built as https://<marketplace>/dp/<asin>?tag=<your-id>. | | url | Full Amazon URL | (empty) | Use instead of asin for search pages or non-standard links. Your Tracking ID is appended unless the URL already carries one. | | title | Plain text | (empty) | Product title, also used as the image alt. | | image | Image URL | (empty) | Product image. Use your own copy or a permitted Amazon image URL. | | price | Plain text, e.g. $19.99 | (empty) | Displayed price. Type it, or let the Amazon API fill it. | | original_price | Plain text | (empty) | Crossed-out former price. Shown only together with savings_pct. | | savings_pct | Number, e.g. 25 | (empty) | Discount badge, in percent. | | rating | 0–5, e.g. 4.5 | (empty) | Star rating above the price. Empty means no stars. | | rating_count | Number | (empty) | Review count shown next to the stars. | | brand | Plain text | (empty) | Brand line above the title. | | button_text | Plain text | Settings value, or "Buy on Amazon" | Text on the call-to-action button. | | layout | post, sidebar, compact, hero | Settings default | post 640px horizontal. sidebar 400px, stacked and centred. compact a single 640 × 78px line. hero 960px with a bigger picture. | | eyebrow | plain text | (empty) | A short line in small capitals above the product name — Our pick. Shares a line with the brand when both are filled in; compact leaves it out. | | image_size | small, medium, large | medium | 90px / 140px / 200px on desktop; scales down on mobile. | | bg_color | Hex colour, e.g. #f7f7f7 | Settings value | Box background, this box only. | | marketplace | Marketplace key, e.g. de | Settings default | Which Amazon store the link points to. | | asin_de, image_de, title_de, price_de, … | Per store | (empty) | Store-specific values. The one matching the box's marketplace wins over the plain attribute. | Examples In-post box:

[affiliate_box asin="B08N5WRWNW" title="Echo Dot (4th Gen)" image="https://example.com/echo-dot.jpg" price="$29.99" rating="4.5" rating_count="1204"]

Sidebar widget:

[affiliate_box asin="B08N5WRWNW" title="Echo Dot (4th Gen)" image="https://example.com/echo-dot.jpg" price="$29.99" layout="sidebar"]

A saved box, price kept in one place — the usual way: [affiliate_box box="a7f3k2c9"] German store, large image, discount badge:

[affiliate_box asin="B08N5WRWNW" title="Echo Dot (4. Generation)" image="https://example.com/echo-dot.jpg" price="29,99 €" original_price="39,99 €" savings_pct="25" marketplace="de" image_size="large"]

A search result page instead of a product:

[affiliate_box url="https://www.amazon.com/s?k=smart+speaker" title="Smart speakers" image="https://example.com/speakers.jpg" button_text="Browse on Amazon"]

Premium version A Premium version is available at doozly.link. It adds bestseller lists, comparison tables, review boxes carrying your own photo and score, IP-based geotargeting — every affiliate link rewritten to the Amazon store closest to the visitor — rotation, which shows a different one of your saved boxes at the same spot each day, reports on how often each box was seen and clicked, and a nightly refresh that keeps saved prices current. This free plugin is complete on its own and never asks for a licence key. Each of these features has a tab in it as a preview, saying what the feature does — nothing in the free plugin is locked, because the code for them is not part of it. Product images The plugin stores an image address and renders it. It cannot tell where that address came from, and it does not try to. Pressing Fetch from Amazon or picking a search result fills the field from the Amazon Creators API, which is the path Amazon's Associates Operating Agreement intends for product images. You can also type an address yourself — the field accepts any URL, because a product box is often built before a credential exists, or from your own photography. Which images you are entitled to display is between you and Amazon. The Associates Operating Agreement limits it, that agreement is between Amazon and you as the account holder, and the plugin is not a party to it. Anything you enter is published on your site under your responsibility. Disclaimer Amazon and the Amazon logo are trademarks of Amazon.com, Inc. or its affiliates. This plugin is an independent product and is not affiliated with, endorsed by, or sponsored by Amazon.

安装:

Upload the doozly-affiliate-box-for-amazon folder to /wp-content/plugins/, or install through the WordPress Plugins screen.
Activate the plugin through the Plugins screen.
Go to Settings → Affiliate Box → Marketplaces and enter your Amazon Associates Tracking ID for every marketplace you are enrolled in. On the General tab, pick which of them stands in for the stores you leave empty.
Optional: under Amazon API, enter a Creators API credential from Associates Central so boxes fill themselves.
Build a box under Product Box and paste the shortcode into any post, page or widget.

屏幕截图:

升级注意事项:

2.28.2 Fixes the Get Premium link and the upgrade button disappearing while a Freemius confirmation email was unanswered. Nothing else changes. 2.28.1 Adds a Get Premium link to this plugin's row on the Plugins screen, leading to the pricing page. Nothing else changes. 2.28.0 Nothing you use changes. The Premium tabs now appear as previews saying what each feature does, instead of being hidden; the General tab keeps them in a group of their own below the rest. 2.27.1 The admin screens now load their JavaScript from a file — nothing changes on screen, but it is what the WordPress.org directory requires. The Amazon search in the box editor is translatable from this version on. 2.26.0 The affiliate disclosure can now appear once per page instead of in every box — which is what makes the new Button only layout usable: a bare call to action for after a paragraph that already named the product. Plus a tick box to mirror a box, picture on the right. 2.25.1 The Compact layout kept its one-line height only for square product photos; a portrait one made the row up to three times taller than its own name promises. Compact and Hero now cap the picture's height too. In post and Sidebar are unchanged. 2.25.0 Two new layouts for a product box: Compact, a single line for naming a product mid-paragraph, and Hero, the wide box for the top of a review with a "Line above the name" field. The sidebar layout now fills a column up to 400px instead of stopping at 320px. 2.24.0 Rotation: pick the saved product boxes that should take turns at one spot, and how often to change. It survives a page cache, and since Reports counts each box on its own, a rotation doubles as an A/B test. Add it with the Affiliate Box block, the widget or a shortcode. 2.23.0 The block editor gets a block of its own: add Affiliate Box, pick from a list of everything you have saved, and see the real box while you choose. A widget does the same for sidebars on sites using Classic Widgets. Nothing already in a post changes. 2.22.2 The "as of" date that 2.22.0 added beside every fetched price is gone again. The rule behind it belongs to the API licence you accepted, and the way large publishers meet it is to refresh often rather than stamp every box. Also: the affiliate disclosure no longer scales up with your theme. 2.22.0 Amazon requires a date/time stamp beside any price refreshed less often than hourly, plus a short disclaimer. Both were missing and are now there — on every box, in both versions. Also: export a box as a self-contained shortcode, and the preview on the General tab finally follows your settings. 2.21.2 Fixes a quiet one: every box overruled the button text and colour, so changing them on the General tab reached nothing. All appearance settings now sit together on General, Marketplaces got a save bar and foldable regions, and the box editor asks less of you. 2.21.1 Text fixes for the tab merge in 2.21.0 — ten places still named the two old tabs, including the heading above the list. A box built from the Amazon search now names itself instead of showing "(no label)", and an empty per-box search term is flagged while geotargeting is on. 2.21.0 Product Box and Saved Boxes are now one tab, Product Boxes. Every box is saved and inserted with [affiliate_box box="…"]; older shortcodes keep working unchanged. A box can now carry its own ASIN per store, and the nightly refresh is about ten times faster. 2.13.0 Check all products: one button asks Amazon about everything used on a published page, including shortcodes written straight into a post, which nothing checked before. Where something is gone, Find a replacement opens the box with the old title already in the search field. 2.12.0 Health now says what a finding costs, taken from Reports: "this cost you 1,030 of 5,860 box views". Beside the count a curve says whether it is getting better, findings are sorted by weight, and where one click fixes something the button sits on the finding. 2.11.0 The plugin now reads through your posts once a day and knows which post uses which box. The Saved Boxes list says where each box appears, Health names boxes used nowhere, and shortcodes written straight into a post are on the map for the first time. 2.10.0 Health now names the saved boxes Amazon no longer returns, at the cost of no extra Amazon requests: the nightly refresh already checks them and used to keep only a count. A product counts as gone after failing on two different days, so a single hiccup never raises a false alarm. 2.9.0 Fixes a Reports column that was always zero: clicks never reached the country rows, so "which countries click" could not be answered. Adds a day-by-day chart, the posts a box appears in with their links, a CSV export, and it now says plainly what is not counted. 2.8.2 Fixes the review gallery, which did nothing at all: clicking a thumbnail left the big photo in place, silently. Also fixes the grey bands above and below a photo across the top. New review boxes now default to the photo beside the text, with a gallery. 2.8.1 Fixes an invalid product snippet in the review markup: Google asked the embedded product for offers, review or aggregateRating and it had none. The product now carries the review instead of the other way round, which satisfies the condition without adding a price or a fake average rating. 2.8.0 Review boxes now describe themselves to search engines: a block of JSON-LD with the product, the author, the score and the pros and cons. Price and availability are deliberately left out, because Amazon is the seller. Switch it off if an SEO plugin already marks up the same reviews. 2.7.0 Jeder Reiter der Verwaltung einmal ueberarbeitet: jeder Bildschirm sagt oben, ob etwas fehlt, lange Erklaerungen liegen hinter einem Aufklapper, und farbige Abgrenzungen fuehren durch die Seite. Dazu Vorschauen in den Editoren, Kontrastpruefungen und mehrere behobene Fehler. 2.6.2 Improvements to Premium's review box. Nothing changes for this free plugin. 2.6.1 Fixes three unguarded calls that could have thrown a fatal error on the settings screen, plus layout repairs to Premium's review box. 2.6.0 Adds a Reviews tab to Premium: a box for products you tested yourself, with your own photo, score, pros and cons. Nothing changes for this free plugin. 2.5.0 Adds a Reports tab to Premium. Nothing changes for this free plugin. 2.4.1 Fixes the General page showing a second time underneath the Health tab, and adds two tests to Geotargeting: where you are detected right now and which source answered, plus what a reader from any country would get - no VPN needed. 2.4.0 Adds a Health tab that reports what is misconfigured without announcing itself, and links you to the screen that fixes it. It collects nothing and changes nothing. 2.3.1 Fixes: without Amazon credentials you could not create a saved box at all, not even by typing the values in. The button was greyed out and the fields locked. Saved boxes need neither credentials nor a licence. 2.3.0 Improvements to Premium's geotargeting. Nothing changes for this free plugin. 2.2.1 Internal housekeeping only — the bundled SDK moved to a conventional location. Nothing changes for you. 2.2.0 Adds a Freemius opt-in screen with a Skip button next to it. Skipping keeps every setting available. 2.1.44 Renames the paid tier from "Pro" to "Premium". The [affiliate_box_pro] shortcode is unchanged and keeps working. 2.1.43 Raises the minimum to WordPress 6.1. If you run 6.1 or newer, nothing changes for you. 2.1.42 Documentation fix: [affiliate_box] has no id attribute — saved boxes use [affiliate_box_pro id="3"]. The shortcode reference in the admin was rewritten and now ends with a live example box. 2.1.41 Adds a "Show the price" switch to saved boxes. Existing boxes are unaffected and keep showing their price. 2.1.40 Corrects the claim that star ratings arrive from Amazon. They do not — Amazon answers without them, so those two fields are yours to type. Text only. 2.1.39 Housekeeping in the paid modules. Nothing changes in this free plugin. 2.1.38 Fixes three faults when you duplicate a saved box and pick another product: old ratings stayed behind, the preview image did not change, and the marketplace did not follow the search. 2.1.37 Fixes saved boxes rendering nothing at all on the front end. If you use [affiliate_box_pro], this is worth updating for. 2.1.36 The fallback marketplace is now yours to choose. The "Main Tracking ID" field on the General tab has become a selector, and all Tracking IDs live on the Marketplaces tab. Existing settings are unchanged — left alone, the fallback stays the United States. 2.1.35 The plugin is now called Doozly Affiliate Box for Amazon and the text domain follows the new slug. Shortcodes, settings and saved boxes are unaffected. 2.1.34 Fixes a red "Pro plan required" badge that was always visible on the Amazon API tab, even though nothing on that tab is restricted. Adds documentation and support links in the admin. 2.1.33 Adds the Amazon Creators API, a visual shortcode builder, saved boxes and star ratings. Nothing you have configured changes; the API is optional and idle until you enter a credential. 2.0.0 All licensing code removed; IP-based geotargeting is part of the separate Pro version.

常见问题:

Does this plugin require an Amazon API credential?

No. Without one you type the title, image and price yourself and the plugin builds the link from the ASIN and your Tracking ID. A credential only saves you the typing.

Where do I get a Creators API credential?

In Amazon Associates Central under Tools → Creators API. Amazon issues one credential per region — North America, Europe, Far East — and a credential does not work outside its own region, so enter one for each region you sell in. The old Product Advertising API keys no longer work; Amazon shut that API down.

Why are the star rating and the review count not filled in for me?

Because Amazon does not send them. The API accepts a request for customerReviews.starRating and customerReviews.count and then answers without them — the block is absent from the response altogether. It is a long-standing gap that affects every plugin working through this API; it is not your credential, and not this plugin. So those two fields are yours to fill: type the rating and the number of reviews from the product page. They are the one part of a box that does not keep itself current, so it is worth checking them now and then. The plugin keeps asking for both on every request. It costs nothing extra, and if Amazon ever starts answering, they fill themselves from that day on. To see what your own account gets back, press Fetch from Amazon and read Last raw API response at the foot of the Amazon API tab.

Does this plugin include geotargeting?

No. Each box points at whichever store you choose with the marketplace attribute, with the matching Tracking ID appended. Automatic routing by visitor country is part of the Pro version.

What happens if a marketplace has no Tracking ID configured?

The link falls back to the Tracking ID of your fallback marketplace, so you never lose a commission just because you have not enrolled in a regional programme.

Can I use several Amazon marketplaces?

Yes. The Associates programme runs separately in each country, each with its own Operating Agreement and its own Tracking ID — enter each one under Marketplaces and the plugin picks the right one per box. The settings page warns you when an ID does not look like it belongs to the store it is filed under.

How do I show a box in a sidebar?

On a modern theme the widget areas are block areas: add the Affiliate Box block and pick your box. On a site running Classic Widgets, use the Affiliate Box widget under Appearance → Widgets. It defaults to the narrow Sidebar layout, and a widget with nothing chosen draws nothing at all — not even its heading. A shortcode in a Text widget still works too: [affiliate_box box="a7f3k2c9" layout="sidebar"]. The Sidebar layout is vertical, centred, and fills the column up to 400px.

更新日志:

2.28.2

Fixed: an unanswered Freemius email hid the Get Premium link and made the preview tabs mention a licence you never bought. That email is sent when you connect the site and your address already has a Freemius account — it has nothing to do with a purchase. The link and the Upgrade to Premium button now stay; the notice at the top still asks you to confirm.

2.28.1

A Get Premium link in this plugin's row on the Plugins screen, leading to the pricing page. It replaces the plain Upgrade link that could appear there, and it is gone once a Premium licence is active.

2.28.0

The Premium tabs are there now, as previews. Geotargeting, Bestsellers, Comparison Tables, Reviews, Rotation and Reports each open a short page saying what the feature does, with a button to the pricing page. Nothing in this plugin is locked or greyed out — the code for those features is not part of it, and everything that was free stays free.
On the General tab, what you have comes first. The cards for the paid tabs stand apart, in a second group headed In Premium.

2.27.2

Removed a licensing key that had been travelling in the free package. It is not used at runtime, but a key of any kind has no business in a package anyone can download. The build now removes it and refuses to finish if it is still there.
Every admin screen now loads its JavaScript from a file instead of carrying it in the page. Nothing changes on screen; the file is cached by the browser rather than re-sent with every page. WordPress.org does not allow JavaScript written into the markup, and the free edition was held up for exactly that.
The Amazon search in the box editor speaks your language now — eleven messages were written into the script in English and reached no translation file.
The readme documents every external service: what is contacted, when, what is sent, and under whose terms.
Fixed: a product box saved by an older version printed PHP warnings on the page. Fields have been added to a box over the versions, and the stored boxes were never brought up to date; the renderer read them without asking whether they were there. Nothing was visible, but with WP_DEBUG on a row of "Undefined array key" warnings appeared in the middle of the post. Found on a clean install while testing this release.
Removed Tested up to from the plugin header, where it is not a valid field.

2.26.0

The affiliate disclosure has a third answer: once per page. It was in every box or nowhere, and neither works once an output gets small — a grey compulsory sentence under a one-line Compact strip is longer than the strip, and five product mentions in an article meant five copies of the same line. Leaving it out is not an option: Amazon requires it, and a silent omission is exactly the kind of mistake this plugin exists to prevent. Once per page draws it with the first box and leaves it off the rest, so it still sits above every link it covers.
A fifth layout: Button only (auto × 38 px). No card at all — just the call to action, for after a paragraph that has already named the product. No picture, no title, no price, because they are in the sentence above. This is the layout the disclosure setting unlocks; without Once per page every button would carry its own grey line and stop being a button.
Picture on the right, a tick box in the box editor. For several boxes one after another: three identical arrangements read as a catalogue, alternating sides read as an article somebody wrote. It belongs to the box rather than to the placement, which is what makes the alternation hold wherever the box appears.
Under the surface, again: the disclosure was read in six places across five files, each with its own copy of the same rule. It now lives in one.