Kukuriya -- WordPress 插件

开发者	piftoworks
更新时间	2026年10月1日 18:33
PHP版本:	7.4 及以上
WordPress版本:	7.1
版权:	GPLv2 or later
版权网址:	版权信息

Kukuriya is a WordPress plugin that bundles product links from multiple affiliate service providers (ASPs) into a single "product" and manages them in one place. It is fully integrated with the Block Editor, covering everything from product search to card rendering, comparison tables, and automatic price updates. It is aimed at people migrating from Pochipp, affiliate marketers struggling with the Amazon API entry barrier, and anyone who wants to manage multiple ASPs across one site. Key features

Universal Link: one product = a set of offers from multiple ASPs. A data model that lets you serve the best link depending on user, stock, and price
Connector architecture: every ASP integration is an isolated connector module. Five official connectors ship built in and can be toggled per site, and third-party connectors can be added as separate plugins via a public hook
Modern Block Editor: product search modal, block insertion, and attribute editing UI built with TypeScript + React 18 + @wordpress/scripts
One-action registration by URL paste: paste a Rakuten or Amazon product page URL into the Block Editor to identify, fetch, and register the product CPT automatically. SiteStripe short URLs (amzn.to / amzn.asia) are expanded automatically. Also useful as a rescue path for products that do not appear in search results
5 built-in card templates: Simple / Card / Compact / Pochipp compatible (visual parity for migrating users), plus a comparison table block for up to 10 products
Comparison tables you can actually shape: reorder the rows, add your own from custom fields or free text, mark cells with ◎ ○ △ ×, turn a cell into a bullet list, highlight the one that decides it, put the products down the side instead of across the top, give each column its own button text and colour, and add a heading above the table
Design controls: 4 visual presets (Neo / Outline / Glass / Bold), custom card frames (width / color), button styles (solid / outlined / gradient / raised), an optional "See reviews" link, and animated frame and button effects (glow, pulse, shine, aurora) that pause automatically for visitors who prefer reduced motion — configurable site-wide or per block
Custom fields: add per-product spec fields in 5 types (text / number / select / boolean / date) with editing and CSV round-trip support
CSV import / export: full CSV round-trip including custom fields, with dry-run validation
Pochipp migration: import products and affiliate URLs from an existing Pochipp install (CPT pochipps). Amazon ASIN / Rakuten item code / Yahoo seller_id + itemcode are mapped automatically. The last step rewrites the cards inside your posts and cannot be undone, so take a full site backup before you run it
Automatic price refresh cron: re-fetches Amazon / Rakuten / Yahoo prices every 6 hours. Failed items are retried with interval protection for stable operation
Click tracking on your own site (anonymized): a small script reports purchase-button clicks to your site's own REST API and the dashboard shows which products, stores and posts get clicked. IP / UA are hashed with HMAC-SHA256, referrers keep the host only, no cookies. Can be switched off under "Measurement"
Automatic product description generation (external API): a Composer Service that can call a vendor-neutral Messages-style API. Users configure their own API key
Optional credit: off by default. If you want to show where the cards come from, a switch under Design adds a small mark and the name "Kukuriya" at the bottom right of cards and comparison tables. It is never a link, and nothing about the plugin depends on it
Internationalization: every string is translatable (text domain: kukuriya). Translation contributions via translate.wordpress.org are welcome

Supported ASPs (all built in — enable the ones you use)

Amazon (Creators API, 15 marketplaces)
Rakuten Ichiba (Rakuten IchibaItem Search API v2)
Yahoo! Shopping (Shopping Web Service V3 + ValueCommerce affiliate URL support)
Moshimo Affiliate (link conversion; an alternative route without Amazon keys)
Mercari (Mercari Ambassador: your afid is appended to Mercari links — search links and per-product links)
Manual entry (A8.net / afb / ValueCommerce, etc.) (a generic connector for ASPs without a product API)

Usage notes

The Amazon Creators API requires per-account credentials (a central proxy model is not permitted under its licence)
Amazon grants API access only to accounts with at least 10 qualifying sales in the trailing 30 days. The Moshimo Affiliate route can be used as an alternative
Please follow the terms of service of each ASP

0.15.2

Fixed: a second store's price could be shown long after it had stopped being fetched, with a "checked at" time that was wrong and sometimes in the future. When a store stopped returning a price - out of stock, for example - Kukuriya kept the old price and took the time of the failed attempt as the time the price was fetched. Prices are now judged by the last time they were actually fetched, so they disappear 24 hours later as intended. The card itself, with its buttons, stays.
Fixed: the click summary on the dashboard no longer says that no clicks have been recorded when the table under it lists recent clicks. If there were none in the last 7 days, it now says so.
Changed: recent clicks on the dashboard are listed by the time they happened, newest first.

