SAM
Menu

Platform

Defyn SAM for WordPress & WooCommerce.

Drop-in WordPress plugin that connects WooCommerce to your SAM tenant. Battle-tested at art centres from the Central Desert to Arnhem Land. Standard WP plugin install (no FTP, no Composer required on your end), HPOS-compatible orders, encrypted credentials at rest, and a dashboard that surfaces every sync result.

The pain

Why WooCommerce centres typically end up here.

  • Free or generic catalogue-import plugins don't understand SAM's structure — categories nest weirdly, artist metadata loses cultural context, edition runs collapse into one product.
  • DIY WordPress imports require a developer to keep working when SAM changes a field, when WooCommerce updates its HPOS table layout, or when WordPress drops PHP-7 support.
  • Hosted SaaS catalogue connectors charge per-product/month and don't reconcile Australian GST correctly — leaving the centre's accountant to fix split errors manually at end-of-month.
What it does

Production-grade WordPress plugin built specifically for the SAM-WooCommerce stack.

  • Standard WP plugin: download a zip, upload via Plugins → Add New, activate. Updates pull automatically from a private auto-updater (no FTP, no Composer on your end).
  • HPOS-compatible: orders push to SAM via WooCommerce's new high-performance orders schema. Future-proof against WC's 2026+ HPOS-only direction.
  • Encrypted at rest: SAM API credentials, license key, and webhook secret are sealed with AES-256-GCM keyed off WordPress's AUTH_KEY salt. A leaked DB backup can't be used to forge requests.
  • Standard WordPress conventions: custom post types for artists, custom taxonomies for SAM categories, Action Scheduler for paginated syncs. Anyone who knows WordPress can read the codebase.
How it works

Install. Connect. Map. Sync.

  1. 01

    Install the plugin

    Plugins → Add New → Upload Plugin → defyn-sam-plugin.zip → Activate. PHP 8.1+, WordPress 6.5+, WooCommerce 9.0+ supported.

  2. 02

    Register your site

    On first activation, paste the license key we provide into the Registration tab. The plugin registers with the Defyn licence registry and an encrypted certificate is stored locally.

  3. 03

    Connect to SAM

    Defyn SAM → Settings. Enter SAM API base URL, your tenant username, and password OR static token. Test the connection from the same screen.

  4. 04

    Map your categories

    Defyn SAM → Category Mapping. Define display buckets, drag SAM categories in. Save — takes effect on next sync.

  5. 05

    Sync All

    Defyn SAM → Sync Dashboard → Sync All. Categories run inline (fast); artists, artworks, editions, products queue via Action Scheduler. Watch Tools → Scheduled Actions for live progress.

  6. 06

    Set a recurring schedule

    Optionally configure the recurring sync (hourly, every 3/6/12/24 hours, or manual-only). Stock changes don't wait for the schedule — they arrive via SAM webhook within seconds.

Where it kicks in

Live at WordPress centres today.

Scenario: A centre on WP Engine had previously been syncing via manual CSV exports — slow, error-prone, and dependent on one staff member who knew the spreadsheet.

Result: After installing Defyn SAM, sync runs every 6 hours automatically. New artworks appear on the storefront within that window, stock updates within seconds via webhook. The staff member's CSV workflow is retired.

Scenario: A centre's $400 painting was hitting SAM's books as $363.64 + $36.36 GST — wrong (SAM ships artworks GST-exempt). Their bookkeeper flagged the mismatch every month.

Result: Defyn SAM reads the SAM gst_amount flag per product and reconciles correctly: ExGST=$400 for the exempt artwork. SAM's invoice math reconciles. No more red highlights in the monthly review.

Scenario: A centre on a shared host (1GB storage quota) was running out of disk every few months because SAM's 5000px photos accumulated in /wp-content/uploads/.

Result: Set max_image_width to 1500. Subsequent sync cycles save 70-80% disk per image. The orphan-media cleanup tool wiped years of pre-v1.14 attachments that wp_delete_post had left behind. Storage usage dropped from 1.2 GB to 380 MB.

Questions

Frequently asked.

Does it work on managed WordPress hosts?

Yes — tested on WP Engine, Kinsta, SiteGround, Cloudways, DreamHost, and self-hosted LAMP. WP Engine's CloudFront layer needs SAM's outbound IPs allowlisted at the WAF, which we help organise during onboarding. Hosts without PHP sodium extension (rare on modern PHP 8) get a clear admin notice instead of silent failure.

What WordPress / WooCommerce versions are supported?

WordPress 6.5+, PHP 8.1+, WooCommerce 9.0+. HPOS-compatible (declared via FeaturesUtil). Tested on the latest WordPress 6.9. We track WC's HPOS direction — when WC removes the legacy orders table, the plugin keeps working.

How are updates delivered?

Built-in auto-updater. The plugin polls a private update manifest once a day (or instantly on "Check Again" in Dashboard → Updates). When a new release is available, the standard WordPress "Update Now" button appears. No FTP, no manual zip uploads.

Will it conflict with my existing WC plugins (Elementor, Yoast, etc.)?

Not in any deployment we've seen. The plugin only writes to WC products, custom post types it owns (artist, sam_log), and a single namespaced options blob. It doesn't hook into the front-end or alter WC's checkout flow.

What's the recovery path if a sync goes wrong?

Three layers. (1) Every sync action is logged with created/updated/failed counts in Sync Dashboard. (2) A Factory Reset button wipes every SAM-origin product, artist, and category (manual products untouched) so you can rehydrate from scratch. (3) Defyn provides direct support — phone, email, or screen-share.

Can I trial it without subscribing?

Yes — we run a guided proof-of-concept against a single SAM product category in your tenant. You see real sync output against your actual data before signing anything. Contact us to set one up.

See it in your tenant.

Want a 15-minute screenshare against your actual SAM data? Send us a quick note or call — we’ll line up a walkthrough at a time that suits.