=== Built Not Begged Bookshelf ===
Contributors: matthewxmurphy
Tags: books, author, bookshelf, amazon, kobo
Requires at least: 6.5
Requires PHP: 8.0
Stable tag: 2026.10.10.002
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Editable themed author bookshelves with Amazon, Kobo and Spotify links. Free from BuiltNotBegged.com, developed by MatthewxMurphy.com.

== Description ==
Add your author shelf first, Matthew second, and optional Taylor romance books third. Choose site, light, dark, Taylor purple or custom colors. Optional daily updates add new published books from connected author-owned WordPress catalogs. Existing books are preserved. Approved Amazon API access is separate.

Amazon checks are off by default. When explicitly enabled and configured, daily checks request Books SearchItems page 1 with NewestArrivals and up to 10 results per eligible visible author. Existing ASIN previews refresh in batches of at most 10 and expire after 600 seconds. New ASINs enter a private identifier-only review queue. Hidden Taylor books are excluded. Amazon checks never publish candidates or overwrite saved books, covers, links or status.

Configure approved Creators API credentials privately, with an actual Associates tag and a permitted application/use case. Missing credentials leave checks pending with zero Amazon HTTP requests. Enrollment alone does not authorize API use for a giveaway author tool. The search is not an exhaustive Author Central catalog; review namesakes and editions before adding author-owned content.

Administrator-only API: GET /wp-json/mxm-bookshelf/v1/amazon/status and POST /wp-json/mxm-bookshelf/v1/amazon/check. Check queues a run; status shows actual progress. WordPress Cron depends on page loads unless the host runs scheduled tasks. Use a server runner for quiet sites.

Implementation details and official Amazon policy/SearchItems and WordPress Cron references are linked in README.md.

== Installation ==
Upload, activate, choose your primary author under Bookshelf Settings, add books, and put [mxm_bookshelf] on a page. Included examples are optional and never published on activation.

== Changelog ==
= 2026.10.10.002 =
Adds opt-in bounded Amazon checks, 600-second ASIN previews, a private review queue and administrator status/check APIs. No automatic publication or saved-book overwrites; missing credentials make no Amazon requests.

= 2026.10.10.001 =
Themed author shelves, optional partner visibility, own-art examples, administrator API settings and safe new-release feeds.