0.15.1

Added: when links are converted through ValueCommerce - with the sid and pid in the ValueCommerce connector, or in the Yahoo! Shopping connector - Kukuriya now outputs ValueCommerce's impression image next to each converted link, as it already does for Moshimo. ValueCommerce hands out each ad as a link plus a 1x1 image, and until now only the link was output, so the impression count in your ValueCommerce dashboard stayed at zero. Nothing is output when the sid or pid is empty, so a site that uses LinkSwitch is not counted twice. See "External services" for what ValueCommerce receives.
Fixed: the connection test for Yahoo! Shopping or Rakuten no longer warns that links will not be converted when you send that store's links through another provider in Monetization route (ValueCommerce or Moshimo) and that provider is set up. It now says which provider converts them.
Changed: the link at the bottom of the Moshimo Affiliate settings is no longer labelled as an API key guide. Moshimo has no API key; you paste an ad link.

0.15.0

Fixed: a comparison table no longer sends readers to a product page that has been marked as gone. Product cards already switched such a button to a search for the product, but the table ignored the mark and kept linking to the discontinued page. A column now goes where the card's buy button for that store would go - usually a search for the product at the same store, or the card's first button when that store has none - and if the card would have no button at all, the product is shown without a link. Clicks on such a column are counted for the store it now leads to.
Fixed: a comparison table shows another store's current price when the product's own price has expired, as product cards already do. It used to show a dash even when a different store had a fresh price. The price is taken from the same store as the column's button wherever possible, so the price and the link do not point at different shops.
Changed: the note under a price in a comparison table now names the store the price came from, as it already did on a product card ("as of 2026/09/25 10:00 | via Rakuten Ichiba"). Now that a column can switch to another store's price, the note is what tells readers whose price they are looking at.
Fixed: a comparison table that is wider than the page can be scrolled with the keyboard. It only scrolled with a mouse or touch, so the columns off to the right could not be reached without one. The table area now takes focus, shows an outline when it has it, and is announced to screen readers as a comparison table that scrolls sideways.
Fixed: the star rating on a product card no longer shows its screen-reader text on themes that do not hide it. The extra words relied on a class the theme was expected to define, and on themes without it the card read "Rating ★4.5 out of 5, (128 reviews)". The rating is now described by a label on the element itself, as it already was in comparison tables, so it no longer depends on the theme.
Fixed: posts that contain only [bcore_link] shortcodes load the plugin's stylesheet. Without it, banner images in those links were not scaled down and spilled past the edge of the screen on phones. Links printed from other places, such as widgets or excerpts, are covered as well. The block version was not affected.
Fixed: a custom link with its own rel value keeps "sponsored" and "noopener". Writing rel="nofollow" replaced the defaults instead of adding to them, so the link lost the value that marks it as an ad and the safeguard for links that open in a new tab. The values you enter are kept and the missing defaults are added.
Fixed: a search link can no longer take a page down because of a store template. Search addresses were filled in with PHP's sprintf, so a stray percent sign in a template supplied through the kukuriya_store_catalog filter made PHP 8 stop with an error and the page did not render. Only the %s placeholder is replaced now.
Fixed: sale classes passed in through the kukuriya_product_render_options filter are reduced to characters that are valid in a class name before they are printed. They were added to the card's class attribute as they came, so a quotation mark in the value could break out of it.
Changed: the "Find my outbound IP address" button now makes its request the same way as every other request in the plugin, which refuses to follow a redirect to a private or local address. It still contacts only api.ipify.org, and only when you press the button.
Fixed: the Pochipp migration could read a card and the Pochipp card right after it as a single card. The second card was then neither converted nor listed among the cards that could not be converted.
Fixed: a Pochipp block whose closing comment is missing, which usually comes from hand editing, no longer takes the text after it with it. The migration treated everything up to the next closing comment - paragraphs and other cards included - as part of that block and replaced all of it with one card. Such a block is now left as it is, and the cards after it are converted or reported as usual.
Fixed: the Pochipp migration never saves a post it could not read to the end, and never saves a post that would come out empty. A very long card, or text containing broken characters, could make the matching fail partway, and in rare cases the post was written back empty. Such posts are now left untouched and listed with the reason.
Fixed: uninstalling the plugin also removes the record that the Pochipp settings were imported. When it was left behind and the plugin was installed again, the migration screen treated the site as already migrated and would not move past that step.
Added: the Products screen opens a single product for editing when its address carries &product= and the product's ID, so a link from elsewhere in the admin can land straight on that product. If the product cannot be opened, the list is shown as usual and the parameter is taken out of the address.
Changed: the Moshimo connector links to its own setup guide. It used to point at the index of the guides.
Added: for developers, kukuriya_product_link( $product_id, $store ) returns the link a reader would follow for a product: the same link as the card's buy button for that store - the product page through your monetization route, or a search link only when that search earns - and an empty string otherwise. kukuriya_product() returns the plain product URL, which earns nothing, so an add-on that lists products had no proper link to give them. Escape the result when you print it.
Added: for developers, PiftoWorks\Kukuriya\Links\PlacementScanner::by_kind() sorts what a post contains - cards, comparison tables, links, inline product links and any Pochipp cards still left - using the same rules the migration uses to rewrite them, and says whether it could read the whole post. PlacementScanner::RULES_VERSION goes up whenever those rules change, so anything that stores the result knows when to rebuild it.

