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
| Name | Beschreibung |
|---|---|
| Email branding color | Hex-Farbton zur Gestaltung der Export-/Import-Emails |
| Email branding image | Relativer 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
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
| Key | Beschreibung | Pflichtangabe | Beispiel |
|---|---|---|---|
key | Eindeutiger Name für Ihr Zielsystem (Camel-Case Schreibweise) | Ja | shop_staging |
target_type | Typ des Zielsystems. Derzeit wird dies nur im Falle des Wertes "shopware" verwendet, um codeseitige Logiken zu unterscheiden | Ja | shopware | pimcore | wordpress | andere... |
adapter_blocklist | Array von Adapternamen, die für dieses Exportziel gesperrt sind | Nein | fairs |
has_delta_management | Steuert, ob das Zielsystem Delta-Exporte verarbeiten kann (Standard true) | Nein | true | |
export_directory | Pfad zum Exportverzeichnis | Ja | /path/to/export/ |
asset_domain | Asset-Domain | Nein | https://assets.tld |
asset_directory | Pfad zum Asset-Verzeichnis | Ja | /path/to/assets/ |
image_path | URL-Präfix der Bild-Thumbnails im Export anstelle von asset_domain (Dokumente verwenden weiterhin asset_domain) | Nein | https://images.tld |
directory_resolver | DerIdentifier des zu nutzenden Directory-Resolvers zum bestimmen der Ablageverzeichnisse Siehe: Ablageverzeichnisse über ein Directory-Resolver bestimmen | Nein | default |
transfer > adapter | Der Identifier des zu nutzenden Transfer-Adapters für die Ablage von Dateien Siehe: Dateiablage über ein Transfer-Adapter | Nein | nfs |
transfer > parameters | Adapterabhängige Parameter, siehe: Dateiablage über ein Transfer-Adapter | Nein | host: 'sftp.example.com' username: 'user_name' password: Password123!' port: 22 |
asset_transfer > adapter | Der Identifier des zu nutzenden Transfer-Adapters für die Ablage von Assets. Ist asset_transfer nicht konfiguriert, wird der unter transfer konfigurierte Adapter genutztSiehe: Dateiablage über ein Transfer-Adapter | Nein | nfs |
asset_transfer > parameters | Adapterabhängige Parameter für den Asset-Transfer-Adapter, siehe: Dateiablage über ein Transfer-Adapter | Nein | host: 'sftp.example.com' port: 22 |
reporting > from | Reporting-Mailadresse des Absenders | Ja | sender@your-domain.tld |
reporting > reply_to | Reporting-Mailadresse des Reply-to-Empfängers | Nein | reply-to@your-domain.tld |
reporting > cc_recipients | Array der CC-Mailadressen für das Reporting | Nein | copy-recipient@your-domain.tld |
export_mail_subject | Betreff für Export-Mail-Report | Nein | Pimcore-Export to STAGE |
import_mail_subject | Betreff für Import-Mail-Report | Nein | Shopware-Import to STAGE |
supported_languages | Pimcore-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" | Nein | de en |
Adapter konfigurieren
| Key | Beschreibung | Pflichtangabe | Beispiel |
|---|---|---|---|
key | Eindeutiger Name für einen Adapter (entspricht dem PackageName des Adapters) | Ja | fairs |
hide_export_mask | Ausblenden der Option in der Export-Maske | Nein | true |
source_folder_ids | Array von Ordner- oder Objekt-IDs, deren untergeordnete Objekte beim Export berücksichtigt werden. Ohne Angabe gilt der Root-Ordner (ID 1) | Nein | 5 |
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