User Guide of Product Association Position Changer for Akeneo

Akeneo Product Association Position Changer module allows the admin to change the product association and as well as product model association position using the drag and drop technique.

The same position of the product and product model association will be used while exporting the products.

Product association can be thought of as a marketing strategy for informing your customers about the products they’re looking for and what they should think about when buying them.

Basic Requirements:

• This module works with Akeneo 3.0.x, 3.1.x, 3.2.x, 4.0.x, 5.0.x and 6.0.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

• Admin may drag and drop product associations to modify their positions.
• Admin can change the position of product model association using drag and drop.
• The same saved position of the product and product model association will be used during the export.
• This module is compatible with Akeneo latest version 6.0.x

Composer Installation

Read This Blog

For Akeneo 6

1: Get the ACCESS KEYS [Create a support ticket]
2: In Akeneo composer.json, add our repository as well as the installation script.

{
  "scripts": {
        "post-update-cmd": [
           "vendor/webkul/associationpositionchangerbundle/src/Webkul/AssociationPositionChangerBundle/install/config.sh COMPOSER=true NO_DOCKER=true"
        ],
        "post-install-cmd": [
           "vendor/webkul/associationpositionchangerbundle/src/Webkul/AssociationPositionChangerBundle/install/config.sh COMPOSER=true NO_DOCKER=true"
        ],
        "post-create-project-cmd": [
          "vendor/webkul/associationpositionchangerbundle/src/Webkul/AssociationPositionChangerBundle/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/associationpositionchangerbundle/composer_install.sh"
        ],
        "post-install-cmd": [
           
"vendor/webkul/associationpositionchangerbundle/composer_install.sh"
        ],
        "post-create-project-cmd": [
         
"vendor/webkul/associationpositionchangerbundle/composer_install.sh"
       ]
   },
  "repositories": [{
    "type": "composer",
    "url": "https://akeneorepo.webkul.com/"
  }]
}

3: Use composer to install the extension.

         composer require webkul/associationpositionchangerbundle

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

Installing Module for Version 6.0.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/AssociationPositionChangerBundle/install/config.sh COMPOSER=false NO_DOCKER=true

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

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

Module Installation for Version 4.0.x to 5.0.x

Please follow the below steps for installing the Akeneo Product Association Position Changer module in your Akeneo PIM platform.

• Unzip the respective extension zip then merge the “src” folder into the Akeneo project root directory.

• Goto config/Bundles.php then add line:

Webkul\AssociationPositionChangerBundle\AssociationPositionChangerBundle::class => ['all' => true],

in return array.

• Copy the “config” folder into akeneo project root directory for routing.

• 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 associationpositionchanger: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 :

For Akeneo 5

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;

For Akeneo 4

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 less;

Installing Module For Version 3.x

Please follow these steps for installing the Akeneo Product Association Position Changer module in your Akeneo PIM platform.

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

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

new Webkul\AssociationPositionChangerBundle\AssociationPositionChangerBundle(),

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

wk_association_position_changer:
    resource: "@AssociationPositionChangerBundle/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 associationpositionchanger: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

It might happen that even after proper installation, upon opening your Akeneo admin dashboard, you see a loading screen. In that case, do check for the following solution:

• Webpack Installation: If you get the below error.

It means that web pack is not installed in your system. Run the following command.

npm install --save-prod webpacknpm install

• Module routing.yml is not configured properly. Re-check the routing.yml file as mentioned in the 3rd step of Module Installation
• Clear your browser cache.

Uninstall Module: For Akeneo 6

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

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

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

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

You can go through the Video Guide to understand how Product Association Position Changer for Akeneo work.

Create Product in Akeneo

After Installation of the module in Akeneo, you have to navigate through Products -> Create Products as seen in the screenshot given below.

Afterward, the admin needs to choose the product type as Product as seen in the screenshot given below

After selecting the product action, you must provide certain information and click on the Save button.

• SKU(Stock Keeping Unit) – A stock keeping unit (SKU) is a unique identifier for a product that aids in inventory tracking.
• Family – A product family is a set of attributes that represent the products from the same family.

Afterward, clicking on the save button the product window will open, and here you have to fill in the details of the product like Name, Description, and etc.

However, You can make other attributes if you want to use them.

Additional features, such as images, color, and size, can be added.

After that, you must assign this product to a category. Hence, this item can be classified into one or more categories.

Change the Position of Product Association

Now you must select an association type by clicking the drop-down association type option. Click the ADD ASSOCIATIONS Button after that.

Here’s where you may add an associated product. You may use this page to filter and add items by category, family, and as well as status. Furthermore, You may also use the search function to find the product and as well as add it as an associated product.

The associated product may also be found on the right side of the page. Following that, you must click the confirm button.

Afterward, you can see an associative product list within the product as seen in the screenshot given below.

However, you can change the position of the product association using drag and drop.

Afterward, click on the Save button, and your product is added to the Akeneo product list as seen in the screenshot given below.

To export the product in the CSV file you need to select the products and as well as click on the QUICK EXPORT button as seen in the screenshot given below.

Afterward, you need to select the export details and click on the EXPORT button as seen in the screenshot given below.

You can download the CSV file of the product by clicking on the DOWNLOAD GENERATED FILES button as seen in the screenshot given below.

After the product has been exported, you may look at the CSV file to see whether you can modify the location of the product association using drag and drop, as seen in the picture below.

Change the Position of Product Model Association

Note: How to create product model – https://webkul.com/blog/create-product-and-product-model-in-akeneo/

You can also change the position of the product model association. to do so, you have to navigate through the product model list and select the variant product as seen in the screenshot given below.

Now you must select an association type by clicking the drop-down association type option and afterward, Click the ADD ASSOCIATION Button as seen in the screenshot given below.

Here’s where you may add an associated product. You may use this page to filter and add items by category, family, and as well as status. You may also use the search function to find the product and add it as an associated product.

On the right, you can also see the associative products. afterward, you have to click on CONFIRM button as per the below image.

However, you can see an associative product list in the variant product as seen in the screenshot given below.

You can change the position of the product model association using drag and as well as drop as seen in the screenshot given below and click on the Save button as per the below image.

To export the product model in the CSV file you need to select the products and as well as click on the QUICK EXPORT button as seen in the screenshot given below.

Afterward, you need to select the export details and as well as click on the Export button as seen in the screenshot given below.

By selecting the GENERATED FILES button, you may download the product’s CSV file as seen in the screenshot given below.

Once the product is exported you can check the CSV file regarding the change position of product association using drag and drop as seen in the screenshot given below.

Support

So, that was much about the User guide of Product Association for Position Changer for Akeneo for any queries or doubts reach out to us at [email protected]. You can also raise a ticket at our HelpDesk System.

Please explore our Akeneo Development Services and Quality Akeneo Extensions.

Shivam Virmani 4 Badges 20 July 2022