Audio Folder Suite – Album-Player, Sharing, SEO & Tracks-Sitemap in einem Plugin

Mit Audio Folder Suite brauchst du kein Plugin-Bündel mehr: Du bekommst einen schnellen Album-/Playlist-Player, schöne Single-Track-Share-Seiten, saubere OG-/Twitter-Metadaten (inkl. Favicon pro Track) und eine eigene Tracks-Sitemap – alles schlank, crawler-freundlich und kompatibel mit Rank Math (Free).

---

Highlights

• Schneller Album-/Playlist-Player (SSR + JS): Suche, Sortierung, Keyboard-Shortcuts, Mobile-Swipe.

• Bessere UX: Cover, Titel & Favicon werden sofort gesetzt – Audio lädt danach.

• Share-Seiten pro Track (/share/?track=…), perfekt für Facebook, X/Twitter, WhatsApp & Google.

• OG-/Twitter-Bildlogik: immer erst Track-Cover, sonst Album-Default (1200×630).

• Intelligente Description (≈160 Zeichen):
  ©Jahr, Composer, Artist – Title / mm:ss / Genre / Album
  Falls Platz: , mp3, , wav, , download, , anhören.

• Favicons pro Track (16–512px), praktisch auf Mobilgeräten & Shortcuts.

• Rank-Math-Integration: Titel/Description/OG/Canonical sauber überschrieben.

• Eigene Tracks-Sitemap: …/afs-tracks-sitemap.xml inkl. <lastmod>; optionaler Eintrag im Rank-Math Index.

• Kein Theme-Lock-in (Divi, Block-Themes, Classic) & Cache/CDN-freundlich.

---

Quickstart (in 5 Minuten)

1. Album-Ordner anlegen (z. B.):

2. musicData.json füllen (Beispiel siehst du weiter unten).

3. Auf deiner Seite/Beitragsseite diesen Shortcode einfügen:

4. Permalinks speichern (Einstellungen → Permalinks → „Änderungen speichern“), damit:

• schöne Share-URLs &

• https://deine-seite.tld/afs-tracks-sitemap.xml
  funktionieren.

Fertig – Player plus SEO/OG-Magie sind aktiv. 🙂

---

Ordner & Cover-Konvention

• Track-Covers: Du hinterlegst in musicData.json nur den Basispfad in cover.
  Das Plugin ergänzt automatisch die benötigten Suffixe:

  • -48.jpg, -512.jpg, -1080.jpg, -1200x630.jpg

• Fehlt ein Track-Cover, nutzt das Plugin die Album-Defaults in covers/default-cover-*.jpg.

---

musicData.json – Feldreferenz (Beispiel)

Wichtig

• duration in Sekunden (Anzeige als mm:ss).

• cover ohne Suffixe – das Plugin hängt Größen an.

• file/wav optional → Download-Buttons werden automatisch eingeblendet.

---

Shortcodes

Album-/Playlist-Player (empfohlen)

Kompatibilität (falls vorhanden)

---

Teilen einzelner Titel

• Share-URL (empfohlen):
  https://deine-seite.tld/deine-album-seite/share/?track=<Dateiname.mp3>

• Direkter Player-Link:
  https://deine-seite.tld/deine-album-seite/?track=<Dateiname.mp3>

Im Player gibt’s den Button „Jetzt teilen“, der die /share-URL in die Zwischenablage kopiert.

---

SEO & Social: so werden Metadaten gebaut

• Title
  Titel – Seitenname | Lizenzfreie … (z. B. „Alphorn Fanfare, Resonet in laudibus – nuonu | Lizenzfreie Weihnachtsmusik“)

• Description (≈160 Zeichen, dynamisch)
  ©Jahr, Composer, Artist – Title / mm:ss / Genre / Album
  Falls noch Platz: , mp3, , wav, , download, , anhören

• OG/Twitter

  • Bild: Track-Cover -1200x630.jpg, Fallback Album-Default

  • Typ: music.song

  • Alt: Artist – Title

  • URL/Canonical: richtige Share- bzw. Player-URL

