| 开发者 | roesware |
|---|---|
| 更新时间 | 2026年10月8日 18:48 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
[art_in_ar_buttons] shortcode to place the button anywhere, with per-placement attributesnl_NL, nl_BE), German, French, Spanish, Italian, Portuguese (pt_PT, pt_BR), Japanese, Polish, Swedish, Danish and Russian. The AR preview page your customers see is available in 23 languages and follows the visitor's browser language. More translations are welcome at translate.wordpress.org.
artinar folder to /wp-content/plugins/ and activate it under Plugins. Then continue with step 3 above.
After setup
No. Activate the plugin, approve the connection once in the setup wizard and your store is connected. No sign-up, no email address and no keys to copy. An email address is optional and only needed if you want to sign in to the ArtInAR dashboard from another device, upload artwork by hand, or move to a paid plan. You can add it at any time without losing anything.
Yes, for up to 5 artworks. The free plan has no end date and needs no credit card, and its AR previews stay live on your product pages. The plugin itself is free and open source (GPL). Larger catalogues need a paid plan on the ArtInAR service, because the 3D models are generated and hosted there. See artinar.app for current plans.
ArtInAR converts as many products as your plan holds. The plugin tells you how many were left out and links to the plan picker. Artworks that already have AR keep it.
No. AR runs in the mobile browser using the AR viewer built into the phone: AR Quick Look on iPhone and iPad, Scene Viewer on Android. The visitor taps "View on your wall" and the artwork appears on their wall.
iPhones and iPads with iOS 12 or later, and most Android phones that support Google Play Services for AR (ARCore). That covers the large majority of phones in use. Devices without AR get a 3D preview they can rotate instead, and desktop visitors get a QR code to continue on their phone.
The model is built at the dimensions of your WooCommerce product (Product data → Shipping → Dimensions), in the unit your store uses. As long as those dimensions are right, the artwork appears at its real size. You can also adjust the dimensions per product in the ArtInAR dashboard.
By default, ArtInAR compares each product photo's proportions with the product's dimensions and picks the photo that matches the artwork. That way a photo of the work hanging in a room is not turned into a 3D model of that room. You can also pick the photo yourself in the "ArtInAR — image for the 3D model" box in the product editor.
The ones in the product categories you tick in the setup wizard. Conversion starts by itself the moment you connect. Tick nothing and every product in your store is included. Because the free plan covers 5 artworks, choosing the category that holds your work makes sure those five go to the right products.
Open Settings → Art In AR → Run setup wizard and adjust the categories on the Connect step. Saving sends the new selection to ArtInAR and starts converting straight away. Nothing that was already converted is lost.
Yes. Each variation can have its own 3D model, for example when you sell the same work in several sizes. The button follows the variation the customer selects.
The button is added through a standard WooCommerce hook, which works with most themes. If your theme or page builder (Elementor, Divi, Bricks, a block theme) does not show it where you want it, switch off automatic display and place the [art_in_ar_buttons] shortcode wherever you like.
No. The product page only loads a small script and stylesheet for the button. The 3D model loads only when a visitor opens the preview, on the ArtInAR preview page.
Yes. The in-app browsers of Facebook and Instagram cannot start AR themselves. The preview page detects this and shows a button that opens the page in the phone's normal browser, where AR works.
The button only appears once the product (or, for variable products, the selected variation) has a ready 3D model. Check the AR column in your Products list: "Queued" and "Processing" mean the model is still being made, "Failed" means the conversion did not work; the product editor shows why. If the column shows "No AR yet", make sure the product is in one of the categories you selected in the setup wizard and has a product photo.
Yes. Under Settings → Art In AR you can pick a different WooCommerce hook, or switch off automatic display and use the shortcode.
Yes. Under Settings → Art In AR → Appearance you choose the button style (follow your theme, filled, or outlined), an accent colour, the width, and whether an AR icon is shown. Each of these can be overridden for a single placement with a shortcode attribute.
[art_in_ar_buttons] accepts:
product_id — which product to show, so you can place the button on a page, post or template instead of only on the product page. Defaults to the current product.text — the button label for this placement.style — theme, filled or outline.color — accent colour as a hex code, for example #4f39f6.width — full or auto.icon — yes or no, to show the AR icon on the button.qr — yes or no, to show the QR code on desktop.qr_title and qr_note — the texts around the QR code.qr_color — the colour of the code itself as a hex code. Defaults to the accent colour, then to black.qr_bg — the background behind the code: a hex code, or transparent.qr_size — how large the code appears, in pixels (120–400).qr_style — rounded, square, dots or classy.qr_logo — URL of a small logo to place in the middle of the code.fallback — the text shown when neither AR nor the QR code is available.class — extra CSS classes on the wrapper.[art_in_ar_buttons product_id="123" style="filled" color="#4f39f6" width="auto"]
Anything you leave out follows your site-wide settings, so several placements can each look different on the same page. The settings screen lists every attribute, including the QR-card ones.
Yes. Under Settings → Art In AR you set the shape of the code, its size, colour (or a gradient), background, corner colour and an optional logo in the middle, plus the card around it: background, text colour, border, corner radius and shadow. A live preview shows the result as you type, and you get a warning when a colour combination is too light for phone cameras to read.
Not if you keep it modest. The plugin raises the error correction level as soon as a logo is set and keeps the logo to under a third of the code's width. A simple, square, high-contrast logo works best. Always scan the result with a real phone before you leave it live. If the logo image cannot be loaded, the code is drawn without it.
Yes. The plugin exposes five filters: artinar_should_display (render this placement at all), artinar_preview_url (the AR URL for a product), artinar_button_text (the label, per product), artinar_settings (all resolved settings for one placement) and artinar_markup (the final HTML).
In the product meta field art_in_ar_preview_url (the key can be changed under Settings → Art In AR). ArtInAR fills it automatically. The value is read with get_post_meta(), so an ACF field with the same key works too.
Deactivate the plugin, and revoke the ArtInAR key under WooCommerce → Settings → Advanced → REST API. ArtInAR can then no longer read your products.
No. The plugin adds no tracking, no ads and no external scripts to your product pages, and the QR-code library is bundled with the plugin. What the plugin does send to the ArtInAR service, and when, is listed under "External services" below.
qr_style, qr_size, qr_color, qr_bg.[art_in_ar_buttons] shortcode now takes a product, so you can place the AR button on pages, posts and templates instead of only on the product page itself.art_in_ar_preview_url meta key, instead of launching native AR directly. On-boarding and the 3D/AR experience now live on that page.