Implementation Guide

The SiteGenesis version of this integration follows the best practices for this storefront version. In order to achieve the features described in this document, please use the sample code snippets below as reference for this integration.

Setup of Business Manager

  1. Upload Cartridge & include into the cartridge patUpload the int_extend cartridge to the sandbox.
    1. Upload the int_extend cartridge to the sandbox.
    2. Go to Business Manager → Administration → Site → Manage Sites. Select the desired site and go to Settings. At the beginning of the Cartridge Path add “int_extend:” in order to include the cartridge in the current site’s configuration.
  2. Import metadata
    1. Go to Business Manager → Administration → Site Development → Import & Export
    2. Upload the following files from ./metadata/meta/ folder
      • system-objecttype-extensions.xml
      • custom-objecttype-definitions.xml
    3. Go to Business Manager → Administration → Site Development → Import & Export → Meta Data → Import. Both previous files should be available for import. Proceed to importing both.
  3. Import custom jobs
    1. Go to Business Manager → Administration → Operations → Import & Export
    2. Upload the following file: ./metadata/jobs.xml
    3. Go to Business Manager → Administration → Operations → Import & Export → Jobs → Import. The previous file should be available for import. Proceed to importing it.
  4. Import Service
    1. Go to Business Manager → Administration → Operations → Import & Export
    2. Upload the following file: ./metadata/services.xml
    3. Go to Business Manager → Administration → Operations → Import & Export → Services → Import. The previous file should be available for import. Proceed to importing it.
    4. Note: by default, the service URL is configured to point to the demo instance of the Extend API. Prior to going live with the integration, this will need to be changed and tested with the live production API.
  5. Import Extend Catalog
    1. Select the site integrating with Extend
    2. Go to Business Manager → Merchant Tools → Products and Catalogs → Import & Export
    3. Upload the following file: ./metadata/catalog.xml. This will import 3 dummy option products, which are used in order to create dynamic product line items in the cart. We recommend keeping this as a separate master catalog, for visibility purposes.