Epox Connector for WooCommerce
| 开发者 | epoxtech |
|---|---|
| 更新时间 | 2026年9月5日 04:58 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPL-2.0-or-later |
| 版权网址: | 版权信息 |
详情介绍:
- One call per sync. Download, media-library registration, gallery placement and metadata all happen server-side in one request.
- Safe retries. Every media item carries an idempotency key. If Epox retries a sync, the plugin returns the attachment it already created instead of importing a second copy.
- All-or-nothing. If any part of a sync fails, attachments created during that request are removed. A failed sync leaves no orphans in your media library.
- Video support. Product video can be imported and linked to your gallery plugin's
metadata, which the standard WooCommerce product API has no way to express. The video file
itself can be imported into your media library — not just referenced by URL — verified
against "WooCommerce Gallery Slider" (
gallery-slider-for-woocommerce, formerly WooGallery). - Variation images. One generated image can be assigned across several variations without importing it more than once.
安装:
- Upload the plugin zip via Plugins → Add New → Upload Plugin, or extract it into
wp-content/plugins/. - Activate Epox Connector for WooCommerce. WooCommerce must already be active — WordPress will tell you so and block activation otherwise.
- In Epox, connect the store as usual using a WooCommerce API key with Read/Write permissions. Epox detects the connector automatically.
常见问题:
Do I need a separate API key or password?
No. The plugin registers its routes with WooCommerce's own authentication, so the consumer key and secret you already gave Epox authorise these endpoints too.
What permissions does it require?
The API key's user must be able to edit products (shop manager or administrator, with a Read/Write key). Every request is also checked against the specific product being changed.
My gallery plugin shows videos from a custom field. Will this work?
Probably, and if not it is one filter away. The plugin writes the video URL to its own
_epox_video_url field plus a configurable list of third-party keys — wcgs_video and
_product_video_url by default. To target a different key, add to the
epox_video_meta_keys filter or set the epox_video_meta_keys option.
wcgs_video is not a guess: it is the exact key "WooCommerce Gallery Slider" reads off the
gallery image's own attachment (get_post_meta( $image_id, 'wcgs_video', true )), confirmed
against that plugin's real source.
Does the video need to already be hosted somewhere, or can Epox upload it here?
Either. Send video_url (a string) to point at an already-hosted video — nothing is
downloaded, the URL is written to your gallery plugin's meta as-is. Send video (an object
with a url) to have this plugin import the video file itself into your media library, the
same way it imports images, then write that attachment's own URL as the meta value. The
two are mutually exclusive on one media item.
Will it delete my own product photos?
No. Removal only ever deletes files this plugin imported; anything you uploaded yourself is detached from the product but left in your media library.
Can it fetch media from anywhere on the internet?
Only over HTTPS, and only from public hosts — WordPress's own URL safety checks apply. To
restrict it further to specific hostnames, use the epox_allowed_media_hosts filter.
更新日志:
- The Try-On widget now hides itself on your storefront whenever it cannot load, instead of showing shoppers an error they cannot act on. Nothing is lost: when you are logged in with permission to manage the store, the same failure is spelled out in place — what happened, what to do about it, and a note that your customers see none of it.
- That answer is computed on the permit request, not baked into the page, so a full-page cache warmed by an admin can never show the diagnostic message to a shopper.
- Forwards the platform's new "store is not connected to a workspace" code.
- A permit rejection that can never succeed on retry — the platform does not recognise this
store's widget key, or the bridge credential has been rotated away — now retires the stored
bridge instead of failing every storefront request forever.
[epox_tryon]renders nothing until Epox reconfigures it (re-enable Try-On in your workspace), rather than showing shoppers an error only you can fix. - Logs the issuer's status and error code to the PHP error log under
WP_DEBUG, so a broken Try-On install can be diagnosed from the store instead of guessing at a generic 503.
[epox_tryon]now forwards specific "widget disabled" / "out of try-on credits" errors from the platform instead of collapsing every failure into a generic unavailable message — lets the storefront loader hide the widget silently in those expected cases rather than showing an error.- Reserves the widget's aspect ratio up front to avoid a layout shift once it mounts.
- Adds the
[epox_tryon]shortcode. Place it anywhere — product description, a text widget, a page builder's shortcode block — and it renders the storefront widget itself; the workspace's publishable widget key is stored server-side at enable-time and never needs to be copied.
- Adds the server-side Try-On permit bridge for connected stores. Epox configures the connector through its existing authenticated API; storefront code receives only a short-lived permit.
media-detachwithdelete_filesnow also removes the video file an imported thumbnail points at. Previously only the thumbnail itself was deleted, orphaning the raw video attachment in the media library on every video removal.
media-syncitems accept avideoobject (in addition to the existingvideo_urlstring) to import the video file itself into the media library — not just reference an already-hosted URL — then write the imported attachment's own URL as the video meta. Idempotent and rolled back atomically along with its thumbnail, same as everything else. Newvideo_uploadcapability reported bystatus.
- Initial release:
status,media-syncandmedia-detachendpoints, idempotent media import, atomic rollback, video metadata bridging and variation image assignment.