Joined: 20 Aug 2003
Posts: 5341
Location: Nottingham, UK
Posted: 02/14/12 13:39
Jamroom paSCSeamless Module
Revision History
20120218 V1.0.0 Original Release
20120218 V1.0.2 Nova theme template bug fixes
20130423 V1.0.3 Hide track bug fix
20130908 V1.0.4 Try file_get_contents if CURL fails
Overview
The paSCSeamless module provides users with seamless integration of both their uploaded 'regular' songs, and embedded SoundCloud songs on both the user profile, and skin song pages
When users click on their 'Create Song' button, they get the choice of uploading either a regular song, or a SoundCloud song and are subsequently directed to the respective similar looking form page
After uploading an embedded SoundCloud song, it is treated as a regular song and can be modified, arranged and deleted in the same manner as, and alongside of regular songs
User access to this module is artist quota controlled
Module Installation
Copy the paSCSeamless.php and the 'modules' folder to your Jamroom directory
Log into Jamroom as admin, go to the Module Config page and enable the paSCSeamless module
Installation should now be complete, however, if not running Jamroom V4.1.5 or later, you may need to run the Integrity Check to install this module correctly
Skin and Theme Templates
In order to show SoundCloud songs in the skin and user profile pages, templates need to be modified
Included with this module are the modified template for the 'stock' Nova skin and theme
If you are running the above 'stock' skin and theme, just copy the templates from this package as appropriate
If you are running the above 'stock' skin and theme that have only had their CSS files changed as a colour scheme, say, it should be OK to copy these modified files, BUT BE SURE TO BACKUP FIRST
If you are not running stock skins and themes, or have modified your song templates in any way, check out the included templates to see what is required - basically, whenever the song image, or a link to a popup player, or an embedded player is required, the relevant template code is wrapped in the conditional statement {if is_numeric($SONG_SOUNDCLOUD_ID)}{else}{/if} and the appropriate Song code put in the 'if' section, and the original template code in the 'else' section - copy and paste the Song code from one of the supplied modified templates - BE SURE TO BACKUP FIRST
NOTE that the sample templates also include those modified for the paYTSeamless and paVimeoSeamless modules. It is OK to copy these over as well, even if you are not running these two modules.
Upgrading This Module
Overwrite all your previously uploaded module files with those in the latest release.
Log into your Jamroom site as 'Admin' and if prompted to do so, run the Integrity Check
Module Configuration
By default, all your artist quotas will be configured with this module disabled - the enable/disable option is in the quota Media Support section
By default, all your artist quotas will be configured to allow uploads of both SoundCloud and regular songs - the 'SoundCloud Songs Only' option is in the quota Media Support section and if set, only SoundCloud songs will be uploadable
Go to the Config Modules section and click on the module settings button. A page is displayed where you can configure all the module options - You should not need to change the SoundCloud Tracks URL settings at this time
In order to use this module, perform the following steps to register this application with SoundCloud
Goto http://soundcloud.com and create an account with SoundCloud
Confirm your registration email and log into SoundCloud
Goto http://soundcloud.com/you/apps and register a new application
Name the new application (your Jamroom site name, say) and enter your Jamroom site URL as the re-direct URL, then save the application
Make a note of your SoundCloud Client ID and Secret
In your Admin Control Panel, goto Admin Options => System Config => System Modules and click on the paSCSeamless Settings button
Enter the above Client ID and Secret codes into the relevent fields and click on 'Update Settings'
Questions?
Email any questions, comments or suggestions to paul@paulasher.com, or post on this Forum Thread
The smarty function call paSCSeamless_GetTrackData returns additional track data supplied by the SC API as an array $_scData
So for a song image occurance, the template code might be something like -
Note that you may want to put a {debug} in your code and take a look at the $_scData array - There may be stuff in there you can use!!
I'm hoping that most users will be able to do the mods themselves, but I will offer advice where necessary. Alternatively, I will do skin/theme templates on demand and put them in the Marketplace for a nominal charge. Hope that is acceptable to you all and that you appreciate that doing this does take time and effort.
Having said that, I do not have a copy of the n8flash skin so at the moment would not be able to do it.
Cheers
Pa
soundcloud tracks shows up always as hidden tracks in the track list of the control panel. Also favorite a track of soundcloud not be listet in the favorites on profiles. Actions by create a soundcloud track also not programmed too yet. Just wanted tell you this issues.
Joined: 20 Aug 2003
Posts: 5341
Location: Nottingham, UK
Posted: 02/18/12 12:12
Acidphantom:
Hi PA,
soundcloud tracks shows up always as hidden tracks in the track list of the control panel. Also favorite a track of soundcloud not be listet in the favorites on profiles. Actions by create a soundcloud track also not programmed too yet. Just wanted tell you this issues.
It is an amazing feature for my site...
Best regards,
Acidphantom
Actions and Favouriting SC tracks work OK on the demo site - http://paulasher.com
Also, SC tracks are not being created as 'hidden'.
Have you tried it there?
I still have the logins you sent me the other day so I'll check it out on your site.
Cheers
Pa
Joined: 20 Aug 2003
Posts: 5341
Location: Nottingham, UK
Posted: 02/19/12 09:55
Acidphantom:
Hi PA,
Still same login ... the wierd thing is that on nachtkind profile track pictures disapearing. Tyvm for reply.
Actions yes it says "Created song" ok then the other action info is a n8flash thing.
Greetings,
Acidphantom
Just tried things on your site and its working the same as the demo site - SC tracks created ok, actions and fans working. Maybe I'm misunderstanding your issues?
As for Nachtkind, I looked at the SC data on your database for him and there are no images for most of his tracks. The SC API returns an array of SC track data which may, or may not contain an image url. I make all of that array available for use in your templates so if there was no image from SC when importing the track, there will be no image in your templates.
Cheers
Pa
Thanks for checking it... Just a question is it possible to make in the next soundcloud Module release an manager like you made with the youtube module? Just for future things.
Joined: 20 Aug 2003
Posts: 5341
Location: Nottingham, UK
Posted: 02/19/12 10:47
Acidphantom:
HI PA,
Thanks for checking it... Just a question is it possible to make in the next soundcloud Module release an manager like you made with the youtube module? Just for future things.
Best regards,
Acidphantom
You mean to check that the SC tracks are still valid?
I'll look into it.
Cheers
Pa