Zum Hauptinhalt springen
Version: 2026.10

Konfiguration

Bundle-Konfiguration​

Übersicht​

Das Bundle kann in der Twocream Bundle Übersicht konfiguriert werden. Diese ist über eine neue Schaltfläche mit Twocream-Logo in der Pimcore-Seitenleiste erreichbar, dort kann dann das Bundle ausgewählt werden um dessen Konfiguration zu öffnen.

Konfigurationsfelder​

NameBeschreibung
Email branding colorHex-Farbton zur Gestaltung der Export-/Import-Emails
Email branding imageRelativer Dateipfad (ausgehend vom Pimcore-Verzeichnis) des Logos, das in Export-/Import-Emails eingebettet wird

YAML-Konfiguration​

Allgemein​

Es muss eine YAML-Datei im Verzeichnis config/packages/shopware_connector.yaml des Pimcore-Projekts abgelegt werden. In dieser Datei werden alle Konfigurationen für das Bundle vorgenommen.

Aufbau​

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/'
directory_resolver: 'default'
transfer:
adapter: 'sftp'
parameters:
host: 'sftp.example.com'
username: 'user_name'
password: 'Password123!'
port: 22
asset_transfer:
adapter: 'nfs'
      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"
supported_languages:
- de
- en
  adapters:
    - key: YOUR-ADAPTER-PACKAGENAME
      source_folder_ids:
        - 5
        - 7
language_mapping:
de: 'de_DE'
en: 'en_GB'
disabled_languages:
- fr
Best Practice

Zur flexiblen Nutzung in verschiedenen Instanzen wird empfohlen, die Werte in Umgebungsvariablen (.env) auszulagern. So können einfach Anpassungen für die jeweiligen Instanzen vorgenommen werden, ohne die Service-Konfigurationsdatei bearbeiten zu müssen.

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)%'
directory_resolver: '%env(SW_CONNECTOR_TARGETS_SHOP_STAGING_DIRECTORY_RESOLVER)%'
transfer:
adapter: '%env(SW_CONNECTOR_TARGETS_SHOP_STAGING_TRANSFER_ADAPTER)%'
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)%'
directory_resolver: '%env(SW_CONNECTOR_TARGETS_SHOP_LIVE_DIRECTORY_RESOLVER)%'
transfer:
adapter: '%env(SW_CONNECTOR_TARGETS_SHOP_LIVE_TRANSFER_ADAPTER)%'
parameters:
host: '%env(SW_CONNECTOR_TARGETS_SHOP_LIVE_TRANSFER_SFTP_HOST)%'
username: '%env(SW_CONNECTOR_TARGETS_SHOP_LIVE_TRANSFER_SFTP_USERNAME)%'
password: '%env(SW_CONNECTOR_TARGETS_SHOP_LIVE_TRANSFER_SFTP_PASSWORD)%'
port: '%env(SW_CONNECTOR_TARGETS_SHOP_LIVE_TRANSFER_SFTP_PORT)%'
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: 'products'
source_folder_ids:
- '%env(SW_CONNECTOR_ADAPTERS_PRODUCTS_SOURCE_FOLDER_ID)%'
- key: 'attributes'
hide_export_mask: true
source_folder_ids:
- '%env(SW_CONNECTOR_ADAPTERS_ATTRIBUTES_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_DIRECTORY_RESOLVER=""
SW_CONNECTOR_TARGETS_SHOP_STAGING_TRANSFER_ADAPTER=""
SW_CONNECTOR_TARGETS_SHOP_LIVE_TRANSFER_SFTP_HOST=""
SW_CONNECTOR_TARGETS_SHOP_LIVE_TRANSFER_SFTP_USERNAME=""
SW_CONNECTOR_TARGETS_SHOP_LIVE_TRANSFER_SFTP_PASSWORD=""
SW_CONNECTOR_TARGETS_SHOP_LIVE_TRANSFER_SFTP_PORT=""
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_DIRECTORY_RESOLVER=""
SW_CONNECTOR_TARGETS_SHOP_LIVE_TRANSFER_ADAPTER=""
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_PRODUCTS_SOURCE_FOLDER_ID=""
SW_CONNECTOR_ADAPTERS_ATTRIBUTES_SOURCE_FOLDER_ID=""

Zielsysteme konfigurieren​

