[XenCustomize] Profile Audio Player & Library - Music and Lyrics 2.1.4

Profile Audio Player version 2.1.4 is now available for all licensed customers to download. In this update, we've implemented a new feature, thanks to the funding provided by @Vercingetorix. More detail on our support forum.

What's new?​

---

• Audio Track BB Code with Playback:
  • A new HTML5 audio player plays audio tracks embedded with the Audio BB code.
  • Audio playback respects user group permissions: Users with the "Listen Track" permission can access audio playback.
  • Display alternate content when playback is disabled or user don't have permission to listen.
• New Admin option:
  • Enable "Audio Playback" on Audio Track BB Code.
  • Enabled by default. This option allows audio playback when embedded with the Audio BB code.
• New Style Properties:
  • BB code player background
  • BB code player color

Copy Audio BB code​

Audio Track BB Code with Playback​

New Admin option​

View without permission or when the above option is disabled:​

New Style Properties​

Upgrade Notes​

---

• When upgrading please ensure that you the "Overwrite existing files for add-on rebuilds / upgrades" option.
• If uploading files using an FTP or file manager, you have to overwrite all files.
• After upgrading, please make sure to revert the modified templates to ensure the changes take effect.
  • Changed templates:
    • xcu_profile_audio_view

Profile Audio Player v2.1.3 Released​

We're delighted to announce the latest release of the Profile Audio Player add-on - version 2.1.3, available now as of December 13, 2023!

Changelog​

---

• Bug Squashed! Addressed an issue with the shared content title on social media, thanks to the sharp eyes of @oO5 Dynasty (View detailed post).
• Sleeker Look! Minor styling improvements for both the full player (on profile) and the mini player (on audio tracks).
• Clearer Phrasing! We've updated a few phrases from "Profile Audios" to "Audio Tracks" for better clarity and consistency.
• Customer Support Forum! We've added the newly launched customer support forum link to addon.json metadata. Now, accessing support is just a click away!

Upgrade Notes​

---

• When upgrading from v1, please ensure that you're upgrading from v1.0.3.
• Also make sure that you CHECK the "Overwrite existing files for add-on rebuilds / upgrades" option. If uploading file using an FTP or file manager, you have to overwrite all files.
• If you have made modifications to the templates, be sure to make a backup of those changes, and then revert those templates.

Rate & Review!​

---

If you're loving the add-on, please consider leaving a rating and a brief review.

In this release, Version 2.1.2 has been updated to correct the install script, ensuring that the comments table is not missed during a fresh installation. No other changes have been made. If your site is already running 2.1.2, there's no need to update. This update is only necessary for fresh installations.

Profile Audio Player v2.1.2 Released​

We're delighted to announce Profile Audio Player v2.1.2, featuring several minor improvements that enhance your experience. These enhancements include the reorganization of user group permissions, facilitate genre translation, and more!

Changelog​

• User group permissions related to moderators have been separated.
• To facilitate genre translation, we've relocated chosen.jsand included the following new phrases:
  • xcu_pap_you_may_select_multiple_genres
  • xcu_pap_select_a_genre
  • xcu_pap_no_results_match
    There are some other new phrases and changes to existing ones.
• Styling improvements have been made to various templates, including the Add and Edit audio track templates.
• Added further explanations to the admin options.

What's Next from XenCustomize?​

We're delighted to reveal the addition of a brand new add-on to XenCustomize's add-on portfolio (hint: ). It has been in development for some time, and we expect the initial release in the coming week.

Profile Audio Player v2.2 Update​

We've exciting plans for Profile Audio Player v2.2, which includes fantastic new features. We're bringing you the much-anticipated multiple playlists feature. Since the release of v2.0, we've dedicated hundreds of hours to developing new features and improvements including the huge update of v2.1. However, with a limited customer base, it is challenging for us to continue pushing forward with new developments. Therefore, development for v2.2 is currently on hold, and we would greatly appreciate your support to fund its resumption (Start a DM).

Profile Audio Player v2.1.1 Is Here! ​

We're pleased to announce the Profile Audio Player version 2.1.1, packed with enhancements that make your audio experience even better, including External Audio URL Validation, Clearer display of Supported Extensions, and more!

