Displaying Media on your Pages

ProMedia comes with three types of Component players that meet specific needs.

• Videoplayer
• Audioplayer
• Multimediaplayer

To add media to your pages add the component to your page and render it with the component tag/alias:

{% component 'proMediaVideoplayer' %}

Audioplayer

The Audioplayer component comes with four specially designed views tailored for audio use.

The following settings are available:

• itemsPerPage - used for pagination
• audioplayer_view - what custom view to use (footer_list,thumb_list,popup_list,single_player)
• filter_type - filter by category or item ID
• filter_value - the value to filter by
• pagination - enable/disable pagination
• enable_rss - enable/disable rss feed / podcase (iTunes compatible)
• rss_title - rss feed title
• rss_description - rss feed description

Videoplayer

The Videoplayer component comes with four specially designed views tailored for video use.

The following settings are available:

• itemsPerPage - used for pagination
• vidoplayer_view - what custom view to use (list,player,footer_list,single_player)
• filter_type - filter by category or item ID
• filter_value - the value to filter by
• pagination - enable/disable pagination
• enable_rss - enable/disable rss feed / vidocast
• rss_title - rss feed title
• rss_description - rss feed description

Multimediaplayer

The Multimediaplayer component is designed specifically for usecases where potentially all three - Video,Audio,File Download - might be present.

An example of this would a church. Wherein a message video, message audio, and message notes might all be present for one media "item".

The following settings are available:

• itemsPerPage - used for pagination
• mediaplayer_view - what custom view to use (player) //more may be added later
• filter_type - filter by category or item ID
• filter_value - the value to filter by

Flexible Component Filtering

All three components offer flexible routing to search and filter your media. With all three components you can establish passive url parameteres like so:

/mediapage/:filter?/:slug?/

The following can be searched or filtered for all three media players:

• Category - /mediapage/category/category-name/
• Item - /mediapage/item/id#/
• Search - /mediapage/search/search-term/

Displaying Individual Media in your Pages

There are two ways you can display individual players of audio or video.

• Limit the results to 1 to which the latest video or audio will always show.
• Specify a filter of "specific" and provide an id# value

Video formatting Recomendations

We recommend using Youtube and Vimeo when you can. Hosted videos are possible, but certianly server intensive. If you have a larger quantity of videos, we do recommend a video CDN. For best hosted video & CDN performance we recommend you encode in h.264 mp4. You can use great converters such as ffmpeg to achieve this - http://www.ffmpegx.com/

Styling the player

You can add custom styling to your liking. We have included an example skin of how you might approach this in the component controller.

To start out, duplicate the custom_skin folder and rename. In the component controller uncomment out the custom skin css and point to your new folder name. All three components can utilize custom skins. Make sure you back up any custom work you've done incase you update the plugin at some point.