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.
| Name | Wert |
|---|---|
| Funktion | public function mapTranslations(Localizedfield $field, array $fieldNames = [], array $map = [], ?string $defaultLanguage = ''): array |
Argument $field | Localized-Fields vom Objekt |
(Optional) Argument $fieldNames | Pimcore-Feld-Identifier des Feldes, dessen Werte exportiert werden sollen |
(Optional) Argument $map | Legt den Namen des Zielfelds im Export fest |
(Optional) Argument $defaultLanguage | Fehlt in einer Sprache ein Wert, wird er aus der angegebenen Standardsprache entnommen |
| Rückgabewert | siehe 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").
| Name | Wert |
|---|---|
| Funktion | public function getSupportedLanguageMapping(array $supportedLanguages): array |
| Parameter | $supportedLanguages: Pimcore-Sprachen, z.B. ['de', 'en'] |
| Rückgabewert | Pimcore-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?").
| Name | Wert |
|---|---|
| Funktion | public function prepareTranslation(array $translations, array $keyMap = []): array |
Argument $translations | Übergabe der Übersetzungs-Arrays aus export |
(Optional) Argument $keyMap | Mapping der Felder: Exportfeld zum Zielfeld. Mit Mapping werden nur die gemappten Felder übernommen |
| Rückgabewert | Array |
Beispiel
protected function store(Result $result): ?EntityWrittenContainerEvent
{
// ...
foreach ($result as $entry) {
$records[] = [
'id' => $entry['uuid'],
'translations' => $this->service->prepareTranslation($entry['texts']),
// ...,
];
}
// ...
}