DF-Music Player turns selected forums into a native music library with a dedicated player page — no external frontend libraries, no CDNs, no icon fonts.

LIBRARY & PLAYER
* Dedicated player.php library: album cards, album/artist/track search, pagination
* Album detail pages: native audio controls, next/previous, shuffle, repeat-track, track selection, saved volume
* First-post replacement for albums linked to threads in administrator-selected forums (the stored post is preserved; replies untouched)
* Static lyrics AND synchronized LRC lyrics (multiple timestamps per line, millisecond offset)
* Up to four song recommendations from other accessible music threads, ranked by artist → genre → recency
* Staff-controlled artist/album verification badges
* Two trusted HTML advertisement slots (above/below library & player)

ACCESS CONTROL
* Usergroup + additional-group restrictions
* Forum restrictions incl. forum passwords, parent passwords, own-thread permissions, active forums, approved threads/posts

ADMINISTRATION
* ACP album/track management with draft/publish workflow
* Per-module admin permissions, CSRF checks, admin action logging
* Up to 200 tracks per album; duplicate thread links rejected

DESIGN
* Original charcoal/amber/record-art theme, fully responsive
* Keyboard-focus indicators and reduced-motion support

AUDIO SOURCES
Direct HTTPS audio URLs only (MP3/OGG/WAV). YouTube/Spotify/SoundCloud page URLs are not audio sources; the plugin does not scrape, upload, transcode or proxy audio.

REQUIREMENTS
MyBB 1.8 · PHP 8.1+ · UTF-8 · HTTPS audio/image URLs

INSTALL (summary)
1. Backup. Resolve any existing player.php filename conflict.
2. Merge contents of Upload/ into the MyBB root (renamed ACP: place admin/modules/config/dfmusic.php accordingly).
3. ACP → Plugins → Install & Activate.
4. Settings → DF-Music Player: pick Music forums + allowed usergroups; confirm Board URL.
5. Configuration → DF-Music Player → Add album (existing thread ID), then add tracks with direct HTTPS audio URLs.

TESTING
Integration + JS test suites included (see tests/ and TEST-REPORT.md in the package).

Support Thread- https://data-forums.com/Thread-DF-Music-...9#pid25309

DF-Music Player biến một số diễn đàn thành thư viện nhạc gốc với trang trình phát riêng biệt — không có thư viện giao diện bên ngoài, không có CDN, không có phông chữ biểu tượng.

THƯ VIỆN & TRÌNH PHÁT
* Thư viện player.php riêng biệt: thẻ album, tìm kiếm album/nghệ sĩ/bài hát, phân trang
* Trang chi tiết album: điều khiển âm thanh gốc, tiếp theo/trước, xáo trộn, lặp lại, chọn bài hát, lưu âm lượng
* Thay thế bài đăng đầu tiên cho các album liên kết với các chủ đề trong diễn đàn do quản trị viên chọn (bài đăng lưu trữ được giữ nguyên; phản hồi không bị ảnh hưởng)
* Lời bài hát tĩnh VÀ lời LRC đồng bộ (nhiều dấu thời gian mỗi dòng, lệch mili giây)
* Tối đa bốn đề xuất bài hát từ các chủ đề âm nhạc dễ tiếp cận khác, xếp hạng theo nghệ sĩ → thể loại → thời gian gần đây
* Huy hiệu xác minh nghệ sĩ/album do nhân viên kiểm soát
* Hai khe quảng cáo HTML đáng tin cậy (trên/dưới thư viện & trình phát)

KIỂM SOÁT TRUY CẬP
* Hạn chế nhóm người dùng + nhóm bổ sung
* Các hạn chế diễn đàn bao gồm mật khẩu diễn đàn, mật khẩu cha, quyền chủ đề, diễn đàn đang hoạt động, chủ đề/bài đăng được phê duyệt

QUẢN LÝ
* Quản lý album/bài hát ACP với quy trình nháp/xuất bản
* Quyền quản trị theo từng mô-đun, kiểm tra CSRF, ghi nhật ký hành động quản trị
* Tối đa 200 bài hát mỗi album; các liên kết luồng trùng lặp bị từ chối

THIẾT KẾ
* Chủ đề than củi/hổ phách/nghệ thuật đĩa gốc, phản hồi đầy đủ
* Chỉ báo lấy nét bàn phím và hỗ trợ giảm chuyển động

NGUỒN ÂM THANH
Chỉ các URL âm thanh HTTPS trực tiếp (MP3/OGG/WAV). URL trang YouTube/Spotify/SoundCloud không phải là nguồn âm thanh; plugin không thu thập dữ liệu, tải lên, chuyển mã hay chuyển đổi âm thanh proxy.

YÊU CẦU
MyBB 1.8 · PHP 8.1+ · UTF-8 · URL âm thanh/hình ảnh HTTPS

CÀI ĐẶT (tóm tắt)
1. Sao lưu. Giải quyết bất kỳ xung đột tên tệp player.php nào hiện có.
2. Hợp nhất nội dung của Upload/ vào root MyBB (đổi tên thành ACP: đặt admin/modules/config/dfmusic.php tương ứng).
3. Cài đặt & Kích hoạt Plugin ACP → →.
4. Cài đặt → DF-Music Player: chọn Diễn đàn Nhạc + nhóm người dùng được phép; xác nhận URL bản.
5. Cấu hình → DF-Music Player → Thêm album (ID luồng hiện có), sau đó thêm các track có URL âm thanh HTTPS trực tiếp.

KIỂM TRA
Bao gồm bộ kiểm thử tích hợp + JS (xem các bài kiểm tra và TEST-REPORT.md trong gói).

Chủ đề hỗ trợ-https://data-forums.com/Thread-DF-Music-...9#pid25309