> For the complete documentation index, see [llms.txt](https://docs.rh-webdesign.com/cms-bundle/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rh-webdesign.com/cms-bundle/elemente/medien/audio-playlist.md).

# Audio Playlist

Mehrere Audiodateien als Playlist mit eigenem Player und Titelliste abspielen

Mit dem Element **Audio Playlist** bündelst du mehrere Audiodateien – zum Beispiel Podcast-Folgen, Hörproben, Interviews oder Musik – in einem gemeinsamen Player. Deine Kunden springen mit **Zurück / Weiter** zwischen den Titeln, starten einen Titel direkt aus der **Titelliste** und spulen über den Fortschrittsbalken an jede beliebige Stelle.

Der Player übernimmt automatisch die Farben deines Themes. Möchtest du nur eine einzelne Audiodatei einbinden, genügt das Element [Audio / Musik](https://docs.rh-webdesign.com/cms-bundle/elemente/medien/audio-musik.md).

<figure><img src="https://3915424864-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnbkIIyayUD6QJmp1xMoG%2Fuploads%2Fgit-blob-f44fa1aed05b3bd93d17d09835f2dbec80ad980b%2Faudio-playlist-beispiel.webp?alt=media" alt=""><figcaption><p>Beispiel im Storefront: Playlist mit vier Titeln, der zweite Titel wird gerade abgespielt</p></figcaption></figure>

{% hint style="success" %}
**Tipp: Verwende MP3-Dateien**

MP3 spielt auf allen gängigen Geräten – auch auf iPhone und iPad – und lässt sich in der Shopware-Medienverwaltung ohne weitere Einstellungen hochladen. Mehr dazu im Abschnitt **Unterstützte Dateiformate** am Ende dieser Seite.
{% endhint %}

### Block hinzufügen

Die Audio Playlist steht dir als fertiger Block zur Verfügung, den du per **Drag & Drop** in deine Erlebniswelt ziehst.

<div align="left"><figure><img src="https://3915424864-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnbkIIyayUD6QJmp1xMoG%2Fuploads%2Fgit-blob-90eda86877eaaf2a616b5a373fbb0272b8b90699%2Faudio-playlist-block-auswahl.webp?alt=media" alt="" width="360"><figcaption><p>Block „Audio Playlist“ in der Kategorie „Medien“</p></figcaption></figure></div>

1. Öffne deine Erlebniswelt unter **Inhalte > Erlebniswelten** und klicke in der rechten Leiste auf **Blöcke** (1).
2. Wähle im Auswahlfeld darunter die Kategorie **Medien** (2).
3. Ziehe den Block **Audio Playlist** (rot markiert) an die gewünschte Stelle in deiner Sektion.

### Element austauschen

Du kannst auch ein bereits platziertes Element durch die Audio Playlist ersetzen. Klicke das Element in der Erlebniswelt an und fahre mit der Maus darüber – oben rechts erscheinen zwei Schaltflächen:

<figure><img src="https://3915424864-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnbkIIyayUD6QJmp1xMoG%2Fuploads%2Fgit-blob-2901ee61eeb55d9eb3f1d37a8ff3beaa2e4b070f%2Faudio-playlist-element-aktionen.webp?alt=media" alt=""><figcaption><p>Schaltflächen eines Elements in der Erlebniswelt</p></figcaption></figure>

<table><thead><tr><th width="287">Funktion</th><th>Beschreibung</th></tr></thead><tbody><tr><td>Element austauschen (1)</td><td>Öffnet die Element-Auswahl von Shopware, in der du ein anderes Element für diesen Platz wählst.</td></tr><tr><td>Einstellungen (2)</td><td>Öffnet die <a href="#element-einstellungen">Element-Einstellungen</a> der Audio Playlist.</td></tr></tbody></table>

Im Fenster **„Element austauschen“** findest du die Audio Playlist in der Gruppe **CMS Bundle - Content Elemente** – im rot markierten Feld. Ein Klick auf die Kachel setzt das Element ein.

<figure><img src="https://3915424864-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnbkIIyayUD6QJmp1xMoG%2Fuploads%2Fgit-blob-777d9e4ff31ce41c18a90e673524edd50435b139%2Faudio-playlist-element-auswahl.webp?alt=media" alt=""><figcaption><p>Die Audio Playlist in der Element-Auswahl</p></figcaption></figure>

### Element-Einstellungen

Über das Zahnrad (2) öffnest du die Einstellungen. Sie sind auf drei Reiter verteilt: **Titel**, **Verhalten** und **Darstellung**.

#### Titel

Hier legst du die Titel deiner Playlist an. Jeder Eintrag besteht aus einer Audiodatei und dem Namen, der im Shop angezeigt wird.

{% hint style="info" %}
**Hinweis „Keine Titel vorhanden“**

Ein neu eingefügter Block enthält noch keine Titel. Solange die Liste leer ist, zeigt die Erlebniswelt an der Stelle des Players – und der Reiter **Titel** über der Schaltfläche **Titel hinzufügen** – den Hinweis „Keine Titel vorhanden – Das Element wird in der Storefront nicht angezeigt, solange keine Titel hinzugefügt wurden.“ Sobald du den ersten Titel hinzufügst, verschwindet der Hinweis.
{% endhint %}

<figure><img src="https://3915424864-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnbkIIyayUD6QJmp1xMoG%2Fuploads%2Fgit-blob-52c75be96a53945bfa649b79b809f312f558f322%2Faudio-playlist-titel.webp?alt=media" alt=""><figcaption><p>Reiter „Titel“ mit aufgeklapptem ersten Eintrag</p></figcaption></figure>

<table><thead><tr><th width="287">Funktion</th><th>Beschreibung</th></tr></thead><tbody><tr><td>Eintrag auf- / zuklappen (1)</td><td>Ein Klick auf den Namen eines Titels klappt den Eintrag auf, damit du ihn bearbeiten kannst.</td></tr><tr><td>Angezeigter Name (2)</td><td>Name des Titels im Player und in der Titelliste. Bleibt das Feld leer, wird der Titel der Mediendatei aus der Medienverwaltung bzw. ihr Dateiname verwendet. Beim Zuweisen einer Datei wird ein leeres Feld automatisch damit vorbelegt.</td></tr><tr><td>Audiodatei (3)</td><td>Lade hier die Audiodatei hoch oder wähle eine vorhandene Datei aus der Medienverwaltung. Empfohlen ist MP3 (siehe Abschnitt <strong>Unterstützte Dateiformate</strong>).</td></tr><tr><td>Nach oben / Nach unten verschieben (4)</td><td>Verschiebt den Titel um eine Position. Die Reihenfolge hier ist die Reihenfolge im Player und in der Titelliste. Beim ersten bzw. letzten Eintrag ist die jeweilige Pfeil-Schaltfläche ausgegraut.</td></tr><tr><td>Löschen (5)</td><td>Entfernt den Titel aus der Playlist. Die Audiodatei selbst bleibt in der Medienverwaltung erhalten.</td></tr><tr><td>Titel hinzufügen (6)</td><td>Legt am Ende der Liste einen neuen, leeren Eintrag an.</td></tr></tbody></table>

**So legst du die Playlist an:**

1. Klicke auf **Titel hinzufügen** (6) – für jeden Titel einmal.
2. Klappe den neuen Eintrag auf (1) und lade bei **Audiodatei** (3) die Datei hoch oder wähle sie aus der Medienverwaltung.
3. Passe bei Bedarf den **Angezeigten Namen** (2) an.
4. Bringe die Titel mit den Pfeilen (4) in die gewünschte Reihenfolge.
5. Schließe die Einstellungen mit **Fertig** und speichere die Erlebniswelt.

{% hint style="info" %}
Einträge ohne Audiodatei werden im Shop übersprungen. Ist keinem Eintrag eine Datei zugewiesen, wird die Audio Playlist im Shop gar nicht angezeigt – auch wenn der Hinweis „Keine Titel vorhanden“ im Admin bereits verschwunden ist, denn er prüft nur, ob Einträge vorhanden sind. Ab sechs Titeln erscheint über der Liste zusätzlich ein Suchfeld, mit dem du Einträge schnell wiederfindest.
{% endhint %}

#### Verhalten

Im Reiter **Verhalten** legst du fest, welche Bedienelemente angezeigt werden und was am Ende eines Titels passiert.

<figure><img src="https://3915424864-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnbkIIyayUD6QJmp1xMoG%2Fuploads%2Fgit-blob-1d00a0abf5e97df88491645dd6e85d41c420e61f%2Faudio-playlist-verhalten.webp?alt=media" alt=""><figcaption><p>Reiter „Verhalten“ mit den Standardwerten</p></figcaption></figure>

<table><thead><tr><th width="287">Funktion</th><th>Beschreibung</th></tr></thead><tbody><tr><td>Titelliste anzeigen (1)</td><td>Zeigt die Liste aller Titel unterhalb des Players. Ein Klick auf einen Eintrag startet den Titel. Standard: aktiv.</td></tr><tr><td>Lautstärke-Regler anzeigen (2)</td><td>Zeigt im Player das Lautsprecher-Symbol zum Stummschalten und den Lautstärke-Regler. Auf iPhone und iPad wird der Regler automatisch ausgeblendet (siehe <a href="#ansicht-auf-dem-smartphone">Ansicht auf dem Smartphone</a>). Standard: aktiv.</td></tr><tr><td>Nächsten Titel automatisch abspielen (3)</td><td>Startet nach dem Ende eines Titels automatisch den nächsten. Ist die Option deaktiviert, stoppt die Wiedergabe nach jedem Titel. Standard: aktiv.</td></tr><tr><td>Playlist in Endlosschleife abspielen (4)</td><td>Beginnt nach dem letzten Titel wieder mit dem ersten. Wirkt nur, wenn <strong>Nächsten Titel automatisch abspielen</strong> (3) aktiv ist. Standard: inaktiv.</td></tr></tbody></table>

**Titelliste ausgeblendet** – es bleibt nur der Player; gewechselt wird über **Zurück / Weiter**:

<figure><img src="https://3915424864-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnbkIIyayUD6QJmp1xMoG%2Fuploads%2Fgit-blob-31e3398ca945670b3e016293fc38a8327a583071%2Faudio-playlist-ohne-titelliste.webp?alt=media" alt=""><figcaption><p>„Titelliste anzeigen“ deaktiviert</p></figcaption></figure>

**Lautstärke-Regler ausgeblendet** – der Fortschrittsbalken nutzt die volle Breite:

<figure><img src="https://3915424864-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnbkIIyayUD6QJmp1xMoG%2Fuploads%2Fgit-blob-fe9a67f543f2dbf2d44bffdcd45da4a36f6428aa%2Faudio-playlist-ohne-lautstaerke.webp?alt=media" alt=""><figcaption><p>„Lautstärke-Regler anzeigen“ deaktiviert</p></figcaption></figure>

#### Darstellung

Im Reiter **Darstellung** passt du die Farben des Players an.

<figure><img src="https://3915424864-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnbkIIyayUD6QJmp1xMoG%2Fuploads%2Fgit-blob-6029e5aa1c6da8c0845e67996c4b5bedfd93beae%2Faudio-playlist-darstellung.webp?alt=media" alt=""><figcaption><p>Reiter „Darstellung“ mit den vorbelegten Theme-Farben</p></figcaption></figure>

<table><thead><tr><th width="287">Funktion</th><th>Beschreibung</th></tr></thead><tbody><tr><td>Akzentfarbe (1)</td><td>Farbe für den Play-Button, den Fortschrittsbalken, den Lautstärke-Regler und den aktiven Titel in der Titelliste. Vorbelegt mit <code>var(--bs-primary)</code>, der Primärfarbe deines Themes.</td></tr><tr><td>Hintergrund Player (2)</td><td>Hintergrundfarbe des oberen Player-Bereichs. Vorbelegt mit <code>var(--bs-light)</code>, der hellen Farbe deines Themes.</td></tr></tbody></table>

{% hint style="info" %}
Solange die Theme-Variablen eingetragen sind, folgt der Player automatisch deinem Theme – das Farbfeld links zeigt dafür keine Vorschau. Hast du eine eigene Farbe gewählt und möchtest zurück zur Theme-Farbe, trage wieder `var(--bs-primary)` bzw. `var(--bs-light)` ein.
{% endhint %}

<figure><img src="https://3915424864-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnbkIIyayUD6QJmp1xMoG%2Fuploads%2Fgit-blob-e11c7e846bb38f7000abdf202db712177eb6c085%2Faudio-playlist-farben.webp?alt=media" alt=""><figcaption><p>Eigene Farben: Akzentfarbe #2f7d5b, Hintergrund Player #eef6f1</p></figcaption></figure>

### Bedienung im Shop

So bedienen deine Kunden die Audio Playlist im Storefront:

<figure><img src="https://3915424864-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnbkIIyayUD6QJmp1xMoG%2Fuploads%2Fgit-blob-695ccfc83c305cc40b35c69557315eb604367bfc%2Faudio-playlist-bedienung.webp?alt=media" alt=""><figcaption><p>Bedienelemente des Players</p></figcaption></figure>

<table><thead><tr><th width="287">Funktion</th><th>Beschreibung</th></tr></thead><tbody><tr><td>Zurück (1)</td><td>Wechselt zum vorherigen Titel. Beim ersten Titel geht es zum letzten Titel der Playlist.</td></tr><tr><td>Abspielen / Pausieren (2)</td><td>Startet oder pausiert den aktuellen Titel.</td></tr><tr><td>Weiter (3)</td><td>Wechselt zum nächsten Titel. Nach dem letzten Titel geht es wieder zum ersten.</td></tr><tr><td>Aktueller Titel (4)</td><td>Zeigt den Namen des Titels, der gerade geladen ist.</td></tr><tr><td>Fortschrittsbalken (5)</td><td>Zeigt die aktuelle Position und die Gesamtdauer. Durch Klicken oder Ziehen springen deine Kunden an jede Stelle des Titels.</td></tr><tr><td>Lautstärke (6)</td><td>Das Lautsprecher-Symbol schaltet stumm und wieder laut, mit dem Regler daneben wird die Lautstärke eingestellt. Nur sichtbar, wenn <strong>Lautstärke-Regler anzeigen</strong> aktiv ist.</td></tr><tr><td>Titelliste (7)</td><td>Ein Klick auf einen Titel startet ihn sofort. Ein Klick auf den laufenden Titel pausiert ihn. Der aktive Titel ist in der Akzentfarbe hervorgehoben.</td></tr></tbody></table>

{% hint style="info" %}
**Gut zu wissen**

* Die Wiedergabe startet erst, wenn deine Kunden auf Play oder einen Titel klicken – nie automatisch beim Seitenaufruf.
* **Zurück / Weiter** behalten den Zustand bei: Läuft gerade ein Titel, startet der neue sofort; ist der Player pausiert, wird nur gewechselt.
* Platzierst du mehrere Audio Playlists auf einer Seite, läuft immer nur eine: Startet eine Playlist, pausiert die andere automatisch.
  {% endhint %}

### Ansicht auf dem Smartphone

Auf kleinen Bildschirmen rückt der Lautstärke-Regler in eine eigene Zeile unter den Fortschrittsbalken, lange Titel in der Liste brechen um.

<div align="left"><figure><img src="https://3915424864-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnbkIIyayUD6QJmp1xMoG%2Fuploads%2Fgit-blob-ffcc010c70efd36e26a0a74da9f3a6ee98a02fe0%2Faudio-playlist-mobil.webp?alt=media" alt="" width="320"><figcaption><p>Smartphone (Android): Lautstärke-Regler in eigener Zeile</p></figcaption></figure></div>

Auf **iPhone und iPad** (iOS / iPadOS) lässt sich die Lautstärke einer Webseite nicht per Regler steuern – dort regeln deine Kunden sie über die Lautstärketasten des Geräts. Der Player erkennt das und blendet den Lautstärke-Regler automatisch aus, auch wenn **Lautstärke-Regler anzeigen** aktiv ist.

<div align="left"><figure><img src="https://3915424864-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnbkIIyayUD6QJmp1xMoG%2Fuploads%2Fgit-blob-8964db6c5a32bb1e4663169044a3c60e48643191%2Faudio-playlist-mobil-ios.webp?alt=media" alt="" width="320"><figcaption><p>iPhone: Lautstärke-Regler automatisch ausgeblendet</p></figcaption></figure></div>

### Unterstützte Dateiformate

Die Audiodateien lädst du über die Shopware-Medienverwaltung hoch. Welche Dateiendungen sie annimmt, legt Shopware fest:

<table><thead><tr><th width="287">Format</th><th>Hinweis</th></tr></thead><tbody><tr><td>MP3 (<code>.mp3</code>)</td><td><strong>Empfohlen.</strong> Wird standardmäßig angenommen und auf allen gängigen Geräten abgespielt, auch auf iPhone und iPad.</td></tr><tr><td>Weitere Audioformate</td><td>Shopware nimmt standardmäßig unter anderem auch <code>.wav</code>, <code>.aac</code>, <code>.ogg</code> und <code>.flac</code> an. Ob ein Format abgespielt wird, hängt vom Browser deiner Kunden ab.</td></tr><tr><td>M4A (<code>.m4a</code>)</td><td><strong>Standardmäßig nicht erlaubt.</strong> Die Medienverwaltung lehnt den Upload mit einer Fehlermeldung ab.</td></tr></tbody></table>

{% hint style="warning" %}
**M4A-Datei lässt sich nicht hochladen?**

Wandle die Datei vor dem Hochladen in MP3 um. Alternativ kann dein Entwickler oder Hoster die Dateiendung `.m4a` in der Shopware-Konfiguration für Medien-Uploads freischalten.
{% endhint %}
