# Bezeichnungen, Texte und Bilder

## Bezeichnung im Shop

Standardmäßig wird die Artikelbezeichnung als Produktname übernommen.

### Zusatz hinter Titel

Ist diese Einstellung aktiv, wird der Zusatz aus der Artikelmaske an die Bezeichnung
angehängt. Das Trennzeichen ist einstellbar, voreingestellt ist ein Gedankenstrich mit
Leerzeichen.

### Eigenes Feld als Titel

Soll der Shop-Titel von der SelectLine-Bezeichnung abweichen, kann ein Extrafeld als
Titel bestimmt werden. Das ist der Weg für werbliche Bezeichnungen, die im
Innendienst nicht erwünscht sind.

## Beschreibung

Als Beschreibung wird der Artikeltext übernommen — sofern vorhanden in der
HTML-Fassung, sonst als Text mit umgewandelten Zeilenumbrüchen.

### Eigenes Feld als Beschreibung

Alternativ lässt sich ein Extrafeld als Beschreibung festlegen.

### Keine Beschreibung übertragen

Wer die Beschreibungen im Shopware-Backend pflegt, schaltet die Übertragung ganz ab.

## Weitere Texte

Diese Artikeltexte gehen als Zusatzfelder in den Shop und können im Theme
ausgegeben werden:

| Text in der SelectLine | Zusatzfeld im Shop      |
| ---------------------- | ----------------------- |
| Dimensionstext         | `DimensionsText`         |
| Infotext               | `InfoText`               |
| Bestelltext            | `BestellText`            |

## Suchmaschinenoptimierung

Über Extrafelder in der Artikelmaske:

| Extrafeld           | Wirkung im Shop           |
| ------------------- | ------------------------- |
| `_METATITLE`        | Seitentitel                |
| `_METADESCRIPTION`  | Meta-Beschreibung          |
| `_METAKEYWORD`      | Suchbegriffe               |

