TMM Affiliate Blocks

TMM Affiliate Blocks helps publishers build clear, responsive affiliate product modules without hand-coding every article. Create Product Boxes, Deal Links, Link Embeds, reusable affiliate destinations, disclosures, editorial ratings, and cache-first Amazon-backed fields from Gutenberg, Elementor, or copy-ready shortcodes. The plugin is built for editorial commerce workflows: reviews, buyer guides, deal posts, "best for" recommendations, and product mentions where readers need a clean call to action and publishers need policy-aware output. Free core. Affordable Pro when you need more scale. The WordPress.org plugin is a useful free publishing toolkit, not a crippled trial. When a larger affiliate workflow needs automation and reporting, the separate TMM Affiliate Blocks Pro add-on adds Best Picks Grid, advanced comparison workflows, privacy-safe aggregate Click Analytics, Link Health, cache-health and refresh-queue tools, CSV import/export, reusable Saved Kits, style packs, and private licensed updates. Current annual plans are Starter $25/year for 1 site, Growth $59/year for 3 sites, and Publisher $119/year for 10 sites. Pro requires this free plugin; payment, licensing, customer data, and private updater code are not included in the WordPress.org package. View Pro plans | See the live demo | Read the documentation The plugin includes:

• Product Box Gutenberg setup with Card, Horizontal, and Minimal responsive variants.
• Deal Link and Link Embed surfaces for quick product mentions.
• A unified TMM Display launcher in Gutenberg plus a matching Elementor widget when Elementor is active.
• Display Defaults for consistent layouts, button treatments, card styles, and badges with per-block overrides.
• An Editorial Rating block for clearly labeled publisher judgment, never imported Amazon customer-review data.
• Manual retailer links with editor-provided values.
• A searchable Link Registry for reusable Amazon ASINs and approved manual retailer destinations.
• Block Builder for copy-ready setup snippets and visual previews.
• Cache-only public rendering for Amazon-backed fields.
• Diagnostics for ASINs, manual URLs, cache age, rendered affiliate modules, and ASIN cache inventory.
• Affiliate disclosure block and optional automatic disclosure insertion.
• Mobile, tablet, sidebar, and AMP-safe frontend rendering with focus states and reduced-motion support.

Amazon product data is shown only when the site owner configures supported credentials and the API/cache provides that field. The plugin does not scrape Amazon and does not invent price, stock, savings, Prime, merchant, or discount values when source data is missing. Amazon customer ratings and review counts are not imported; any rating-style editorial element must be entered by an editor and clearly treated as publisher judgment. Manual retailer links remain editor-provided. If an editor enters a manual price, savings note, or retailer label, the plugin treats that value as editorial copy, not live retailer data.

1. Upload the tmm-affiliate-blocks directory to /wp-content/plugins/, or install it from the WordPress plugin directory when available.
2. Activate the plugin in WordPress.
3. Open TMM Affiliate in wp-admin.
4. Review Output, Modules, Link Registry, Amazon API, and Diagnostics.
5. Add Amazon Creators API credentials only if your site is approved to use them.
6. Insert the TMM Affiliate Disclosure block or enable automatic disclosure insertion before publishing affiliate content.
7. Test on staging before deploying to a production site.

Recommended server constants for Amazon API configuration: TMMAFBL_AMAZON_CREDENTIAL_ID TMMAFBL_AMAZON_CREDENTIAL_SECRET TMMAFBL_AMAZON_CREDENTIAL_VERSION TMMAFBL_AMAZON_MARKETPLACE TMMAFBL_AMAZON_PARTNER_TAG Do not commit production Amazon credentials, partner tags, private API keys, or customer data to a public repository.

0.7.44

• Fixed AMP-sanitized phone layouts so Best Picks cards, Product Boxes, Link Embeds, product lists, and comparison fallbacks stay inside narrow article columns even when AMP removes container queries and root selectors.
• Added regression coverage that models AMP removing container rules and verifies visible cards remain one per row at 390px with no document overflow.
• Refreshed the WordPress.org description and screenshot captions to show the shipped editor workflows, responsive variants, and clearly separated affordable Pro add-on.

0.7.43

