Setup guide

1. Install

1. In the WordPress admin, open Plugins > Add New and search for Pukulink.
2. Press Install Now.
3. Press Activate Plugin.
4. Settings > Pukulink appears in the admin menu.

If you would rather install a ZIP, get it from the download page and use Plugins > Add New > Upload Plugin.

2. Connect the APIs

Enter the credentials for the marketplaces you want on the API settings tab of Settings > Pukulink. You do not need all three. Rakuten alone, or Yahoo! alone, is enough.

Each marketplace issues credentials differently, so they have a page each. Open the one you need.

• Amazon Creators APIClient ID / Client Secret, and what happens before you're eligible
• Rakuten Web ServiceApplication ID, access key and the allowed-website registration (2026 spec)
• Yahoo! Shopping / ValueCommerceIssuing a Client ID and finding your sid / pid
• Moshimo Affiliate (optional)Route all three marketplaces through Moshimo; import IDs from an Easy Link code

Moshimo Affiliate is optional — you don't need it if you are registered directly with each marketplace. Note that Moshimo provides no product search API, so the three API settings above are required even when routing through Moshimo (Moshimo sits on top of them rather than replacing them).

When you are done, press each marketplace's connection test button. Errors are worded to tell you what to fix rather than just failing.

3. Display settings (optional)

Adjust these on the Display & Design tab if you want to. The defaults are all usable as they are.

4. Insert your first product card

In the Classic Editor

1. Open a post and press Add Pukulink — the Pukuo icon in the media button row above the editor.
2. The search modal opens. Choose a marketplace tab, type a product name, search.
3. Pick a result and the insert preview opens. Choose a template and check the desktop, tablet and phone widths.
4. Press Insert. A shortcode goes into the post, shown in the Visual tab as a product card placeholder.

In the Block Editor

1. Add a block and type /pukulink, then choose Pukulink (searching for “product link” finds it too). The search screen opens immediately.
2. Everything from there is identical to the Classic Editor. The inserted card becomes a Pukulink Card block and renders as a real card while you edit.
3. The same search screen also opens from the Pukuo icon in the toolbar of any block you have selected.

5. Going further

Tune the search keyword

Buttons for marketplaces without a linked product become links to that store's search results. You can edit that search term in the Search keyword field of the insert preview. Adding a model number or capacity gets readers to the right item faster. (The title shown on the card is unaffected; leaving the field empty searches by product name.)

Link a product from another store

Use ＋ Link an item from another store in the insert preview. Choose a store other than your starting one, search by product name, and press Link on the result you have confirmed. Back in the preview, each store's item and price are listed.

Linking makes each store's price update independently. Marketplaces you did not link get a keyword search link instead — the plugin never decides on its own that two items are the same product. More on linking →

Edit a card you already inserted

• Block Editor: select the card, then Edit card in the toolbar.
• Classic Editor: the pencil button on the placeholder in the Visual tab.

Either route lets you re-pick the product or change the links.

Save a favourite store

On the Favourite stores tab, choose the marketplace, paste the store URL (or store code) and press Verify and save. The store name is confirmed against the official API first. Afterwards, the search screen gains a Search in selector for narrowing to that store.

• Rakuten Ichiba: https://www.rakuten.co.jp/scope/ or scope
• Yahoo! Shopping: https://store.shopping.yahoo.co.jp/STORE-ID/ or the store ID

Register a sale

Rakuten's “days with 5 and 0” and Yahoo!'s “days with 5” appear automatically. For fixed-period events such as Rakuten Super SALE or an Amazon time sale, add the marketplace, label text and date range on the Sales tab. Labels never show outside their range.

Use the Comparison Buttons template

Selecting Comparison Buttons outputs store buttons only, laid out so they survive being dropped into a table cell. The insert preview offers filled or outlined and horizontal or stacked.

Let an AI write the draft

Tell your AI to write [pukulink_draft keyword="product name"] wherever a product should go. The draft then shows highlighted markers in the Classic Editor's Visual tab; press the pencil button, search, pick, and the marker becomes a card. Markers left in a published post are invisible to readers. Example prompts are on the plugin's Help tab.

With several markers, confirming one moves automatically to the next (“AI markers: 2 of 5”). Skip this marker passes over anything you don't want to handle yet.

6. About automatic price updates

Prices refresh through WP-Cron, a little each hour (24-hour cache by default). On quiet sites WP-Cron barely runs, so scheduling wp-cron.php with your server's cron is more reliable.

On Xserver, use the server panel's Cron設定 to run something like this hourly (adjust the path to your own environment):

/usr/bin/php /home/USERNAME/example.com/public_html/wp-cron.php

Adding define( 'DISABLE_WP_CRON', true ); to wp-config.php then stops cron running on every page view, which makes the site a little lighter.

7. When something doesn't work

Start with FAQ & troubleshooting, which covers each connection-test error and the common questions.