TubePress provides an end-to-end solution for allowing your users to interactively search YouTube or Vimeo, all without leaving your site. Here's a very basic idea of what this looks like.

Like everything else with TubePress, interactive searching has loads of options and is fully customizable to suit your needs. To use the feature, you'll need to invoke TubePress twice: once for displaying the search input and once more for displaying the user's search results. Let's go over each invocation in detail.

Searching wouldn't be very fun if you didn't provide an easy way for your users to search. With TubePress, it's really easy.

When invoked on your page, this shortcode will print out a search input box along with a submit button. If you'd like to customize the HTML of either of these, you can edit your theme's HTML template at search/search_input.tpl.php. By default, this search form will submit back to the same page. If you want the results to show up on another page, just set searchResultsUrl.

Regardless of which URL you want to use for the results, somewhere on the page you'll need to invoke TubePress to display the search results.

Displaying search results is also easy.

The searchProvider attribute can be set to either youtube or vimeo, and this determines if the gallery will display YouTube videos or Vimeo videos. This shortcode will also display a placeholder gallery if the user isn't searching, but you can make it invisible until it has search results by setting searchResultsOnly.

Of course, you can use any TubePress shortcode to control the resulting thumbnail gallery.

With TubePress Pro, search results are displayed asynchronously (i.e. without a full page load). It's also a bit easier to set up than standard searching because you only need to invoke TubePress once on the page. The only catch is you also have to identify the DOM element where you want the search results to show up.

For the searchResultsDomId value, just use any jQuery selector that uniquely identifies a DOM element that can contain HTML. Like the standard search input, you can [:customize:themes|customize the HTML]] for the search input elements by editing your theme's HTML template at search/search_input.tpl.php