Introduction

Welcome to the AirRobe Connector! The AirRobe connector acts as a data gateway between your ecommerce store and the AirRobe marketplace. When a customer opts into their AirRobe Circular Wardrobe on your store and places an order, details of their purchases are sent via the AirRobe Connector to the AirRobe marketplace. From there, customers can easily rent or re-sell their purchases at a later date using original imagery, product descriptions, and more.

This documentation is for magento integrations with AirRobe.

How it works

Hassle-free plugin

AirRobe's plugin integrates directly into your online store quickly and seamlessly, without changing any of your existing platforms.

Grow customer loyalty

Your customers make more premium purchases knowing they can make a positive impact on the planet and their wallet, at a later date.

Access data insights

Access key data insights on the post-sale activity of a purchase to monetise more opportunities in the circular economy.

As your end-customer shops on your site, they can choose to opt-in and add their purchase/s to their own private Circular Wardrobe.

An example of the AirRobe Circular Wardobe Widget.

The App does not interfere with any part of the checkout process. If the customer opts-in, then after checkout is complete, the customer can then click to view their "Circular Wardrobe" where they see what they have purchased and choose to setup an account.

At a later date, the customer can log in to their Circular Wardrobe and choose to re-sell, rent, recycle or donate their item in just a few clicks. AirRobe handles the full process and all trading risks.

Installation

The Circular Wardrobe extension can be installed with or without composer to manage your application dependencies (version 2 or greater). Choose one of the two installation methods below to proceed.

• Using composer
• Without composer

• Run the following command on your server from the magento directory of you site to enable the Circular Wardrobe Widget:
  
  composer require airrobe/thecircularwardrobe
  
  # If you don't currently have packagist configured as a repository source, you may need to first run:
  composer config repositories.packagist.org composer https://repo.packagist.org
  

• Alternatively, you can download a copy of the Circular Wardrobe Extension code and upload it directly to your magento site.

  # Change into your magento2 directory on your server:
  cd /path/to/magento2
  
  # Change into the "app/code" subdirectory:
  cd app/code
  
  # Create a new "AirRobe" directory:
  mkdir -p AirRobe
  
  # Clone a copy of the extension files into your project's app/code directory:
  git clone https://github.com/airrobe/magento-extension AirRobe/TheCircularWardrobe
  # ... or alternatively, download a copy to your local development machine first, then upload it manually to your server (if for example you do not have git configured on your server)
  
  # Return to the magento root path
  cd ../..
  

Command line setup

Be sure to run all commands in order.

  # Enable the module
  php bin/magento module:enable AirRobe_TheCircularWardrobe

  # Apply database upgrades
  php bin/magento setup:upgrade --keep-generated

  # Flush the cache
  php bin/magento cache:flush

Configuration

Now that the Circular Wardrobe Widget is installed and setup, you'll need to provide some configuration values to get started. To access configuration for the Circular Wardrobe Widget, first click "Stores" in your magento admin sidebar, then "Configuration":

Then select "AirRobe" in the configuration sidebar, followed by "Configuration":

General

To enable or disable the Circular Wardrobe widget, use the Enable Module setting. The module will be disabled by default, as you must first provide required configuration including credentials, and should also provide optional mapping information if available.

Credentials

To securely send order information to the AirRobe connector API, you need to provide an AppId and an API secret key that can verify the identity of your site. Provide your AppId and Secret Key in the appropriate fields.

You'll need to sign in or sign up to access credentials.

Mapping

After providing credentials as outlined in the module configuration above, it's also necessary to run the following command on your server to send a summary of categories and product options to the AirRobe connector. This allows us to perform additional work mapping your store's categories into the AirRobe taxonomy.

bin/magento airrobe:taxonomy:sync

Also, the Circular Wardrobe Widget uses certain attributes such as the price, original full price, brand, material and category to intelligently estimate a future resale value of your items and display this value to your customers. In order to support these calculations, you should provide the names of the attributes in your system that correspond to these attributes. For example, in your system, an item's "brand" may be stored under the "manufacturer" attribute (which is a magento default), but this attribute may be different in your system. If you are unsure about what values to put here, feel free to contact us.

Note that it is not required to provide all of these attributes in order to display the Circular Wardrobe Widget, but it is encouraged to do so for best performance.

Wrapping up

We're so excited to have you on board with us in the Circular Fashion Movement!

We're here for you

Our team is just an email away, at integration@airrobe.com. We're more than happy to answer your questions and do what we can to help make your AirRobe integration successful!

Alex

Edwin

John

Pius

Max