Audio Map Suite – Albumspeler, Delen, SEO & Tracks-Sitemap in één plugin

Met Audio Map Suite heb je geen bundel plugins meer nodig: je krijgt een snelle album-/afspeellijstspeler, mooie deelpagina's voor losse tracks, schone OG-/Twitter-metadata (incl. favicon per track) en een eigen Tracks-Sitemap – alles slank, crawlervriendelijk en compatibel met Rank Math (Gratis).

---

Hoogtepunten

• Snelle album-/afspeellijstspeler (SSR + JS): Zoeken, sorteren, sneltoetsen, mobiel swipen.

• Betere UX: Cover, titel & favicon worden direct ingesteld – audio laadt daarna.

• Deelpagina's per track (/share/?track=…), perfect voor Facebook, X/Twitter, WhatsApp & Google.

• OG-/Twitter-afbeeldingslogica: altijd eerst track-cover, anders album-standaard (1200×630).

• Intelligente beschrijving (≈160 tekens):
  ©Jaar, Componist, Artiest – Titel / mm:ss / Genre / Album
  Indien ruimte: , mp3, , wav, , download, , beluisteren.

• Favicons per track (16–512px), praktisch op mobiele apparaten & snelkoppelingen.

• Rank Math-integratie: Titel/Beschrijving/OG/Canonical netjes overschreven.

• Eigen Tracks-Sitemap: …/afs-tracks-sitemap.xml incl. <lastmod>; optionele vermelding in de Rank Math Index.

• Geen thema-lock-in (Divi, Block-Themes, Classic) & cache/CDN-vriendelijk.

---

Snelstart (in 5 minuten)

1. Albummap aanmaken (bijv.):

2. musicData.json vullen (voorbeeld zie je hieronder).

3. Op je pagina/bericht deze shortcode invoegen:

4. Permalinks opslaan (Instellingen → Permalinks → „Wijzigingen opslaan“), zodat:

• mooie deel-URL's &

• https://jouw-site.tld/afs-tracks-sitemap.xml
  werken.

Klaar – speler plus SEO/OG-magie zijn actief. 🙂

---

Map & Cover-conventie

• Track-covers: Je slaat in musicData.json alleen het basispad op in cover.
  De plugin voegt automatisch de benodigde suffixen toe:

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

• Als een track-cover ontbreekt, gebruikt de plugin de album-standaarden in covers/default-cover-*.jpg.

---

musicData.json – Veldreferentie (voorbeeld)

Belangrijk

• duration in seconden (weergave als mm:ss).

• cover zonder suffixen – de plugin voegt formaten toe.

• file/wav optioneel → Downloadknoppen worden automatisch weergegeven.

---

Shortcodes

Album-/Afspeellijstspeler (aanbevolen)

Compatibiliteit (indien aanwezig)

---

Afzonderlijke nummers delen

• Deel-URL (aanbevolen):
  https://jouw-site.tld/jouw-album-pagina/share/?track=<Bestandsnaam.mp3>

• Directe spelerlink:
  https://jouw-site.tld/jouw-album-pagina/?track=<Bestandsnaam.mp3>

In de speler is er de knop „Nu delen“, die de /share-URL naar het klembord kopieert.

---

SEO & Social: zo worden metadata opgebouwd

• Titel
  Titel – Paginanaam | Licentievrije … (bijv. „Alphorn Fanfare, Resonet in laudibus – nuonu | Licentievrije Kerstmuziek“)

• Beschrijving (≈160 tekens, dynamisch)
  ©Jaar, Componist, Artiest – Titel / mm:ss / Genre / Album
  Indien nog ruimte: , mp3, , wav, , download, , beluisteren

• OG/Twitter

  • Afbeelding: Track-cover -1200x630.jpg, fallback album-standaard

  • Type: music.song

  • Alt: Artiest – Titel

  • URL/Canonical: juiste deel- of speler-URL

• Favicon per track
  Voor tabbladen/snelkoppelingen stelt de plugin favicons in op basis van de 512px-cover.

Alles wordt server-side weergegeven – bots zien direct de uiteindelijke tags (cache-vriendelijk, geen JS nodig).

---

Tracks-Sitemap

• Oproep:
  https://jouw-site.tld/afs-tracks-sitemap.xml
  (alternatief werken /afs-tracks-sitemap en /?afs_tracks_sitemap=1)

• Inhoud: Alle Single-Track-Deellinks incl. <lastmod> (uit timestamp of mtime van de musicData.json).

• Rank Math-index: Kan automatisch worden opgenomen in …/sitemap_index.xml – of afzonderlijk indienen in de Search Console.

Opmerking: Na (de-)activering Permalinks opslaan, zodat de Pretty-URL werkt.

---

Bediening & UX

• Zoeken via titel/artiest/album/genre/opmerking.

• Sortering: Nieuwste/Oudste, Lengte ↑/↓, Titel A–Z/Z–A.

• Toetsenbord: ←/→ track wisselen, Space afspelen/pauzeren.

• Swipe (mobiel) op de cover: vooruit/achteruit.

• Voortgangsbalk: huidig / totaal / -rest.

• ZIP-downloads: Groottes worden via HEAD bepaald en inline weergegeven.

---

Prestaties

• First Paint geoptimaliseerd: Eerst visuele gegevens (cover/titel/favicon), daarna audio-load.

• SSR-afspeellijst: Zonder JS blijft de pagina bruikbaar & crawlbaar.

• loading="lazy" & cover-fallbacks inbegrepen.

---

Probleemoplossing

OG-afbeelding is het album in plaats van de track?
Controleer cover en de bestanden -1200x630.jpg, -512.jpg, -1080.jpg. Leeg cache/CDN. De /share-pagina toont wat bots zien.

/afs-tracks-sitemap.xml geeft 404?
Instellingen → Permalinks → „Wijzigingen opslaan“. Indien nodig: leeg de server/hosting-rewrite-cache.

Thema (bijv. Divi) schrijft eigen OG-tags?
Audio Map Suite verwijdert concurrerende outputs en levert OG via Rank Math-filters. Zorg ervoor dat geen andere plugins ook OG/Twitter instellen.

---

Systeemvereisten

• WordPress 6.x

• PHP 8.0+ aanbevolen

• Rank Math (Gratis) optioneel, wordt ondersteund – is niet verplicht.

---

FAQ

Moet ik musicData.json handmatig bijhouden?
Dat kan – of je gebruikt de geïntegreerde generator (indien geactiveerd). Beide zijn mogelijk.

Hoe komt de mm:ss-weergave tot stand?
duration in seconden → plugin rendert automatisch mm:ss.

Andere afbeeldingsformaten?
Je kunt extra formaten aanbieden; belangrijk zijn de suffixen -48/-512/-1080/-1200x630.

Waarom verschilt /share soms van de speler?
/share is een bot-geoptimaliseerde metapagina (OG/Twitter, gestructureerde gegevens). De speler gebruikt dezelfde logica, maar met speler-URL & interactieve UI.

---

Changelog (kort)

1.0.2

• Consolidatie: Speler, SEO/OG, Favicons, Delen, Sitemap in één plugin.

• UI/UX: Visuele gegevens vóór audio-load; swipe/toetsenbord; ZIP-groottes.

• SEO: Titel/Beschrijving-tuning (komma na componist, mm:ss, album, mp3/wav/download/beluisteren).

• Sitemap: afs-tracks-sitemap.xml + optionele Rank Math-indexvermelding.

---

Voorbeelden

Shortcode

Deel-URL

Sitemap

---

Als je wilt, pas ik de tekst nog aan jouw toon aan (korter/meer marketinggericht) of voeg ik screenshots & code-highlights toe.