{"id":339134,"date":"2026-08-10T22:48:19","date_gmt":"2026-08-10T22:48:19","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/ar-button-ar-product-preview-configurator\/"},"modified":"2026-08-10T22:47:46","modified_gmt":"2026-08-10T22:47:46","slug":"arbutton","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/arbutton\/","author":23531174,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.6","stable_tag":"1.0.6","tested":"7.0.3","requires":"5.8","requires_php":"7.4","requires_plugins":null,"header_name":"AR Button \u2013 AR Product Preview & Configurator","header_author":"AR Button","header_description":"Let your customers preview and configure products in augmented reality \u2014 right in the browser, no app needed. Works with WooCommerce, Gutenberg, Elementor and shortcodes.","assets_banners_color":"dacf94","last_updated":"2026-08-10 22:47:46","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/www.ar-button.com","header_author_uri":"https:\/\/www.ar-button.com\/privacy-policy\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":41,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.6":{"tag":"1.0.6","author":"arbutton","date":"2026-08-10 22:47:46"}},"upgrade_notice":{"1.0.6":"<p>Plugin Check warning fixes (languages path, image source context).<\/p>","1.0.5":"<p>Directory assets removed from plugin zip; external services documented in readme.<\/p>","1.0.4":"<p>Packaging cleanup for WordPress.org automated checks.<\/p>","1.0.3":"<p>Plugin and author URIs are now distinct for WordPress.org compliance.<\/p>","1.0.2":"<p>Shortcode tag is <code>[arbutton]<\/code>. If you still use <code>[ar_button]<\/code>, update to <code>[arbutton]<\/code>.<\/p>","1.0.1":"<p>Prefix and shortcode aligned to <code>arbutton<\/code>. Update shortcodes from <code>[ar_button]<\/code> to <code>[arbutton]<\/code> if needed.<\/p>","1.0.0":"<p>Initial release. Install, enter your API key, done.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3641189,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3641189,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3641189,"resolution":"1544x500","location":"assets","locale":"","width":1024,"height":331},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3641189,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":{"arbutton\/ar-button":{"$schema":"https:\/\/schemas.wp.org\/trunk\/block.json","apiVersion":3,"name":"arbutton\/ar-button","version":"1.0.6","title":"AR Button","category":"embed","icon":"visibility","description":"Displays an AR Button for 3D \/ augmented reality product previews.","keywords":["ar","augmented","reality","3d","button"],"textdomain":"arbutton","attributes":{"imageId":{"type":"number","default":0},"imageUrl":{"type":"string","default":""},"autoImage":{"type":"boolean","default":true},"imageSource":{"type":"string","default":""},"template":{"type":"string","default":""},"showControls":{"type":"boolean","default":false},"extra":{"type":"string","default":""},"advanced":{"type":"object","default":{}}},"supports":{"html":false,"align":["wide","full"]},"editorScript":"arbutton-block-editor"}},"tagged_versions":["1.0.6"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"AR Product Preview and Configurator \u2014 customers preview products on their wall and configure frame, print, finish and mat color in real time","2":"Digital Twin AR Viewer \u2014 place a true-to-scale digital twin of any room or space in augmented reality","3":"Garden House AR Configurator \u2014 customers choose type, roof style and wall cladding, then see the result live in AR","4":"Solar Carport AR Configurator \u2014 configure modules, colors, materials, dimensions and offsets with live AR feedback","5":"Textile and Clothing AR Preview \u2014 preview fabrics and clothing items in augmented reality","6":"AR Quick Look on iOS \u2014 framed art viewed as a 3D object, rotatable and zoomable on any surface","7":"Live AR Wall Preview \u2014 a framed art print placed on a real wall using the phone camera","8":"True-to-Scale AR Preview \u2014 framed artwork shown at exact dimensions in a real room","9":"Rollup Display in 3D \u2014 banner stands and rollup displays rendered in a realistic environment","10":"Print Products in 3D \u2014 business cards, flyers, folders and rollups displayed together"}},"plugin_section":[],"plugin_tags":[147394,147393,39420,45083,286],"plugin_category":[45],"plugin_contributors":[275086],"plugin_business_model":[],"class_list":["post-339134","plugin","type-plugin","status-publish","hentry","plugin_tags-ar","plugin_tags-augmented-reality","plugin_tags-product-configurator","plugin_tags-product-preview","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-arbutton","plugin_committers-arbutton"],"banners":{"banner":"https:\/\/ps.w.org\/arbutton\/assets\/banner-772x250.png?rev=3641189","banner_2x":"https:\/\/ps.w.org\/arbutton\/assets\/banner-1544x500.png?rev=3641189","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/arbutton\/assets\/icon-128x128.png?rev=3641189","icon_2x":"https:\/\/ps.w.org\/arbutton\/assets\/icon-256x256.png?rev=3641189","generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>AR Button adds an augmented reality product preview to any WordPress site. Your customers tap the button, point their phone camera at a wall or floor, and see the product at true scale in their own space \u2014 directly in the mobile browser, no app download required.<\/p>\n\n<p><strong>Works with any product that has a front image:<\/strong> posters, framed art, canvas prints, wallpaper, tiles, flooring, carpets, wall decals, doors, fences, garden houses, carports, packaging, signage, rollups, business cards, flyers and more. Use it on WooCommerce product pages, Elementor layouts, Gutenberg pages, or any WordPress page with a shortcode.<\/p>\n\n<h4>AR Product Preview &amp; Configurator<\/h4>\n\n<p>For simple products (posters, prints, rollups), AR Button works as a true-to-scale preview \u2014 customers see the exact product on their wall before ordering. For configurable products (tiles, doors, fences, garden houses, carports), enable the built-in AR controls and it becomes a full product configurator \u2014 your customers can change colors, frame styles, materials, dimensions and finishes interactively, and see every change live in augmented reality.<\/p>\n\n<h4>Why AR Button?<\/h4>\n\n<ul>\n<li><strong>Reduce returns<\/strong> \u2014 customers see the real size and how it looks in their room before ordering<\/li>\n<li><strong>Increase conversions<\/strong> \u2014 interactive AR previews keep visitors engaged and build buying confidence<\/li>\n<li><strong>No app needed<\/strong> \u2014 runs 100% in the mobile browser (iOS Safari, Android Chrome)<\/li>\n<li><strong>No file upload<\/strong> \u2014 images are loaded via URL, nothing is uploaded to any server<\/li>\n<li><strong>100% GDPR-compliant<\/strong> \u2014 fully client-side, no personal data collected or processed<\/li>\n<li><strong>One-click WooCommerce<\/strong> \u2014 enable auto-embed on all product pages with a single checkbox<\/li>\n<\/ul>\n\n<h4>How It Works<\/h4>\n\n<ol>\n<li>Install the plugin and enter your free API key<\/li>\n<li>Choose where the AR button appears (after Add to Cart, in the product summary, or anywhere via shortcode)<\/li>\n<li>The plugin automatically uses your product image \u2014 no manual setup per product<\/li>\n<li>Customers tap the button, point their camera, and see the product at real scale on their wall<\/li>\n<\/ol>\n\n<p>On desktop, a QR code is shown so customers can instantly open the AR preview on their phone.<\/p>\n\n<h4>Three Ways to Place the Button<\/h4>\n\n<ul>\n<li><strong>WooCommerce auto-embed<\/strong> \u2014 one checkbox, every product page gets an AR button automatically<\/li>\n<li><strong>Gutenberg block<\/strong> \u2014 drag and drop the AR Button block into any page or post<\/li>\n<li><strong>Elementor widget<\/strong> \u2014 full AR Button widget with all options in the Elementor editor<\/li>\n<li><strong>Shortcode<\/strong> \u2014 <code>[arbutton]<\/code> works anywhere, with full attribute control<\/li>\n<\/ul>\n\n<h4>Built for Developers<\/h4>\n\n<p>AR Button is a native Web Component (<code>&lt;ar-button&gt;<\/code>). Every product attribute \u2014 size, color, frame style, texture, finish \u2014 is controlled via DOM attributes and can be changed dynamically in real time. Six WordPress filters let you extend templates, image sources, and loader URLs without touching plugin code.<\/p>\n\n<h4>Product Templates<\/h4>\n\n<p>Pre-configured product types for one-click setup:<\/p>\n\n<ul>\n<li><strong>Poster<\/strong> \u2014 flat prints, photos, art prints<\/li>\n<li><strong>Framed image<\/strong> \u2014 framed art with customizable frame color, material, finish, passepartout and glass<\/li>\n<li><strong>Door<\/strong> \u2014 interior and exterior doors with placement pane<\/li>\n<li><strong>Rollup<\/strong> \u2014 banner stands and rollup displays<\/li>\n<li><strong>Business card<\/strong> \u2014 front and back preview<\/li>\n<li><strong>Flyer \/ Folder<\/strong> \u2014 brochures and folders<\/li>\n<li><strong>Packaging<\/strong> \u2014 product boxes and packaging<\/li>\n<\/ul>\n\n<h4>Automatic Image Sources<\/h4>\n\n<p>No need to set images manually. The plugin resolves the product image automatically from:<\/p>\n\n<ul>\n<li>WooCommerce main product image<\/li>\n<li>WooCommerce gallery (first or last image)<\/li>\n<li>WordPress featured image<\/li>\n<li>Custom field (post meta)<\/li>\n<li>ACF image field<\/li>\n<\/ul>\n\n<h4>Full Styling Control<\/h4>\n\n<p>Match the AR button to your shop design. All colors (primary, hover, active), border radius, border width, and text size are configurable from the admin panel \u2014 or override per button via shortcode attributes.<\/p>\n\n<h4>Who Is This For?<\/h4>\n\n<ul>\n<li><strong>Print shops &amp; online printers<\/strong> \u2014 posters, canvas prints, photo products, business cards, flyers<\/li>\n<li><strong>Art galleries &amp; frame shops<\/strong> \u2014 framed art, canvas, limited editions<\/li>\n<li><strong>Home &amp; interior retailers<\/strong> \u2014 wallpaper, tiles, flooring, carpets, wall decals<\/li>\n<li><strong>Outdoor &amp; construction<\/strong> \u2014 doors, garden fences, garden houses, carports, signage<\/li>\n<li><strong>Trade show &amp; display<\/strong> \u2014 rollups, banners, booth graphics, exhibition displays<\/li>\n<li><strong>Packaging &amp; merchandise<\/strong> \u2014 product boxes, custom merch, promotional items<\/li>\n<li><strong>Any e-commerce shop<\/strong> \u2014 WooCommerce, or any WordPress site with product images<\/li>\n<\/ul>\n\n<p>AR Button works on any WordPress site. WooCommerce integration is built in but optional. The AR Button Web Component also works with Shopify, Shopware, Magento, Webflow and plain HTML (outside of this plugin).<\/p>\n\n<h4>Links<\/h4>\n\n<ul>\n<li><a href=\"https:\/\/www.ar-button.com\">Website &amp; Live Demo<\/a><\/li>\n<li><a href=\"https:\/\/api.ar-button.com\/v1\/readme\/README.md\">Documentation<\/a><\/li>\n<li><a href=\"https:\/\/www.ar-button.com\/#pricing\">Get your free API key<\/a><\/li>\n<li><a href=\"mailto:peter@ar-button.com\">Support<\/a><\/li>\n<\/ul>\n\n<h3>External services<\/h3>\n\n<p>This plugin relies on the AR Button service (provided by the plugin author) to display augmented reality product previews. Without these external resources, the AR button cannot load or run.<\/p>\n\n<h4>CDN (cdn.ar-button.com)<\/h4>\n\n<p>The plugin loads the AR Button JavaScript loaders from <code>https:\/\/cdn.ar-button.com<\/code> whenever an AR Button is rendered on the front end (or previewed in the admin settings). These scripts are required to register the <code>&lt;ar-button&gt;<\/code> \/ <code>&lt;ar-button-controls&gt;<\/code> web components and start the AR experience.<\/p>\n\n<p>When the scripts are requested, the visitor's browser performs a normal HTTPS request to the CDN (standard request metadata such as IP address and User-Agent may be processed by the CDN for delivery and security). No WordPress site content or customer account data is uploaded by the plugin for this request.<\/p>\n\n<p>Service provider: AR Button\nTerms of service: https:\/\/www.ar-button.com\/terms\/\nPrivacy policy: https:\/\/www.ar-button.com\/privacy-policy\/<\/p>\n\n<h4>API (api.ar-button.com)<\/h4>\n\n<p>After the loaders are loaded, the AR Button scripts connect to <code>https:\/\/api.ar-button.com<\/code> to validate the configured Public Key and to provide AR preview functionality (including product image URLs and product configuration attributes such as dimensions, colors, and template settings that are set on the button).<\/p>\n\n<p>This happens when a visitor views a page that contains an AR Button and interacts with \/ opens the AR preview. The Public Key configured in the plugin settings is included so the service can identify the site account and apply plan limits.<\/p>\n\n<p>Service provider: AR Button\nTerms of service: https:\/\/www.ar-button.com\/terms\/\nPrivacy policy: https:\/\/www.ar-button.com\/privacy-policy\/<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the <code>arbutton<\/code> folder to <code>\/wp-content\/plugins\/<\/code>, or install directly from the WordPress plugin directory<\/li>\n<li>Activate the plugin through the <strong>Plugins<\/strong> menu<\/li>\n<li>Go to <strong>AR Button<\/strong> in the sidebar and enter your Public Key (get a free one at <a href=\"https:\/\/www.ar-button.com\/#pricing\">ar-button.com<\/a>)<\/li>\n<li>For WooCommerce: enable <strong>Show button automatically on product pages<\/strong> in the WooCommerce section<\/li>\n<\/ol>\n\n<p>That's it. Every product page now has an AR preview button.<\/p>\n\n<!--section=faq-->\n<dl>\n<dt id=\"do%20my%20customers%20need%20to%20download%20an%20app%3F\"><h3>Do my customers need to download an app?<\/h3><\/dt>\n<dd><p>No. AR Button works directly in the mobile browser. Your customers tap the button on your product page and the AR preview opens instantly \u2014 no download, no setup, no friction.<\/p><\/dd>\n<dt id=\"is%20it%20free%3F\"><h3>Is it free?<\/h3><\/dt>\n<dd><p>The Starter plan is free \u2014 100 AR previews per month, no credit card required. Paid plans start at \u20ac49\/month. Get your free API key at <a href=\"https:\/\/www.ar-button.com\/#pricing\">ar-button.com<\/a>.<\/p><\/dd>\n<dt id=\"does%20it%20work%20with%20woocommerce%3F\"><h3>Does it work with WooCommerce?<\/h3><\/dt>\n<dd><p>Yes. Enable the WooCommerce auto-embed with one checkbox and every product page gets an AR button automatically. The plugin uses the product's main image (or gallery image) \u2014 no manual configuration needed per product.<\/p><\/dd>\n<dt id=\"which%20devices%20support%20ar%3F\"><h3>Which devices support AR?<\/h3><\/dt>\n<dd><p>AR preview works on iPhones (iOS 12+, Safari) and Android phones (ARCore-capable, Chrome). On desktop browsers, a QR code is shown so users can scan and open the preview on their phone.<\/p><\/dd>\n<dt id=\"is%20it%20gdpr-compliant%3F\"><h3>Is it GDPR-compliant?<\/h3><\/dt>\n<dd><p>Yes, 100%. AR Button runs entirely client-side in the browser. No personal data is collected, stored or sent to any server. No cookies, no tracking, no server-side processing.<\/p><\/dd>\n<dt id=\"can%20i%20customize%20the%20button%20styling%3F\"><h3>Can I customize the button styling?<\/h3><\/dt>\n<dd><p>Yes. All colors (primary, secondary, text, border, hover, active states), border radius, border width, text size and button label are configurable from the admin panel. You can also override any attribute per button via shortcode.<\/p><\/dd>\n<dt id=\"does%20it%20work%20with%20elementor%3F\"><h3>Does it work with Elementor?<\/h3><\/dt>\n<dd><p>Yes. AR Button includes a dedicated Elementor widget with all options. It also works as a Gutenberg block and as a shortcode.<\/p><\/dd>\n<dt id=\"what%20image%20formats%20are%20supported%3F\"><h3>What image formats are supported?<\/h3><\/dt>\n<dd><p>JPG, PNG, TIFF, PDF, WebP, GIF, BMP, TGA and SVG. The image URL must be publicly accessible.<\/p><\/dd>\n<dt id=\"can%20i%20use%20it%20for%20products%20other%20than%20posters%3F\"><h3>Can I use it for products other than posters?<\/h3><\/dt>\n<dd><p>Yes. AR Button supports posters, framed images, canvas prints, rollups, business cards, flyers, folders, packaging, doors and more. Each product type has a pre-configured template with appropriate 3D settings.<\/p><\/dd>\n<dt id=\"how%20accurate%20is%20the%20ar%20preview%3F\"><h3>How accurate is the AR preview?<\/h3><\/dt>\n<dd><p>True to scale. If you set a product to 60\u00d790cm, it appears at exactly 60\u00d790cm in the customer's room. This helps customers judge size, color and placement before buying.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.6<\/h4>\n\n<ul>\n<li>Restored languages folder for Domain Path header<\/li>\n<li>Avoided Plugin Check false positive on image source context key<\/li>\n<\/ul>\n\n<h4>1.0.5<\/h4>\n\n<ul>\n<li>Removed WordPress.org directory banner\/icon assets from the plugin package<\/li>\n<li>Documented CDN and API external services in readme.txt with terms and privacy links<\/li>\n<\/ul>\n\n<h4>1.0.4<\/h4>\n\n<ul>\n<li>Removed hidden <code>.gitkeep<\/code> file that failed WordPress.org automated checks<\/li>\n<\/ul>\n\n<h4>1.0.3<\/h4>\n\n<ul>\n<li>Plugin URI and Author URI now point to different pages (WordPress.org requirement)<\/li>\n<\/ul>\n\n<h4>1.0.2<\/h4>\n\n<ul>\n<li>Shortcode uses prefixed tag <code>[arbutton]<\/code> (no unprefixed <code>ar_button<\/code>)<\/li>\n<li>Confirmed unique <code>arbutton<\/code>\/<code>ARBUTTON_<\/code> prefix across plugin APIs<\/li>\n<li>Admin menu icon uses base64 SVG data URI so WordPress can match the color scheme<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Consistent <code>arbutton<\/code> prefix for classes, constants, options, hooks, and settings IDs<\/li>\n<li>Shortcode renamed to <code>[arbutton]<\/code> (replaces <code>ar_button<\/code>)<\/li>\n<li>Text domain aligned to slug <code>arbutton<\/code><\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release<\/li>\n<li>Admin settings page with full styling control (colors, border, text size)<\/li>\n<li>Automatic image source resolution (WooCommerce, featured image, ACF, custom fields)<\/li>\n<li>Product behavior defaults (3D viewer, zoom, drag icon, placing pane)<\/li>\n<li>Product templates: poster, framed image, door, rollup, business card, flyer, folder, packaging<\/li>\n<li>WooCommerce auto-embed with configurable hook position<\/li>\n<li>Gutenberg block with automatic image and template selection<\/li>\n<li>Elementor widget with full attribute support<\/li>\n<li>Shortcode <code>[arbutton]<\/code> with all attributes<\/li>\n<li>Developer filters for templates, image sources and loader URLs<\/li>\n<li>Lightweight: no admin bloat, no upsell notices, no tracking<\/li>\n<\/ul>","raw_excerpt":"Let your customers preview products on their wall or in their room before buying \u2014 in augmented reality, right in the browser. No app needed.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/339134","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=339134"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/arbutton"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=339134"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=339134"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=339134"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=339134"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=339134"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=339134"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}