=== iJewel3D ===
Contributors: ijewel3d
Tags: 3d, jewelry, product configurator, 3d viewer, woocommerce
Requires at least: 6.6
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
WC requires at least: 10.0
WC tested up to: 11.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Your iJewel designs in 3D on WooCommerce products, following the metal and stone the shopper picks, and ring configurators priced by iJewel.

== Description ==

* Sign in to your iJewel account (Products › iJewel 3D).
* On a product, in its iJewel 3D tab, choose a design from your account. For a product with variations, match each value (Yellow Gold, Ruby) to a material of the design: most are matched for you. The product page gets a "3D" button over the main photo, and the 3D follows the variation the shopper picks.
* Many products at once: Products › All Products, select them, Bulk actions › Match 3D designs.
* Your iJewel configurators become products with one click (Add to store). The shopper builds the ring on the product page, in your theme's style or as the iJewel configurator, and adds it to the cart at the price iJewel gives for that build. The order keeps the build, its SKU and a link to the exact ring in iJewel.
* Settings: WooCommerce › Settings › Products › iJewel 3D.
* Works with classic themes and block themes, the classic and the block cart and checkout, and HPOS.

You need an iJewel account (https://ijewel3d.com).

== External service ==

This plugin is the store's side of the iJewel service (https://ijewel3d.com), run by iJewel3D. It calls iJewel only for what you ask it to do:

* When you sign in, in the admin: your iJewel email and password go to the iJewel server of your workspace (https://drive-weur-1.app.ijewel3d.com for iJewel Drive). The password is not kept; your browser keeps iJewel's sign-in (a token it renews) until you sign out, and it shows in your account's sessions on iJewel. Your site's address is added to your account's domains, so your prices answer your store.
* In the admin: the list of your account's folders, designs and configurators, and the public record of a design (its name, picture and 3D file, to list its materials). For each configurator, your store's server also reads its public record and asks its price server for the default build's price.
* On a configurator product, when a shopper picks a choice, adds the build to the cart, and again at the cart and at checkout: your store's server reads the configurator's public record from the iJewel server of your workspace, and sends the build (its choices) to the configurator's price server (https://configurator.apps.ijewel.info) to get its price. No shopper's personal data is sent.
* On the product page: the 3D is iJewel's own page (https://ijewel3d.com) in a frame. On desktop it loads after the page when "Load in the background" is on; on phones only when the shopper taps "3D".

Terms of service: https://ijewel3d.com/terms/. Privacy policy: https://ijewel3d.com/privacy-policy/.

== Installation ==

1. Upload the plugin (Plugins › Add Plugin › Upload Plugin) and activate it. WooCommerce must be active.
2. Products › iJewel 3D: sign in with your iJewel email and password (signed up with Google? set a password with "Forgot password?" first). This adds your site's address to your account's domains. Your site address must be https.
3. A product: its iJewel 3D tab › Choose a design. Update the product.
4. A configurator: Products › iJewel 3D › Add to store (publish it and share it as "Anyone with the link" in iJewel first). The product is a draft: publish it when it is ready.

== Frequently Asked Questions ==

= The configurator says "This item cannot be ordered online right now". =

The configurator is not published, or not shared as "Anyone with the link", in iJewel, or the product has no configurator. Publish and share it in iJewel, then check it on Products › iJewel 3D.

= The 3D does not change with the metal. =

Match the values in the product's iJewel 3D tab, and give the design material variations in iJewel.

= Does it work in other languages, and with WPML or Polylang? =

The plugin's words can be translated (text domain ijewel3d). A configurator shows its steps and options in the shopper's language when the configurator has a translation for it in iJewel; otherwise in the configurator's own language. With WPML or Polylang, a product's translation shows the original's 3D: the plugin's wpml-config.xml copies the 3D fields to each translation, and the matches are set once, on the original. iJewel's own configurator panel (the look "iJewel configurator") is in the configurator's own language.

== Changelog ==

= 1.0.0 =
* First release.
