Optogrid Eyeglasses for WooCommerce
| 开发者 |
optogrid
saulogt |
|---|---|
| 更新时间 | 2026年10月1日 11:41 |
| PHP版本: | 8.0 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPLv3 or later |
| 版权网址: | 版权信息 |
详情介绍:
- Configurable Lens Builder — Multi-step UI for lens type, material, coatings, and tints with dynamic pricing.
- Rx Capture — Collect prescription data via form fields, or via document upload with a connected Optogrid account.
- PD Measurement — Manual PD entry or automated measurement via Optogrid photo analysis.
- Visual Flow Builder — Admin interface to configure lens journey steps, options, conditions, and pricing.
- Dynamic Pricing — Real-time price calculation with per-option deltas and formatted breakdowns.
- WooCommerce Integration — Works with cart, checkout, and order management. HPOS compatible.
安装:
- Upload the
optogrid-eyeglasses-for-woocommercefolder towp-content/plugins/. - Activate the plugin through the 'Plugins' menu in WordPress.
- Ensure WooCommerce is installed and active.
- Go to WooCommerce > Optogrid Eyeglasses to configure settings.
- Use the Setup Wizard to get started quickly.
屏幕截图:
常见问题:
Does this plugin require WooCommerce?
Yes. WooCommerce 8.0 or later is required.
Do I need an Optogrid account?
An Optogrid account is only required for the digital PD photo measurement feature. The plugin works without it using manual PD entry and Rx form fields.
Is this compatible with WooCommerce HPOS?
Yes. The plugin declares full compatibility with WooCommerce High-Performance Order Storage (custom order tables).
Does this work with block-based cart and checkout?
Yes. The plugin declares compatibility with WooCommerce block-based cart and checkout.
Which page builders and themes are supported?
The lens builder works on classic WooCommerce themes (hook-based product pages) and on WooCommerce Blocks (Gutenberg) product, cart, and checkout pages. Elementor is supported, including a dedicated integration for the Elementor Pro Single Product "Add to Cart" widget. Divi, Bricks, and WPBakery are not officially supported yet: on those builders the plugin falls back to a JavaScript injection that may not place the "Select Lens" button reliably. If your product pages are built with one of these, test on a staging site first.
Can customers buy more than one pair, or use product bundles and add-ons?
By default, eyeglasses products are sold individually (quantity locked to 1), because each pair is configured with its own prescription and lens options. You can turn this off under WooCommerce > Optogrid Eyeglasses > General ("Eyeglasses sold individually") if you need quantity-based add-ons. If you also enable ERP lens line items, the plugin adds the lens (and any add-ons) as separate cart lines. When a third-party bundle or composite plugin (such as WooCommerce Product Bundles or Composite Products) is already managing an eyeglasses product, the plugin detects this and does not inject its own child items, to avoid duplicates. Full interoperability with those extensions is not yet officially tested -- verify on a staging site.
What happens to my data if I uninstall the plugin?
Nothing is lost by default. Deleting the plugin removes its settings and Optogrid connection credentials, but preserves all order data -- prescriptions, PD measurements, and lens selections stay attached to your orders so your business records remain intact and past orders can still be fulfilled or referenced.
If you want a complete cleanup (for example on a test site), opt in before deleting the plugin by either defining the constant OPTOGD_REMOVE_ALL_DATA as true in wp-config.php, or setting the option via WP-CLI: wp option update optogd_erase_all_data_on_uninstall 1. With the opt-in active, uninstalling also erases all order-level plugin data, including customer prescriptions -- this cannot be undone.
Data previously sent to Optogrid (uploaded photos and measurement records) lives in your Optogrid account and is managed there; uninstalling the plugin does not delete it.
更新日志:
- New: support for the Optogrid free plan allowance. Photo upload and PD photo capture now work on every Optogrid plan. On the free plan, a store can open 5 customer photos for measuring in any 30 days; Premium removes the limit. The Optogrid tab in Settings shows how many free photos you have used and how many are waiting, with an upgrade link. An admin notice appears only when photos are waiting and the allowance is used up. Plan status refreshes on Test Connection, right after connecting, and hourly in the background.
- Shoppers never see plan or account state. If the store's Optogrid account cannot accept an upload (for example, invalid credentials or a cloned site), the builder removes the upload option, switches the shopper to manual entry, and shows a neutral message.
- Orders: a PD photo deleted unopened after 30 days is marked Expired, and a photo waiting on the plan allowance is flagged. Each adds one order note, and the order meta box offers the manual PD form for both. An expired photo never triggers a retake email to the shopper.
- Fixed: connecting a store through OAuth after using mock mode left the plugin in mock mode. The Optogrid tab showed "Connected" while every call still returned mock responses. Connecting now always switches to live mode.
- Fixed: Premium stores saw a "free plan: measurements disabled" notice in the Optogrid tab.
- Hardening: the two REST routes that cannot use a capability or nonce check — the Optogrid webhook and the tokenized PD re-upload link — now verify their credential (an HMAC-SHA256 signature and an order-bound expiring token) in the route's permission callback, so an unauthenticated request is rejected before the handler runs.
- Hardening: the builder's add-to-cart payload is sanitized after JSON decoding, and the nonce carried inside it is sanitized before it reaches wp_verify_nonce().
- Hardening: every remaining variable output in PHP is now escaped at the point of output, including the Rx/PD summary in the admin order email, which carries a shopper-supplied file name.
- Compliance: all plugin CSS and JavaScript is now delivered through the WordPress enqueue API instead of inline tags.
- Docs: corrected the free-vs-paid description. Prescription document upload requires a connected Optogrid account (the document is stored there), which earlier wording incorrectly listed as working without an account. Also documented the two fields the Optogrid service can send back (a replacement API address and a service notice), and the build recipe for reproducing /build/ from the shipped /src/.
- Mock (development) mode is hidden on production installs. It remains available on local, development and staging environments, or by defining OPTOGD_ALLOW_MOCK_IN_PROD.
- Translations are no longer bundled; they are delivered by translate.wordpress.org once available.
- Plugin renamed to "Optogrid Eyeglasses for WooCommerce".
- Fixed: the lens journey configuration was read on plugins_loaded, which loaded translations before init. On any locale with a translation installed this produced a "translation loading was triggered too early" notice on every request, and with WP_DEBUG display enabled it could print before headers were sent and block login.
- Security: bind the Optogrid connection to the site it was established on. A staging clone or migrated copy carrying live credentials now pauses all Optogrid calls until it is reconnected on the new address, protecting the original store's tenant and connection.
- Initial release.
- Configurable multi-step lens builder.
- Rx capture via form fields and document upload.
- PD measurement via manual entry and Optogrid photo analysis.
- Visual flow builder for lens journey configuration.
- Dynamic pricing with per-option deltas.
- WooCommerce HPOS and block checkout compatibility.