Unterschiedliche Produktbilder je Sprachen festlegen
Technische Informationen
Highlights
-
Produktbilder gezielt für einzelne Sprachen ein- oder ausblenden
-
Individuelle Titelbilder für unterschiedliche Sprachversionen festlegen
-
Standard-Cover als automatische Fallback-Lösung verwenden
Funktionen
-
Verfügbarkeit jedes Produktbildes für eine oder mehrere Sprachen festlegen
-
Bilder ohne Sprachzuordnung automatisch in allen Sprachen anzeigen
-
Für jede Sprache ein eigenes Produkt-Cover definieren
-
Standard-Cover als automatische Fallback-Lösung verwenden
-
Sprachabhängige Coverbilder im Storefront automatisch an die erste Position verschieben
-
Konfiguration direkt über die Produktmedien in der Shopware Administration
-
Mehrere Sprachen gleichzeitig einem Produktbild zuweisen
Zweck des Plugins
In mehrsprachigen Shops werden häufig unterschiedliche Produktbilder für die jeweiligen Sprachen benötigt. Verpackungen, Beschriftungen, Maßangaben, Anwendungshinweise oder Werbegrafiken enthalten oftmals sprachabhängige Inhalte und sollten daher nicht in jeder Sprachversion identisch dargestellt werden. Mit dem Plugin lässt sich die Anzeige von Produktbildern abhängig von der aktuell ausgewählten Sprache im Storefront steuern. Kund:innen sehen dadurch automatisch die Produktbilder, die zur jeweiligen Sprachversion passen.
Produktbilder abhängig von der Sprache anzeigen
Jedem Produktbild können direkt in der Medienkonfiguration des Produkts eine oder mehrere Sprachen zugewiesen werden. Im Storefront zeigt das Plugin automatisch nur jene Bilder an, die für die aktuell aktive Sprache verfügbar sind. Dadurch lassen sich beispielsweise unterschiedliche Verpackungen, Produktbeschriftungen, Informationsgrafiken oder Werbeinhalte verwenden, ohne dafür separate Produkte anlegen zu müssen.
Produktbilder für mehrere Sprachen verwenden
Ein Produktbild kann mehreren Sprachen gleichzeitig zugewiesen werden. Dies ist beispielsweise sinnvoll, wenn dasselbe Bild für mehrere Sprachversionen des Shops geeignet ist. Die Sprachzuordnung kann für jedes Bild individuell festgelegt werden, sodass allgemeine und sprachabhängige Produktbilder flexibel innerhalb derselben Bildergalerie kombiniert werden können.
Allgemeine Produktbilder in allen Sprachen anzeigen
Wird einem Produktbild keine Sprache zugewiesen, bleibt es automatisch in allen Sprachversionen sichtbar. Allgemeine Produktfotos ohne sprachabhängige Inhalte können dadurch weiterhin im gesamten Shop verwendet werden, während lediglich ausgewählte Bilder mit Texten oder Hinweisen auf bestimmte Sprachen eingeschränkt werden.
Individuelles Titelbild je Sprache festlegen
Für jede konfigurierte Sprache kann ein eigenes Produkt-Cover beziehungsweise Titelbild ausgewählt werden. Ist die jeweilige Sprache im Storefront aktiv, wird das zugewiesene Bild automatisch als Titelbild verwendet und an die erste Position der Bildergalerie verschoben. Dadurch erscheint das passende Bild auch überall dort, wo das Produkt-Cover ausgegeben wird, beispielsweise in Produktlistings oder auf der Produktdetailseite.
Standard-Titelbild als Rückfalllösung verwenden
Das reguläre Shopware-Titelbild kann weiterhin als Standard-Cover verwendet werden. Ist für die aktuell ausgewählte Sprache kein eigenes Titelbild hinterlegt, greift das Plugin automatisch auf dieses Standardbild zurück. Dadurch bleibt die Produktdarstellung auch dann vollständig, wenn nicht für jede Sprache ein individuelles Cover konfiguriert wurde.
Installation
- Plugin Manager über Erweiterungen > Meine Erweiterungen aufrufen
- Das Plugin hochladen, installieren und aktivieren
Plugin konfigurieren
Erweiterungen > Meine Erweiterungen > Produktbild Anzeige je Sprache > Konfigurieren
Grundeinstellungen
- Abschneiden der vorhandenen Konfiguration der Anzeigebildsprache beim Produktimport
Legt fest, ob bestehende Sprachzuordnungen der Produktbilder bei einem Produktimport über die Sync API durch die neu importierten Einträge ersetzt werden. Ist die Einstellung deaktiviert, bleiben vorhandene Zuordnungen bestehen.
Produktbilder je Sprache konfigurieren
Kataloge > Produkte > Produkt öffnen > Medien
- Kontextmenü des gewünschten Produktbildes öffnen
- „Bild/Cover konfigurieren“ auswählen
- Als Standard Cover nutzen
Legt das ausgewählte Bild als reguläres Titelbild des Produkts fest. - Unter „Das Bild sollte in den folgenden Sprachen verfügbar sein“ eine oder mehrere Sprachen auswählen
- „Verwenden Sie dieses Bild als Cover für [Sprache]“ aktivieren
- Konfiguration über „Übernehmen“ bestätigen
- Produkt speichern
Das Produktbild wird im Storefront nur angezeigt, wenn eine der zugewiesenen Sprachen aktiv ist. Wird keine Sprache ausgewählt, ist das Bild automatisch in allen Sprachen verfügbar.
Frequently Asked Questions
Ja, eine Nutzung der Zuordnung über die Sync-API ist möglich - hier ein Beispielaufruf: Sync-API Aufruf: /api/_action/sync
[
{
"key": "write",
"action": "upsert",
"entity": "product",
"payload": [
{
"id": "44211790f53d485cb59d9cdcce607c12",
"coverId": "380e35f6a4b2446fb1ae86a6fdfdc482",
"media": [
{
"id": "201188140388444d9f6ac8a143d4afc2",
"position": 0,
"acrisProductDisplayImage": {
"languages": [
{
"id": "d34fa0aad2544b3b91f1ae58d73eff23"
},
{
"id": "2fbb5fe2e29a4d70aa5854ce7ce3e20b"
}
],
"useImageAsCoverForLanguage": [
{
"languageId": "d34fa0aad2544b3b91f1ae58d73eff23",
"value": false
},
{
"languageId": "2fbb5fe2e29a4d70aa5854ce7ce3e20b",
"name": "English",
"value": false
}
]
}
},
{
"id": "380e35f6a4b2446fb1ae86a6fdfdc482",
"acrisProductDisplayImage": {
"languages": [
{
"id": "2fbb5fe2e29a4d70aa5854ce7ce3e20b"
}
],
"useImageAsCoverForLanguage": [
{
"languageId": "2fbb5fe2e29a4d70aa5854ce7ce3e20b",
"value": true
}
]
}
},
{
"id": "a2094d86f4de429784de005c792dba67",
"position": 2
}
]
}
]
}
]
* „languages“ beschreibt zu welchen Sprachen die Bilder zugeordnet sind. Hier musst du die UUID der Sprache nehmen. * „useImageAsCoverForLanguage“ beschreibt in welchen Sprachen das Bild als Cover genutzt werden soll. Es sollte pro Sprache natürlich immer nur ein Bild als Cover geben.
Ja. Das Plugin liefert keine eigene Store-API Route mit, aber das Plugin implementiert die Logik beim Laden von Produkten (technisches Event: „sales_channel.product.loaded“). Somit kann das Plugin bewerkstelligen, dass nur die der jeweiligen Sprache zugeordneten Medien beim Produkt geladen werden.
| Version | Datum | Shopware Kompatibilität | Changelog |
|---|---|---|---|
| 3.0.14 | 1. Juli 2026 | >=6.7.0.0 < 6.8.0.0 |
|
| 3.0.13 | 1. Juni 2026 | >=6.7.0.0 < 6.8.0.0 |
|
| 3.0.12 | 7. Mai 2026 | >=6.7.0.0 < 6.8.0.0 |
|
| 3.0.11 | 3. März 2026 | >=6.7.0.0 < 6.8.0.0 |
|
| 3.0.10 | 3. März 2026 | >=6.7.0.0 < 6.8.0.0 |
|
| 3.0.9 | 3. Februar 2026 | >=6.7.0.0 < 6.8.0.0 |
|
| 3.0.8 | 2. Februar 2026 | >=6.7.0.0 < 6.8.0.0 |
|
| 3.0.7 | 7. November 2025 | >=6.7.0.0 < 6.8.0.0 |
|
| 3.0.6 | 7. November 2025 | >=6.7.0.0 < 6.8.0.0 |
|
| 3.0.5 | 3. November 2025 | >=6.7.0.0 < 6.8.0.0 |
|
| 3.0.4 | 20. August 2025 | >=6.7.0.0 < 6.8.0.0 |
|
| 3.0.3 | 11. Juli 2025 | >=6.7.0.0 < 6.8.0.0 |
|
| 3.0.2 | 3. Juli 2025 | >=6.7.0.0 < 6.8.0.0 |
|
| 3.0.1 | 21. Mai 2025 | >=6.7.0.0 < 6.8.0.0 |
|
| 3.0.0 | 5. Mai 2025 | >=6.7.0.0 < 6.8.0.0 |
|
| 2.3.9 | 1. Juni 2026 | >=6.6.0.0 < 6.7.0.0 |
|
| 2.3.8 | 7. Mai 2026 | >=6.6.0.0 < 6.7.0.0 |
|
| 2.3.7 | 7. November 2025 | >=6.6.0.0 < 6.7.0.0 |
|
| 2.3.6 | 7. November 2025 | >=6.6.0.0 < 6.7.0.0 |
|
| 2.3.5 | 3. November 2025 | >=6.6.0.0 < 6.7.0.0 |
|
| 2.3.4 | 20. August 2025 | >=6.6.0.0 < 6.7.0.0 |
|
| 2.3.3 | 28. Juli 2025 | >=6.6.0.0 < 6.7.0.0 |
|
| 2.3.2 | 21. Mai 2025 | >=6.6.0.0 < 6.7.0.0 |
|
| 2.3.1 | 12. Mai 2025 | >=6.6.0.0 < 6.7.0.0 |
|
| 2.3.0 | 21. Februar 2025 | >=6.6.0.0 < 6.7.0.0 |
|
| 2.2.1 | 11. Dezember 2024 | >=6.6.0.0 < 6.7.0.0 |
|
| 2.2.0 | 13. September 2024 | >=6.6.0.0 < 6.7.0.0 |
|
| 2.1.2 | 6. September 2024 | >=6.6.0.0 < 6.7.0.0 |
|
| 2.1.1 | 26. August 2024 | >=6.6.0.0 < 6.7.0.0 |
|
| 2.1.0 | 21. August 2024 | >=6.6.0.0 < 6.7.0.0 |
|
| 2.0.2 | 19. Juni 2024 | >=6.6.0.0 < 6.7.0.0 |
|
| 2.0.1 | 22. März 2024 | >=6.6.0.0 < 6.7.0.0 |
|
| 2.0.0 | 21. März 2024 | >=6.6.0.0 < 6.7.0.0 |
|
| 1.6.1 | 1. Juni 2026 | >=6.5.0.0 < 6.6.0.0 |
|
| 1.6.0 | 19. Januar 2026 | >=6.5.0.0 < 6.6.0.0 |
|
| 1.5.0 | 21. Februar 2025 | >=6.5.0.0 < 6.6.0.0 |
|
| 1.4.0 | 13. September 2024 | >=6.5.0.0 < 6.6.0.0 |
|
| 1.3.1 | 6. September 2024 | >=6.5.0.0 < 6.6.0.0 |
|
| 1.3.0 | 21. August 2024 | >=6.5.0.0 < 6.6.0.0 |
|
| 1.2.5 | 27. November 2023 | >=6.4.0.0 |
|
| 1.2.4 | 17. November 2023 | >=6.4.0.0 |
|
| 1.2.3 | 18. September 2023 | >=6.4.0.0 |
|
| 1.2.2 | 8. September 2023 | >=6.4.0.0 |
|
| 1.2.1 | 25. April 2023 | >=6.4.0.0 |
|
| 1.2.0 | 20. April 2023 | >=6.4.0.0 |
|
| 1.1.6 | 3. März 2023 | >=6.4.0.0 |
|
| 1.1.5 | 1. März 2023 | >=6.4.0.0 |
|
| 1.1.4 | 13. Februar 2023 | >=6.4.0.0 |
|
| 1.1.3 | 20. Dezember 2022 | >=6.4.0.0 |
|
| 1.1.2 | 26. November 2022 | >=6.4.0.0 |
|
| 1.1.1 | 26. November 2022 | >=6.4.0.0 |
|
| 1.1.0 | 26. November 2022 | >=6.4.0.0 |
|
| 1.0.1 | 26. November 2022 | >=6.4.0.0 |
|
| 1.0.0 | 26. November 2022 | >=6.4.0.0 |
|