Add-Ons

TubePress "add-ons" are optional, additional software installations that add functionality to TubePress Pro. Currently, we offer 4 add-ons, described below.

Add-ons are pre-installed at no cost for TubePress Express users (including Jimdo, Weebly, and 1&1) and Wix users; you only need to purchase and install the add-on if you are using TubePress Pro.

YouTube Black Bars Remover

Most YouTube video thumbnails have horizontal black bars on the top and bottom. This TubePress add-on completely removes these bars, leaving behind a clean and more professional image.

Screenshots

Installation

1. Purchase and download the YouTube Black Bars Remover add-on from the TubePress Dashboard.

2. Using FTP, unzip the file you downloaded (youtube-black-bars-remover_x_y_z.zip) into the add-ons subdirectory of your TubePress Content Directory (wp-content/tubepress-content/add-ons).

3. You should now have a directory at wp-content/tubepress-content/add-ons/youtube-black-bars-remover_x_y_z (where x, y, and z are the major, minor, and micro version numbers of the add-on).

4. Clear the TubePress system cache once so TubePress discovers the add-on.

Usage

You can activate this add-on from WP Admin > Settings > TubePress. Navigate to the "Thumbnails" tab and scroll to the bottom of the page. There you will see a checkbox which enables/disables the black bar removal.

Vimeo All Access

This TubePress add-on provides TubePress with enhanced access to your Vimeo Plus or PRO account, thus allowing TubePress to work with private Vimeo videos. This is particularly useful if you’d like to hide your videos from display on vimeo.com and only show them on your website.

To make a video private, choose the last radio icon in the privacy settings for the video as shown below:

Installation

1. Purchase and download the Vimeo All Access add-on from the downloads page of the TubePress Dashboard.

2. Using FTP, unzip the file you downloaded (vimeo-all-access_x_y_z.zip) into the add-ons subdirectory of your TubePress Content Directory (wp-content/tubepress-content/add-ons).

3. You should now have a directory at wp-content/tubepress-content/add-ons/vimeo-all-access_x_y_z (where x, y, and z are the major, minor, and micro version numbers of the add-on).

4. Clear the TubePress system cache once so TubePress discovers the add-on.

Usage

1. If you haven't already done so, complete the initial Vimeo API setup process.

2. Under the "Feed" tab of your TubePress settings page, scroll down to the Vimeo area and click the "New token" button.

   

   A popup window will open and ask for your permission to allow TubePress to access your private videos. Click the "Allow" button to grant permission.

   

   The popup window should close itself automatically and you should see a success message.

   

   And you should see a new token in your list of API tokens.

   

3. Under the "Which Videos?" tab, select the "Feed Options" tab for any Vimeo video source. Use the "API Token" dropdown menu to choose your new All Access token.

   

4. You may repeat the above process to obtain additional tokens, which may be useful if you have several Vimeo accounts under your control.

Flexible Thumbnail Rows

This add-on automatically adjusts the height of thumbnail rows in TubePress galleries, ensuring that the metadata (runtime, title, description, etc.) for each video is completely visible. This overcomes TubePress themes that might use a fixed height for the thumbnail rows where any metadata that is taller than the row will be cut off.

Screenshots

Installation

1. Purchase and download the Flexible Thumbnail Rows add-on from the downloads page on the TubePress Dashboard.

2. Using FTP, unzip the file you downloaded (flexible-thumbnail-rows_x_y_z.zip) into the add-ons subdirectory of your TubePress Content Directory (wp-content/tubepress-content/add-ons).

3. You should now have a directory at wp-content/tubepress-content/add-ons/flexible-thumbnail-rows_x_y_z (where x, y, and z are the major, minor, and micro version numbers of the add-on).

4. Clear the TubePress system cache once so TubePress discovers the add-on.

Usage

You can activate this add-on from WP Admin > Settings > TubePress. Navigate to the "Thumbnails" tab and scroll to the bottom of the page. There you will see a checkbox which enables/disables the add-on.

QuickPlay

This TubePress add-on replaces video thumbnail images with fully-functional embedded video players. Among other things, this allows your users to watch your videos right within the context of your gallery. It also makes it easy to showcase the latest video from a collection.

Screenshots

Installation

1. Purchase and download the QuickPlay add-on from the downloads page on the TubePress Dashboard.

2. Using FTP, unzip the file you downloaded (quickplay_x_y_z.zip) into the add-ons subdirectory of your TubePress Content Directory (wp-content/tubepress-content/add-ons).

3. You should now have a directory at wp-content/tubepress-content/add-ons/quickplay_x_y_z (where x, y, and z are the major, minor, and micro version numbers of the add-on).

4. Copy (or symlink) the directory at wp-content/tubepress-content/add-ons/quickplay_x_y_z/tubepress-theme to wp-content/tubepress-content/themes/quickplay

5. Clear the TubePress system cache once so TubePress discovers the add-on and theme.

Basic Usage

Anytime you add TubePress to a post or page, set the options enableQuickplay="true" and theme="tubepress/quickplay", e.g.

[tubepress enableQuickplay="true" theme="tubepress/quickplay"]

Controlling Height and Width of the Embeds

To control the height and width of the embedded video players, you can simply use the embeddedHeight and embeddedWidth options. thumbHeight and thumbWidth are ignored when this add-on is in use.

Show the Latest Video from a Collection

A common question we get from users is:

How can I have an embedded video player that automatically shows the latest video from my YouTube or Vimeo channel?

With QuickPlay, this is easy to do for any collection of videos. The trick is to set resultCountCap="1" and orderBy="newest". For instance, say that you’d like to show the latest video from YouTube user engineerguyvideo. The following invocation would achieve this:

[mode="user" userValue="engineerguyvideo" resultCountCap="1" orderBy="newest" enableQuickplay="true" theme="tubepress/quickplay" embeddedWidth="480" embeddedHeight="270"]

The result is an always-updating, fully-customizable single video embed that you can embed anywhere on your site.