[XenCustomize] Profile Audio Player & Library - Music and Lyrics v2.1.3

My journey with XenForo is as long-standing as the platform itself. Over time, I've seen many requests for a profile music addon for XenForo 2. Now, with XenCustomize, I've put in my best effort to offer a solution. Hoping the XenForo community values this sincere effort.

Express Yourself with Music Elevate your XenForo 2 community profiles by adding your favorite custom music tracks. Share your musical taste with others in a fun and unique way.

Easy for Everyone You don't need to be a tech expert to use this. Just upload your music, and the Profile Audio Player will do the rest.

Admin Control, Your Way Tailor the experience to your community’s preferences with admin options. Enable or disable the Player with a single click, and choose whether audio tracks autoplay site-wide when profiles load. You’re in control.

Immersive Audio Player Experience music like never before with our stylish, HTML5, CSS3 and jQuery-based Audio Player. It’s more than just play and pause – enjoy artist names, album details, track duration, progress bars, reactions, and even a playlist button for uninterrupted listening pleasure.

Visual Brilliance The Profile Audio Player doesn’t just sound great – it looks stunning too. With album artwork integration, your users’ profiles will come alive with vibrant visuals that perfectly complement their musical choices.

Make it Yours With dozens of style properties, you can customize the Player’s appearance and design to match your community’s unique identity. Set the mood and create an immersive experience like no other.

Seamless Management Integrates well into the Player, Account wrapper and Visitor menu. Users can manage unlimited audio tracks with individual input fields, including audio uploads or URLs, artist names, song titles, album names, and even the ability to upload custom album art.

Effortless Translation If your site supports multiple languages, our product is fully phrased, making it easy to translate into different languages and connect with users from around the world.

Be a Trailblazer Be the first in your community to have this unique Profile Music add-on. Share your love for music with friends and fellow members.

Feel the Music Experience the joy of music as it fills your profile. Let your favorite tunes speak for you.

Changelog v2.1.0

Implemented an Advanced Rich-Feature Comment System​

• Added a new default tab for comments on audio track pages.
• The comment system includes the following features:
  • Full support for a rich text editor.
  • Attachment support.
  • The ability to reply to comments using the quote feature.
  • Support for multi-quoting.
  • Quick inline editing:
    • Edit silently
      • If selected, no "last edited" note will be added for this edit.
    • Clear last edit information
      • If selected, any existing "last edited" note will be removed.
  • Edit history support with the ability to view and compare previous versions.
  • Options to delete comments with deletion types:
    • Remove from public view with a reason.
    • Permanently delete.
    • Notify author of this action with Reason.
  • Display of IP address information for comments.
  • Inline moderation support with the ability to:
    • Delete comments.
    • Undelete comments.
    • Approve comments.
    • Unapprove comments.
  • View of soft-deleted comments and the option to undelete.
  • Warning support.
  • Report support.
  • Spam cleaner support.
  • New comments go through an approval queue before becoming visible to the public.
  • Support for reactions.
  • Receive alert notifications when someone:
    • Mentions you in a comment.
    • Quotes your comment.
    • Reacts to your comment.
    • Comments on a watched audio track.
  • Pagination support.
  • Admin-defined number of comments per page.
  • Admin-defined maximum comment length.
  • Option to show or hide signatures on comments.
  • Admin-defined maximum comment attachment size.
  • Admin-defined allowed comment attachment file types (extensions).
• Fully permission-controlled, with complete sets of permissions for users and moderators.
• Added search indexing support for comments' content type.
• Added a new navigation link for easy access to view recent comments.

Implemented "New comments" on the What's New Page.​

• Presents tracks linked to unread comments in a new list view layout.
• Shows the comment count.
• Provides the ability to filter and display only:
  • Unread comments
  • Save as default
    • These filters will be used by default whenever you return.

Implemented a New Widget: "Latest Comments"​

• The widget title is linked to the What's New comments tab.
• Widget options include the number of comments to be displayed.
• The widget is automatically added to the Library sidenav during the installation or upgrade process.

