You can embed SoundCloud in Apostrophe right out of the box using the embed code feature. But you can also get tighter integration with SoundCloud, with support for SoundCloud searches from within Apostrophe and linked SoundCloud accounts. Linked accounts automatically populate Apostrophe's media repository so they are particularly useful.
This support is similar to that provided for YouTube, however unlike YouTube, SoundCloud does require that you obtain a consumer key (identical to an API key) for your particular site.
To obtain a consumer key, first create a !SoundCloud account and log into the soundcloud.com site. Note: if you are building a client site, the client should do this, or you should create a special SoundCloud account on their behalf. Do not use a single consumer key for many clients.
Then, go to the !SoundCloud Applications page (while logged in), click on the Register a new application button, enter your site's name, and click the Register button. You'll be taken to a page containing your Consumer Key.
Your site only needs one consumer key for SoundCloud, no matter how many SoundCloud accounts you link it to.
Once you complete the process, copy the consumer key to your clipboard and paste it to your project's app.yml file, like so:
all:
a:
soundcloud:
consumerKey: xxxxxxxxx
As always, run the symfony cc command after any change to app.yml.
Now you should be able to use SoundCloud directly from within Apostrophe, in the following ways:
You'll be shown a selection of matching videos, and you can select any of them to add to your Apostrophe site's media repository.
You'll be shown a selection of videos to confirm that this is the correct account. Confirm and the account will be linked to your site.
The next time and every time the apostrophe:update-linked-accounts task is run, all videos in that account will be synced to your Apostrophe media repository. Tags are included in the sync, so you can use the smart slideshow feature to automatically embed relevant videos at any point in your site.