AR for WordPress

Shortcode
Show Model Fields

Hang your artwork in AR with just a photo!

Purchase an AR Model for your site.

GLTF/GLB 3D Model



AR_Display_chair-1.glb
USDZ/REALITY 3D Model - Optional



AR_Display_chair-1.usdz

Allow user to upload their own image or model file?


Using the [ar-user-upload] shortcode displays an Image/Model upload button and an empty model viewer. Model files (gltf & glb) will be displayed in the model viewer and image files (jpg & png) will be converted to hanging artworks with the 3D Gallery Builder.

AR Display Settings | Documentation | Sample 3D Models | Sample HDR Images

[ar-display id=X] - Displays the 3D model for a given model/post id.
[ar-display id='X,Y,Z'] - Displays the 3D models for multiple comma seperated model/post ids within 1 viewer and thumbnails to select model.
[ar-display cat=X] - Displays the 3D models for a given category within 1 viewer and thumbnails to select model.
[ar-display cat='X,Y,Z'] - Displays the 3D models for multiple comma seperated category ids within 1 viewer and thumbnails to select model.
[ar-gallery] - Displays the 3D Gallery Model using the featured image of the current post. Includes a size selector.
[ar-user-upload] - Displays the Model Viewer allowing the end user to drag and drop a model or image file to have it display.
[ar-view id=X text=true (OR) buttons=true] - Display either the AR View button, the text link 'text=true' "View in AR / View in 3D" or html buttons 'buttons=true' for a given model/post id without the need for the 3D Model viewer being displayed. Custom text can be set on the AR Settings page.
[ar-qr] - QR Code shortcode display for the page or post the shortcode is added to.<br>

Documentation | Sample 3D Models | Sample HDR Images


Scale
1 = 100%, only affects desktop view, not available in AR
X: Y: Z:
 1
1
1
In Out





Then rotate your model to each of your desired limits and click the arrows to apply.

Compass

Support & Frequently Asked Questions

Whilst we endeavour to make our plugins as easy to use as possible. There will inevitably be queries on how to do certain things with them. Please find answers to the most common queries below and for further support please check our 3D Resources or contact Web and Print Design if you need further assistance.

What is Augmented Reality and Why Use It?

Augmented Reality (AR) is an interactive technology that superimposes digital objects onto the real world, allowing users to see and interact with a virtual representation of the physical environment. Integrating AR into a website can provide several benefits for business owners, including:

  1. Enhanced customer experience: AR can provide an immersive and engaging experience for customers, allowing them to interact with products in a more meaningful way. For example, a furniture company can use AR to allow customers to see how a particular piece of furniture would look in their home before making a purchase.
  2. Increased engagement and conversion: AR can help capture the attention of website visitors and increase engagement with the website content. This can lead to higher conversion rates and increased sales.
  3. Improved brand awareness: By integrating AR into their website, business owners can create a unique and memorable brand experience that sets them apart from competitors. This can lead to increased brand awareness and recognition.
  4. Better product visualization: AR can help customers better visualize and understand a product’s features, benefits, and capabilities. For example, a company that sells complex machinery can use AR to provide a 3D visualization of how the machinery works.
  5. Cost-effective marketing: AR technology can be a cost-effective way for business owners to market their products and services. By providing an innovative and interactive experience, businesses can generate buzz and attract new customers without spending a lot of money on traditional marketing campaigns.

Overall, using AR on a website can provide a range of benefits for business owners, including enhanced customer experience, increased engagement and conversion, improved brand awareness, better product visualization, and cost-effective marketing.

FAQ

If you use the free version of the plugins then there are no costs involved, however you will have limitations to the number of 3D models you can have on your site.

If you use a premium version of the plugins then there is a monthly subscription fee for the plugin to support unlimited models and to receive the plugin updates for the duration of your subscription.

How to install

To get started, you’ll need to install the AR for WordPress plugin. You can do this by navigating to the WordPress plugin repository and searching for “AR for WordPress” or “AR for Woocommerce”. Once you’ve found the plugin, click “Install Now” and then “Activate”.

