Zum Hauptinhalt springen
Version: 2026.10

Umgang mit Übersetzungen

In einigen Fällen ist es notwendig Übersetzungen zu exportieren und anschließend in Shopware zu importieren.

Pimcore​

In Pimcore steht der TranslationService zur Verfügung. Dieser kann im Adapter über die Methode $this->translationHelper() bezogen werden.

Klasse​

Twocream\ShopwareConnectorBundle\Service\TranslationService

Methode mapTranslations​

Die Methode ermittelt die Werte in allen verfügbaren Pimcore-Sprachen und gibt ein Array zurück. Dabei können Feldnamen beim Export umbenannt werden, um die spätere Verarbeitung in Shopware zu vereinfachen.

NameWert
Funktionpublic function mapTranslations(Localizedfield $field, array $fieldNames = [], array $map = [], ?string $defaultLanguage = ''): array
Argument $fieldLocalized-Fields vom Objekt
(Optional) Argument $fieldNamesPimcore-Feld-Identifier des Feldes, dessen Werte exportiert werden sollen
(Optional) Argument $mapLegt den Namen des Zielfelds im Export fest
(Optional) Argument $defaultLanguageFehlt in einer Sprache ein Wert, wird er aus der angegebenen Standardsprache entnommen
Rückgabewertsiehe Ausgabe

Beispiel​

protected function prepare($object): array
{
$texts = $this->translationHelper()->mapTranslations(
$object->getLocalizedfields(),
['articleName', 'description'],
['articleName' => 'name']
);

return [
// ...,
'translations' => $texts ?? [],
// ...,
];
}

Ausgabe​

Mit dem Sprachen-Mapping de: de_DE und en: en_GB:

[
'de_DE' => [
'name' => 'Beispiel Name',
'description' => 'Beispiel Beschreibung'
],
'en_GB' => [
'name' => 'Example name',
'description' => 'Example description'
]
]

Methode getSupportedLanguageMapping​

Die Methode liefert getLanguageMapping() eingeschränkt auf die übergebenen Pimcore-Sprachen. Bei einem leeren Array liefert sie das vollständige getLanguageMapping(). Der Produkt-Export übergibt die Option supported_languages des Zielsystems (siehe "Sprachen-Mapping konfigurieren").

NameWert
Funktionpublic function getSupportedLanguageMapping(array $supportedLanguages): array
Parameter$supportedLanguages: Pimcore-Sprachen, z.B. ['de', 'en']
RückgabewertPimcore-Sprache => Shopware-Locale, z.B. ['de' => 'de_DE', 'en' => 'en_GB']

Im Unterschied dazu enthält getLanguageMapping() – und damit mapTranslations() – alle gültigen und nicht deaktivierten Pimcore-Sprachen, Sprachen ohne Mapping unter ihrem Pimcore-Schlüssel. Der Produkt-Export (ProductAdapterAbstract) exportiert die Sprachen aus getSupportedLanguageMapping() (siehe "Pimcore-Sprache und Shopware-Locale").

Shopware​

In Shopware steht der ModuleService in jedem Import-Modul über $this->service zur Verfügung, z.B. $this->service->prepareTranslation().

Klasse​

Twocream\JsonImporter\Core\System\Import\Module\Service\ModuleService

Methode prepareTranslation​

Die Methode transformiert die exportierten Übersetzungen in das passende Shopware-Importformat. Dabei kann auch optional durch ein Mapping eine Umbenennung der Felder vorgenommen werden. Die Schlüssel der Übersetzungen werden über JsonImportConfiguration::getLocaleMapping() den Sprachen in Shopware zugeordnet, z.B. de => de_DE und en => en_GB (siehe "Welche Locales werden akzeptiert?").

NameWert
Funktionpublic function prepareTranslation(array $translations, array $keyMap = []): array
Argument $translationsÜbergabe der Übersetzungs-Arrays aus export
(Optional) Argument $keyMapMapping der Felder: Exportfeld zum Zielfeld. Mit Mapping werden nur die gemappten Felder übernommen
RückgabewertArray

Beispiel​

protected function store(Result $result): ?EntityWrittenContainerEvent
{
// ...

foreach ($result as $entry) {
$records[] = [
'id' => $entry['uuid'],
'translations' => $this->service->prepareTranslation($entry['texts']),
// ...,
];
}

// ...
}