Guide for Akeneo Wix Connector

Akeneo Wix connector integrate Akeneo PIM (Product Information Management) with Wix store. This allows you to enrich the products for your Wix store.

It synchronizes and enriches product data that includes details like product names, descriptions, images, prices, and other attributes.

You can also check the Akeneo Shopify Connector that allows you to connect your Shopify store with Akeneo for product enrichment.

• Export Categories from Akeneo as Collections in Wix.
• Export Products from Akeneo to Wix.
• It works with simple and variable products
• Connector also exports the categories as collections.
• Export Product Images.
• Can export Inventory quantity, Sale price along with Product Data.
• Can Use fixed value for some fields when Exporting data.
• Filter data to be Exported based on Category, family, Completeness, Identifier(SKU), Language and Currency.
• Set up user ACL roles for the permissions a users has for Wix.

Note:

• CLI User must be the same as the FPM user, a good practice is to use the FPM user for installation.
• Ownership/permissions for the Akeneo directory must be assigned to the FPM user. Otherwise, you will face the permission issue during installation.

Composer Installation:

Read this blog on installing Webkul Akeneo Connector via Composer before start the installation via composer.

Step 1: GET the Access Keys [Raise a ticket].

For Step 2: Add our repository and installation script in your Akeneo composer.json

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

Step 3: Install the extension using composer.

 composer require webkul/wixconnector

For Step 4: Fill the authentication.
Step 5: Success Message
Step 6: Clear Browser cache

Manual Installation:

Unzip the respective extension zip and then merge “src” folder into akeneo project.

Run the below command over the NO-DOCKER Instance from the PIM directory:

./src/Webkul/WixConnectorBundle/install/config.sh COMPOSER=false NO_DOCKER=true

Run the below command over the docker Instance from the PIM directory:

./src/Webkul/WixConnectorBundle/install/config.sh COMPOSER=false NO_DOCKER=false

Uninstall-Module:

Run the below command over the NO-DOCKER Instance from the PIM directory:

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

Run the below command over the docker Instance from the PIM directory:

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

Raise a ticket if you will face any issue during installation / uninstallation .

For generating credentials to connect Wix store with Akeneo PIM navigate to Wix Site login.

After that, login to your Wix account.

After login, you will be able to see the section to generate the API credentials.

Tap, Generate API keys and then enter the name and select all permissions.

After that, tap Generate Key button.

Then tap the Send Code button and a 6 digit verification code is sent on your email address.

Now, check your email for the code and enter the same.

Then tap Verify & Generate Key and the toke gets generated.

Now, the generated token is visible under the respective section.

I you have not created a Wix store, then create it first by tapping Create New Site option.

After, the Wix store is setup go to Home page and in the address bar URL, you can see the Site ID.

Login to Akeneo backend and on the side panel you can see the Wix connector option.

Tapping Wix icon brings up the section to connect Akeneo and Wix store.

For the same navigate through Wix->Credentials.

To add credentials, tap the Create button.

Here, enter the –

• Site Name
• Authorization Toke
• Site ID

Lastly, tap the save button therafter.

Also, the admin can set the user ACL roles for the permissions a users has for Wix.

Navigate through Wix->Attribute Mapping.

Here, you can –

• Map Wix product attributes with the Akeneo attributes as required and save the mapping thereafter.

Apart from that, you can also see the attribute mapping history author wise as required.

Map Existing Categories/Products of Wix with Akeneo

Click the Manual Mapping button for creating a new mapping for a category, product, or product model as required.

This brings up the section as shown below.

Here, you can do the mapping of product, product model, and categories that have not been mapped.

Category Mapping –

For the mapping type selected a category, the user will –

• Select the respective Wix credentials
• Choose the Akeneo category
• Choose the Wix category

Lastly, tap the Save button.

Product Mapping –

For the mapping type selected a product, the user will –

• Select the respective Wix credentials
• Choose the Akeneo product
• Choose the Wix product

Lastly, tap the Save button.

Product Model Mapping –

For the mapping type selected a category, the user will –

• Select the respective Wix credentials
• Choose the Akeneo product model
• Choose the Wix product model

Lastly, tap the Save button.

Navigate through side menu option in Akeneo Exports->Create Export Profile.

Tap, Create Export Profile to create the same.

Here, for the export profile, enter the –

• Code
• Label
• Choose the Job as – Wix Category Export

Lastly, save the job by tapping the Save button.

After that, edit the respective job and go to content section.

Here, for the export process, filter the data –

• Choose the channel for category export
• Choose the locale for the same

Now, go to the credentials section.

Run the job by tapping the export button.

After the job is executed, a success message is displayed.

In the Export Category job, only the category label is exported. If a category label does not exist, the category will be skipped during the export process.

Here, is an example of product list in Akeneo to be exported to Wix.

Navigate through side menu option in Akeneo Exports->Create Export Profile.

Tap, Create Export Profile to create the same.

Here, for the export profile, enter the –

• Code
• Label
• Choose the Job as – Wix Product Export or Wix Product model Export as required.

Lastly, save the job by tapping the Save button.

After that, edit the respective job and go to content section.

Here, for the export process, filter the data –

• Choose the channel for product export
• Choose the locale for the same

You can decide which all products you want to export to Wix. There are various filters available such as – family, status, completeness, time condition, category.

If you want to export only some specific products, you can enter their SKU in the Identifier section separated by a comma.

Now, go to the credentials section.

Run the job by tapping the export button.

After the job is executed, a success message is displayed.

Note: Only simple products were exported with the Export Product job. In the Product Model Job Export, the product model was exported along with variant products.

After product export to Wix the products are visible in the Wix store.

Products are visible at the store front of Wix as well.

Product page at Wix.

That, was much about the Akeneo Wix Connector.

For any further queries drop us an email at [email protected]