E-commerce Category Sync

Edition

Incubator (services)

Issues

Git

Git

Latest

1.1.0

Compatible with Magnolia 6.2.

The ecommerce-catalogsync module brings everything you need to enhance e-commerce categories with data collected in Magnolia as well as to play them out in an optimised order. It is based on the E-commerce module. For this purpose, the new CategoryImportCommand command is registered. To make use of this command, the E-Commerce Categories app is registered, which can be extended as desired via decoration. For the Categories App, a special field is also provided with which the displayed order of the products of a category can be changed by using drag-and-drop.

This module is at the INCUBATOR level.

Installing with Maven

Maven is the easiest way to install the module. Add the following to your bundle:

<dependency>
  <groupId>info.magnolia.ecommerce.catalogsync</groupId>
  <artifactId>category-importer</artifactId>
  <version>1.1.0</version>
</dependency>

Usage

This module contains a command and the corresponding app. Below you will learn how to use both.

App

The E-Commerce Categories app is registered automatically on the first startup of the module.

The app can be adapted to individual needs with the help of a decoration file. Below you will find an example of how to activate the visualMerchandise field included in the module.

To be able to use this example, the JavaScript Dialog Fields module must be installed.
decorations/ecommerce-catalogsync-app/apps/ecommerce-catalogsync-app.yaml
subApps:
  detail:
    form:
      implementationClass: info.magnolia.ui.javascript.form.FormViewWithChangeListener
      properties:
        visualMerchandise:
          label: Visual Merchandise
          $type: javascriptField
          fieldScript: /ecommerce-catalogsync-app/webresources/visualMerchandise.html
      layout:
        $type: tabbedLayout
        tabs:
          visualMerchandise:
            label: Visual Merchandise
            fields:
              - name: visualMerchandise
          system:
            label: System Properties
            fields:
              - name: name
              - name: externalId

Command

The CategoryImportCommand command is registered automatically on the first startup of the module under /module/category-importer/commands/pxm.

If you use the app that comes with this module, you do not need to adjust the command parameter. Therefore, all parameters are optional.
Command Description

workspace

optional, default is ecommerce-categories
The workspace in which the categories are synced.

contentType

optional, default is ecomcategory
The ContentType under which the categories are saved.

nodeNameProperty

optional, default is name
The property under which the name of the category is stored in JCR.

externalIdProperty

optional, default is externalId
The property under which the external ID of the category is stored in JCR.

Changelog

Version Notes

1.1.0

Several updates:

  • Introduced default values for command definition.

  • Introduced the visualMerchandise Field which can be used in the app to change the order of products via drag-and-drop.

  • Improved root category detection so the configuring of the root node is not necessary anymore.

  • Included the base app into the command module to bring base app and command together.

1.0.4

Minor updates.

1.0.3

Minor updates.

1.0.2

Minor updates.

1.0.1

Minor updates.

1.0.0

Initial release of the module.

Feedback