Version: 2025.9

Configuration

General

A YAML file must be placed in the directory config/packages/shopware_connector.yaml of the Pimcore project. All configurations for the bundle are made in this file.

Structure of Configuration

twocream_shopware_connector:
  export_targets:
    - key: shop_staging
      target_type: shopware
      has_delta_management: true
      adapter_blocklist:
        - links
        - fairs
        - press
      export_directory: '/path/to/export/directory/'
      asset_domain: 'https://assets.tld'
      asset_directory: '/path/to/asset/directory/'
      reporting:
        from: 'sender@your-domain.tld'
        reply_to: 'reply-to@your-domain.tld'
        cc_recipients:
          - copy-recipient@your-domain.tld
      import_mail_subject: "Shopware-Import to STAGE"
      export_mail_subject: "Pimcore-Export to STAGE"
  adapters:
    - key: YOUR-ADAPTER-PACKAGENAME
      source_folder_ids:
        - 5
        - 7
  language_mapping:
    de: 'de_DE'
    en: 'en_GB'

Best Practice

For flexible use in different instances, it is recommended to outsource the values into environment variables (.env). This allows easy adjustments for the respective instances without having to edit the service configuration file.

twocream_shopware_connector:
  export_targets:
    - key: shop_staging
      target_type: shopware
      has_delta_management: true
      export_directory: '%env(SW_CONNECTOR_TARGETS_SHOP_STAGING_EXPORT_DIRECTORY)%'
      asset_domain: '%env(SW_CONNECTOR_TARGETS_SHOP_STAGING_ASSET_DOMAIN)%'
      asset_directory: '%env(SW_CONNECTOR_TARGETS_SHOP_STAGING_ASSET_DIRECTORY)%'
      reporting:
        from: '%env(SW_CONNECTOR_TARGETS_SHOP_STAGING_REPORTING_FROM)%'
        reply_to: '%env(SW_CONNECTOR_TARGETS_SHOP_STAGING_REPORTING_REPLY_TO)%'
      import_mail_subject: "%env(SW_CONNECTOR_TARGETS_SHOP_STAGING_IMPORT_MAIL_SUBJECT)%"
      export_mail_subject: "%env(SW_CONNECTOR_TARGETS_SHOP_STAGING_EXPORT_MAIL_SUBJECT)%"
    - key: shop_live
      target_type: shopware
      has_delta_management: true
      export_directory: '%env(SW_CONNECTOR_TARGETS_SHOP_LIVE_EXPORT_DIRECTORY)%'
      asset_domain: '%env(SW_CONNECTOR_TARGETS_SHOP_LIVE_ASSET_DOMAIN)%'
      asset_directory: '%env(SW_CONNECTOR_TARGETS_SHOP_LIVE_ASSET_DIRECTORY)%'
      reporting:
        from: '%env(SW_CONNECTOR_TARGETS_SHOP_LIVE_REPORTING_FROM)%'
        reply_to: '%env(SW_CONNECTOR_TARGETS_SHOP_LIVE_REPORTING_REPLY_TO)%'
      import_mail_subject: "%env(SW_CONNECTOR_TARGETS_SHOP_LIVE_IMPORT_MAIL_SUBJECT)%"
      export_mail_subject: "%env(SW_CONNECTOR_TARGETS_SHOP_LIVE_EXPORT_MAIL_SUBJECT)%"
  adapters:
    - key: 'product'
      source_folder_ids:
        - '%env(SW_CONNECTOR_ADAPTERS_PRODUCT_SOURCE_FOLDER_ID)%'
    - key: 'product-attribute'
      hide_export_mask: true
      source_folder_ids:
        - '%env(SW_CONNECTOR_ADAPTERS_PRODUCT_ATTRIBUTE_SOURCE_FOLDER_ID)%'

SW_CONNECTOR_TARGETS_SHOP_STAGING_EXPORT_DIRECTORY=""
SW_CONNECTOR_TARGETS_SHOP_STAGING_ASSET_DOMAIN=""
SW_CONNECTOR_TARGETS_SHOP_STAGING_ASSET_DIRECTORY=""
SW_CONNECTOR_TARGETS_SHOP_STAGING_REPORTING_FROM=""
SW_CONNECTOR_TARGETS_SHOP_STAGING_REPORTING_REPLY_TO=""
SW_CONNECTOR_TARGETS_SHOP_STAGING_IMPORT_MAIL_SUBJECT=""
SW_CONNECTOR_TARGETS_SHOP_STAGING_EXPORT_MAIL_SUBJECT=""
SW_CONNECTOR_TARGETS_SHOP_LIVE_EXPORT_DIRECTORY=""
SW_CONNECTOR_TARGETS_SHOP_LIVE_ASSET_DOMAIN=""
SW_CONNECTOR_TARGETS_SHOP_LIVE_ASSET_DIRECTORY=""
SW_CONNECTOR_TARGETS_SHOP_LIVE_REPORTING_FROM=""
SW_CONNECTOR_TARGETS_SHOP_LIVE_REPORTING_REPLY_TO=""
SW_CONNECTOR_TARGETS_SHOP_LIVE_IMPORT_MAIL_SUBJECT=""
SW_CONNECTOR_TARGETS_SHOP_LIVE_EXPORT_MAIL_SUBJECT=""
SW_CONNECTOR_ADAPTERS_PRODUCT_SOURCE_FOLDER_ID=""
SW_CONNECTOR_ADAPTERS_PRODUCT_ATTRIBUTE_SOURCE_FOLDER_ID=""

Configure Target Systems

Key	Description	Mandatory	Example
`key`	Unique name for your target system (CamelCase notation)	Yes	shop_staging
`target_type`	Type of the target system. Currently, this is only used in the case of the value "shopware" to distinguish code-side logic	Yes	shopware \| pimcore \| wordpress \| others...
`adapter_blocklist`	Array of adapter names that are blocked for this export target	No	fairs
`has_delta_management`	Controls whether the target system can process delta exports	Yes	true \| false
`export_directory`	Path to the export directory	Yes	/path/to/export/
`asset_domain`	Asset domain	Yes	https://assets.tld
`asset_directory`	Path to the asset directory	Yes	/path/to/assets/
`reporting > from/reply_to`	Reporting email addresses for sender and reply-to recipients	Yes	sender@your-domain.tld
`reporting > cc_recipients`	Array of CC email addresses for reporting	No	copy-recipient@your-domain.tld
`export_mail_subject`	Subject for export email report	No	Pimcore-Export to STAGE
`import_mail_subject`	Subject for import email report	No	Shopware-Import to STAGE

Configure Adapters

Key	Description	Mandatory	Example
`key`	Unique name for an adapter (corresponds to the package name of the adapter)	Yes	fairs
`hide_export_mask`	Hide the option in the export mask	No	true
`source_folder_ids`	Array of folder IDs to be considered during export	Yes	5

General​

Structure of Configuration​

Configure Target Systems​

Configure Adapters​

General

Structure of Configuration

Configure Target Systems

Configure Adapters