Embedding SlideShare in Apostrophe

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

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

Then,  go to the SlideShare API page (while logged in), enter your name, email, and a brief description of why you need an API key, and press the Apply for API Key button. The SlideShare team will email you an API key and a shared secret within a few minutes.

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

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

all:
  a:
    slideshare:
      apiKey: xxxxxxxxx
      sharedSecret: xxxxxxxxx

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

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

Searching

• Click the "Media" button
• Click "Search Services"
• Choose "SlideShare"
• 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 "SlideShare"
• Enter your SlideShare user name (or any other SlideShare 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.