Manually

  1. Upload the “AR for WordPress” or “AR for Woocommerce” plugin zip file to the /wp-content/plugins/ directory and unzip it
  2. Activate the plugin through the ‘Plugins’ screen in WordPress
  3. Visit the AR Models ->Settings page to configure the plugin

AR for WordPress and AR for WooCommerce display your 3D models using the model-viewer html5 tags. This system supports the use of USDZ, GLB and GLTF 3D model file formats. For further information please visit our 3D resources section.

Yes, our system supports both iOS and Android devices. You can upload a GLB or GLTF file for display on both Android and iOS, or you can also upload a USDZ file for iOS.

iOS devices need to be running iOS version 12 or newer.

Android devices must be running Android 7.0 or newer with ARCore supported and Google Play Services for AR installed. Please see the ARCore supported devices information at https://developers.google.com/ar/devices. Instructions on How to Enable ARCore on Any Android Device can be found here.

The plugins utilise the model-viewer open source scripts which according to their site currently support the following browsers, however Safari works too. https://modelviewer.dev/#section-browser-support

Yes. When adding/editing a model click on the ‘Show Model Fields’ link to display the field where you can enter a url to file at a different location.

 

Your model must be centred to its origin in your 3D software before exporting to ensure it sits in the correct position when viewed using the plugins. Details and instructions on how to do this can be found here. https://resources.turbosquid.com/training/training-scene-organization/centering-at-the-origin/

If you don’t have 3D models there are a number of solutions available to you, including downloading existing models from online libraries, creating your own models using your mobile phone or tablet’s cameras or commissioning a 3D model to be created. Please visit our 3D Model Resources section for more details.

You may need to enable GLB file support by adding a line into your .htaccess file

AddType model/gltf-binary .glb

The line AddType model/gltf-binary .glb in the .htaccess file instructs the web server to treat files with the .glb extension as model/gltf-binary MIME type. This is relevant for serving 3D model files in the GLB format, allowing browsers and applications to handle them correctly. Without this directive, the server might serve these files as plain binary data, which could cause compatibility issues.

Support for our plugins is provided via the WordPress.org support forums.

1. Log in to your WordPress site dashboard
2. Under AR Models click on Categories to open the category page
3. Choose the category you want to find the category ID
4. Hover on the category’s edit link and you will see the URL at the bottom with the category ID
5. Alternatively, open the category by clicking on it.
6. Check the category ID from the page URL

You can embed the page of your website containing your AR shortcode into an iframe on your site. or another site. However you may need to do the following to ensure it will work.

In the .htaccess file for your parent site, add this line:
Header Feature-Policy: xr-spatial-tracking *;

Then in your iframe tag add:
allow=”xr-spatial-tracking”

When your subscription expires the support for unlimited products, categories and product variations will no longer be available. You will need to renew your subscription for these functionalities to continue to work.

If you are not satisfied with the plugin then we offer a full refund within 30 days of purchasing. Please contact us should you wish to receive a refund.

Getting Started

Installation

To get started, you’ll need to install the AR for WordPress plugin. You can do this by navigating to the WordPress plugin repository and searching for “AR for WordPress” or “AR for Woocommerce”. Once you’ve found the plugin, click “Install Now” and then “Activate”.

Manually

  1. Download the plugin from the WordPress plugin repository, “AR for WordPress” or “AR for Woocommerce
  2. Upload the “AR for WordPress” or “AR for WooCommerce” plugin zip file to the /wp-content/plugins/ directory and unzip it
  3. Activate the plugin through the ‘Plugins’ screen in WordPress
  4. Visit the AR Models ->Settings page to configure the plugin

Settings

AR for WordPress
Browse to the AR Models Settings Page found on the left hand side admin menu AR Models -> Settings.

AR for Woocommerce
Browse to the AR Models Settings Page found on the left hand side admin menu WooCommerce -> Settings =>AR Display (tab)

License Key – Enter your Premium Licence Key to unlock the customisation options.

Renewal – Premium subscription renewal date

Model Count – The number of AR Models in your site

Custom AR Button – Upload an image file to replace the AR button in the model viewer on AR capable devices.

Custom Fullscreen Button – Upload an image file to replace the fullscreen popup icon in the model viewer on desktop and laptops.

Custom Play Button – Upload an image file to replace the play button in the model viewer for models with animations.

