Reading list Switch to dark mode

    A Complete Guide to Akeneo Augmented Reality Extension

    Updated 7 September 2023

    Akeneo Augmented Reality PIM Guide – This extension allows the users to create AR Media and add it to products. The users must create an attribute by selecting the AR media type and assign it to the family.

    It enables the users to add a 3-D AR model to the products in order to provide a more realistic view.

    Check a brief overview of the plugin –

    6GWHOvvljLU

    Basic Requirements:

    • This module works with Akeneo 3.x, 4.x,5.x, 6.x and 7.x. Download Akeneo from here
    • Node and as well as Yarn packages need to be installed.
    • This module is compatible with the Akeneo community and Enterprise(Flexibility) edition.
    • If you want to use this extension on Akeneo EE Serenity mode, please contact us.
    • For the Akeneo installation, your Akeneo server should meet these system requirements.

    Features

    • Enhance your products with Augmented Reality Media.
    • Users can preview AR media on their desktops, smartphones, and tablets.
    • AR media with products can be imported and exported by users.
    • The module allows users to view each and every side of the product.
    • The users can upload GLB files for Android.
    • The users can upload USDZ files for iOS.
    • The module is accessible for product and product model types of products.
    • This module is compatible with Akeneo’s latest version 7.x

    Installation

    Two different types of module installation processes are available for the module.

    1. Composer Installation
    2. Manual Installation

    Installation using Composer Installation

    Read This Blog

    Start your headless eCommerce
    now.
    Find out More

    Before beginning the composer installation

    1: Get the ACCESS KEYS [Create a support ticket]

    2: In Akeneo composer.json, add our repository and the installation script.

    Akeneo 6 and 7

    {
      "scripts": {
            "post-update-cmd": [
               "vendor/webkul/arbundle/src/Webkul/ArBundle/install/config.sh COMPOSER=true NO_DOCKER=true"
            ],
            "post-install-cmd": [
               "vendor/webkul/arbundle/src/Webkul/ArBundle/install/config.sh COMPOSER=true NO_DOCKER=true"
            ],
            "post-create-project-cmd": [
              "vendor/webkul/arbundle/src/Webkul/ArBundle/install/config.sh COMPOSER=true NO_DOCKER=true"
           ]
       },
      "repositories": [{
        "type": "composer",
        "url": "https://akeneorepo.webkul.com/"
      }]
    }
    

    For Akeneo <=5.x 

    {
      "scripts": {
            "post-update-cmd": [
               
    "vendor/webkul/arbundle/composer_install.sh"
            ],
            "post-install-cmd": [
               
    "vendor/webkul/arbundle/composer_install.sh"
            ],
            "post-create-project-cmd": [
             
    "vendor/webkul/arbundle/composer_install.sh"
           ]
       },
      "repositories": [{
        "type": "composer",
        "url": "https://akeneorepo.webkul.com/"
      }]
    }

    3: Use composer to install the extension

            composer require webkul/arbundle

    4: Complete the authentication form.
    5: Send a Message of Success
    6: Delete your browser’s cache.

    Manual Installation for Version 6.x and 7.x

    •  After unzipping the appropriate extension zip, merge the “src” folder into the akeneo project.
    • From the PIM directory, run the following command over the NO-DOCKER Instance.
    ./src/Webkul/ArBundle/install/config.sh COMPOSER=false NO_DOCKER=true
    • After that run the command below over the PIM directory’s DOCKER instance.
    ./src/Webkul/ArBundle/install/config.sh COMPOSER=false NO_DOCKER=false

    Manual Installation for Version 4.0.x to 5.0.x

    Please follow the below steps for installing the Akeneo Augmented Reality Media module in your Akeneo PIM platform.

    • Unzip the respective extension zip then merge the “src” folder into the Akeneo project root directory.
    src-icecat-1-1200x287-1
    • Goto config/Bundles.php then add line:
    conf-bundle-php-reality-pim
    Webkul\ArBundle\WebkulArBundle::class => ['all' => true],

    in return array.

    • Copy the “config” folder into akeneo project root directory for routing.
    conf-icecat
    • Run this command after ssh to your akeneo server by terminal and navigating to Akeneo installation directory (ex. cd /opt/bitnami/apps/akeneo/htdocs).
    rm -rf var/cache && php bin/console wk-ar-media:setup:install
    • If you are using php-fpm. Then you need to restart the php-fpm services and apache web server.

    For Akeneo 5

    sudo service php-fpm7.4 restart

    For Akeneo 4

    sudo service php-fpm7.3 restart

    Docker Installation Command :

    sudo -su root;
    alias docker_php='docker-compose run -u www-data --rm php php';
    alias docker_yarn='docker-compose run -u node --rm node yarn';
    docker_php bin/console cache:clear --env=prod;
    docker_php bin/console pim:installer:assets --symlink --clean --env=prod;
    docker_php bin/console d:s:u --force;
    docker_yarn run webpack;
    docker_yarn run update-extensions;
    docker_yarn run less;
    docker-compose restart fpm;

    Manual Installation For Version 3.x

    Please follow these steps for installing the Akeneo Augmented Reality Media module in your Akeneo PIM platform.

    1 – Unzip the respective extension zip then merge the “src” folder into akeneo project root directory.

    src_2_x-1-1200x283-1

    2 – Goto app/AppKernel.php then add line.

    app-kernal-reality-pim
    new Webkul\ArBundle\WebkulArBundle(),

    3 – Goto app/config/routing.yml then add these lines at top of file.

    routing-yml-reality-im
    wk_augmented_reality:
            resource: "@WebkulArBundle/Resources/config/routing.yml"
            prefix:   /

    4 –Run this command after ssh to your akeneo server by terminal and navigating to Akeneo installation directory (ex. cd /opt/bitnami/apps/akeneo/htdocs).

    rm -rf ./var/cache/** && php bin/console wk-ar-media:setup:install

    5– If you are using php-fpm. Then you need to restart the php-fpm services a apache web server.

    sudo service php-fpm7.2 restart

    Common Issues After Installation

    If you will not see the translation of the module, then you need to clear the browser cache or hard reload the browser to see the translations.

    Uninstall Module: For Akeneo 6 and 7

    • From the PIM directory, run the command below over the NO-DOCKER Instance.

    ./src/Webkul/ArBundle/uninstall/uninstall.sh COMPOSER=false NO_DOCKER=true

    • Run the command below over the PIM directory’s DOCKER instance.

    ./src/Webkul/ArBundle/uninstall/uninstall.sh COMPOSER=false NO_DOCKER=false

    Create Augmented Reality Media

    The Akeneo Augmented Reality symbol appears in the Akeneo dashboard when the module is installed as seen in the screenshot given below.

    Dashboard-12

    To add Augmented Reality Media the user needs to click on Akeneo Augmented Reality.

    Augmented-Reality

    To create AR Media the user needs to click on Create Button as seen in the screenshot given below.

    Augmented-Reality-1

    Here the user needs to enter the code and click on the Save button.

    Augmented-Reality-2

    Afterward, the user needs to upload the following details.

    Augmented-Reality-Edit
    • AUGMENTED REALITY MEDIA (JPG/PNG) – Here the admin needs to upload the media file in the JPG/PNG format.
    • AUGMENTED REALITY ANDROID MEDIA (GLB)- The Android Media section is where the user can upload a media file (image) for Android, and the image format is GLB.

    GLB is a 3D file format for virtual reality (VR), augmented reality (AR), games, and web applications that support motion and animation.

    • AUGMENTED REALITY IOS MEDIA (USDZ) – The iOS File area is where the user may submit a media file (picture) for iOS (Apple), with the image format being USDZ.

    Apple developed their own AR Viewer (AR Quick Look) and integrated it into a number of iOS apps, including Safari, Messages, News, and Notes. It can display USDZ files in 3D or augmented reality right away.

    After uploading the files the users need to click on the Save button.

    The Barcode is generated after uploading the GLB and USDZ files. the user can scan the image of the barcode in their Android and iOS devices to see the AR product.

    The users need to click on the View button to scan the barcode image on devices.

    Augmented-Reality-Edit-1

    The user can redirect to the website and see the AR product after scanning this Bar Code with their phone.

    img_20210825_095858_google-pixel4-clearlywhite-portrait

    To see the AR image in real space the user needs to click on the cube.

    img_20210824_173740_google-pixel4xl-clearlywhite-portrait

    However, the users can view each and every side of the product on the desktop too.

    screenshot-800e-103-80-65-178.ngrok_.io-2021.08.24-17_51_19

    The user can also download the image file or generate the link for the image to view the product as seen in the screenshot given below.

    Augmented-Reality-Edit-3

    Create AR Attribute

    To create the Augmented Reality attribute the user needs to navigate through Settings -> Attributes -> CREATE ATTRIBUTE as seen in the screenshot given below.

    Attributes-13

    Afterward, the user needs to click on Augmented Reality as seen in the screenshot given below.

    Attributes-14

    After selecting the Augmented Reality the user needs to enter the following details and select the Attribute group.

    Attribute-AR-View-Edit

    The user needs to click on Save Button after entering the following details to save the AR attribute.

    Afterward, the user needs to add the following attribute group to the respective family as seen in the screenshot given below.

    Family-Accessories-Edit-4

    After adding the attribute group to the respective family the user needs to click on the SAVE button.

    Family-Accessories-Edit-5

    Create Product – Augmented Reality PIM Guide

    To create a product in Akeneo the user needs to navigate through Products -> Create Product as seen in the screenshot given below.

    Ag6-1

    Afterward, the user needs to select the Product.

    screenshot-24de1214116b.ngrok_.io-2021.08.23-13_40_31

    Here the users need to enter the SKU details, family and click on the Save button.

    screenshot-24de1214116b.ngrok_.io-2021.08.23-13_43_25

    While entering the details for the product the user can see the Augmented reality attribute as seen in the screenshot given below.

    Product-Bag-Edit-16

    The users need to click on ADD/UPDATE AR MEDIA(S) to add the AR Media to the basket and click on CONFIRM button.

    Product-Bag-Edit-17

    After clicking on Confirm button the following AR Media is added to the respective product as seen in the screenshot given below.

    Product-Bag-Edit-18

    The user can also download the image file or generate the link for the image to view the AR product as seen in the screenshot given below.

    Product-Bag-Edit-19

    Afterward, the user needs to click on the SAVE button to save the product.

    Similarly, the same process works for the Product model as well.

    Import/Export – Augmented Reality PIM Guide

    Users can Import or Export AR Media with Products.

    To export products, the user needs to first, select the products and then click the QUICK EXPORT button, as shown in the screenshot below.

    Products-31

    After that, as shown in the screenshot below, you must select the export details and click the EXPORT button.

    The user can download the product in CSV and as well as the XLSX file.

    Products-32

    By clicking the DOWNLOAD GENERATED FILES button, as shown in the screenshot below, you can download the product’s CSV file.

    Process-tracker-Show-job-17

    After the product has been exported the users may check the AR media attribute in the CSV file as seen in the screenshot given below.

    Screenshot-from-2022-09-15-13-05-57

    Support

    So, that was much about the Akeneo Augmented Reality PIM Guide for any queries or doubts reach out to us at [email protected]. You can also raise a ticket at our HelpDesk system webkul.uvdesk.com

    Please explore our Akeneo Development Services and Quality Akeneo Extensions.

    Current Product Version - Akeneo 3 to 5 || 1.0.0, Akeneo 6 || 2.0.0 and Akeneo 7 || 3.0.0

    Supported Framework Version - 3.x.x, 4.x.x,5.x.x , 6.x.x & 7.x.x

    Blog Version - 3.x.x, 4.x.x,5.x.x , 6.x.x & 7.x.x
    • Version 3.x.x, 4.x.x,5.x.x , 6.x.x & 7.x.x
    • Version 3.x.x & 4.x.x & 5.x.x
    . . .

    Leave a Comment

    Your email address will not be published. Required fields are marked*


    Be the first to comment.

    Back to Top

    Message Sent!

    If you have more details or questions, you can reply to the received confirmation email.

    Back to Home

    Table of Content