Implemented News Feed Support for:​

• Reactions to comments.
• New comments on audio tracks.

Implemented Watch/Subscribe Feature​

• You can now watch (subscribe to) each audio track with the option to:
  • Receive email notifications
  • Watch without receiving email notifications.
• Tracks are auto-watched when users post comments on them.
• Alert notifications are sent when someone posts a comment on the track.

Added a Watched Audio Tracks Page​

• This page displays all the audio tracks you've watched in a new list view layout.
• It allows you to efficiently manage your watched audio tracks, including:
  • Disabling email notifications
  • Stopping watching audio tracks.
• You can select all or multiple audio tracks and, with your selection, you can:
  • Enable email notification
  • Disable email notification
  • Stop watching.
• Included a new navigation link for easy access to your watched audio tracks.
• Additionally, a "Watched Audio Tracks" filter has been added in the What's New (audio tracks) section.

Subtitles​

• Introduced a new optional text input field with a length of up to 100 characters.
• This field can be found just below the title on add/edit pages.
• The subtitle will be displayed under the title in various locations.

Multiple Music Genres​

• Previously, genres were hardcoded in PHP. Now, admins can define their own Music Genres through a new admin option.
• Previously, only a single genre could be selected, we've now added the ability to choose multiple genres for each audio track.
• We've implemented Chosen jQuery for multiple selections, but we would change/update it for XenForo 2.3 version.

Added a new permission group "Profile Audio: Comments" with new permissions:​

• View comments
• View comment attachments
• React to comments
• Post comments
• Post comments on own tracks
• Submit comments without approval
• Upload attachments to comments
• Edit own comment
• Delete own comment
• Time limit on editing/deleting own comments (minutes)

Added a new permission group "Profile Audio: Comments Moderator" with new permissions:​

• Use inline moderation on comments
• View unapproved comments
• View deleted comments
• Approve / unapprove comments
• Edit any comment
• Delete any comment
• Undelete comments
• Hard delete any comment
• Give warnings on comments

Added new permissions to "Profile Audio" group:​

• View audio tracks
  • Added this new permission for viewing audio tracks. This permission applies to various scenarios, including:
    • Viewing audio tracks
    • Viewing audio tracks in the Library
    • Viewing audio tracks in widgets
    • Viewing audio tracks on the What's New page
    • Viewing audio tracks on search results
• Listen to audio tracks
  • Added this new permission specifically for listening to audio tracks on track view pages. Without this permission, users can still access audio tracks, but the track player won't be available for listening.
• View profile audio player (Existing permission)
  • This permission now exclusively applies to the user's profile audio player only.
  • With this permission, you can now disable the profile player without affecting the entire system.

Added a new tab, "Audio Tracks," to user profile tabs.​

• Lists tracks from the user's library.
• Includes an Ajax search box.

Replaced the "Minimelody" audio track player with a mini version of the default full player (on profiles).​

• This new mini player is designed to work on audio track pages.
• Built using HTML5, CSS3, and JavaScript/jQuery.
• Now provides better support for dark styles and is prepared to support XenForo 2.3 dark styles.
• Fully customizable.
• Available action buttons include "Play, Pause, Stop, Repeat, and Volume."
• Supports auto-play with an option to disable auto-play.

Profile Audio Player Positions​

• Added a new option to place the Player on user profiles sidebar down the order.

Improvements to Profile Audio Player

• The player now verifies the presence of attached audio files or direct audio links. If any entries are added without audio attachments or links, they will not be listed for playback.
• Various minor adjustments.
• Font Awesome <i class> tags now changed to <xf:fa> tags.

Tab Settings Revised
These Tab options not only let you show or hide tabs but also impact how their related features function. Here's what each of them does, along with the ability to enable or disable them:

• Enable Listen tab
  • If it's disabled, users won't be required to Attach audio or Provide a link to audio when adding or editing an audio entry. In that case, entries added without audio attachments or audio links will not appear on the profile player.
• Enable Lyrics tab
  • If it's disabled, users won't be able to access the Lyrics editor when adding or editing an audio entry because there's no point in adding lyrics in that case.
• Enable Spotify tab
  • If it's disabled, users won't be able to access the editor to Spotify embed when adding or editing an audio entry because there's no point in embedding Spotify in that case.
• Enable Apple Music tab
  • If it's disabled, users won't be able to access the editor to Apple Music embed when adding or editing an audio entry because there's no point in embedding Apple Music in that case.
• Enable SoundCloud tab
  • If it's disabled, users won't be able to access the editor to SoundCloud embed when adding or editing an audio entry because there's no point in embedding SoundCloud in that case.
• Enable YouTube Music tab
  • If it's disabled, users won't be able to access the editor to YouTube Music embed when adding or editing an audio entry because there's no point in embedding YouTube Music in that case.

New Button Options
Added these new Button options, not only let you show or hide buttons separately but also impact how their related features function. Here's what each of them does, along with the ability to enable or disable them:

• Enable Spotify button
  • Enable or disable the Spotify Button Link on the Profile Audio view.
  • If it's disabled, users won't be able to access the input field for the Spotify Button Link when adding or editing an audio entry because there's no point in linking a Spotify track in that case.
• Enable Apple Music button
  • Enable or disable the Apple Music Button Link on the Profile Audio view.
  • If it's disabled, users won't be able to access the input field for the Apple Music Button Link when adding or editing an audio entry because there's no point in linking a Apple Music track in that case.
• Enable SoundCloud button
  • Enable or disable the SoundCloud Button Link on the Profile Audio view.
  • If it's disabled, users won't be able to access the input field for the SoundCloud Button Link when adding or editing an audio entry because there's no point in linking a SoundCloud track in that case.
• Enable YouTube Music button
  • Enable or disable the YouTube Music Button Link on the Profile Audio view.
  • If it's disabled, users won't be able to access the input field for the YouTube Music Button Link when adding or editing an audio entry because there's no point in linking a YouTube Music track in that case.

Tabbed Admin Options

• As we continue to add more options, we are organizing and grouping them to make it easier for admins to find what they need:
  • General options
  • Player options
  • Buttons options
  • Tabs options
  • Listeners options
  • Library options
  • Comments options
  • Extras

Download Button​

• Now checks for the presence of attached audio files or direct audio links. If any entries are added without audio attachments or links, the download button will not be displayed.

Miscellaneous Changes and Additions:​

• The "Add" and "Edit" audio track links will no longer appear in overlays.
• The Statistics widget now displays the total number of comments.
• The audio information block now includes the following details:
  • Total listeners count
  • Total comments count
  • Total watchers count
• Share this audio tooltip is now linked to the audio track for improved consistency.
• We've added numerous new phrases and templates.
• Several template modifications have been refreshed, and a few new ones have been included.
• "Track Comments" count is now displayed in Member stats, and the previously labeled "Profile audios" has been revised to "Tracks" for consistency.
• Manage your audios button in the account navigation group, next to the Inbox & Alert buttons, now linked to "Add new audio track".
• Added explanations with examples for embedding Spotify, Apple Music, SoundCloud, and YouTube Music.

Install/Upgrade Script Update:​

• Default permissions are automatically applied during the installation and upgrade process, saving you time.
• A new widget, "Latest Comments," is created and placed in default positions as part of the installation and upgrade process.
• The uninstall code has been updated to ensure the removal of all new tables, columns, widgets, and content types.
• We maintain the migration script from v1.0.3, allowing for a direct upgrade to v2.1. However, starting from v2.2, we won't carry this script.

Changelog v2.0.3
2.0.3 - Audio Listeners, New Admin Options, User Group Permission, and Bug Fixes

Audio Listeners​

• Introducing the "Audio Listeners" feature.
• Members who listened to an audio can now be displayed in a sidebar block on the audio view.
• In the block footer, you'll find the total listener count.
• Clicking the 'View Details' button opens an overlay that also displays the last listen date for each listener.