• Favicon pro Track
  Für Tabs/Shortcuts setzt das Plugin Favicons anhand des 512er-Covers.

Alles wird serverseitig ausgegeben – Bots sehen sofort die finalen Tags (cache-freundlich, kein JS nötig).

---

Tracks-Sitemap

• Aufruf:
  https://deine-seite.tld/afs-tracks-sitemap.xml
  (alternativ funktionieren /afs-tracks-sitemap und /?afs_tracks_sitemap=1)

• Inhalt: Alle Single-Track-Share-Links inkl. <lastmod> (aus timestamp oder mtime der musicData.json).

• Rank-Math-Index: Kann automatisch in …/sitemap_index.xml aufgenommen werden – alternativ separat in der Search Console einreichen.

Hinweis: Nach (De-)Aktivierung Permalinks speichern, damit die Pretty-URL greift.

---

Bedienung & UX

• Suche über Titel/Artist/Album/Genre/Kommentar.

• Sortierung: Neueste/Älteste, Länge ↑/↓, Titel A–Z/Z–A.

• Keyboard: ←/→ Track wechseln, Space Play/Pause.

• Swipe (mobil) auf dem Cover: vor/zurück.

• Progress-Leiste: aktuell / gesamt / -rest.

• ZIP-Downloads: Größen werden per HEAD ermittelt und inline angezeigt.

---

Performance

• First Paint optimiert: Erst visuelle Daten (Cover/Titel/Favicon), dann Audio-Load.

• SSR-Playlist: Ohne JS bleibt die Seite nutzbar & crawlbar.

• loading="lazy" & Cover-Fallbacks inklusive.

---

Troubleshooting

OG-Bild ist das Album statt Track?
Prüfe cover und die Dateien -1200x630.jpg, -512.jpg, -1080.jpg. Cache/CDN leeren. Die /share-Seite zeigt, was Bots sehen.

/afs-tracks-sitemap.xml liefert 404?
Einstellungen → Permalinks → „Änderungen speichern“. Falls nötig: Server/Hosting-Rewrite-Cache leeren.

Theme (z. B. Divi) schreibt eigene OG-Tags?
Audio Folder Suite entfernt konkurrierende Ausgaben und liefert OG via Rank-Math-Filter. Achte darauf, dass keine anderen Plugins ebenfalls OG/Twitter setzen.

---

Systemvoraussetzungen

• WordPress 6.x

• PHP 8.0+ empfohlen

• Rank Math (Free) optional, wird unterstützt – ist nicht zwingend.

---

FAQ

Muss ich musicData.json manuell pflegen?
Kannst du – oder du nutzt den integrierten Generator (falls aktiviert). Beides ist möglich.

Wie kommt die mm:ss-Anzeige zustande?
duration in Sekunden → Plugin rendert automatisch mm:ss.

Andere Bildgrößen?
Du kannst zusätzliche Größen bereitstellen; wichtig sind die Suffixe -48/-512/-1080/-1200x630.

Wieso unterscheidet sich /share manchmal vom Player?
/share ist eine Bot-optimierte Metaseite (OG/Twitter, strukturierte Daten). Der Player nutzt die gleiche Logik, aber mit Player-URL & interaktiver UI.

---

Changelog (Kurz)

1.0.2

• Konsolidierung: Player, SEO/OG, Favicons, Share, Sitemap in einem Plugin.

• UI/UX: Visuelle Daten vor Audio-Load; Swipe/Keyboard; ZIP-Größen.

• SEO: Titel/Description-Tuning (Komma nach Composer, mm:ss, Album, mp3/wav/download/anhören).

• Sitemap: afs-tracks-sitemap.xml + optionaler Rank-Math-Index-Eintrag.

---

Beispiele

Shortcode

Share-URL

Sitemap

---

Wenn du möchtest, passe ich den Text noch auf deinen Ton an (kürzer/marketinglastiger) oder ergänze Screenshots & Code-Highlights.