Thumbnail Options

This page lists all of the TubePress options that apply to video thumbnails.

Global

The options below apply to all video providers (YouTube, Vimeo, Dailymotion, etc.).

Option name ajaxPagination
Description Use Ajax to paginate (clicking on "Next", etc) through galleries. This avoids a full page reload and is usually a better experience for your users.
Default value false
Valid values true or false
Example shortcode
[tubepress ajaxPagination="false"]
Example in PHP
<?php TubePressPro::getHTML('ajaxPagination="false"');
Option name enableQuickplay
Description Replaces video thumbnail images with fully-functional embedded video players.
Default value true
Valid values true or false
Note This is only available with the QuickPlay Add-On for TubePress
Example shortcode
[tubepress enableQuickplay="false"]
Example in PHP
<?php TubePressPro::getHTML('enableQuickplay="false"');
Option name flexibleThumbnailRows
Description Automatically adjust the height of thumbnail rows in TubePress galleries, ensuring that the metadata (runtime, title, description, etc) for each video is completely visible.
Default value true
Valid values true or false
Note This is only available with the Flexible Thumbnail Rows Add-On for TubePress
Example shortcode
[tubepress flexibleThumbnailRows="false"]
Example in PHP
<?php TubePressPro::getHTML('flexibleThumbnailRows="false"');
Option name fluidThumbs
Description Dynamically adjust the width of thumbnail columns to best fit their container. This generally improves the appearance of the thumbnail gallery, but can cause problems in complex site layouts.
Default value true
Valid values true or false
Example shortcode
[tubepress fluidThumbs="false"]
Example in PHP
<?php TubePressPro::getHTML('fluidThumbs="false"');
Option name hqThumbs
Description Use highest-quality thumbnails. This allows thumbnail sizes greater than 120px x 90px without causing distortion.
Default value false
Valid values true or false
Example shortcode
[tubepress hqThumbs="true"]
Example in PHP
<?php TubePressPro::getHTML('hqThumbs="true"');
Option name paginationAbove
Description Show pagination links ("Next", "Prev", etc) above the thumbnail gallery.
Default value false
Valid values true or false
Example shortcode
[tubepress paginationAbove="true"]
Example in PHP
<?php TubePressPro::getHTML('paginationAbove="true"');
Option name paginationBelow
Description Show pagination links ("Next", "Prev", etc) below the thumbnail gallery.
Default value false
Valid values true or false
Example shortcode
[tubepress paginationBelow="true"]
Example in PHP
<?php TubePressPro::getHTML('paginationBelow="true"');
Option name resultsPerPage
Description Defines how many videos from a video source should be on each page of the gallery.
Default value 30
Valid values Any integer between 1 and 50 (inclusive)
Example shortcode
[tubepress resultsPerPage="30"]
Example in PHP
<?php TubePressPro::getHTML('resultsPerPage="30"');
Option name thumbHeight
Description The desired height (in pixels) of video thumbnails.
Default value 90
Valid values Any positive integer
Example shortcode
[tubepress thumbHeight="30"]
Example in PHP
<?php TubePressPro::getHTML('thumbHeight="30"');
Option name thumbWidth
Description The desired width (in pixels) of video thumbnails.
Default value 90
Valid values Any positive integer
Example shortcode
[tubepress thumbWidth="30"]
Example in PHP
<?php TubePressPro::getHTML('thumbWidth="30"');

Dailymotion

The options below apply only to Dailymotion.

Option name dailymotionThumbnailPreferredSize
Description Select the desired height (in pixels) of the thumbnails served from Dailymotion. Higher resolutions will generally look better but will negatively impact your site's load time. For best results, choose the value closest to (but not less than) your actual thumbnail height.
Default value original
Valid values
  • max
  • 720px
  • 480px
  • 360px
  • 240px
  • 180px
  • 120px
  • 60px
Example shortcode
[tubepress dailymotionThumbnailPreferredSize="720px"]
Example in PHP
<?php TubePressPro::getHTML('dailymotionThumbnailPreferredSize="720px"');
Option name dailymotionThumbnailRatio
Description Select the desired aspect ratio of the Dailymotion thumbnails.
Default value original
Valid values
  • original
  • widescreen
  • square
Example shortcode
[tubepress dailymotionThumbnailRatio="widescreen"]
Example in PHP
<?php TubePressPro::getHTML('dailymotionThumbnailRatio="widescreen"');

YouTube

The options below apply only to YouTube.

Option name randomize_thumbnails
Description Most YouTube videos come with several thumbnails. By setting this option to true, each time a user visits a gallery they will see a randomly-selected thumbnail for each video. This option conflicts with hqThumbs.
Default value false
Valid values true or false
Example shortcode
[tubepress randomize_thumbnails="true"]
Example in PHP
<?php TubePressPro::getHTML('randomize_thumbnails="true"');
Option name youtubeHideBlackBars
Description Hides the "black bars" on most YouTube thumbnails.
Default value false
Valid values true or false
Note Requires the YouTube Black Bars Remover Add-On
Example shortcode
[tubepress youtubeHideBlackBars="true"]
Example in PHP
<?php TubePressPro::getHTML('youtubeHideBlackBars="true"');


Last Updated May 31, 2016 12:25PM PDT
c65861bf7a72e1a8878bdf73cabbbdbf@tubepress.desk-mail.com
http://assets3.desk.com/
false
desk
Loading
seconds ago
a minute ago
minutes ago
an hour ago
hours ago
a day ago
days ago
about
false
Invalid characters found
/customer/en/portal/articles/autocomplete