Welcome to TubePress

TubePress makes it easy to add video galleries to your website. It’s highly configurable and designed for website builders and users of any skill level.

Check out a live demo of TubePress here.

TubePress is available both as a downloadable package and via several cloud-hosted, zero-installation services. The software is mostly open source, and it’s designed and maintained by TubePress LLC, a software company based in Pittsburgh, Pennsylvania.

User Guides

Most TubePress users will want to use one of the guides below. Each guide covers installation, general usage, and troubleshooting.

TubePress for PHP

TubePress Pro is available to use as a mature PHP library, which makes it accessible to any website that runs PHP.

Manual Contents

Getting Started

This section of the manual is targeted towards new users of TubePress for PHP.

Basic Usage in PHP

On This Page

Add TubePress to any PHP Page

This section has moved to http://support.tubepress.com/customer/portal/articles/2032994-add-tubepress-to-any-php-page

Video Galleries from Multiple Sources

With TubePress Pro, you can create galleries that are composed of video from multiple video sources. TubePress can even combine videos from multiple video providers - for instance, you can easily have YouTube and Vimeo videos intermingled in the same gallery!

As an example, say that you want to create a single gallery containing videos from the following sources, all combined into a single gallery:

  • the YouTube playlist F5D324185EE73FEC
  • uploads from YouTube user bbc
  • uploads from YouTube user funnyordie
  • YouTube search for the exact term “san diego craft beer”
  • the Vimeo album 140484

This is easy to accomplish with TubePress Pro. The trick is to use + in some of your options to combine the sources. For the example above, the set of options that you pass to TubePress might look like this:

<?php

print TubePressPro::getHTML('mode="playlist + user + tag + vimeoAlbum" playlistValue="F5D324185EE73FEC" userValue="bbc + funnyordie" tagValue=\'"san diego craft beer"\' vimeoAlbumValue="140484"');

The videos from all 5 sources will be collected and seamlessly assembled into a single TubePress gallery. You can combine any number of gallery sources with any number of parameters to each source.

Please keep in mind the following “gotchas”

  • The resultsPerPage option will apply to each source, so expect each gallery page to contain up to resultsPerPage x <number of sources> videos per page. In the example above, assuming resultsPerPage was set to 10, there would be 40 videos per page (10 videos per page x 4 sources).
  • As the user pages through the gallery, some of the sources will drop off quietly. For instance, if one video source has 1,000 videos and another has 10 videos, the second page of the gallery won’t contain any of the latter source’s videos.
Add-Ons

TubePress is built on a modular architecture, and is designed so that additional modules can be “plugged in” to add or change functionality. We refer to these modules as TubePress “add-ons.”

Wish that TubePress had new or modified functionality? The first place to check is the TubePress Marketplace, where you can purchase and download powerful add-ons written by TubePress LLC.

In This Section

Vimeo All Access

On This Page

Introduction

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:

_images/vimeo-privacy-settings.png
Installation
  1. Purchase and download this add-on from the TubePress Marketplace.

  2. Unzip the file you downloaded (vimeo-all-access_x_y_z.zip) into the add-ons subdirectory of your TubePress Content Directory.

  3. Clear the TubePress system cache so TubePress discovers the add-on.
Usage

  1. Ensure you have completed the one-time Vimeo API setup.

  2. You will need to supply an additional set of Vimeo API credentials to TubePress: an “Access Token” with a corresponding “Access Token Secret”. This is a one-time step for this add-on.

    Visit https://developer.vimeo.com/apps. You should see a list of any Vimeo apps that you have created. Click on the app that you are using for TubePress.

  3. Click the “OAuth” tab.

  4. At the bottom of the page, you will see a box containing your Access Token and Access Token Secret:

    _images/access_token_secret.jpg
Advanced Topics
The TubePress System Cache

This section has moved to http://support.tubepress.com/customer/portal/articles/2048959-the-system-cache

Reference
Options
Core Options

On This Page

Vimeo Options

On This Page

Embedded Video Player

Embedded Video Player

playerColor
Option name playerColor
Description The highlight color of the Vimeo video player.
Provided with All TubePress distributions
Default value 000000
Valid values Any six hexadecimal characters representing an HTML color.
Shortcode example [tubepress playerColor="A32638"]
Standalone PHP example TubePressPro::getHtmlForShortcode('playerColor="A32638"');
YouTube documentation Click here
Video Feed

Video Feed Options

vimeoKey
Option name vimeoKey
Description The API key that TubePress will use when communicating with Vimeo.
Provided with All TubePress distributions
Default value empty
Valid values Any valid Vimeo API key
Shortcode example [tubepress vimeoKey="..."]
Standalone PHP example TubePressPro::getHtmlForShortcode('vimeoKey="..."');
Vimeo documentation Click here
vimeoSecret
Option name vimeoSecret
Description The API secret that TubePress will use when communicating with Vimeo.
Provided with All TubePress distributions
Default value empty
Valid values Any valid Vimeo API secret
Shortcode example [tubepress vimeoSecret="..."]
Standalone PHP example TubePressPro::getHtmlForShortcode('vimeoSecret="..."');
Vimeo documentation Click here
Video Meta Display
likes
Option name likes
Description Toggle display of the number of times the video has been “liked”.
Provided with All TubePress distributions
Default value false
Valid values true or false
Shortcode example [tubepress likes="true"]
Standalone PHP example TubePressPro::getHtmlForShortcode('likes="true"');
Vimeo All Access Options

This page documents the options available with the ../../../manual/add-ons/vimeo-all-access/index add-on for TubePress.

vimeoApiAccessToken
Option name vimeoApiAccessToken
Description The API secret that TubePress will use when communicating with Vimeo.
Provided with
  • All cloud-based TubePress distributions
  • Vimeo All Access add-on add-on
Default value empty
Valid values Any valid Vimeo API access token
Shortcode example [tubepress vimeoApiAccessToken="..."]
Standalone PHP example TubePressPro::getHtmlForShortcode('vimeoApiAccessToken="..."');
Vimeo documentation Click here
vimeoApiAccessTokenSecret
Option name vimeoApiAccessTokenSecret
Description The API secret that TubePress will use when communicating with Vimeo.
Provided with
  • All cloud-based TubePress distributions
  • Vimeo All Access add-on
Default value empty
Valid values Any valid Vimeo API access token secret
Shortcode example [tubepress vimeoApiAccessTokenSecret="..."]
Standalone PHP example TubePressPro::getHtmlForShortcode('vimeoApiAccessTokenSecret="..."');
Vimeo documentation Click here
Flexible Thumbnail Row Options

This page has moved to http://support.tubepress.com/customer/portal/articles/2034850-thumbnail-options

YouTube Black Bars Remover Options

This page has moved to http://support.tubepress.com/customer/portal/articles/2034850-thumbnail-options

Around the Web

A few other places around the Internet where you’ll find us.

Contact Us

You can find our contact info on this page. We look forward to hearing from you.