0.14.1

Fixed: changing a monetization route, saving connector credentials or saving the design settings now clears your page cache. Until now only saving a product did. If you switched a store to a different network, pages already in the cache kept handing out the old links, which earned nothing, and there was nothing on screen to say so. The same applies to the scheduled price refresh: cached pages kept showing the old price and the old "as of" date, past the 24-hour limit the card is supposed to respect.
Fixed: a store button that cannot be monetized is no longer shown as a bare search link. Kukuriya ships with Amazon, Rakuten and Yahoo! Shopping enabled and falls back to a search link for stores with no product data, so a site that had only set up Rakuten was publishing plain Amazon and Yahoo! search links. They sent visitors away and earned nothing. Buttons for products you have actually registered are unaffected.
Fixed: a store whose route cannot work is shown in the monetization route list with the reason, instead of disappearing from it. A store with no credentials of its own and no working route was dropped from the list entirely, so the setting could not be corrected and nothing explained why its links were not being converted. Migrating from Pochipp could leave a store in exactly that state.
Fixed: the route list also refuses combinations that cannot work, such as routing Amazon through the Rakuten connector. These were accepted and produced broken links.
Fixed: pasting a Moshimo ad link into the wrong merchant section is now refused, naming both merchants. Moshimo issues a different set of IDs per merchant and its ad link carries the advertiser number, which Kukuriya already knows; it was reading only the partnership ID and ignoring the rest. An Amazon ad link pasted into the Rakuten section therefore read as "set up", the links still redirected, and nothing was ever tracked.
Fixed: the click-measurement endpoint now only accepts beacons sent from your own site, and its rate limit is applied atomically where an object cache is available. Anyone could previously post arbitrary values to it and distort the click figures in your dashboard. Nothing about what is stored has changed: addresses and user agents are still hashed, never kept in the clear.

0.14.0

Added: when a store is routed through Moshimo Affiliate, Kukuriya now outputs Moshimo's impression tag alongside the link. Moshimo hands out each ad as a pair - a link that counts clicks, and a 1x1 image that counts how often the ad was shown - and until now only the link was output. The impression count in your Moshimo dashboard therefore stayed at zero and the click-through rate could not be read. Commissions and clicks were never affected; they are counted by the link itself.
Added: the tag is output once per placement - next to each purchase button, each inline product link and each comparison-table button - and only if you have entered a Moshimo partnership ID (a_id) and chosen Moshimo as the route for that store. Your visitors' browsers then load an image from i.moshimo.com whenever such a page is shown. The "External services" section above describes exactly what Moshimo receives.
Changed: the Moshimo connector asks for three values instead of sixteen. The p_id, pc_id and pl_id that Moshimo issues per advertiser are the same for every site and every partnership, so the plugin now holds them and asks only for the a_id of each of the three advertisers. Values you saved in an earlier version are still read, and still take precedence.
Changed: the Yahoo! connector links to its own setup guide, which walks through the Yahoo! Developer Network and the ValueCommerce registrations separately. It used to point at the index of the guides.
Fixed: the "saved" banner in the settings screens disappears on its own. It used to stay until you saved again or touched a field, covering the top of the page - the admin bar included - for as long as you left it alone. All six screens are affected.
Fixed: the cross in a comparison table is the same size as the circles beside it. The multiplication sign used until now is a Latin-width character, so at the same font size it looked smaller than the full-width circles - most noticeably in Yu Gothic, the usual default on Windows.

