Complete the initial Rock Plugin setup before you configure media. This setup creates and validates the Subsplash API client that the media account uses.

The Subsplash Rock Plugin syncs published media from your Subsplash Media library to Rock. Synced items become Rock Media Elements (Rock's record for a single video or audio item) that you can use in content channels, Rock websites, and other Rock integrations.

The media sync is one-way from Subsplash to Rock. The plugin does not preserve Subsplash libraries or folders. It puts all synced media in a public Rock folder named Media Items.

Changes you make to synced items in Rock are overwritten on the next sync. Edit titles, artwork, and media in Subsplash.

Set up the media account in Rock

In Rock, open Admin Tools > Digital Tools > Media Accounts.
Select Add (+) to add a media account.
Set Account Type to Subsplash Media Account.
Select the active Subsplash API Client that you configured under Admin Tools > Installed Plugins > Subsplash > Settings.
Save the media account.

Sync media

Rock's Sync Media job syncs your media automatically. By default, it runs every two hours:

Full sync: The first time the job runs each day, it imports and updates all of your published media and then sends analytics to Subsplash.
Quick sync: Every other run that day imports only items that were created or updated in Subsplash since the last sync.

To change the schedule, navigate to Admin Tools > Settings > Jobs Administration and select Sync Media. To allow a full sync on every run, turn Limit Full Sync to Once a Day to No and select Save.

Media that syncs

The data that syncs for each Media item are the following:

Title, duration, and the Subsplash media item short code.
Video streams and downloadable video files.
Downloadable audio files.
Square, Wide, and Banner artwork.

At this time, only published items sync. Draft and unpublished items do not.

Deleting or unpublishing an item in Subsplash doesn't remove it from Rock. Delete the Media Element in Rock if you no longer want it.

Run a manual sync

You can start a manual sync in either of these ways:

Use the download button in the Media Account configuration to run a full sync.
Use the refresh button where Rock shows a Media Element field to sync folders and media elements.

Embed media

You can embed a synced media item with the Subsplash player or Rock's media player.

Use the Subsplash player

Sign in to the Subsplash Dashboard.
Go to Web > Web App.
In Basic Info, find the app short code in the Custom URL. Use that value for AppShortCode below.

{% assign AppShortCode = '[Your app short code]' %}
{% assign MediaItemShortCode = Item | Attribute:'MediaItem','SourceKey' %}
<div class="sap-embed-player">
  <iframe src="https://subsplash.com/+{{ AppShortCode }}/embed/mi/+{{ MediaItemShortCode }}?audio&video&logoWatermark" frameborder="0" webkitallowfullscreen mozallowfullscreen allowfullscreen></iframe>
</div>
<style type="text/css">
  div.sap-embed-player { position: relative; width: 100%; height: 0; padding-top: 56.25%; }
  div.sap-embed-player > iframe { position: absolute; top: 0; left: 0; width: 100%; height: 100%; }
</style>

Use the Rock media player

Get the Media Element attribute's raw value and pass it to Rock's mediaplayer shortcode:

{% assign mediaElement = Item | Attribute:'MediaItem','RawValue' %}
{[ mediaplayer media:'{{ mediaElement }}' autoresumeindays:'14' combineplaystatisticsindays:'14' width:'100%' ]}
{[ endmediaplayer ]}

Sync analytics

When people watch media in Rock's media player, Rock records the views. Rock sends these views to Subsplash once a day during the full sync, or when you run a manual full sync. Analytics sync one way, from Rock to Subsplash.

Synced plays appear in the Subsplash Dashboard as Web Embed views.

New plays can take up to 24 hours to appear in Subsplash.

Rock Plugin Media