• Added the Phase 4 responsive output contract for the Free Product Box and Link Embed surfaces, plus shared compatibility styling used when Pro supplies Comparison Tables, so displays respond to the actual publishing column instead of the viewport alone.
• Added the TMM Display launcher as the unified Gutenberg inserter entry point (inserts the right variant block on the editor; renders nothing on the public site so no raw shortcode text can leak).
• Expanded the existing Link Registry with multi-field search, draft exclusion, and a published-only default for the editorial autocomplete surface.
• Added Display Defaults as the saved-defaults contract for Product Box layout, style preset, button style, card style, and badge style, with explicit per-block override semantics and legacy alias normalization (vertical/feature to card, list/list_row/compact to minimal, default/standard to horizontal).
• Added a free TMM Editorial Rating block (fixed "Editorial rating" label; no Amazon customer-review signals) with a Pro extension seam for reusable rating records.
• Added an Elementor TMM Display widget that surfaces the same Phase 4 catalog as the Gutenberg inserter; the widget is no-op when Elementor is absent.
• Bumped #110 (Card / Horizontal / Minimal Product Box variants) into a single trusted renderer with canonical + legacy class pairs and a data-layout attribute for analytics / CSS hooks.
• Hardened cache invalidation (#91, #92) so transient / cache flushes on save / clear do not strand stale fallback state.
• Fixed narrow Product Box ribbon badges so their fold and 12px card-edge overhang remain consistent with Best Picks cards without causing horizontal overflow; pill badges stay inset.
• Hardened the public-free boundary: no Product Search, paid code, license, payment, customer, or private updater code is in the WordPress.org package; the Free/Pro seam is tmmafbl_affiliate_block_definitions + tmmafbl_affiliate_module_definitions + tmmafbl_affiliate_admin_tabs + tmmafbl_affiliate_admin_panels.
• Kept the public-only renderer contract intact: cache-only by default for logged-out visitors, no remote JS/CSS enqueued, no editor-price values described as live API data, no scraping paths.
• Verified end-to-end on the homelab by an independent QA run covering Link Registry CRUD + search, Display Defaults inheritance + override, Saved Kits Linked + Snapshot end-to-end (Pro canonical master 970bb8f), Migration Center evidence export (no automated apply-rollback), Editorial Rating records, and Free/Pro license state machine. See docs/qa/issue-119-phase4-qa-evidence.md for the full evidence.

0.7.42

• Fixed Best Picks Grid layouts in narrow article columns with a sidebar so product cards wrap before they can overlap surrounding page content.
• Added responsive container-aware grid behavior so the layout adapts to the actual publishing area, not only the browser viewport.
• Added regression coverage for the Best Picks Grid wrapper and narrow-content column behavior.
• Kept the WordPress.org package boundary unchanged: no Product Search, paid code, payment, customer data, or private updater code is included.

0.7.41

• Added the conditional frontend bridge used when the separate licensed Pro add-on provides privacy-safe aggregate Click Analytics.
• Fixed logged-out click delivery so browsers fall back to a keepalive request when Beacon cannot queue an event.
• Fixed nested Pro workflow links so Analytics, Link Health, CSV, Kits, Comparisons, Styles, and Workflow sections stay inside the Pro tab.
• Kept analytics implementation, licensing, reports, customer data, and paid update code outside the WordPress.org package.

0.7.40

• Added a read-only editor/agent shortcode helper REST route (GET/POST /tmm-affiliate/v1/agent-helper/shortcode) that emits only the five existing free shortcodes. No new public shortcode, no Amazon API calls, no database writes.

0.7.39

• Added a public-free regression guard for admin/editor metabox class drift so internal Tech My Money class names cannot enter the WordPress.org runtime unnoticed.
• Documented the free versus full plugin class-risk audit for this patch release.
• Kept the WordPress.org package boundary unchanged.

0.7.38

• Fixed Amazon token cache invalidation when administrators clear or save Amazon API settings so old credential-scoped access tokens are cleared before and after settings changes.
• Switched comparison tables to stacked comparison cards when the article content container is narrow, even on desktop/sidebar layouts.

0.7.37

• Reframed the admin dashboard, module manager, builder, diagnostics, and editor meta box around block-first setup instead of shortcode-first publishing.
• Added dashboard quick-start cards for Product Box, Deal Link, Link Embed, and Disclosure workflows.
• Added a clearer free package versus separate Pro workflow boundary without bundling paid code into the WordPress.org package.

0.7.35

• Hardened Amazon feature-bullet normalization so decorative 4-byte Unicode from catalog responses cannot prevent product data from being cached.
• Keeps cache-only public rendering stable when Amazon returns product bullets with database-unsafe characters.

0.7.34

• Fixed Best Picks grid card sizing so cached or mismatched item-count classes cannot collapse cards into narrow columns.
• Bumped frontend assets so browsers request the corrected layout CSS.

0.7.33

• Added first-class Gutenberg setup flows for Product Data Field and Affiliate Disclosure so the free publishing surface can be built from blocks instead of shortcode typing.
• Added quick-start preset buttons for Product Box, Deal Link, and Link Embed blocks.
• Replaced the editor preview's raw-shortcode fallback with a friendly setup placeholder.

0.7.32

• Rebalanced the WordPress.org package into a lean free core: Product Box, Deal Link, Link Embed, Data Field, Link Registry, disclosure, diagnostics, Credential Doctor, and cache refresh.
• Removed premium workflow surfaces from the free package UI and registrations, including grids, comparison tables, discovery lists, rating badges, Quick View builders, link-health automation, and analytics/reporting.
• Kept the tmmafbl_ / TMMAFBL_ prefix migration from 0.7.31.

0.7.31

• Renamed all plugin-owned identifiers from the short tmm prefix to tmmafbl_ / TMMAFBL_ (functions, classes, constants, options, transients, hooks, shortcodes, AJAX actions, post type, script handles, localized JS objects) per WordPress.org plugin review requirements. No functional changes.

0.7.30

• Fixed mobile AMP Link Embed images by scoping mobile resets away from AMP runtime image internals.
• Added lazy-load bypass markers to Link Embed images to match Product Box image behavior.
• Updated package tooling defaults and docs to target the current release version.

0.7.29

• Fixed mobile AMP product images in Product Box cards by narrowing CSS resets so AMP runtime image nodes keep their intrinsic sizing.
• Fixed clipped mobile product-card ribbons by positioning badges inside the card edge on narrow screens.
• Fixed mobile AMP comparison-card images by scoping comparison resets to card/body elements instead of every descendant.
• Bumped frontend asset version so production/mobile browsers request the corrected CSS.

0.7.24

• Fixed a Quick View payload escaping bug in Product Box output. Affected 0.7.22 and 0.7.23 builds could expose raw popup JSON on public posts when Quick View was enabled.
• Added a renderer regression guard so popup payloads must stay hidden/escaped and must not be passed through wp_kses_post() in a way that strips the wrapper.
• Tightened mobile product-card containment to prevent affiliate blocks from creating horizontal overflow.
• Tightened ASIN candidate parsing so cache refresh batches do not send word-like labels to Amazon.

0.7.23

• Removed paid-gated UI and server gates from the WordPress.org package; features that ship in the plugin are usable in the free build.
• Updated Plugin URI, contributor metadata, and Amazon External Services disclosures with Terms and Privacy links.
• Tightened the REST post-report permission callback so diagnostics require access to the specific post.

0.7.22

• Added admin UI screenshot regression checks for Dashboard, Modules, Amazon API, Template Builder, Diagnostics, and mobile frontend card rendering.
• Added ASIN cache inventory to the Amazon API admin screen with cache age, stale status, field coverage, and refresh/clear/copy actions.
• Improved Credential Doctor layout and next-step guidance.
• Improved Template Builder with a visual composer preview and cleaner multi-product badge/best-for input handling.
• Improved admin module and Template Builder previews with clearer mock product cards and manual retailer price cues.

0.7.21

• Improved the WordPress.org listing copy with practical editorial use cases.
• Added an Amazon API Credential Doctor with version, endpoint, source, cache, cooldown, last smoke-test, and support-safe copy diagnostics.
• Added FAQ guidance for Creators API versions, credential failures, and cache-first behavior during Amazon API changes.

0.7.20

• Fixed admin tab panels so hidden sections cannot remain visible when panel-specific display styles are present.

0.7.19

• Fixed admin builder checkbox sizing so checkbox controls no longer stretch like text fields.

0.7.18

• Improved the Modules admin screen with visual module previews and clearer module labels.

0.7.17

• Improved admin tab state syncing, dashboard quick-action highlighting, keyboard navigation, and accessible tab-panel markup.

0.7.16

• Converted the package plan to GPL-compatible WordPress.org packaging.
• Rewrote readme copy for public plugin users.
• Made click analytics disabled by default for privacy-first installs.
• Fixed Gutenberg block-only detection and automatic disclosure detection.
• Added uninstall cleanup.
• Tightened Amazon credential guidance and ASIN extraction.
• Stopped deriving savings when Amazon does not explicitly provide savings data.
• Reworked Quick View to use one shared modal.
• Moved click analytics to custom table storage with legacy option fallback.
• Improved focus states, reduced-motion support, optional dark-mode styling, and cache-miss states.
• Added Amazon Creators API endpoint diagnostics.
• Added archive/widget asset support.
• Documented click token replay behavior.
• Replaced production-looking partner tag examples.
• Added i18n and package-readiness files.

0.7.15

• Added broader affiliate/deal rendering, diagnostics, output controls, and editorial workflow surfaces.