KeyBeschreibungPflichtangabeBeispiel
keyEindeutiger Name für Ihr Zielsystem (Camel-Case Schreibweise)Jashop_staging
target_typeTyp des Zielsystems. Derzeit wird dies nur im Falle des Wertes "shopware" verwendet, um codeseitige Logiken zu unterscheidenJashopware | pimcore | wordpress | andere...
adapter_blocklistArray von Adapternamen, die für dieses Exportziel gesperrt sindNeinfairs
has_delta_managementSteuert, ob das Zielsystem Delta-Exporte verarbeiten kann (Standard true)Neintrue |
export_directoryPfad zum ExportverzeichnisJa/path/to/export/
asset_domainAsset-DomainNeinhttps://assets.tld
asset_directoryPfad zum Asset-VerzeichnisJa/path/to/assets/
image_pathURL-Präfix der Bild-Thumbnails im Export anstelle von asset_domain (Dokumente verwenden weiterhin asset_domain)Neinhttps://images.tld
directory_resolverDerIdentifier des zu nutzenden Directory-Resolvers zum bestimmen der Ablageverzeichnisse

Siehe: Ablageverzeichnisse über ein Directory-Resolver bestimmen
Neindefault
transfer > adapterDer Identifier des zu nutzenden Transfer-Adapters für die Ablage von Dateien

Siehe: Dateiablage über ein Transfer-Adapter
Neinnfs
transfer > parametersAdapterabhängige Parameter, siehe: Dateiablage über ein Transfer-Adapter
Neinhost: 'sftp.example.com'
username: 'user_name'
password: Password123!'
port: 22
asset_transfer > adapterDer Identifier des zu nutzenden Transfer-Adapters für die Ablage von Assets. Ist asset_transfer nicht konfiguriert, wird der unter transfer konfigurierte Adapter genutzt

Siehe: Dateiablage über ein Transfer-Adapter
Neinnfs
asset_transfer > parametersAdapterabhängige Parameter für den Asset-Transfer-Adapter, siehe: Dateiablage über ein Transfer-AdapterNeinhost: 'sftp.example.com'
port: 22
reporting > fromReporting-Mailadresse des AbsendersJasender@your-domain.tld
reporting > reply_toReporting-Mailadresse des Reply-to-EmpfängersNeinreply-to@your-domain.tld
reporting > cc_recipientsArray der CC-Mailadressen für das ReportingNeincopy-recipient@your-domain.tld
export_mail_subjectBetreff für Export-Mail-ReportNeinPimcore-Export to STAGE
import_mail_subjectBetreff für Import-Mail-ReportNeinShopware-Import to STAGE
supported_languagesPimcore-Sprachen, die die Produkt-Adapter für dieses Zielsystem exportieren. Ohne Angabe werden alle in Pimcore aktivierten Sprachen exportiert, die nicht in disabled_languages stehen. Siehe "Sprachen-Mapping konfigurieren"Neinde
en

Adapter konfigurieren​

KeyBeschreibungPflichtangabeBeispiel
keyEindeutiger Name für einen Adapter (entspricht dem PackageName des Adapters)Jafairs
hide_export_maskAusblenden der Option in der Export-MaskeNeintrue
source_folder_idsArray von Ordner- oder Objekt-IDs, deren untergeordnete Objekte beim Export berücksichtigt werden. Ohne Angabe gilt der Root-Ordner (ID 1)Nein5

Sprachen-Mapping konfigurieren​

Es kann ein Mapping zwischen Pimcore-Sprachen und Shopware-Sprachen konfiguriert werden, dabei stellt die Pimcore-Sprache den Schlüssel und die Shopware-Sprache den Wert dar:

language_mapping:
de: 'de_DE'
en: 'en_GB'

Welche Pimcore-Sprachen der Produkt-Export (ProductAdapterAbstract) exportiert, wird pro Zielsystem mit supported_languages festgelegt. Ohne Angabe werden alle in Pimcore aktivierten Sprachen exportiert, die nicht in disabled_languages stehen. language_mapping bestimmt nur die Shopware-Locale: Eine Sprache ohne Eintrag wird unter ihrem Pimcore-Schlüssel exportiert (siehe "Pimcore-Sprache und Shopware-Locale").

twocream_shopware_connector:
export_targets:
- key: shop_staging
supported_languages:
- de
- en

Sprachen deaktivieren​

Über disabled_languages können einzelne Pimcore-Sprachen vom Export ausgeschlossen werden. Die angegebenen Sprachen werden beim Export übersprungen und auch im Sprachen-Mapping nicht berücksichtigt:

disabled_languages:
- fr