Changelog​

• Simplified Audio Track Adding: No longer require "Upload audio" and "Provide a link to audio file" when Adding an audio track.
  • This is especially useful when you only want to exclusively embed content from platforms like Spotify and YouTube in their respective tabs.
• Enhanced Clarity: A clearer display of "Supported audio files" on Adding and Editing an audio track.
  • Supported audio files are linked to an overlay that provides even more detailed audio file guidelines.
• External Audio URL Validation:
  • Added validation for external audio URLs to ensure they have supported audio extensions and a correct URL format.
  • Users will now receive an error message if the URL format is incorrect, improving the user experience and data integrity.
  • Users will now receive an error message if the extension is not supported, improving the user experience and data integrity.
• Enhanced Data Management:
  • Implemented a system to automatically update user-related content within multiple tables when user content changes occur, such as username changes or deletions. This ensures data consistency and accuracy.
• User Deletion Enhancements:
  • Improved user data deletion process by registering specific cleanup queries that remove user-related content from various tables when a user account is deleted. This ensures a cleaner and more efficient user data management system.
• User Merge Enhancements:
  • Improved user merging process by allowing the update of audio tracks and comments count. When users are merged, their audio tracks and comments are accurately combined into the target user's account, ensuring a seamless transition.
• Member Statistic Formatting:
  • Enhanced member statistic result formatting for profile audio-related metrics. Now, values for "Profile Audio Count" and "Profile Audio Comment Count" are properly formatted for improved readability.
• Mini Player Icons: We've included a couple of missing icons for when the mini player auto-plays.

Exciting News:​

Profile Audio Player v2.1 Is Here! ​

In response to the valuable feedback we've received and examining how customers have used the add-on, we've made significant changes and reevaluated how things worked in 2.0. As a result, we proudly present version 2.1.

Today, we're super excited to introduce you to Profile Audio Player v2.1.0! We've been working hard on this, and it's packed with awesome new features and improvements that take user interaction with the music content to the next level.

What's Coming Up Next?​

Before we delve into the details of 2.1, let's address some questions about our roadmap. We've exciting plans for the future! We're already planning v2.2 with a fantastic new feature, and we're finally bringing you the much-anticipated multiple playlists feature.

Since the release of version 2.0, we've dedicated hundreds of hours to developing new features and improvements. However, with a limited customer base, it's challenging for us to keep pushing forward with new developments. We would greatly appreciate your support in funding our upcoming work. (Start a DM with me).

Alright, let's get into the details of what's new in v2.1.

Changelog​

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.

Comment reply with quote

Reply with multi-quotes

Edit Comment

Comment edit history

Comment delete

Comment reports

Approval queue

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.

Disable email notification

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.

Dark mode

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.

Upgrade to version 2.1.0 today! ​

---

If you already upgraded to v2.0, you get v2.1 for free.

Upgrade Notes ​

---

• When upgrading from v1, please ensure that you're upgrading from v1.0.3.
• Also make sure that you CHECK the "Overwrite existing files for add-on rebuilds / upgrades" option. If uploading file using an FTP or file manager, you have to overwrite all files.
• If you have made modifications to the templates, be sure to make a backup of those changes, and then revert those templates.

Rate & Review! ​

---

If you're loving the upgrade, please consider leaving a rating and a brief review.

Profile Audio Player v2.0.4 Has Released! ​

During maintenance on a client's website while working in dark style, some necessary styling corrections were discovered. As a result, we've just rolled out an important update to enhance your experience, especially on dark-themed styles. Be sure to upgrade to take advantage of these improvements.

Changelog​

Minimelody Player Styling Enhancements​

• The Minimelody player on Audio View has received styling improvements.
• It now utilizes standard XenForo Color palettes to enhance its appearance on dark styles.
• Display on mobile devices has been significantly enhanced for a better user experience.

Mobile view:

Desktop view:

​

Improved Styling for Various Layouts​

• Several layouts have been updated to use standard XenForo Color palettes, enhancing their display on dark styles.
• The following layouts have benefited from these improvements:
  • Audio View (Minimelody player part)
  • Audio Library Index
  • Audio Library View
  • Ajax Search Results
  • New Audios page in What's new.

Important Upgrade Notes​

If you have made modifications to the templates, you will need to revert them to see the changes.

Profile Audio Player v2.0.3 Has Released ​

In our previous release, we introduced Listen Tracking, laying the foundation for an exciting new feature in this release. We are thrilled to present the latest update packed with new features! This v2 update continues to elevate your audio experience and offers innovative ways to discover and engage with audio content. Here's what's new:

Changelog​

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.

New admin options to customize the "Audio Listeners" block:​

• Display the block in a collapsed state.
• Choose the display mode for Audio Listeners: Avatars and User names.
• Set a limit for Audio Listeners within the last X hours.
• Order Audio Listeners by "Listen date" or "Alphabetical."

New User Group Permission​

• Added a new user group permission to control access to the "Audio Listeners" feature.

Default permission automatically applied during the installation and upgrade process.

Post Deletion Database Cleanup​

• Updated database cleanup code that also clear entries from the following when an audio is deleted:
  • xf_xcu_profile_audio_listen
  • xf_deletion_log

Code Optimization​

• Cleaned up unnecessary code to improve performance and maintainability.

Bug Fixes​

• Resolved a style bug that prevented the display of embedded content from Spotify, Apple Music, SoundCloud, and YouTube Music.

This update marks another step forward in enhancing your audio experience. We recommend all customers running an older version of v2 upgrade to this version as it also includes an important bug fix.

If you enjoy the update, please leave a review, and stay tuned for more exciting updates in the future!

Profile Audio Player v2.0.2 Has Released ​

We are delighted to announce the latest feature-packed update for Profile Audio Player! This v2 update continue to enhancing your audio experience and providing exciting new ways to discover and interact with audio content. Here is what's new:

Changelog​

Introducing Listen Tracking​

• User interactions with audio are now tracked and stored in a dedicated table.
• This sets the stage for an exciting new feature in the upcoming update that relies on this tracking.

Mark Audios as Listened​

• You can mark all profile audios as listened with ease.

News feed Integration​

• Added News feed entries for new audio additions.
• Enjoy News feed updates for reactions to audio tracks.

What's New Integration​

• Discover the all-new "New Audio Tracks" tab in the What's New section.
• Use the filters menu to toggle between:
  • Unlistened profile audios (default filter).
  • Your profile audios.
  • Save your preferences as default (these filters will be applied automatically).

Improved Simple Layout Widget​

• Enhanced the "Latest Audio Tracks" widget with a convenient "See more..." link. It opens the "New Audio Tracks" section on the What's New tab.

Enhanced Audio Tools​

• The undelete link on the audio view page now appears only when the audio state is deleted.

Various Tweaks and Improvements​

• Updated Genres List
• Added numerous new phrases and updated several existing ones.
• Navigation links have been refined, including the addition of a "New Audios" link.

If you enjoy the update, leave a short review!

Profile Audio Player v2.0.1 is Here! ​

Following our major release yesterday, we're thrilled to bring you another quick update packed with further improvements and bug fixes. Here's what's new:

Changelog​

---

Manage Deleted Audios:​

• Soft deleted audio tracks are now visible on the "Manage Your Profile Audios" page.
• Clearly indicates the deleted entry.

Undelete Soft Deleted Audios:​

• Now it's possible to recover soft-deleted audio tracks, simply grant users the ability to view deleted and undelete audio.

Added new usergroup permissions:​

• View deleted audio
• Undelete audio

Default permissions are auto applied during the installation and upgrade process.

Added link to undelete audio tracks:​

• You'll now find a link to undelete audio tracks if they are deleted, and user has the undelete permission.

Ajax Search Enhancement:​

• The Ajax search now only displays visible audio tracks.
• Improved styling of the Ajax search box on iPhones.

Improved Post-Save Actions:​

• Added an additional method that adjusts the user's profile audio count when a new audio track is added.

BUG FIX:​

• Fixed an issue related to an unknown column when changing the "Default audio list order" to "Last update".