Installation

Minimum Requirements

  • WordPress 4.7
  • WooCommerce 3.0
  • PHP 5.6 (PHP 7.0 or greater is recommended)
  • MySQL version 5.0 or greater (MySQL 5.6 or greater is recommended)
  • iOS 12 to view 3D files

More information on how to add plugins can be found in the WordPress codex here: https://codex.wordpress.org/Managing_Plugins#Manual_Plugin_Installation

Automatic Installation

  1. Go to Plugins > Add New
  2. Type WooCommerce AR Quick Look in Search Plugins
  3. Find the WordPress Plugin you wish to install.
    1. Click Details for more information about the Plugin and instructions you may wish to print or save to help set up the Plugin.
    2. Click Install Now to install the WordPress Plugin.
  4. The resulting installation screen will list the installation as successful or note any problems during the install.
  5. If successful, click Activate Plugin to activate it, or Return to Plugin Installer for further actions.

Manual Installation

WordPress Dashboard (.ZIP Archive)

  1. Go to Plugins > Add New
  2. Click Upload Plugin to display the WordPress Plugin upload field.
  3. Click Choose File to navigate your local file directory.
  4. Select the WordPress Plugin zip archive you wish to upload and install.
  5. Click Install Now to install the WordPress Plugin.
  6. The resulting installation screen will list the installation as successful or note any problems during the install.
  7. If successful, click Activate Plugin to activate it, or Return to Plugin Installer for further actions.

FTP

  1. Download your WordPress Plugin to your desktop.
  2. If downloaded as a zip archive, extract the Plugin folder to your desktop.
  3. Read through the “readme” file thoroughly to ensure you follow the installation instructions.
  4. With your FTP program, upload the Plugin folder to the wp-content/plugins folder in your WordPress directory online.
  5. Go to Plugins screen and find the newly uploaded Plugin in the list.
  6. Click Activate to activate it.

Settings

You will find all settings related to WooCommerce AR Quick Look under WooCommerce => Settings => AR Quick Look.

Product Display – Button 

Show a button above the price on the product page which users can click to start an AR Quick Look session.

Product Display – Media library

This will replace the product media library with the featured image and AR Quick Look on iOS devices only.

Product Display – Off Shortcode only

This will show nothing on the product page by default. You can then use the shortcode to choose where you would like to display AR Quick Look.

Show in product loop

Choose whether to show the AR Quick Look options in the product loop such as on the archive or shop pages.
Please note: This will disable the product from linking to the product page via the product image so you will need to provide an alternative link or button to view the product page.

Shortcode

WooCommerce AR Quick Look provides a handy shortcode which lets you place a product anywhere on your website with AR Quick Look enabled.

[wc-ar-quick-look-model] – shows the current product featured image with AR Quick Look Enabled. Use on the single product page.

Shortcode Attributes

product_id – Use this to display any WooCommerce product featured image with AR Quick Look enabled. Can be used on any page by adding the product ID as an attribute.

button – yes or no – Display the View in AR button which when clicked reveals the featured image and AR Quick Look link.

Example

[wc-ar-quick-look-model product_id=”1″ button=”yes”]

This will display the product with an ID of 1 and will show the View in AR button.

Adding Models to Products

There are two places you can add models for products depending on if the product is simple or variable.

Simple Products

Add files to simple product

Variable Products

Add models to variable products

Troubleshooting

Error adding lines to .htaccess file

The plugin was unable to add the required rules to your .htaccess file in order for the plugin to work. Go to the root of your WordPress site and add the following lines to your .htaccess file:

The product zoom & gallery doesn’t work anymore 

Due to the way AR Quick Look works we have to disable the zoom and gallery on iOS devices only. This allows users to click the Quick Look icon and start an AR session.

Themes & Plugins

The plugin uses common WooCommerce hooks in order to function. Providing the WooCommerce hooks have been left in their original location in your theme then this plugin will work with your theme and plugins.

We have tested this plugin with the latest versions of Storefront, Avada and BeTheme.

Hooks this plugin requires to function:

woocommerce_before_shop_loop_item_title
woocommerce_single_product_image_thumbnail_html

If you are having issues with how the output of the plugin is displayed then navigate to the settings and turn Product Display to Off Shortcode only. You can then use our shortcode to manually choose where to display the plugin HTML on the product page.

Frequently Asked Questions

How do i create .usdz models?

The usdz file format is a new 3D model format created by Pixar. You can find out more about the file format including how to create them here: https://medium.com/techinpieces/vectary-a-quick-way-to-create-3d-designs-and-usdz-files-cde050e2179a

Can i use .obj .fbx or another 3D file type? 

Yes you can however you will need to convert from them formats into .usdz. There is an online tool which makes this easy. https://www.vectary.com

What is ARKit Quick Look?

ARKit Quick Look is a new feature released by Apple that allows website and app developers to embed 3D models within their apps or websites without launching a separate app. This makes adding Augmented Reality experiences to your website a lot easier.

Does this work for variable products?

Yes. There is a setting for adding 3d models to individual variations when editing a product. These models will show when a user selects a variation on the front-end. Please see the screenshots above about how to add models to variable products.

Do I need an active license to use this plugin?

No you can continue to use the plugin without a license key however you will no longer be eligible for plugin updates or support.

Does AR Quick Look work for walls? 

Yes Apples AR Quick Look and ARKit can be used to detect flat wall planes and place objects on them.

Further Support

Please send all support queries to support@kijo.co.uk