0.13.9

Added: the product list now shows, for each store, whether its button opens the product page or only searches for the name. Until now the list showed a number, and finding the gaps meant opening products one at a time.
Added: those store labels are buttons. Press one and Kukuriya searches that store for the product, so you can fill a gap without leaving the list.
Added: a filter that leaves only the products still searching at a store you pick, so you can work through the gaps one store at a time.
Fixed: the new column no longer lists a store whose button does not appear on the site. Mercari can only be linked directly through a URL override, so without an ambassador ID its button is never rendered, yet the list described where that button would go.
Fixed: error messages from the connectors are translatable. Until now a missing Rakuten application ID, an Amazon rate limit and similar problems were shown in English regardless of the site language.
Fixed: the product list no longer spills past the panel on narrow screens. The table scrolls sideways instead.
Fixed: the tabs across the top wrap onto a second line on narrow screens. They used to be squeezed into one row until each label broke into a vertical stack of single characters.

0.13.8

Added: a button in the Rakuten connector settings that looks up your server's outbound IP address. Rakuten asks for it when you register an application as an "API / backend service", and it is not the address your own domain resolves to. The value can be copied with a click, and nothing is sent anywhere until you press the button.
Added: an optional expiry date for your Rakuten application. Rakuten does not tell you when the key is about to stop working, so the settings screen starts reminding you 30 days ahead. If a call does fail, the connection test now names both of the causes that produce the same error and how to tell them apart.
Added: links from each connector's settings to the setup guide for that service, and to the terms of the company providing the API (Amazon / Rakuten / Yahoo!).
Changed: "no affiliate ID is set" is no longer folded into the green success message of a connection test. It is shown as a warning of its own, and it appears as soon as you save the credentials rather than only after you run a test.
Changed: connector settings are grouped under headings that separate the keys used to fetch product data from the keys used to earn a commission.
Changed: the migration screen and the FAQ now say plainly that the last step rewrites the cards inside your posts and cannot be undone, and that a full backup is the way back.

0.13.7

Changed: the hint that appears when a comparison table scrolls sideways is now a light chip with dark text instead of a dark bar. It sits over the buttons in the last row, and the dark version read as though it were covering them up.

0.13.6

Changed: the "scroll sideways" hint on a comparison table is shorter, and the buttons underneath show through it. The old line ran long enough to sit on top of them.

0.13.5

Changed: the Amazon button is a brighter orange out of the box. The old one read as brown next to the other stores. Sites that picked their own Amazon colour under Design are unaffected.

0.13.4

Fixed: the store buttons in a comparison table ran together into one solid bar. Each button was overflowing its column by the width of its own padding on themes that do not set border-box sizing for you, Twenty Twenty-Five among them. Most themes do set it, and those were never affected.
Fixed: a column label such as "Top pick" covered the product name next to it once a table had several columns. A table that uses a label now keeps room for it above every heading, so the names still line up with each other.

0.13.3

Fixed: the sample card on the Design screen carried a real manufacturer's name as its brand line. It is a made-up name now. Nothing on your site changes — the name only ever appeared in that preview, before you pick a product.

0.13.2

Changed: cards and buttons have much squarer corners out of the box. The 14px radius made every card look like a pill, which fought with most themes. Sites that set their own radius under Design are unaffected.
Changed: a one-line (compact) card is now one link the whole way across. The row used to be dead except for the round arrow on the right, and nothing said so.
Changed: the column headings in a comparison table are the same size as the product names below them. They were smaller, which read as though the headings mattered less than the rows.
Fixed: the store buttons in a comparison table disappeared. The link that rewrites inline product mentions was also rewriting the buttons the table had already drawn, and stripped the class that made them look like buttons.
Fixed: a product name in a comparison table was drawn in your theme’s link colour and weight, so it looked like body text that happened to be linked instead of the name of the thing in that row.
Fixed: on a phone, the store name inside a button (Amazon, Rakuten, and so on) was set thin and narrow while the button around it stayed large.

0.13.1

Fixed: cards no longer turn dark on their own. Following dark mode was on by default, but the browser setting it follows has nothing to do with your theme, so a card could go black in the middle of a light page. It is off by default now, and the setting says what it actually follows. Sites that already saved a choice keep it; turn it back on under Design if your theme follows the browser too.

0.13.0

