Special Content Sources

07.17.2015Jason

There are several new content sources that can be used for Slider Revolution.
These include Instragram, Facebook, Twitter and more.

Important Article Note!
Since the setup for each of these special content sources is all very similar, in the beginning of this article, we'll walk through a single, general example, and then toward the end, discuss the different specific settings for each source.

1. Select a Source

2. Fill out the Source's Settings

Most of the special sources require some type of ID / additional data. Use the linked resources (circles in red in example below) to learn how you can retrieve this special information.

3. Select "Stream Image" or "Stream Video", depending on your special source.

Quick Note:
A "slide" for a "special content source slider" is a template that will be used for how the content will be displayed. Only one template is required, meaning only one "slide" needs to be setup.

4. Add some Text/HTML Layers to pull in special content

4.1 Then click the "Edit Meta" icon for the layer, and choose one of the listed options that can be pulled in for the special content source.

4.2 Next, style the layer as you would a regular text field, and then save the current slide.

Specific settings for each content source
Refer to sections #1-2 above for where these settings can be found.

1. Slides (max 500) - Choose the number of items to pull in from your content source.
2. Cache (sec) - A cache of 1200 (20 minutes) would allow your pages to load faster, as the Instagram API would only be called for your site every 20 minutes.
3. Flickr API Key - Click here to learn how you can get your API Key
4. Source - Choose the Flickr Source:
- 5.1 User Public Photos - Requires Flickr User URL
- 5.2 User Photoset - Requires Flickr User URL + Photoset Selection
- 5.3 Gallery - Requires Flickr Gallery URL
- 5.4 Group Photos - Requires Flickr Group URL

1. Slides (max 20) - Choose the number of items to pull in from your content source.
2. Cache (sec) - A cache of 1200 (20 minutes) would allow your pages to load faster, as the Instagram API would only be called for your site every 20 minutes.
3. Source - Public photos from user account
4. Instagram User Name - An official username from an Instagram account

1. Post Types - For multiple selections, use Ctrl-Select.
2. Product Categories - Use Ctrl-Select to choose which categories and tags you wish to pull into the slider.
3. Sort Products By - Choose the order of the products (price, sales, quantity, etc.)
4. Sort Direction - Sort products by highest to lowest or vice versa.
5. Max Products - The maximum number of products to be pulled into the slider.
6. Limit the Excerpt To - Max number of words to use for the product's excerpt text.
7. Regular Price - A range of prices to display.
8. Sale Price - A range of sale prices to display.
9. In Stock Only - Only include products that are marked as "In Stock".
10. Featured Only - Only include products that are marked as "Featured".

1. Slides (max 500) - Choose the number of items to pull in from your content source.
2. Cache (sec) - A cache of 1200 (20 minutes) would allow you pages to load faster, as the Twitter API would only be called for your site every 20 minutes.
3. Twitter Name - Your Twitter UserName (without the @ symbol)
4. Text Tweets - Choose to include Text Tweets
5. Retweets - Choose to include Re-Tweets
6. Replies - Choose to include Reply Tweets
Authentication Details - Click here to create a new Twitter "App" that the following information can then be retrieved from.
- 7. Consumer Key - Located in "Key & Access Tokens -> Application Settings" from your Twitter App.
- 8. Consumer Secret - Located in "Key & Access Tokens -> Application Settings" from your Twitter App.
- 9. Access Token - Located in "Key & Access Tokens -> Your Access Token" from your Twitter App.
- 10. Access Secret - Located in "Key & Access Tokens -> Your Access Token" from your Twitter App.

1. Slides (max 25) - Choose the number of items to pull in from your content source.
2. Cache (sec) - A cache of 1200 (20 minutes) would allow you pages to load faster, as the Twitter API would only be called for your site every 20 minutes.
3. Facebook Page - URL to your Facebook page
4. Source - Choose a traditional "timeline" or a specific album.
5. Select Album - Choose a specific album if "Source -> Album" is used for #4 above.
Authentication Details - Click here to create a new Facebook "App" that the following information can then be retrieved from.
- 6. App ID - Located in "My Apps -> App Name -> Dashboard" from your Facebook App.
- 7. App Secret - Located in "My Apps -> App Name -> Dashboard" from your Facebook App.

1. Slides (max 50) - Choose the number of items to pull in from your content source.
2. Cache (sec) - A cache of 1200 (20 minutes) would allow your pages to load faster, as the Instagram API would only be called for your site every 20 minutes.
3. Youtube API Key - Click here to learn how you can generate a YouTube API Key
4. Channel ID - Click here to get your YouTube channel's ID
5. Source - Choose to pull in videos from your YouTube channel or a specific playlist

1. Slides (max 60) - Choose the number of items to pull in from your content source.
2. Cache (sec) - A cache of 1200 (20 minutes) would allow your pages to load faster, as the Instagram API would only be called for your site every 20 minutes.
3. Source - The video source to pull from
- 4.1 User - Your Vimeo Username
- 4.2 Album - A Vimeo Video Album's ID (a number at the end of your album's url)
- 4.3 Group - Name of a Vimeo Video Group
- 4.4 Channel - Name of a Vimeo Video Channel