TMM Affiliate Blocks
| 开发者 | mjcity |
|---|---|
| 更新时间 | 2026年7月12日 12:26 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
TMM Affiliate Blocks helps publishers build clear, mobile-friendly affiliate product modules without hand-coding every article. Use it for product boxes, quick deal links, compact link embeds, reusable affiliate destinations, disclosures, diagnostics, and cache-first Amazon-backed fields.
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.
The plugin includes:
- Product Box Gutenberg setup and advanced fallback output.
- Deal Link and Link Embed surfaces for quick product mentions.
- Manual retailer links with editor-provided values.
- Basic 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/accessibility-safe frontend rendering with focus states and reduced-motion support.
安装:
- Upload the
tmm-affiliate-blocksdirectory to/wp-content/plugins/, or install it from the WordPress plugin directory when available. - Activate the plugin in WordPress.
- Open TMM Affiliate in wp-admin.
- Review Output, Modules, Link Registry, Amazon API, and Diagnostics.
- Add Amazon Creators API credentials only if your site is approved to use them.
- Insert the TMM Affiliate Disclosure block or enable automatic disclosure insertion before publishing affiliate content.
- Test on staging before deploying to a production site.
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.屏幕截图:
常见问题:
Does this plugin scrape Amazon?
No. Amazon product data is expected to come from supported Amazon API responses and the plugin cache. The plugin does not scrape Amazon pages.
Does public rendering call the Amazon API?
Public cache-only rendering is enabled by default. Logged-out visitors should see cached Amazon data or a clean fallback state, not live API requests.
Which Amazon Creators API versions are supported?
The Amazon settings screen supports version-aware Creators API token routing for v3.1, v3.2, and v3.3 credential versions. Unknown versions fall back to the v3.1 token endpoint and should be checked with the Credential Doctor before publishing API-backed modules.
What should I do if Amazon credentials fail?
Open TMM Affiliate > Amazon API and use the Credential Doctor. It shows the configured credential version, masked credential ID, credential source, token endpoint, marketplace, cache-only setting, cooldown state, and last smoke-test result. The copy-safe diagnostic packet intentionally omits secrets, tokens, cookies, full tracking IDs, user profiles, and affiliate destination URLs.
Can I use non-Amazon retailer links?
Yes. Deal Link and Link Embed support approved manual retailer URLs. Manual values are editor-provided and should not be described as live API data.
Does the plugin include click tracking?
No. The WordPress.org package focuses on the free publishing blocks and diagnostics. Analytics/reporting workflows belong in the separate Pro add-on.
Can developers extend the plugin?
Yes. The package exposes GPL-compatible hooks for module definitions, server-rendered block definitions, frontend asset detection, admin tabs, and admin panels.
更新日志:
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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- Renamed all plugin-owned identifiers from the short
tmmprefix totmmafbl_/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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- Fixed admin tab panels so hidden sections cannot remain visible when panel-specific display styles are present.
- Fixed admin builder checkbox sizing so checkbox controls no longer stretch like text fields.
- Improved the Modules admin screen with visual module previews and clearer module labels.
- Improved admin tab state syncing, dashboard quick-action highlighting, keyboard navigation, and accessible tab-panel markup.
- 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.
- Added broader affiliate/deal rendering, diagnostics, output controls, and editorial workflow surfaces.