Changed: every on/off control in the admin screens is now a two-part "Off | On" switch, with the chosen side filled in. The round sliding knob did not say which side was on, and the pale colour made it worse.
Changed: a product opens in a window of its own instead of unfolding underneath the list. With a full page of products the editor used to sit far below the fold, so editing meant scrolling past fifty rows first.
Changed: that window is now divided into sections you open one at a time — card overrides, micro-copy, link URLs, custom buttons, sale, posts using it, and store buttons — all closed to begin with. Roughly forty fields used to stand in one flat column. Sections that can be counted show how many things are set in them.
Changed: the store section was rebuilt. It now lists every store a product can be fetched from, one row each, and says where that store’s button goes: straight to the product page, or to a search for the product name. Only the stores that had been registered were shown before, which made a card with four buttons look as though it had one.
Changed: the comparison table list is one card per table, with the post title on a line of its own. As a seven-column table the product column swallowed the width and the rest collapsed into single letters stacked vertically.
Changed: product lists take a page number, and have First and Last buttons, so a site with thousands of products is not paged through one screen at a time.
Changed: sliders are thicker, with a grab handle you can actually hit — a 3px line with a 14px dot was hard to hold with a mouse and worse on a touch screen.
Fixed: the product image on a card sat above the middle of the row, so it crowded any label above it and left a gap below. It is centred now.
Fixed: the icon beside "See reviews" was an empty outline. It has the three dots inside it that make it read as a speech bubble.
Fixed: the card preview on a product’s screen ignored the site-wide design settings, so button colours there did not match the front end.
Fixed: rows that put a text field next to a button had the two at different heights, and the URL field was too narrow to work in.
Fixed: pasting a product URL and pressing the button appeared to do nothing when the address was not from a supported store. The answer now appears next to the field — which store was added, or why it was refused — instead of at the top of the page where it went unseen.
Fixed: Japanese. Everything in the admin screens is translated, including the messages the REST API sends back. A handful of strings had been left in English.

Older versions: see changelog.txt in the plugin folder, or read it online.

Fixed: a Mercari product page pasted into "Add a button from a URL" in the block sidebar now becomes the Mercari button with your Ambassador ID (afid). It used to become a custom button, and custom buttons are printed as they are, so the link carried no afid. If the Ambassador ID is not set yet, or the Mercari connector is switched off, the URL is not saved and the sidebar says what to do first.
Fixed: a Mercari button is never shown without your Ambassador ID. A Mercari link URL saved on a product was still printed while the ID was empty or the connector was switched off, without afid. It is now hidden in those cases, as the search link already was, and the products list agrees with the page.
Fixed: Mercari links that were already in your posts now get your Ambassador ID when they are printed: custom buttons that point at Mercari (which the sidebar used to create) and products registered by hand whose product page is on Mercari. This covers the card's buttons, the product name, the image, comparison tables and links alike.
Changed: the Mercari settings have a single field, "Ambassador ID (afid)". The ID is shown as "Your ID" on your Mercari Ambassador page, so there is no need to make a link first. If you paste a whole Mercari link into the field, only the number after afid= is used; a Mercari URL without afid is not taken as an ID.
Added: "Unlink" in the block sidebar waits a few seconds and offers "Undo". The list of store links on a product now also shows the stores on the card that go to a search for the product, with a note on how to link the product page, and the store the product was registered from.
Fixed: removing a store's link URL from the block sidebar removes only that store, and only if its URL has not changed since. It used to write back the whole list the sidebar had loaded, which could undo a change made meanwhile on the Products tab, or remove a URL pasted again during the undo wait.
Added: the URL field for buttons accepts an ASP's ad tag as it is. The link is taken out of the code, and addresses that start with // get https:.
Fixed: the text on a custom button no longer turns the dark body colour. The button's text colour pointed at itself and was ignored by the browser.
Changed: the form for adding a link starts with what you are registering, and the finer settings (rel, where the link opens, notes) are folded under "Advanced settings". The list filters are now called "Filter by type" and "Filter by status".
Fixed: the suggested key for a link is made from the domain the link leads to, not from the ASP's redirect domain.
Changed: the ValueCommerce connector no longer shows the fallback pid field, which no route could use. A value saved there before is still read.
Changed: "How to set up …, step by step" in the Amazon, ValueCommerce and Mercari settings now opens the guide page for that service, and the link at the bottom of the Mercari and ValueCommerce settings is no longer labelled as an API key guide.
Changed: the "paste a link" boxes in the connector settings also read links copied from a page's HTML (&), and say so when the pasted link does not contain the value the setting needs.

Kukuriya

标签

下载

详情介绍:

安装:

屏幕截图:

升级注意事项:

常见问题:

更新日志: