OAmazon v1.1.1

From WordPress admin

Manual install (FTP / SFTP)

Required credentials per locale

• Associates ID: your tracking tag (e.g. mysite-20)
• PA-API Access Key: issued by Amazon Associates Central
• PA-API Secret Key: paired with the access key

Each Amazon locale (US, UK, etc.) requires its own credentials. Stored encrypted in the wp_oam_programs table.

What the API client fetches

• Title, brand, bullet points
• Price (current, list, savings), currency
• Availability state
• Rating, review count
• Images (small, medium, large)
• Categories
• Affiliate URL with your tracking tag

Rate limiting & queueing

Amazon enforces 1 request/second per credentials. OAmazon tracks per-credentials throttle in transients. When the limit is hit, overflow requests are written to the oam_api_queue option and processed by cron in the next tick.

Caching

Successful PA-API responses are cached in wp_oam_products with a cached_at timestamp. Subsequent renders use the cache; refresh runs on a schedule to keep prices current.

Display styles

Every display type can be rendered in three style themes: light, dark, or orravo (the editorial theme). Set per-display in the admin or via shortcode attribute.

Detection priority

Country → locale map

Variant assignment

• Cookie-based: first impression sets oam_ab_* cookie, 30-day TTL
• Sticky: same visitor sees the same variant on every page load
• 50/50 split: random assignment for new visitors

Statistical significance

OAmazon runs a chi-square test on a 2×2 contingency table (variant A clicks/impressions vs variant B clicks/impressions) on every analytics page load. When p-value crosses the 0.95 threshold, the test status flips to resolved and the winner is recorded.

Pseudocode// Contingency table
//        Clicks  No-click
// A         a        b
// B         c        d
//
// chi² = ((a + b + c + d) × (ad − bc)²)
//      / ((a + b) × (c + d) × (a + c) × (b + d))
//
// significance = 1 − (1 − chi²_p_value)
// declare winner when significance >= 0.95

Test storage

Tests live in wp_oam_abtests with: name, two display IDs, accumulated clicks/impressions per side, current significance, status (draft, running, resolved), winner display ID, and timestamps.

Auto-injected disclosures

When a post contains an OAmazon affiliate link, the plugin auto-injects a disclosure based on context. Configurable per-context (post, widget, sidebar) with position (before / after) and active toggle.

Default disclosure (seeded on activation):

"This post contains affiliate links. As an Amazon Associate,
we earn from qualifying purchases at no extra cost to you."

Manual injection

Use the shortcode for finer placement:

[oam_disclosure context="post"]

ToS checker

Built-in compliance scanner runs on the admin dashboard and flags:

• Stale prices: cached price older than configured threshold
• Missing review counts: affiliate links lacking required attribution
• Price language: references like "the cheapest" or "the lowest" that violate Amazon ToS
• Missing disclosures: pages with affiliate links but no detected disclosure

Per-click stored fields

• link_id, post_id, display_id
• abtest_id, abtest_variant (when click is part of an active test)
• ip_hash, user_agent_hash (hashed for privacy)
• country_code (from geo detection)
• device_type (mobile / desktop / tablet)
• referrer URL
• created_at timestamp

Dashboard reports

• Summary: total clicks, unique links, top product, device breakdown
• Time series: clicks-over-time line chart, 30-day or weekly rollup
• Top products: clicks grouped by ASIN
• Top posts: clicks grouped by source post
• Geo: distribution by country (top 30)
• Device: mobile / desktop / tablet split

Render a saved display

[oam_display id="123"]

References a display configured in the admin. Inherits all settings from the saved display row.

Render an inline display

[oam_product asin="B08N5WRWNW" display="card" style="orravo"]

Renders a one-off display without saving it. Accepts asin (single) or asins (comma-separated for multi-ASIN displays like comparison), display (any of the 15 types), style (light, dark, orravo), and locale.

Inline price & button

[oam_price asin="B08N5WRWNW"]
[oam_button asin="B08N5WRWNW" text="Check current price"]

[oam_price] outputs the cached current price for the visitor's locale. [oam_button] outputs a CTA link routed through the cloaked tracker URL.

FTC disclosure

[oam_disclosure context="post"]

Gutenberg block

A custom Gutenberg block called OAmazon Display is registered for visual placement in the block editor. The block UI exposes display selection, ASIN entry, style picker, and inline preview.

WP-CLI commands

Registered when running under WP-CLI as wp oamazon <command>. Five command namespaces:

Database tables

REST API endpoints

Namespace: oamazon/v1. Admin endpoints require manage_options; public endpoints are open (rate-limited at the link / display layer).

Admin menu

Top-level menu at admin.php?page=oamazon. Tabs: Dashboard, Products, Links, Displays, Analytics, Content, Compliance, Settings. When Orravo Core is active, the menu nests under the unified Orravo dashboard and registers with the Cmd+K command palette.