Repository navigation
Releases
Where to Buy 0.5.0
Ready-made pages for block themes, and a list page you can set up from settings.
New
- Templates for block themes. On WordPress 6.7+ with a block theme (such as Twenty Twenty-Five), items and the Where to Buy list get a proper layout without building templates: photo beside the title, short description and store buttons on an item's page, and a grid of cards on the list and category pages. Your theme's own templates, or ones you change in the Site Editor, always take over.
- List page settings. General Settings → List page sets the title, an introduction, the disclosure shown once at the top, and a disclosure page to link to. Stores' own disclosures (such as Amazon's) are added for you.
- Store buttons block for templates and Query Loops: shows the buttons for whichever item it's in.
- Shortcodes for your own templates:
[where_to_buy_intro],[where_to_buy_disclosure],[where_to_buy_back],[where_to_buy_categories](category links), and[where_to_buy_buttons notes="0"].
Fixed
- The buy box no longer shows twice on an item's page when the template already places it above the content.
Install
Download where-to-buy-0.5.0.zip below, then in WordPress go to Plugins → Add New → Upload Plugin and choose Replace current with uploaded. Your items and settings are kept. See the guide.
Requires PHP 8.1+ and WordPress 6.4+ (templates need 6.7+).
Where to Buy 0.4.2
Category pages now look like the rest of Where to Buy.
Fixed
- Category pages use the list page's design. Pages like
/where-to-buy/category/books/now use the same template as the main Where to Buy list, showing that category's items. Before, themes without a category template (Etch, for one) fell back to a bare default page that showed only one item's description. - If your theme has its own
taxonomy-wtb_item_categorytemplate, that's still used instead.
Install
Download where-to-buy-0.4.2.zip below, then in WordPress go to Plugins → Add New → Upload Plugin and choose Replace current with uploaded. Your items and settings are kept. See the guide.
Requires PHP 8.1+ and WordPress 6.4+.
Where to Buy 0.4.1
A fix for category pages.
Fixed
- Category pages work again. Addresses like
/where-to-buy/category/books/showed "not found", even after saving permalinks, because the item address rules caught them before the category rule did. Category rules now come first.
The address rules are rebuilt automatically when you update, so there's nothing else to do. If you'd set up a redirect away from category pages as a workaround, you can remove it.
Install
Download where-to-buy-0.4.1.zip below, then in WordPress go to Plugins → Add New → Upload Plugin and choose Replace current with uploaded. Your items and settings are kept. See the guide.
Requires PHP 8.1+ and WordPress 6.4+.
Where to Buy 0.4.0
Amazon links tidy themselves. Paste a product link straight from your browser and it's saved in its short form.
What's new
- Shorter Amazon links. When you save an item, a link like
https://www.amazon.com/Atomic-Habits-Proven-Build-Break/dp/0735211299/ref=sr_1_1?crid=…&keywords=atomic+habits&qid=…&tag=yourname-20is saved ashttps://www.amazon.com/dp/0735211299/?tag=yourname-20. The search tracking and title words are dropped. - Your tag is kept. The tag already in the link stays. If the link has none, your Amazon tag from Store Settings is used.
- Works with the usual link shapes:
/dp/…,/gp/product/…,/gp/aw/d/…(mobile) and title-first links. Other Amazon sites, such as amazon.co.uk or amazon.de, keep their own domain.amzn.toanda.colinks are followed to find the product. - Leaves other links alone. Search pages, storefronts and anything without a product ID are saved as pasted.
- On by default. Turn it off with Shorten Amazon links in Where to Buy → General Settings. Developers can use the
wtb_normalize_store_urlfilter, andwtb_resolve_amazon_short_linksto skip following short links.
Links saved before this version change the next time you save the item.
Install
Download where-to-buy-0.4.0.zip below, then in WordPress go to Plugins → Add New → Upload Plugin. Updating keeps your items and settings. See the guide.
Requires PHP 8.1+ and WordPress 6.4+.
Where to Buy 0.3.1
The first public release. Show where to buy the things you recommend: a photo, a short description and a button for each store that sells it, with affiliate disclosures built in.
What's in it
- Stores, set up once in Where to Buy → Store Settings: name, button image, allowed domains, affiliate tag and extra disclosure. Drag to reorder. A default image covers stores without their own.
- Only working links show. A link must be a full web address on the store's own domain. The item editor says which links show and why the others don't.
- Disclosures built in. Your note shows under the buttons, and Amazon's Associates sentence is added whenever an Amazon button shows. Links carry
rel="sponsored nofollow noopener". - Place items anywhere: item pages, a list page at
/where-to-buy/(the slug can be changed), the Where to Buy block, and the[where_to_buy],[where_to_buy_buttons]and[where_to_buy_list]shortcodes. - Works with Affiliate Link Cloaker: any store can use a cloaked
/go/link, and links to ended offers are hidden.
Install
Download where-to-buy-0.3.1.zip below, then in WordPress go to Plugins → Add New → Upload Plugin. See the guide.
Requires PHP 8.1+ and WordPress 6.4+.