Custom Pause Button – Upload an image file to replace the pause button in the model viewer for models with animations.

Dimension Units – Choose what units to display the dimensions in – meters, centimeters, millimiters or inches.

Dimensions Label – Customise the name of the Dimensions box

Please include AR model id in shortcode. [ar-view id=X] View in AR Label – Customise the View in AR label for the ar-view shortcode

Please include AR model id in shortcode. [ar-view id=X] View in 3D Label – Customise the View in 3D label for the ar-view shortcode

Dimensions – Disable the Dimensions option in the model viewer

AR View – Disable the AR view button in the model viewer on AR capable devices

QR Code – Disable the QR Code in the model viewer on desktop and laptops

Reset – Disable the Reset button in the model viewer

Fullscreen – Disable the Fullscreen button in the model viewer on desktop and laptops

Gallery Size Selector – Disable the 3D Gallery Builder size selector within the model viewer

Encrypt Model URLs – Secure your model files by encrypting the URLs in the model viewer

Android – Prioritise Scene Viewer over WebXR – By default Android users will view models using WebXR, you can prioritise this to use Scene Viewer instead if preferred

Remembering Open Tabs – Keep the previously open tabs on the model editing page open upon returning to the page

Disable Viewing Model Posts – Disable the permalinks for armodels

Custom QR Logo – Upload an image file to replace the Logo that appears in the QR code in the model viewer on desktop and laptops.

QR Code Destination – When a user scans the AR code on their device it can take them to either the ‘Parent Page’ which is the page currently displaying the AR model, or ‘Model Viewer’ which opens the model directly in the browser and automatically triggers the AR view once loaded.

Upload Button Label – Customise the Upload Button Label

Default Image/Model – Choose to display the Default Model, the Featured Image of the post the shortcode is used on, or your Custom model

Custom Default Image/Model – Upload an image or model file to replace the model that appears in the User Upload model viewer

Element Positions and CSS Styles – Choose the position in the model viewer for each of the following elements: AR Button, Dimensions, Fullscreen Button, QR Code, Thumbnail Slides, Play/Pause, Reset Button, Call To Action, Model Variants

CSS Styling – Add your own custom CSS Styles to change the appearance of various elements.

Adding your 3D Models

The first thing to do is gather your 3D model files in the correct formats and settings. Please make sure you do the following:

  1. Set the scale of your model to be in metres. This will ensure your model is displayed at the correct scale in AR view. You can change how the units that the dimensions are displayed in within the model viewer once uploaded.
  2. Ensure your model is orientated correctly. It should be positioned at 0,0,0 on your X,Y,Z axis. If your model is to be positioned on a vertical surface then it should also be standing vertical.
  3. Export your model files in GLB/GLTF and USDZ formats.

Then browse to the add model pages:

AR for WordPress
AR Models -> Add New

AR for Woocommerce
Products -> Add New => Product Details -> AR Models (tab)

GLB/GLTF 3D Model – Upload your model file to the media library or insert a URL to your model. URLs should always be served via https://. GLB/GLTF files can be used for both Android and iOS (the iOS Quick Look app can convert them on the fly, though perfect results are not guaranteed).

USDZ/REALITY 3D Model – For guaranteed AR dispay on iOS, upload your model file to the media library or insert a URL to your model. URLs should always be served via https://

Skybox/Background Image – Upload your image file to serve as a skybox-image which links to an equirectangular projection that is used as the skybox, and applied as an environment map to the model

Environment Image – Upload your image file to set environmental lighting without changing the background

Model Placement – Select whether you model should be displayed on horizontal or vertical surfaces when viewed in AR

Scale – Set the X, Y, Z scale to change the size of your model in the desktop view, not available in AR

Field of View – Control the extent of the observable area within the 3D model’s environment, specifying the angular range that the viewer can see within the 3D scene

Exposure – Change the exposure of your model

Shadow Intensity – Change the shadow intensity of your model

Shadow Softness – Change the shadow softness of your model

Zoom Restraints – Restrict the amount a user can zoom in or out

Animation – Play/Pause button – Enable the Play Pause Button if your model contains Animations.

Animation – Auto Play – Auto play the chosen animation for your model

