VSoundCloud - Audio Track Embedding in Proboards v5

[Virgil Sovereign]

VSoundCloud v1.2.0

RELEASE

Author: Virgil Sovereign
Plugin: VSoundCloud v1.2.0 Release - Visit Proboards Plugin Library to Download
Permissions: Editable
Keys Used: None

Description:

Adds WYSIWYG editor support for embedding SoundCloud, MixCloud, ReverbNation, and AudioMack tracks in posts. The tracks are identified by their embed codes, which can be obtained from the Share option associated with tracks on soundcloud.com, mixcloud.com, reverbnation.com, and audiomack.com. The plugin adds a button to the WYSIWYG editor (and if present, the augmented Quick Reply) that inserts a [sound] tag in BBCode mode and a track placeholder in Visual mode. When posted, the contents of a [sound] tag are replaced by an embedded audio player and (optionally) a link to the embedded track. Note that prior to v1.1.0, VSoundCloud used [soundcloud] tags rather than [sound] tags in the BBCode mode of the editor. When updating to v1.1.0+, tracks embedded by previous versions of VSoundCloud will still function properly but will be represented by [sound] tags in the editor. Customizable settings in the plugin UI are: URL or graphic resource used for the WYSIWYG editor button editor button tooltip and 'Insert Track' dialog box caption instructions presented to the user in the 'Insert Tack' dialog box error message presented to the user when an invalid/unknown track is specified SoundCloud player markup MixCloud player markup (as of v1.1.0) ReverbNation player markup (as of v1.2.0) AudioMack player markup (as of v1.2.0) placeholder(s) to display on platforms that do not support Proboards plugins (as of v1.1.7) The plugin is equipped with a stylesheet that can be edited in the 'Build' mode of the plugin to fully customize the look and feel of the audio players, links, and track placeholders in the WYSIWYG editor. The plugin is also equipped with reasonable default settings to work 'out of the box'.

Screenshots:

Fig. 1 - An editor button allows for simple insertion of audio tracks in both editor modes. Visual mode is shown here, with the 'insertaudio' resource (packaged with the plugin) used as a button graphic. Clicking the button will open a dialog where an embed code can be entered/pasted to insert a track. Tracks appear as placeholders in the visual mode of the editor, with a look and feel defined by the editor stylesheet in the 'Build' section of the plugin. The default L&F is shown here.

---

Fig. 2 - The editor is shown in BBCode mode, where embedded tracks are represented by [sound] tags. The track is inserted at the caret (cursor) location. The tag can also be typed in manually.

---

Fig. 3 - When viewed in threads, tracks are replaced by standard audio players and links to the embedded tracks. The exact markup used to render the players and links is customizable in the plugin UI. The look and feel can also be modified by editing the display stylesheet in the 'Build' section of the plugin. The default L&F as of v1.2.0 is shown here.

---

Fig. 4 - The GENERAL tab of the plugin UI is shown here.

---

Fig. 5 - The PLAYERS tab of the plugin UI is shown here.


Bugs and Feedback:

Please notify me of any problems you may have in this thread and I will do my best to resolve any issues promptly. I may also consider certain feature requests if they are reasonable and won't bulk up the code too much. Aside from that, sweet dreams in the audiosphere!

---

Update to v1.0.1

- Fixed problems related to Proboards changes in WYSIWYG backend. - Fixed bug where embedded players did not reload when hot-swapping content into pages.

Update to v1.0.2

- Minor bug fixes. - Updated default SoundCloud player embed code.

Update to v1.0.3

- Fixed bug preventing guest users from posting.

Update to v1.1.0

- Added support for MixCloud tracks. - Added support for embed codes and Wordpress codes as well as track URLs. - Added instructions to the "Insert Track" dialog box. - Updated default player HTML embed codes to modern (iframe-based) versions. - Various improvements and minor bug fixes.

Update to v1.1.7

- Added "Mobile" settings tab and placeholders for no-plugin platforms. - Various improvements and minor bug fixes.

Update to v1.2.0

- Added support for ReverbNation and AudioMack tracks. - Modernized default player markup. - Modernized documentation.

[scanbran]

Works perfectly, thanks!

[Osky]

Thanks this is working great!

[boneman]

I do not get the soundcloud player appearing at the moment.

[Virgil Sovereign]

boneman: You'll have to give me a link to your board where the problem is occurring.

[aRMY83]

WOW! Virgil Sovereign...

This plugin is one nice piece of work.

[boneman]

sonsofsibelius.proboards.com

[boneman]

Did you have a look?

[Virgil Sovereign]

boneman: I created a thread on your board and was able to embed a soundcloud file without issue using Firefox. Likewise, I was able to embed a track using the Quick Reply and IE without issues.

When you say you don't get the soundcloud player appearing, could you provide a link to the thread where it isn't showing up? Also, what browser are you using?

Could the issue possibly be related to the bug listed in the OP? To wit: "Currently, accessing a page using the control bar (the floating bar at the top of the page) will cause the plugin not to run until the page is refreshed. This is a known bug owing to Proboards omitting global footers. I cannot fix it. Proboards is aware of it, and should undoubtedly have fixed it soon."

[boneman]

Thanks for testing VS. Everything seems fine now. I have no idea what was causing the problem.

[merleh]

When using this, the Quick Reply BBCode Buttons plugin doesn't work for me.

[bonebender]

Top notch work.

[scanbran]

In the last few days I've had an issue with the WYSIWYG editor on the forum (visual editor), and when I reported it as a bug, I've been advised that it may be down to the soundcloud plugin.

Here is the bug report and answer from the coder :

support.proboards.com/thread/457298/js-error-typeerror-undefined


I'd really hate to have to stop using teh soundcloud plugin as it's really useful - would there be any modification that could be made to it to avoid the problem I'm having?

Thanks.

[Ztrl]

Just an FYI the soundcloud button breaks the visual preview of posts. This needs to be fixed.

[Virgil Sovereign]

Hi all. There have been some changes made to the Proboards editor that break several of my plugins. I'm presently crushed with work. You'll have to give me until the end of the month.

My apologies, but such is life.