TubePress can be inserted into any WordPress post or page via shortcodes, which are small snippets of text surrounded by two brackets. For instance, the following is TubePress's default shortcode:
If you type that shortcode into any post or page on your website, TubePress will replace it with a video gallery. You may use shortcodes an unlimited number of times, anywhere on your site.
If you just type the "empty" shortcode
[tubepress] in a post or a page, the settings you entered into the TubePress options page (
WP Admin > Settings > TubePress) will be used. The real power of the plugin lies in the ability to be configured differently on multiple posts and pages. This is done by passing options to the
[tubepress]shortcode. For any options not explicitly set in the shortcode, TubePress will revert to your settings saved at
WP Admin > Settings > TubePress.
For example, say on one page you want to display a gallery of YouTube videos that are tagged with "football", want 15 videos per page, and want to play the videos in an HTML popup window. On this page, wherever you want the gallery to be displayed, you would type:
[tubepress mode="tag" tagValue="football" playerLocation="popup" resultsPerPage="15"]
And say on another page you want to display a Vimeo gallery of the
staffpicks channel, 4 results per page, and videos to be played with Shadowbox.js. On this page you would type
[tubepress mode="vimeoChannel" vimeoChannelValue="staffpicks" playerLocation="shadowbox" resultsPerPage="4"]
You may follow this procedure for unlimited galleries on unlimited posts/pages. Just use any TubePress option to control TubePress, and be sure to check out this article for tips on adding shortcodes.