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

With Audio Folder Suite, you no longer need a bundle of plugins: You get a fast album/playlist player, beautiful single-track share pages, clean OG/Twitter metadata (incl. favicon per track), and a dedicated Tracks Sitemap – all lean, crawler-friendly, and compatible with Rank Math (Free).

---

Highlights

• Fast Album/Playlist Player (SSR + JS): Search, Sorting, Keyboard Shortcuts, Mobile Swipe.

• Better UX: Cover, Title & Favicon are set immediately – Audio loads afterwards.

• Share Pages per Track (/share/?track=…), perfect for Facebook, X/Twitter, WhatsApp & Google.

• OG/Twitter Image Logic: always Track Cover first, otherwise Album Default (1200×630).

• Intelligent Description (≈160 characters):
  ©Year, Composer, Artist – Title / mm:ss / Genre / Album
  If space allows: , mp3, , wav, , download, , listen.

• Favicons per Track (16–512px), practical on mobile devices & shortcuts.

• Rank Math Integration: Title/Description/OG/Canonical cleanly overwritten.

• Dedicated Tracks Sitemap: …/afs-tracks-sitemap.xml incl. <lastmod>; optional entry in the Rank Math Index.

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

---

Quickstart (in 5 Minutes)

1. Create Album Folder (e.g.):

2. Populate musicData.json (see example below).

3. On your page/post, insert this shortcode:

4. Save Permalinks (Settings → Permalinks → "Save Changes") so that:

• nice Share URLs &

• https://your-site.tld/afs-tracks-sitemap.xml
  work.

Done – Player plus SEO/OG magic are active. 🙂

---

Folder & Cover Convention

• Track Covers: You only specify the base path in cover within musicData.json.
  The plugin automatically adds the required suffixes:

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

• If a track cover is missing, the plugin uses the Album Defaults in covers/default-cover-*.jpg.

---

musicData.json – Field Reference (Example)

Important

• duration in seconds (displayed as mm:ss).

• cover without suffixes – the plugin appends sizes.

• file/wav optional → Download buttons are automatically displayed.

---

Shortcodes

Album/Playlist Player (recommended)

Compatibility (if available)

---

Sharing Individual Tracks

• Share URL (recommended):
  https://your-site.tld/your-album-page/share/?track=<Filename.mp3>

• Direct Player Link:
  https://your-site.tld/your-album-page/?track=<Filename.mp3>

In the player, there's a "Share Now" button that copies the /share URL to the clipboard.

---

SEO & Social: How Metadata is Built

• Title
  Title – Page Name | Royalty-Free … (e.g., "Alphorn Fanfare, Resonet in laudibus – nuonu | Royalty-Free Christmas Music")

• Description (≈160 characters, dynamic)
  ©Year, Composer, Artist – Title / mm:ss / Genre / Album
  If space allows: , mp3, , wav, , download, , listen

• OG/Twitter

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

  • Type: music.song

  • Alt: Artist – Title

  • URL/Canonical: correct Share or Player URL

• Favicon per Track
  For tabs/shortcuts, the plugin sets favicons based on the 512px cover.

Everything is rendered server-side – bots immediately see the final tags (cache-friendly, no JS needed).

---

Tracks Sitemap

• Access:
  https://your-site.tld/afs-tracks-sitemap.xml
  (alternatively, /afs-tracks-sitemap and /?afs_tracks_sitemap=1 also work)

• Content: All Single-Track Share Links incl. <lastmod> (from timestamp or mtime of musicData.json).

• Rank Math Index: Can be automatically included in …/sitemap_index.xml – alternatively, submit it separately in Search Console.

Note: After (de-)activation, save permalinks for the pretty URL to take effect.

---

Operation & UX

• Search by Title/Artist/Album/Genre/Comment.

• Sorting: Newest/Oldest, Length ↑/↓, Title A–Z/Z–A.

• Keyboard: ←/→ switch track, Space Play/Pause.

• Swipe (mobile) on the cover: forward/backward.

• Progress Bar: current / total / -remaining.

• ZIP Downloads: Sizes are determined via HEAD and displayed inline.

---

Performance

• First Paint optimized: First visual data (Cover/Title/Favicon), then Audio Load.

• SSR Playlist: The page remains usable & crawlable without JS.

• loading="lazy" & Cover Fallbacks included.

---

Troubleshooting

OG image is the album instead of the track?
Check cover and the files -1200x630.jpg, -512.jpg, -1080.jpg. Clear cache/CDN. The /share page shows what bots see.

/afs-tracks-sitemap.xml returns 404?
Settings → Permalinks → "Save Changes". If necessary: Clear server/hosting rewrite cache.

Theme (e.g., Divi) writes its own OG tags?
Audio Folder Suite removes conflicting outputs and provides OG via Rank Math filter. Ensure no other plugins also set OG/Twitter.

---

System Requirements

• WordPress 6.x

• PHP 8.0+ recommended

• Rank Math (Free) optional, supported – is not mandatory.

---

FAQ

Do I have to maintain musicData.json manually?
You can – or you can use the integrated generator (if activated). Both are possible.

How is the mm:ss display generated?
duration in seconds → Plugin automatically renders mm:ss.

Other image sizes?
You can provide additional sizes; the suffixes -48/-512/-1080/-1200x630 are important.

Why does /share sometimes differ from the player?
/share is a bot-optimized meta page (OG/Twitter, structured data). The player uses the same logic but with a player URL & interactive UI.

---

Changelog (Brief)

1.0.2

• Consolidation: Player, SEO/OG, Favicons, Share, Sitemap in one plugin.

• UI/UX: Visual data before audio load; Swipe/Keyboard; ZIP sizes.

• SEO: Title/Description tuning (comma after Composer, mm:ss, Album, mp3/wav/download/listen).

• Sitemap: afs-tracks-sitemap.xml + optional Rank Math index entry.

---

Examples

Shortcode

Share URL

Sitemap

---

If you wish, I can adjust the text to your tone (shorter/more marketing-oriented) or add screenshots & code highlights.