Embedding Viddler in Apostrophe

You can embed Viddler in Apostrophe right out of the box using the embed code feature. But you can also get tighter integration with Viddler, with support for Viddler searches from within Apostrophe and linked Viddler 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 Viddler does require that you obtain an API key for your particular site.

To obtain an API key,  first create a Viddler account and log into the viddler.com site. Note: if you are building a client site, the client should do this, or you should create a special Viddler account on their behalf. Do not use a single API key for many clients.

Then,  go to the Viddler profile & API page, scroll down to "API Access," and generate an API key for your site.

Your site only needs one API key for Viddler, no matter how many Viddler accounts you link it to.

Once you complete the process, copy the API key to your clipboard and paste it to your project's app.yml file, like so:

all:
  a:
    viddler:
      apiKey: xxxxxxxxx

As always, run the symfony cc command after any change to app.yml.

Now you should be able to use Viddler directly from within Apostrophe, in the following ways:

Searching

• Click the "Media" button
• Click "Search Services"
• Choose "Viddler"
• Enter something to search for and press Enter

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.

Linking Accounts

• Click the "Media" button
• Click "Linked Accounts" (at far right)
• Select "Viddler"
• Enter your Viddler user name (or any other Viddler user name).

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.