WP Music Archiver lets users save, organise, and play music links or uploaded audio files inside WordPress. It provides albums, playlists, favourites, ratings, a responsive audio player, and optional Google Drive syncing.

Description

WP Music Archiver is a full-featured music library system for WordPress, inspired by the standalone Django app “Music‑Archiver”.

It allows users to:

• Create albums and add tracks (uploaded audio or external streaming URLs)
• Build playlists with drag‑and‑drop ordering
• Play music using a responsive HTML5 audio player
• Rate ★ and favourite ♥ tracks or albums
• Save snapshots of other users’ albums (optional)
• Sync audio files from Google Drive folders (optional)
• Upgrade to Premium plans using Stripe Checkout (optional)
• Display albums, playlists, or players using shortcodes

This plugin is ideal for:

• Music collectors
• DJs and curators
• Creators who want to share playlists
• Anyone who wants a lightweight, self‑hosted music library

Core Features

• Albums — Create and manage collections of tracks
• Tracks — Upload audio or link to streaming URLs
• Playlists — Custom queues with drag‑and‑drop ordering
• Audio Player — Clean, responsive, mobile‑friendly
• Ratings & Favourites — Engagement tools for users
• Search & Filter — Quickly find albums or tracks
• Shortcodes — Embed albums, playlists, or full UI
• Admin Pages — Manage albums, tracks, playlists
• Custom Tables — Efficient storage for ratings, favourites, playlist items

Optional Advanced Features

• Google Drive Integration
  Sync audio files from a Drive folder into an album.
  Tokens stored securely. Supports streaming via OAuth.

• Stripe Subscriptions
  Offer Free vs Premium plans with limits on albums, playlists, or storage.

Shortcodes

[wpma_albums]
Displays the current user’s albums.

[wpma_album id="123"]
Displays a single album with track list and player.

[wpma_player track="456"]
Embeds a standalone audio player.

[wpma_app]
Loads the full front‑end interface (non‑SPA version).

Developer Notes

• Uses custom post types: wpma_album, wpma_track, wpma_playlist
• Uses custom DB tables for performance (album_tracks, playlist_items, ratings, favourites)
• Provides REST API endpoints under /wp-json/wpma/v1/
• Fully compatible with block themes and classic themes
• No front‑end framework required (vanilla JS + PHP templates)

Installation

1. Upload the wp-music-archiver folder to /wp-content/plugins/.
2. Activate the plugin through the Plugins menu in WordPress.
3. (Optional) Configure Google Drive or Stripe settings under WP Music Archiver → Settings.

Frequently Asked Questions

Does this plugin host copyrighted music?

No. It only plays user‑supplied audio files or URLs. You are responsible for ensuring you have rights to the content you upload.

Does Google Drive integration require API keys?

Yes. You must create OAuth credentials in Google Cloud Console and paste them into the plugin settings.

Can I customise the audio player?

Yes. The player uses HTML5 audio and can be styled via CSS or overridden via template files.

Screenshots

1. Album list view
2. Album detail with track list
3. Audio player
4. Playlist builder
5. Google Drive sync screen
6. Settings page

Changelog

1.0.0

• Initial release with albums, tracks, playlists, player, shortcodes, and admin pages.

Upgrade Notice

1.0.0

First stable release of WP Music Archiver.