WP Music Archiver

=== WP Music Archiver === Contributors: ajdwp Tags: music, albums, playlists, audio player, google drive, cloud storage, stripe, shortcode Requires at least: 5.7 Tested up to: 6.6 Stable tag: 1.0.0 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html

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.