Legacy lighting – By default a neutral lighting environment is used that is evenly lit on all sides, but there is also a baked-in legacy lighting primarily for frontward viewing that van be enabled

Emissive Lighting – Makes surfaces appear self-illuminated, allowing them to glow or emit light without relying on external light sources

Model includes variants – enable this if your model includes variants and a drop down menu will appear in the model viewer for users to choose the variant

Rotation – Set Limits – Restrict the amount users can rotate the model in both the X and Y axis

Disable/Hide Elements – Choose which elements and functionalities you wish to disable including AR View Button, Auto Rotate, Dimensions, Interaction Prompt, Resizing in AR, QR Code, Reset Button and Zoom functionality

QR Code Destination – When a user scans the AR code on their device it can take them to either the ‘Parent Page’ which is the page currently displaying the AR model, or ‘Model Viewer’ which opens the model directly in the browser and automatically triggers the AR view once loaded

Custom QR Logo – Upload an image file to replace the Logo that appears in the QR code in the model viewer on desktop and laptops

Custom QR Code URL – Set a custom URL for your QR code to go to

Call To Action Button – Place a CTA button within the model viewer. Button Displays in 3D Model view and in AR view on Android only

Call To Action URL – Set the URL for your CTA button to go to

Hotspots – Add your text, click the Add Hotspot button, then click on your model where you would like it placed

Display a different AR model when viewing on mobile devices – Choose from an existing model to display when viewing on a mobile device

Display a different AR model when viewing on AR mode – Choose from an existing model to display when viewing on in AR

Override Global Settings – Use custom CSS settings for the model instead of the Global settings

Import Global Settings – Apply the Global settings and CSS to then customise them to this model

Element Positions and CSS Styles – Choose the position in the model viewer for each of the following elements: AR Button, Dimensions, Fullscreen Button, QR Code, Thumbnail Slides, Play/Pause, Reset Button, Call To Action, Model Variants

CSS Styling – Add your own custom CSS Styles to change the appearance of various elements.

Sample Model Editor

Dimensions:

Displaying Models on Your Site

Shortcodes

Insert one of the following shortcodes within your Post, Page or Product content to display the model viewer. Shortcodes shown in orange below must be surrounded in square brackets.

ardisplay – Displays the featured image of a post using the 3D Gallery Builder
ardisplay id=X – Displays the 3D model for a given model/post id.
ardisplay id=’X,Y,Z’ – Displays the 3D models for multiple comma seperated model/post ids within 1 viewer and thumbnails to select model.
ardisplay cat=X – Displays the 3D models for a given category within 1 viewer and thumbnails to select model.
ardisplay cat=’X,Y,Z’ – Displays the 3D models for multiple comma seperated category ids within 1 viewer and thumbnails to select model.
ar-gallery – Displays the 3D Gallery Model using the featured image of the current post. Includes a size selector.
ar-user-upload – Displays the Model Viewer allowing the end user to drag and drop a model or image file to have it display.
ar-view id=X text=true OR buttons=true – Display either the AR View button, text links “View in AR / View in 3D” or button links for a given model/post id to view it directly.
ar-qr – QR Code shortcode display for the page or post the shortcode is added to.

ar-view default

Dimensions:

ar-view text links

View in AR / View in 3D
Dimensions:

ar-view button links

View in AR View in 3D
Dimensions:

ar-qr

Gutenberg, Widgets & Elementor

You can add the AR Display to your pages using the AR for WordPress and AR for Woocommerce Gutenberg blocks. You will also find AR for WordPress and AR for Woocommerce Widgets and Elementor elements.

AR for WooCommerce – Default Product Image

To display your product’s 3D model in place of the Woocommerce product image on the single product page, copy the woocommerce folder found in the AR for Woocommerce plugin templates folder to your theme’s folder.

Copy/wp-content/plugins/ar-for-woocommerce/templates/woocommerce/single-product/product-image.php

To/wp-content/themes/YOURTHEME/woocommerce/single-product/product-image.php

3D Gallery Builder

Introducing the 3D Gallery Builder — the perfect solution to transforming ordinary images into stunning 3D art pieces! Immerse yourself in a world where your creativity knows no bounds. With this powerful tool, you can effortlessly upload your favorite jpg or png image, and with a few clicks, watch it come to life ready to hang on the wall.