Für weitere Sprachen wird die Sprachkennung angehängt, etwa `_METATITLE_EN`. Siehe
[Weitere Sprachen](https://wiki.dako-it.com/books/finnghost-fur-shopware6-wHZ/page/weitere-sprachen).

### Eigene Suchworte

Ein Extrafeld kann zusätzliche Suchbegriffe enthalten, kommagetrennt. Diese werden im
Shop als eigene Suchworte am Artikel hinterlegt.

## Maße und Gewicht

| Angabe   | Quelle                          |
| -------- | ------------------------------- |
| Gewicht  | Gewicht aus der Artikelmaske      |
| Breite   | Extrafeld `_DIMBREITE`            |
| Höhe     | Extrafeld `_DIMHOEHE`             |
| Länge    | Extrafeld `_DIMLAENGE`            |

<p class="callout info">Diese Angaben werden nur am Hauptartikel gesetzt. Varianten erben sie im Shop vom Hauptartikel.</p>

## Garantie

Shopware kann am Artikel eine Garantiedauer in Monaten führen. Woher sie kommt, legt die
Einstellung **Feld für Garantie in Monaten** fest. Zur Auswahl stehen die Freien Zahlen
sowie alle ganzzahligen Extrafelder der Artikeltabelle.

Steht dort keine Zahl größer 0, wird eine im Shop bereits hinterlegte Garantie wieder
entfernt. So verschwindet die Angabe, sobald das Feld in der SelectLine geleert wird.

<p class="callout warning">Shopware kennt dieses Feld erst ab Version 6.7.14. Bei älteren Shops wird die Garantie nicht übertragen, auch wenn ein Feld eingestellt ist. Die Shopware-Version ermittelt die Schnittstelle selbst.</p>

## Bilder

Die Artikelbilder aus der SelectLine werden in die Shopware-Mediathek geladen. Das
erste Bild wird das Titelbild, die weiteren folgen in der Reihenfolge aus der
SelectLine.

![Artikelbilder in der SelectLine](https://wiki.dako-it.com/uploads/images/gallery/2026-08/ghostdocs-finnghost-fur-shopware6-whz-sw6-artikel-texte-bilder-d5a587ca-artikel-bilder-storefront.png)

### Bildtitel und Alternativtext

Zu jedem Bild schreibt die Schnittstelle einen Titel und einen Alternativtext in die
Mediathek. Ohne weitere Einstellung setzt sie beide selbst zusammen, aus
Herstellerbezeichnung, Artikelbezeichnung und Artikelnummer — beim Titel zusätzlich mit
der Bildnummer.

Mit der Einstellung **Bildtitel und Alternativtext aus der SelectLine übernehmen**
kommen die Texte stattdessen vom Bild selbst: die **Beschreibung** wird der Titel, der
**Zusatz** der Alternativtext. Bleibt ein Feld in der SelectLine leer, greift für dieses
Feld weiter der zusammengesetzte Name. Für Gruppenbilder gilt das gleiche. Ändert man die
Texte in der SelectLine, gehen sie beim nächsten Bildexport des Artikels mit — das Bild
selbst muss dafür nicht neu geladen werden.

<p class="callout info">Für Suchmaschinen und Barrierefreiheit ist der Alternativtext der wichtigere der beiden Texte: Er soll beschreiben, was auf dem Bild zu sehen ist. Der zusammengesetzte Name aus Hersteller und Artikelnummer leistet das nicht — wo Alternativtexte zählen, gehört diese Einstellung aktiviert und das Feld <em>Zusatz</em> am Bild gepflegt.</p>

<p class="callout warning">Alternativtexte direkt in der Shopware-Mediathek zu pflegen, funktioniert nur, solange <em>Artikelbilder bei Aktualisierung übertragen</em> abgeschaltet ist. Ist die Einstellung aktiv, werden die Bilder eines Artikels bei jedem Export samt Eintrag in der Mediathek entfernt und neu geladen — von Hand gepflegte Titel und Alternativtexte sind danach weg. Das gilt auch für Bilder, die nur im Shop hängen und in der SelectLine nicht existieren.</p>

### Maximale Bildgröße

Bilder werden vor dem Hochladen auf diese Kantenlänge verkleinert, voreingestellt
1920 Pixel. Kleinere Bilder werden nicht vergrößert.

### Artikelbilder bei Aktualisierung übertragen

Ist diese Einstellung aktiv (Voreinstellung), werden Bilder bei jeder
Artikelaktualisierung mitgeprüft. Schaltet man sie ab, gehen Bilder nur beim ersten
Anlegen eines Artikels mit.

<p class="callout info">Weil bei einer Bildübertragung die vorhandenen Bilder zuerst entfernt und dann neu geladen werden, ist dies der zeitaufwendigste Teil des Artikelexports. Genau darum gibt es die Aufgabe <em>alle Artikel exportieren (ohne Bilder)</em>.</p>

### Bestehende Bilder im Shop aktualisieren

Wichtig beim Austausch von Bildern: Standardmäßig erkennt die Schnittstelle ein Bild
am Dateinamen und verwendet ein bereits vorhandenes weiter.

<p class="callout warning">Tauscht man ein Bild in der SelectLine gegen ein anderes aus, ohne dass sich der Dateiname ändert, bleibt im Shop das alte Bild stehen. Entweder diese Einstellung aktivieren oder die Benennung über den Bildinhalt wählen (nächster Punkt).</p>

### Hash als Dateinamen verwenden

Statt eines sprechenden Namens aus Hersteller, Bezeichnung und Artikelnummer wird
eine Prüfsumme des Bildinhalts als Dateiname verwendet. Vorteil: Ändert sich das
Bild, ändert sich automatisch der Name, und der Shop bekommt zuverlässig die neue
Fassung. Nachteil: In der Mediathek sind die Namen nicht mehr lesbar.

### Nur gekennzeichnete Daten exportieren

Berücksichtigt nur Bilder, die in der SelectLine mit dem Kennzeichen *Export*
versehen sind. So lässt sich steuern, welche Bilder in den Shop gehören und welche
nur intern sind.

### Gruppenbilder verwenden

Hat ein Artikel kein eigenes Bild, können die Bilder seiner Artikelgruppe verwendet
werden. Praktisch für Sortimente, in denen nur wenige Artikel eigene Fotos haben.

## Weiter

- [Weitere Felder aus SelectLine](https://wiki.dako-it.com/books/finnghost-fur-shopware6-wHZ/page/weitere-felder-aus-selectline)
- [Preise](https://wiki.dako-it.com/books/finnghost-fur-shopware6-wHZ/page/preise)