Tailor your masterpiece by choosing from a frame type and size to perfectly suit your style and space. Ideal for artists, photographers, and anyone with an eye for aesthetics, the 3D Gallery Builder opens up a realm of possibilities for showcasing your visual stories.

Step into a virtual art gallery of your own creation, where each image becomes a captivating centerpiece on your walls. Whether you’re looking to exhibit your photography, display digital artwork, or simply add a touch of sophistication to your living space, the 3D Gallery Builder makes it effortless.

Unlock the potential of your images and turn them into immersive 3D experiences. Elevate your artistry, share your stories, and bring your vision to life with the 3D Gallery Builder — where every image becomes a masterpiece.

User Upload

Introducing the AR User Upload — Allow your users to upload their own model or image to view directly in Augmented Reality!

Use the ar-user-upload short code to provide a model viewer that users can drag and drop a GLTF or GLB 3D model file into to view in Augmented Reality.

Users can also upload image files in JPG or PNG format and the image will use the 3D Gallery Builder to produce a 3D model of the image ready to hang on the wall in Augmented Reality.

Model options can be set to custom default values or hidden as follows by setting these attributed in the shortcode.

e.g. ar-user-upload options=”top” ratio=”2:3″ size=”2″ frame=”framed” color=”#f8f8f8″ opacity=”0.5″

options can be top, bottom or none
ratio can be 1:1, A4-A1, 2:3, 4:5, 3:4
size can be 1, 1.5, 2, 2.5
frame can be none, mounted, or framed
color is a 6 digit hex value
opacity is between 0 and 1

You can also use hide_all=true to hide the model options.

How To Display Multiple Models in 1 Viewer

Dimensions:

To display multiple models in the 1 viewer instance, you simply need to add a list of id numbers id=1,2,3′ or you can add a category id number ‘cat=123’ to your ardisplay shortcode, where 123 is the ID number of the category the models/products belong to. This will display their Featured Images as thumbnails in the bottom corner of the viewer.

ardisplay id=1,2,3 (Contained within square brackets).
ardisplay cat=123
(Contained within square brackets).

Using the AR For WordPress plugin you can find the category ID by going to the ‘AR Models’ -> ‘AR Categories’ page and edit a desired category. When editing your category, the URL for the edit page will tell you the ID number for that category. e.g. https://yourdomain.com/wp-admin/term.php?taxonomy=model_category&tag_ID=123&post_type=armodels

Using the AR For Woocommerce plugin you can find the category ID by going to the ‘Product’ -> ‘Categories’ page and edit a desired category. When editing your category, the URL for the dit page will tell you the ID number for that category. e.g. https://yourdomain.com/wp-admin/term.php?taxonomy=product_cat&tag_ID=25&post_type=product

With the AR for Woocommerce plugin you can have your model display in place of Woocommerce’s featured image. Copy the woocommerce folder found in the AR for Woocommerce plugin “templates” folder to your theme folder.

Animation

If you model includes an animation sequence you display this animation using the autoplay and the custom play & pause buttons features.

When editing your model you can enable the autoplay of your animation and whether to show the play and pause buttons by ticking the checkboxes in your model settings.

If you would like to use a custom Play and Pause button you can upload these images to your media library on the AR plugin’s Settings page.

Dimensions:

‘AR view’ example will load an animated robot in Android and an animated flying pteradactal in iOS.

Variants

GLTF Models can also include variants to allow the user to change textures and colours in a model. Be sure to select the ‘Model includes variants’ option when adding your AR model to your website.

Please click here to learn more.

Dimensions:

Contact Support

Please contact us with your support enquiries and we will endeavour to assist you. Please include details of any issue you may be having and url’s to the page where you are displaying your AR models using the plugins if applicable.

  • URL of web page with AR Model displayed on it
  • This field is for validation purposes and should be left unchanged.

Feature Request

If you have any ideas or features you would like to see included in the AR plugins, please get in touch and we would love to explore how we can improve both the user and admin experience of the plugins.

  • This field is for validation purposes and should be left unchanged.
Dimensions:
Dimensions:
Dimensions: