Home

TubePress Documentation

1. Click here 4 1 Options 113 TubePress Documentation Release modestBranding Option name modestBranding Description If enabled hides the YouTube logo from the video controls area Provided with All TubePress distributions Default value true Valid values true or false Shortcode example tubepress modestBranding false Standalone PHP TubePressPro getHtmlForShortcode modestBranding false example YouTube documentation Click here showRelated Option name showRelated Description Toggles display of related videos when playback finishes Provided with All TubePress distributions Default value true Valid values true or false Shortcode example tubepress showRelated false Standalone PHP example TubePressPro getHtmlForShortcode showRelated false YouTube documentation Click here youtubeClosedCaptions Option name youtubeClosedCaptions Description Show closed captions by default Provided with All TubePress distributions Default value false Valid values true or false Shortcode example tubepress youtubeClosedCaptions true Standalone PHP TubePressPro getHtmlForShortcode youtubeClosedCaptions true example YouTube Click here documentation youtubeDisableKeyboardControls Option name youtubeDisableKeyboardControls Description Disable all keyboard controls for the video Provided with All TubePress dist
2. TubePress Documentation Release playerColor Option name Description Provided with Default value Valid values Shortcode example Standalone PHP example YouTube documentation playerColor The highlight color of the Vimeo video player All TubePress distributions 000000 Any six hexadecimal characters representing an HTML color tubepress playerColor A32638 TubePressPro getHtmlForShortcode playerColor A32638 Click here Video Feed Video Feed Options e vimeoKey e vimeoSecret vimeoKey Option name Description Provided with Default value Valid values Shortcode example Vimeo documentation Standalone PHP example vimeoKey The API key that TubePress will use when communicating with Vimeo All TubePress distributions empty Any valid Vimeo API key tubepress vimeoKey TubePressPro getHtmlForShortcode vimeoKey Click here WE vimeoSecret Option name Description Provided with Default value Valid values Shortcode example Vimeo documentation Standalone PHP example vimeoSecret The API secret that TubePress will use when communicating with Vimeo All TubePress distributions empty Any valid Vimeo API secret tubepress vimeoSecret TubePressPro getHtmlForShortcod Click here vimeoSecret W N 4 1 Options 121 TubePress Documentation Release Video Meta
3. Supported provider s Vimeo and YouTube Shortcode example tubepress id true Standalone PHP example TubePressPro getHtmlForShortcode id true length Option name Description Provided with length Toggle display of the video runtime All TubePress distributions Default value true Valid values true or false Supported provider s Vimeo Shortcode example tubepress length false Standalone PHP example TubePressPro getHtmlForShortcode length false relativeDates Option name Description Provided with Default value Valid values relativeDates Toggle display of relative dates such as last year instead of Nov 3 1980 All TubePress distributions false true or false Supported provider s Vimeo or YouTube Shortcode example tubepress relativeDates true Standalone PHP TubePressPro getHtmlForShortcode relativeDates true example ao ee 4 1 Options 103 TubePress Documentation Release tags Option name Description Provided with tags Toggle display of the video keywords All TubePress distributions Default value false Valid values true or false Supported provider s Vimeo Shortcode example tubepress tags true Standalone PHP example TubePressPro getHtmlForShortcode tags true title Option name Description Provided with Default value Valid values title Tog
4. 2 4 Official TubePress Add Ons 59 TubePress Documentation Release Rebuild the system cache so TubePress detects the new features Ensure you have completed the one time Vimeo API setup Obtain your Vimeo access credentials Nn nA Fw This add on introduces two new options vimeoApiAccessToken and vimeoApiAccessTo kenSecret You may supply these options along with vimeoKey and vimeoSecret to TubePressPro getHtmlForShortcode e g lt php print TubePressPro getHtmlForShortcode vimeoKey xxxx vimeoSecret xxxx vimeoAccessToker TubePress for Wix Users of cloud based TubePress installations e g TubePress Express TubePress for Wix should follow these instruc tions 1 Obtain your Vimeo consumer credentials Obtain your Vimeo access credentials Open up the full settings page for your TubePress instance ie oe N In the window that opens navigate to the Feed tab and scroll down to the Vimeo All Access box 5 Enter the credentials obtained in Step 1 into the Client ID and Client secret text boxes 6 Enter the credentials obtained in Step 2 into the Access Token and Access Token Secret boxes 7 Click the Save button Obtaining API Credentials Access Token and Secret You will need to supply an additional set of Vimeo API credentials to TubePress an Access Token with a corre sponding Access Token Secret This is a one time step for this
5. e searchProvider e searchResultsDomId e searchResultsOnly e searchResultsUrl searchProvider Option name Description Provided with Default value Valid values searchProvider The name of a video provider e g YouTube or Vimeo which should be searched for matching videos All TubePress distributions empty The name of a search provider Current either youtube or vimeo Supported provider s Vimeo and YouTube Shortcode example tubepress searchProvider vimeo Standalone PHP TubePressPro getHtmlForShortcode searchProvider vimeo example searchResultsDomId Option name Description Provided with Default value Valid values Supported provider s Shortcode example Standalone PHP example searchResultsDomId Used with the detached playerLocation option this option defines a jQuery selector for which TubePress should place the search results TubePress Pro empty Any valid jQuery selector Vimeo and YouTube tubepress searchResultsDomId tubepress search results div TubePressPro getHtmlForShortcode searchResult sDomId tubepres Is search res 4 1 Options 105 TubePress Documentation Release searchResultsOnly Option name searchResultsOnly Description If set to true this shortcode will produce search results only after the user has submitted search terms It will be invisible if the user is no
6. 3 1 Creating a TubePress Add On On this page e Overview 3 1 1 Overview 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 browse all official and user submitted add ons With luck someone will have already built an add on that meets your needs If not you can easily build your own add on by following the instructions below 3 2 Theme Development This page describes the technical aspects of creating a new TubePress theme Theme creation is relatively quick and requires no special skills other than some basic knowledge of HTML and CSS 73 TubePress Documentation Release On this page 5 Minute Tutorial What s a Theme Manifest File Required Fields Optional Fields Templates List of Templates Using Custom Templates in Themes CSS amp JS Hierarchical Themes Sharing with the Community 3 2 1 5 Minute Tutorial For a very quick start we have put together a tutorial during which you will create your own custom TubePress theme in 5 minutes or less 5 Minute TubePress Theme Tutorial for WordPress For this tutorial you will create a child theme of the default TubePress theme Your theme will simply ad
7. Mi PT d hathon shal Keywords doctors drug addiction pennsylvania physicians health Category People amp Blogs Number of ratings 1 Average rating 5 00 View count 5 809 Date posted Sep 11 2009 My father Dr Rodney Hough interviewed by CBS back in 2007 regarding his recovery from addiction to pain pills This aired on CBS 21 News which servers central Pennsylvania in February 2008 1 1 Features 5 TubePress Documentation Release To embed a single video with TubePress you simply need to give TubePress the ID of the video you d like to embed For instance if you want to embed the YouTube video with ID J51kfduN5aA you would use use the following shortcode tubepress video J51kfduN5aA 1 1 3 Interactive Searching On this page e Introduction e Search Input e Search Results e Ajax Enabled Search Results Introduction TubePress provides an end to end solution for allowing your users to interactively search YouTube or Vimeo all without leaving your site The image below is a simple example showing an interactive search input along with a few results pittsburgh steelers Search Pittsburgh Steelers 2010 2011 Pittsburgh 2011 12 Pittsburgh Madden NFL 12 Unstoppable Steelers Black And Steelers Hype Up Video Gameplay Pittsburgh 2 49 Yellow 7 17 Steelers vs Cleveland Views 527 776 4 09 Views 3 191 Browns HD ES Posthumus Unstoppad Views 1 103 816 Just a little somethin
8. content The TubePress Content Directory which must always be named tubepress content should contain the follow ing immediate subdirectories add ons TubePress add ons that aren t shipped with TubePress config Low level configuration for TubePress themes TubePress themes that aren t shipped with TubePress Installing Add Ons amp Themes Installing an add on or theme involves two steps 1 Unzip the add on or theme into your TubePress Content Directory see above Add ons should be unzipped into the add ons subdirectory and themes should be unzipped into the themes subdirectory 2 Rebuild the system cache so TubePress can detect and load the new items For instance suppose you have downloaded an add on named some_tubepress_feature zip To install you would unzip the downloaded file into the add ons subdi rectory so that the filesystem path of the add on would look something like tubepress_pro_x_y_z tubepress content add ons some_tubepress_feature FAQ amp Troubleshooting On This Page e Common Problems JavaScript Errors Cross Domain Ajax API Latency Locked Down PHP Installation e Troubleshooting Tools Debugging Mode Firebug Common Problems Use the table below to find a solution to your problem 42 Chapter 2 User Manuals TubePress Documentation Release Problem Possible causes and solutions Video thumbnails are unclickable J
9. theme ehough mynewtheme Since this theme is a child of the default TubePress theme and we haven t made any changes everything should look identical to the default theme right now OKC Golf Club whimsical Whitney Kay Brian Scott Twin Hills wedding wedding Shore Lodge wedding 4 28 4 54 6 45 Ea Brides of Oklahoma gown Pear Tree Estate wedding Hotel Zaza St Anne s The shoot 4 48 Corinthian wedding 3 42 6 24 7 Go back to the starter theme directory from Step 1 and again using your favorite text editor open up css theme css and add the following CSS div tubepress_thumb img webkit border radius 15px moz border radius 15px border radius 15px dd tubepress_meta_title font weight 200 dd tubepress_meta_runtime font style italic 82 Chapter 3 Developer Documentation TubePress Documentation Release This will round off the corners of all TubePress thumbnails lighten the font of the video titles and italicize the video runtime Save this file 8 Head back to your test page from Step 6 and hit refresh You should see the changes from your new CSS auf at OKC Golf Club whimsical Whitney Kay Brian Scott Twin Hills wedding wedding Shore Lodge wedding 4 28 4 54 6 45 Ai Brides of Oklahoma gown Pear Tree Estate wedding Hotel Zaza St Anne s The shoot 4 48 Corinthian wedding 3 42 6 24 Congratulations You have successfully creat
10. Click on any TubePress thumbnail You should see a new XHR request show up as TubePress performs its Ajax request ey Console HTML CSS Script DOM Net Cookies p DLII le Clear Persist Profile All Errors Warnings info Debug info Cookies gt GET http tubepress org wp content plugins tubepress pro 2 4 2 sys scripts ajax playerHtml php tubepress video hHuGtuWQoC4 amp tubepress shortcode 255Bgallery tubepress 2520galleryid 253D 25221006 jquery min js line 4 5 Expand this request using the expand icon on the left to view the results You should see a small medium JSON result If you see anything else here or nothing at all then something is wrong ee Console HTML CSS Script DOM Net Cookies P eeo i Clear Persist Profile All Errors Warnings Info Debug info Cookies GET http tubepress org wp content plugins tubepress pro 2 4 2 sys scripts ajax playerHtml php tubepress video hHuGtuWQoC4 amp tubepress shortcode 255Bgallery tubepress 2520galleryid 253D 25221006 jquery min js line 4 Params Headers Response HTML JSON Cookies title Champion 20Spotlight 3A 20Evelynn 2C 20the 20Widowmaker html 83Cdiv 20class 3D 22tubepress_normal_embedded_wrapper 22420style 3D322widtht3A 20575px 2233E 0A 20820 2082033Cdiv 20id 3D 22tubepress_embedded_title_1006144134 22420class 3D822tubepress_embedded_title 2283E 0A 20420820820 20 20Champion 20Spotlightt3A 20Evelynn 2C820thet20Widowmakert20 20 20 2080A 20 2
11. Release vimeoLikes Gallery source vimeoLikes Description Vimeo videos that a particular user has liked The Vimeo user is identified by the value supplied to the vimeoLikesValue option Shortcode tubepress mode vimeoLikes vimeoLikesValue besthd example Standalone PHP TubePressPro getHtmlForShortcode mode vimeoLikes example vimeoLikesValue besthd Vimeo Click here documentation vimeoSearch Gallery source vimeoSearch Description Vimeo videos that match a supplied search term The search term is identified by the value supplied to the vimeoSearchValue option Shortcode tubepress mode vimeoSearch vimeoSearchValue rainbow example alligator Standalone PHP TubePressPro getHtmlForShortcode mode vimeoSearch example vimeoSearchValue rainbow alligator Vimeo Click here documentation vimeoUploadedBy Gallery source vimeoUploadedBy Description Vimeo videos uploaded by a particular user The Vimeo user is identified by the value supplied to the vimeoUploadedByValue option Shortcode tubepress mode vimeoUploadedBy example vimeoUploadedByValue ehough Standalone PHP TubePressPro getHtmlForShortcode mode vimeoUploadedBy example vimeoUploadedByValue ehough Vimeo Click here documentation Embedded Video Player Embedded Video Player playerColor 120 Chapter 4 Reference
12. code more close fullscreen Hello this is some text Delete these tags lt pre gt tubepress lt pre gt Here 1S some more text 2 1 TubePress for WordPress 29 TubePress Documentation Release e fsockopen e fopenQ e Streams extension So the solution is to allow TubePress to use one or more of these mechanisms You or your hosting provider must perform at least one of the following e Install and allow the cURL extension e Install and allow the HTTP extension e Remove fsockopen from the list of disabled functions e Remove fopen from the list of disabled functions Troubleshooting Tools Debugging Mode TubePress s debug mode will print a huge amount of logging statements to the screen It will describe in extreme detail what TubePress is doing behind the scenes To use it you just need to add tubepress_debug t rue to the URL string in your browser s address bar of any page that uses TubePress on it For instance if the TubePress page you re trying to debug has an address of http ehough com page_id 19 then you should add tubepress_debug t rue to the URL to enable debugging http ehough com page_id 19 tubepress_debug tru Most of the debug output is self explanatory If the output is cut off unexpectedly it s likely that TubePress encountered a fatal error Check your PHP error logs for more information Firebug One particular tool which is invaluable in debuggin
13. http absolute path to thumb jpg theme path to full image jpg hy parent tubepress default resources scripts js seriptl js js anotherScript js styles css style css css otherStyle css Let s go through each optional field one by one description Optional A description of this theme Used in TubePress s options GUI This field must be 2000 characters or less keywords Optional An array of keywords tags associated with this theme Used in TubePress s options GUI Each keyword must be 100 characters or less urls Optional An object defining relevant URLs on the web for this theme This can help point your users in the right direction for support 3 2 Theme Development 85 TubePress Documentation Release homepage docs demo download and bugs are the only allowed properties screenshots Optional An object defining paths or URLs to screenshots of the theme Used in TubePress s options GUI Each property of the screenshot object must point to a thumbnail image This can either be a path which represents a relative from the theme s root directory path to the thumbnail image or an absolute URL of the thumbnail image on the web There are no size restrictions on thumbnail images though we recommend 200px by 200px or smaller Each corresponding property value should point to a full sized image of the corresponding thumbnail This can either be a path which re
14. 09 17 57 39 DEBUG Shortcode Parser 2014 01 09 17 57 39 DEBUG Shortcode Parser 2014 01 09 17 57 39 DEBUG Shortcode Parser 2014 01 09 17 57 39 DEBUG Shortcode Parser 2014 01 09 17 57 39 DEBUG Shortcode Parser 2014 01 09 17 57 39 DEBUG Shortcode Parser 2014 01 09 17 57 39 DEBUG Shortcode Parser 2014 01 09 17 57 39 DEBUG Shortcode Parser 2014 01 09 17 57 39 DEBUG Shortcode Parser 2014 01 09 17 57 39 DEBUG Shortcode Parser 2014 01 09 17 57 39 DEBUG Shortcode Parser 2014 01 09 17 57 39 DEBUG Shortcode Parser 2014 01 09 17 57 39 DEBUG Shortcode Parser 2014 01 09 17 57 39 DEBUG Shortcode Parser 2014 01 09 17 57 39 DEBUG Memory Execution Context Accepted valid value 2014 01 09 17 57 39 DEBUG Memory Execution Context Accepted valid value 2014 01 09 17 57 39 DEBUG Memory Execution Context Accepted valid value 2014 01 09 17 57 39 DEBUG Memory Execution Context Accepted valid value 2014 01 09 17 57 39 DEBUG Memory Execution Context Accepted valid value 2014 01 09 17 57 39 DEBUG Memory Execution Context Accepted valid value Found a shortcode gallery tubepress mode user userValue Candidate options detected in shortcode gallery tubepress mo Name value pair detected Name value pair detected Name value pair detected Name value pair detected Name value pair detected Name value pair detected Name value pair detected Name value pair detected Na
15. 4 59 6 06 View count 1 789 4 39 ID gE R6dRUWdk ID CYXkwOjQAPk Date posted Sep 27 2013 ID B2JrN2d0B34 View count 966 View cou Date Kylee and Jay or JJ as we alled Date pos ted Sep 13 2013 View count 1 398 unt 1 552 4 36 4 20 ID C83E w9g hs ID 8FneuFnFijw 7 59 View count 2 500 View count 2 308 6 19 ID wQczcemCfLn8 Date posted Aug 4 2013 Date posted Jul 29 2013 ID oFOfqZBYNk8 View raunt 1 04 There was an overall leff and lulia had a simnle View count 093 TubePress Documentation Release Dashboard TubePress Options Only show Here you can set the default options for TubePress Each option here can be overridden on a applicable to ost basis with Tubef e the docur ation for more information videos layer Meta Feec Cache Advanced Theme efault v t ss tn net se for this galle hone vagrant web wordpress wp content tubepress content themes ptions select hone vagrant web vordpress wp content plugins tubepress src nain resource Height px of thumbs Width px of thumbs 2 Ajax enabled pagination Use fluid thumbnails v TubePress C ically set ewi o Show pagination above thumbnails y Show pagination below thumbnails vd 1 e 1 ultipl 1 Use high quality thumbnails v innot be i Y Randomize thumbnail images Thumbnails per page Flexible Thumbnail Rows Flexible thumbnail rows szoter co
16. JW Player version 5 x TubePress can use JW Player 5 10 to play YouTube videos We are working to integrate JW Player 6 x but this feature is not yet ready for production 1 Download the file player swf from here 2 Upload the file to your TubePress Pro installation at lt tubepress_home gt src main web flash longtail player swf Shadowbox js 1 Download Shadowbox js from here The image below shows the required options when configuring your down load You may select additional checkboxes though not recommended but make sure that at least the settings shown are chosen 2 The download will save to a file named something like shadowbox 3 0 3 zip Unzip this file and it will expand into a directory named shadowbox 3 0 3 14 Chapter 2 User Manuals TubePress Documentation Release Create a new App App Description App Logo URL App Callback URL agree that my application does not violate the TubePress Documentation Release viuneo My Advanced API Apps my amazing website http foo bar Use TubePress within my website Client ID 172d2148d952d4 Client secret 1e965c515b044d OAuth access token 840f3a18a82640572b14a40b555c39f3 Upload Access None Request Upload Access Tools Settings Vimeo General Vimeo API Consumer Key cd302609d805c90a1 feb4a4e1 96bf622e Writing Reading Click here to register for a consumer key and secret I Discussion Vimeo API Consumer Secre
17. TubePress Content Directory 3 Rebuild the system cache so TubePress detects the new features 4 This add on introduces the flexibleThumbnailRows option that you may supply to TubePressPro getHtmlForShortcode e g lt php print TubePressPro getHtmlForShortcode mode user userValue 3hough flexibleThumbnailRows t 62 Chapter 2 User Manuals TubePress Documentation Release Create a new App App Description App Logo URL App Callback URL agree that my application does not violate the TubePress Documentation Release vuneo My Advanced API Apps my amazing website http Aoo bar Use TubePress within my website Client ID 172d2148d952d4 Client secret 1e965c515b044d OAuth access token 84013a18a82640572b14a40b555c39f3 Upload Access None Request Upload Access 64 Chapter 2 User Manuals TubePress Documentation Release 4 48 4 37 3 42 ID TglhaKSHWSY 6 24 ID UtwYmr zE5s ID 96HdK RzobE View count 1 183 ID mW ARVAL rB View count 2 234 View count 150 Date p d Jan 1 2014 NW CE Date posted Nov 6 2013 Date posted lan 9 20 e of Rebe is are 4 38 4 38 ID qsTtflTxudY 4 55 ID QhidsDdVS5o View count 1 733 ID 1XYxEHoGuDc View count 1 482 Date posted Oct 30 2013 Vie w count 813 5 38 Date posted Oct 9 2013 met with Bronwyn and lohn at the ID D YAHSSiBSOkM We instantly loved Emily r ae 4 43 iD _PLN40oWsdnM
18. Version We strongly recommend using WordPress s built in update mechanism to keep the free version of TubePress up to date If you would rather upgrade manually here is the procedure 1 Deactivate TubePress from WP Admin gt Plugins 2 Remove the existing TubePress installation directory from wp content plugins tubepress 3 Repeat the free WordPress plugin installation procedure 4 Rebuild the system cache Caution Do not use WordPress s auto update for TubePress Pro Your installation will be downgraded to the TubeP P ubePress Pro free version of TubePress Here is the safe upgrade procedure for TubePress Pro when used in WordPress 1 Deactivate TubePress Pro from WP Admin gt Plugins 2 Remove the existing TubePress Pro installation directory from wp content plugins tubepress_pro_x_y_zZ 3 Repeat the TubePress Pro installation procedure with the latest copy of TubePress Pro Optimize for Speed On the web speed is king By taking two minutes to read this section you can ensure that TubePress keeps your site running at maximum performance When TubePress is invoked on a new server for the very first time it needs to look around to see what system resources are available to it To save time TubePress can perform this discovery process once and cache its findings on the filesystem This makes subsequent invocations lightning fast We refer to this cache as the TubePress system cache 18 Chapter 2 U
19. add ons TubePress add ons that aren t shipped with TubePress config Low level configuration for TubePress themes TubePress themes that aren t shipped with TubePress 24 Chapter 2 User Manuals TubePress Documentation Release Installing Add Ons amp Themes Installing an add on or theme involves two steps 1 Unzip the add on or theme into your TubePress Content Directory see above Add ons should be unzipped into the add ons subdirectory and themes should be unzipped into the themes subdirectory 2 Rebuild the system cache so TubePress can detect and load the new items For instance suppose you have downloaded an add on named some_tubepress_feature zip To install you would unzip the downloaded file into the add ons subdirectory so that the filesystem path of the add on would look something like wo content tubepress content add ons some_tubepress_feature FAQ amp Troubleshooting On This Page e Common Problems JavaScript Errors Cross Domain Ajax Missing tubepress js Multiple Instances of jQuery WordPress s Visual Editor Interference API Latency Locked Down PHP Installation e Troubleshooting Tools Debugging Mode Firebug Common Problems Use the table below to find a solution to your problem Problem Possible causes and solutions Video thumbnails are unclickable e JavaScript Errors e Missing tubepress js e Multiple Instances of j
20. favorite Your State of the Union Submit Now 1 00 Autore citizentube Keywords obama state of the union citizentube speech politics news president of the united states president barack obama google moderator URL Categoria News amp Politics Valutazioni 377 Valutazione 2 60 ID avitxo8ueEA Visualizzazioni 189 419 Pubblicato 4 days ago On Tuesday January 27 President Obama will deliver his first ever State of the One Year In a Closer Look at the Obama Presidency 11 43 Autore PBSNewsHour Keywords President Obama PBS NewsHour Jeffrey Brown Democrats Health Care URL Categoria News amp Politics Valutazioni 598 Valutazione 2 64 ID AzMmLvejHMM Visualizzazioni 122 442 Pubblicato 4 days ago As the one year anniversary of President Barack Obama s Inauguration arrives Je My Favorite Videos Dwayne Johnson aka The Rock 1 38 AstTop celebrityplaylists Kmoyessie C1082 The Rock wrestling Dwayne Johnson ccana Karteropna People amp Blogs Pewtunrn 840 Pewtunr 4 64 ID acSwOyBBhio flpocmoTpos 527 256 Ao6asnen 2 days ago Dwayne Johnson aka The Rock tells you a little something about his favorite Your State of the Union Submit Now 1 00 Asrop citizentube Karovessie cnoBa obama state of the union citizentube speech politics news president of the united states president barack obama google moderator ccana Kareropua News am
21. get extremely complicated there s no one size fits all solution Typically by hovering over the JavaScript errors in Firebug you can pinpoint which JavaScript file is causing the trouble Cross Domain Ajax TubePress uses Ajax extensively in the browser e g to asynchronously load the video player whenever a user clicks a thumbnail By virtue of this TubePress is forced to adhere to the same origin policy of JavaScript The same origin policy should be embraced at least until the Internet settles on a new policy as its a crucial guard against malicious sites However this means that a small domain misconfiguration can lead to a broken misbehaving TubePress installation As an example say that you have a domain ehough com and are serving a web site at this address loading up http ehough com works normally for your users and TubePress detects that ehough com is the domain that it will use But you also have the site available without HTTP redirects via http www ehough com Users that access the site via the www ehough com domain will experience a broken TubePress installation as TubePress will attempt to make a cross domain Ajax request to echough com To diagnose if this if your problem use the following procedure 1 Using Firefox navigate to a page with a TubePress gallery 2 2 TubePress Manual for PHP 43 TubePress Documentation Release 2 Open up Firebug 3 Open Firebug s Console tab 4
22. getHtmlForShortcode mode youtubeRelated PHP example youtubeRelatedValue ZTUVgYoeN_b YouTube Click here documentation Embedded Video Player 112 Chapter 4 Reference TubePress Documentation Release Embedded Video Player e autoHide e fullscreen e modestBranding e showRelated e youtubeClosedCaptions e youtubeDisableKeyboardControls e youtubePlayerTheme e youtubeShowAnnotations e youtubeShowPlayerControls autoHide Option name Description Provided with Default value Valid values Shortcode example Standalone PHP example YouTube documentation autoHide Automatically fade out elements of the video player af ter a few moments of playback All TubePress distributions fadeOnlyProgressBar fadeBoth Fade both the progress bar and the video controls fadeNone Always show both the progress bar and the video controls fadeOnlyProgressBar Fade only the progress bar but continue to show the video controls tubepress autoHide fadeNone TubePressPro getHtmlForShortcode autpHide fadeNn Click here fullscreen Option name Description Provided with Default value Valid values Shortcode example Standalone PHP example YouTube documentation fullscreen Enable or disable the fullscreen playback option All TubePress distributions true true or false tubepress fullscreen false TubePressPro getHtmlForShortcode fullscreen false
23. gnu build i686 redhat linux gnu Command target i386 redhat linux program prefix program suffix 54 prefix usr local with pdo mysq with pdo pgsql enable bcmath enable calendar enable exif enable ftp enable mbstring enable soap enable e the full path of this directory on your web servers filesystem e g var www html myblog com lib tubepress_pro_x_y_z e the web accessible URL to reach this directory e g http myblog com lib tubepress_pro_x_y_2Z 6 Ensure that the system cache is working so that your site operates at maximum performance 7 Vimeo users only Perform the one time Vimeo API setup 8 Optional Install support for Shadowbox js and or JW Player 5 Vimeo API Setup Note If you aren t using Vimeo you can safely skip this section In order to use TubePress with Vimeo you are required to obtain a consumer key and consumer secret from Vimeo This is a one time setup required by Vimeo Thankfully it s easy to create these credentials and supply them to TubePress 1 Log in to Vimeo if you haven t already 2 Click here to create a new Vimeo app You can fill in anything for the fields Below is a sample form that s filled out Then click the Create App button 3 Make a note of the Client ID and Client secret of your new app See the red box below for an idea of what it should look like That s it You now simply need to pr
24. if you miss a payment TubePress will simply go dark on your website and your site visitors will see an empty box where TubePress used to be You may continue to access the TubePress settings from within the site editor After Wix receives payment TubePress will pick up right where you left off You won t lose anything 2 4 Official TubePress Add Ons 2 4 1 YouTube Black Bars Remover On This Page e Introduction e Manuals TubePress for WordPress Standalone PHP Introduction 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 Note Use of this add on will change the aspect ratio of YouTube thumbnails from 4 3 to 16 9 You will likely want to adjust your settings for thumbHeight and thumbWidth Manuals TubePress for WordPress 1 Purchase and download this add on from the TubePress Marketplace 54 Chapter 2 User Manuals TubePress Documentation Release Before 2 3 next 2 4 Official TubePress Add Ons 55 After TubePress Documentation Release 2 Unzip the file you downloaded yout ube black bars remover_x_y_z zip into the add ons sub directory of your TubePress Content Directory 3 Rebuild the system cache so TubePress detects the new features 4 Configure this add on from WP Admin gt Settings gt TubePress Na
25. image below shows what multiple jQuery loads looks like in Firebug The solution in this case is to pare down your scripts to a single jQuery load How this solution is accomplished depends on your environment 2 1 TubePress for WordPress 27 TubePress Documentation Release gt GET jquery min js 304 Not Modified gt GET jquery js ver 1 7 1 304 Not Modified e In TubePress Pro for PHP this will usually involve simply editing your site s header to only include jQuery once e In TubePress for WordPress typically the best method is to disable your plugins one by one until you find the offending plugin and or theme At that point you ll need to either edit the plugin theme s PHP or ask the original author to include jQuery the right way WordPress s Visual Editor Interference When authoring a post or a page from your WordPress administrative dashboard WordPress allows you to use both the Visual Editor as well as the Text Editor Unfortunately the Visual Editor sometimes wraps TubePress shortcodes with HTML lt pre gt or lt code gt tags This can ruin the appearance of TubePress often resulting in incorrect font faces or diagonal thumbnail layouts The solution is to use WordPress s Text Editor and remove any lt pre gt or lt code gt tags near your tubepress shortcodes API Latency What you see on youtube com or vimeo com will not be immediately and exactly identical to what s available to
26. many times as you like any with any combination of options Changing the Language TubePress is available in the following languages 22 Chapter 2 User Manuals TubePress Documentation Release Language Country Arabic Chinese China Chinese Thaiwan English Finnish Suomi French Fran ais France German Deutsch Germany Greek eAAnuik Hebrew Israel Hindi India Italian Italiano Italy Japanese Korean South Korea Norwegian Bokmal Norway Persian Iran Polish Jezyk Polski Poland Portuguese Portugu s Brazil Russian Russia Spanish Espa ol Mexico Spanish Espa ol Spain Swedish Svenska Sweden Locale ar zh_CN zh_TW en fi fr_F de_D el he_IL hi_IN it IT ja ko_KR nb_NO N CJ Hh P Hi W 0 n Me awe es_E Gl Sv_S We are always eager to provide more translations and update existing translations If you are interested in contributing please submit a ticket describing how you can help The image below is an example of TubePress when configured for Italian left and Russian right My Favorite Videos Dwayne Johnson aka The Rock 1 38 Autore celebrityplaylists Keywords The Rock wrestling Dwayne Johnson URL Categoria People amp Blogs Valutazioni 840 Valutazione 4 64 ID acSwOyBBhio Visualizzazioni 527 256 Pubblicato 2 days ago Dwayne Johnson aka The Rock tells you a little something about his
27. on your keyboard to reload the page with the new URL At this point TubePress will clear and rebuild the system cache Using TubePress in PHP With TubePress for PHP you can add video galleries single video embeds or interactive video searching to your PHP based website On This Page e Add TubePress to any PHP Page e Changing the Language Add TubePress to any PHP Page Follow these instructions to use TubePress Pro in a standalone PHP environment You can integrate TubePress into any PHP page on your site For demonstration purposes we will use the very simple PHP HTML file show below Feel free to create this file or extrapolate the concepts into your existing PHP As you can see by the highlighted lines of code there are four key points lt php include var www html myblog com lib tubepress_pro_x_y_z src main php classes TubePressPro php TubePressPro setBaseUrl http myblog com lib tubepress_pro_x_y_z gt lt html gt lt head gt lt title gt TubePress Pro lt title gt lt php print TubePressPro getHtmlForHead true gt 2 2 TubePress Manual for PHP 39 TubePress Documentation Release lt head gt lt body gt lt php print TubePressPro getHtmlForShortcode mode tag tagValue pittsburgh steelers rest lt body gt lt html gt 1 Include the TubePress Pro class definition TubePressPro php An absolute path works best 2 Call TubePressPro setBaseUrl
28. perform the plugin installation and activation You can search for tubepress and it should come up as the first result 2 Ensure that the system cache is working so that your site operates at maximum performance 3 Vimeo users only Perform the one time Vimeo API setup If the dashboard installation method is not available or if you d prefer to install the plugin manually here s how to do it 1 Download the plugin from its page on wordpress org 2 Follow these instructions to finish the manual installation and activation 3 Ensure that the system cache is working so that your site operates at maximum performance 12 Chapter 2 User Manuals TubePress Documentation Release TubePress Dashboard Posts AIE Pages Comments Appearance amp Plugins Installed Plugins Add New Akismet amp Users Install Plugins Search Search Results Upload Featured Popular Newest Keyword tubepress Search Plugins Name Version Rating TubePress 3 1 5 W Details Install Now 2 1 TubePress for WordPress 13 TubePress Documentation Release 4 Vimeo users only Perform the one time Vimeo API setup TubePress Pro Installation of TubePress Pro into a WordPress environment must be performed manually since TubePress Pro is open but not public source code 1 If you haven t already purchase a TubePress Pro license Download TubePress Pro from here Follow these instructi
29. set the unique identifier of this HTML element By default TubePress will assign a large random number to each element that it produces This allows TubePress to differentiate and coordinate between multiple elements on the same page By setting this option you can choose a constant ID so that you can refer to the element via JavaScript All downloadable TubePress distributions empty Any string though a positive integer is recommended Vimeo and YouTube tubepress galleryId 12345 TubePressPro getHtmlForShortcode galleryId 12345 httpMethod Option name Description Provided with Default value Valid values Supported provider s Shortcode example Standalone PHP example httpMethod Defines the HTTP method to use for most Ajax operations that TubePress performs This can be useful to change when TubePress is used in web servers with tight security requirements All downloadable TubePress distributions GET GET or POST case sensitive Vimeo and YouTube tubepress httpMethod POST TubePressPro getHtmlForShortcode httpMethod POST https Option name Description Provided with https Serve thumbnails and embedded video player over a secure connection This is useful if you are running TubePress inside an HTTPS only site TubePress Pro only Default value false Valid values true or false Supported YouTube provider s Shortcode tubepress https tru
30. showDelayed hide Hide all video controls showImmediate Show the video controls When the Flash player is used Flash will load immediately showDelayed Show the video controls When the Flash player is used Flash will load when video playback begins tubepress youtubeShowPlayerControls TubePressPro getHtmlForShortcode you Click here fFadeNone Video Feed 4 1 Options 115 CubeShowPlay TubePress Documentation Release Video Feed Options e developerKey e embeddableOnly e filter_racy developerKey Option name developerKkey Description YouTube API developer key YouTube will use this developer key for logging and debugging purposes if you experience a service problem on their end Provided with All downloadable TubePress distributions Default value hidden Valid values Any valid YouTube API key Shortcode tubepress developerKey example Standalone TubePressPro getHtmlForShortcode developerKey PHP example YouTube Click here documentation embeddableOnly Option name embeddableOnly Description Some videos have embedding disabled Enabling this option will exclude these videos from your galleries Most users will never need to modify this option Provided with All downloadable TubePress distributions Default value true Valid values true or false Shortcode tubepress embeddableOnly true example Standalone TubePressPro getHtmlFo
31. the TubePress s generated HTML The syntax of each template is pure PHP and HTML This provides high performance and easy customization as there is no need to learn any new templating language List of Templates Below is a list of templates that TubePress will use during normal execution Each template is identified by its name which is the relative path from the theme s root directory to the template file Template name Used for gallery tpl php Single page of a video gallery pagination tpl php Page numbers of a multi page video gallery players tpl php Templates for each playerLocation search search_input tpl php Interactive search input search ajax_search_input tpl php Ajax enabled interactive search input single_video tpl php Single video embedding Using Custom Templates in Themes Here s the procedure to use a custom template in your own theme 86 Chapter 3 Developer Documentation TubePress Documentation Release 1 Use the table above to identify which template you d like to customize 2 Copy the corresponding template from TubePress s default theme to the same loca tion in your theme s directory You can find TubePress s default theme templates at src main resources default themes default For instance if your theme directory is named myt heme and you want to customize the gallery tpl php template you would copy src main resources default themes default gal
32. the file to your TubePress Pro installation at lt tubepress_home gt src main web flash longtail player swf Shadowbox js 1 Download Shadowbox js from here The image below shows the required options when configuring your down load You may select additional checkboxes though not recommended but make sure that at least the settings shown are chosen 2 The download will save to a file named something like shadowbox 3 0 3 zip Unzip this file and it will expand into a directory named shadowbox 3 0 3 3 Copy the contents of this directory not the directory itself to your TubePress Pro installation at lt tubepress_home gt src main web players shadowbox 1lib 4 Optional You may see scrollbars in the Shadowbox js display To fix this simply edit lib shadowbox css On line 8 remove the overflow auto attribute i e change it from sb player html height 100 overflow auto to sb player html height 100 Upgrade The easiest and most reliable way to upgrade TubePress Pro is to perform a side by side installation with the new version alongside the old Here s the exact process 1 Repeat the TubePress Pro installation procedure with the latest copy of TubePress Pro 2 Optional Copy over the TubePress Content Directory from your old TubePress installation tubepress_pro_x_y_z gt tubepress content This is only required if you are using custom Tube Press add ons or themes 3 In the PHP files whe
33. will apply to each source so expect each gallery page to contain up to resultsPerPage x lt number of sources gt 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 e It is strongly recommended to enable the TubePress API cache as TubePress has to perform one network operation for each video source e 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 1 1 2 Single Video Embeds Embedding a single video into a website is easy and common Nearly every video provider includes an embed option for each video that provides an HTML lt iframe gt that can be added to any website If you re reading this you ve probably done this countless times TubePress improves the embedding process by 1 Abstracting away the HTML No need to copy and paste a long and complicated lt i frame gt snippet 2 Allowing you to control the embedded video player e g colors behavior size etc 3 Bringing in all of the video s meta information length description author keywords etc You can even have fine grained control over how the meta information is presented it s just simple HTML Help for Addicted Doctors Dr Rodney Hough on CBS 21 gt vs n
34. 082082083C8 2Fdiv 3E80A820 208208208 3Cdive20ide3D 22tubepress_embedded_object_1006144134 2293E20A820820 20820820820 3Ciframe 20id 3D 22tubepress youtube player hHuGtuWQ0C4 22820class 3D 22youtube player 2292 0type 3D822text 2Phtm1 22 20widtht3D 22575 22 20height 3D 22355 22 20erct ID 22ht tpt 3A2P 2Fwww youtube com 2Fembed 2FhHuGtuWQ0C4 3Fre1 3D1 26autoplay 3D1826 loopt3D0 26 s 3D1826showinfot 3D0 2 6wmodes 3Dtransparent 26enablejsapit3D1426autohides 3D1 26modestbrandingt3D1 22 20frameborder 3D 220 2283E 3C 2F iframes 3E30A 3Cscript 20typet3D 22text 2Fjavascript 22 3ETubePressP layerApi register 28 27hHuCtuWQoC4327 2983B83C 2Pscripts3E 20 2092082080A82082082082083C82Fdive 3ER0AS208208 3CR2Fdive3ES0A To fix this issue Google recommends to choose a preferred domain and stick with it Here are some guidelines on how to achieve this e Use HTTP 301 redirects RedirectPermanent in your htaccess file to smartly redirect users to your preferred domain In Apache you can do this with an htaccess file In IIS you can do this through the administrative console e WordPress users should make sure that both their Site Address and WordPress Address match their preferred domain you can set these at WP Admin gt Settings gt General e If you use TubePress Pro in a PHP environment make sure that the domain you set with TubePressPro setBaseUrl matches your preferred domain API Latency What you see
35. 2tubepress_normal_embedded_wrapper 22820sty1le83D822width 3A820575px82283E30A820 2082082083Cdiv820id83D822tubepress embedded title 1006144134 22820class 3D 22tubepress embedded _title 22 3E 0A 20 20 20820820 20Championt20Spot light 3A 20Evelynn 2C820thes20Widowmaker 20 20 20820 0A 20 20820820 IC 2F diva 3ER0A820820 2082083Cdive20ide3DE22tubepress_embedded_object_1006144134 2283E80A 20820 2082082082083Ci framet20idt3D 22tubepress youtube player hiuGtuWQ0C4 22 20class 3D 22youtube player 22820type 3D822text 2Phtm1 22420width 3D822575 22 20hei ght 3D 22355822820src 3DS22ht tps IAS2PA2Fwww youtube com 2Fembed 2PhHuGtuliQoC 443Fre1 3D1 26autoplay 3D1 261oop 3D0 26 s 3D1426showinfot 3D0 26wmode 3Dtransparent 26enablejsapit3D1426autohidet 3D1826modestbranding 3D1822 20frameborder Q3E83C82Fiframes3E80A 3Cscript 20typet3D 22text2Pjavascript 22 3ETubePressPlayerApi registert28 27hHuGtuWQoC4 27 2983B83C 2Pscript 3E 20 2082082080A8208208208208 3C82Fdive3ER0A2082083CR2Pdive3ES0A e Use HTTP 301 redirects RedirectPermanent in your htaccess file to smartly redirect users to your preferred domain In Apache you can do this with an htaccess file In IIS you can do this through the administrative console e WordPress users should make sure that both their Site Address and WordPress Address match their preferred domain you can set these atWP Admin gt Settings gt General e If you use TubePress P
36. A TubePress theme is a set of files that work together to produce the structure and style of TubePress s output Themes provide you with very fine grained control over how TubePress integrates with your website s existing design In other words a theme is the skinning mechanism for TubePress Themes are typically shared as compressed ZIP files and can be added to or removed from TubePress easily What is an Add On TubePress add ons are software packages that extend the functionality of TubePress Much like themes add ons are typically shared as compressed ZIP files and can be added to or removed from Tube Press easily Get New Add Ons or Themes The central source for all TubePress add ons and themes is the TubePress Mar ketplace There you can find add ons and themes developed by both TubePress LLC as well as the TubePress user community If you are interested in creating your own add on or theme please head over to our developer documentation TubePress Content Directory Both add ons and themes are stored in the TubePress Content Directory which is a special directory inside your WordPress installation located at we content tubepress content TubePress is able to automatically gen erate this directory for you in most cases and by default it s mostly empty The TubePress Content Directory which must always be named tubepress content should contain the follow ing immediate subdirectories
37. Any non negative integer Vimeo and YouTube tubepress cacheCleaningFactor 0 TubePressPro getHtmlForShortcode cacheCleaningFactor 0 cacheDirectory Option name Description Provided with cacheDirectory The absolute path of a directory in which the TubePress API cache can store its contents This directory must be writable by the web server s PHP process owner If this option is left empty TubePress will attempt to find and use the system temporary directory All downloadable TubePress distributions Default value empty Valid values An absolute path of a writeable by the PHP process owner directory on the web server or empty Supported Vimeo and YouTube provider s Shortcode tubepress cacheDirectory tmp tubepress cache example Standalone TubePressPro getHtmlForShortcode cacheDirectory tmp tubepress PHP example cacheEnabled rcache Option name Description Provided with Default value Valid values Supported provider s Shortcode example Standalone PHP example cacheEnabled Enables or disables the TubePress API cache This can significantly improve the performance of TubePress at the slight expense of freshness All downloadable TubePress distributions false true or false Vimeo and YouTube d true tubepress cacheEnab Enabled tru tHtmlForShortcode cach wey TubePressPro ge 4 1 O
38. BUG Shortcode Parser 2014 01 09 17 57 39 DEBUG Shortcode Parser 2014 01 09 17 57 39 DEBUG Shortcode Parser 2014 01 09 17 57 39 DEBUG Shortcode Parser 2014 01 09 17 57 39 DEBUG Shortcode Parser 2014 01 09 17 57 39 DEBUG Memory Execution Context Accepted valid value 2014 01 09 17 57 39 DEBUG Memory Execution Context Accepted valid value 2014 01 09 17 57 39 DEBUG Memory Execution Context Accepted valid value 2014 01 09 17 57 39 DEBUG Memory Execution Context Accepted valid value 2014 01 09 17 57 39 DEBUG Memory Execution Context Accepted valid value 2014 01 09 17 57 39 DEBUG Memory Execution Context Accepted valid value Found a shortcode gallery tubepress mode user userValue Candidate options detected in shortcode gallery tubepress mo Name value pair detected Name value pair detected Name value pair detected Name value pair detected Name value pair detected Name value pair detected Name value pair detected Name value pair detected Name value pair detected Name value pair detected Name value pair detected Name value pair detected mode user unfiltered mode user filtered userValue PenWeddings unfiltere userValue PenWeddings filtered youtubeHideBlackBars true unfilte youtubeHideBlackBars 1 filtered resultsPerPage 12 unfiltered resultsPerPage 12 filtered thumbWidth 144 unfiltered thumbWidth 144 filtered t
39. 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 4 1 4 Vimeo All Access Options This page documents the options available with the Vimeo All Access add on for TubePress vimeoApiAccessToken Option name Description Provided with Default value Valid values Shortcode example Standalone PHP example Vimeo documentation vimeoApiAccessToken The API secret that TubePress will use when communi cating with Vimeo e All cloud based TubePress distributions Vimeo All Access add on add on empty Any valid Vimeo API access token tubepress vimeoApiAccessToken TubePressPro getHtmlForShortcode vimeoApiAccessT Click here vimeoApiAccessTokenSecret Option name Description Provided with Default value Valid values Shortcode example Standalone PHP example Vimeo documentation vimeoApiAccessTokenSecret The API secret that TubePress will use when communi cating with Vimeo e All cloud based TubePress distributions Vimeo All Access add on empty Any valid Vimeo API access token secret tubepress vimeoApiAccessTokenSecret a TubePressPro getHtmlForShortcode vi
40. E description A base TubePress theme that you can modify to suit your needs 16 resources 17 styles 18 css theme css 19 j 2 j i parent tubepress default 2 screenshots 23 Q 76 Chapter 3 Developer Documentation TubePress Documentation Release a Dashboard TubePress Options Posts Here you can set the default options for TubePress Each option here c TubePress shortcodes See the documentation for more information Media Pages Which videos Thumbnails Player Theme Meta Comments Default Theme PACE Appearance Sidebar YouTube Clone ne that you can modify to Plugins Default legacy Vimeo legacy Users YouTube legacy Se ae Tools MPL 2 0 Settings 3 2 Theme Development 77 TubePress Documentation Release 6 Using WordPress open any page with TubePress on it so that we can test Since this theme is a child of the default TubePress theme and we haven t made any changes everything should look identical to the default theme right now OKC Golf Club whimsical Whitney Kay Brian Scott Twin Hills wedding wedding Shore Lodge wedding 4 28 4 54 6 45 Brides of Oklahoma gown Pear Tree Estate wedding Hotel Zaza St Anne s The shoot 4 48 Corinthian wedding 3 42 6 24 7 Go back to the starter theme directory from Step 1 and again using your favorite text editor open up css theme css and add the following CSS div tubepres
41. Press Documentation Release Vimeo Me Videos Create Watch Tools Upload Video Settings Privacy Basic Privacy Add To Embed Video File Advanced Privacy Settings A Video hidden on Vimeo com Who can watch this video Anyone Only me Only people I follow Only people choose Only people with a password Hide this video from Vimeo com 58 Chapter 2 User Manuals TubePress Documentation Release 2 Unzip the file you downloaded vimeo all access_x_y_z zip into the add ons subdirectory of your TubePress Content Directory Rebuild the system cache so TubePress detects the new features Ensure you have completed the one time Vimeo API setup Obtain your Vimeo access credentials Oy OY e o Supply your newly obtained credentials from Step 4 to TubePress at WP Admin gt Settings gt TubePress gt Feed On this tab you will see two new text boxes for this add on TubePress Options Order videos by sf Per page sort order Maximum total videos to retrieve Video diac hinst Media Permalink TubePress Restrict search results to videos from author Vimeo All Access Vimeo API Access Token Vimeo API Access Token Secret le documentation for instructio TubePress for PHP 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 subdi rectory of your TubePress Content Directory
42. Query After clicking thumbnail video never loads Cross Domain Ajax Layout is unstyled or ugly WordPress s Visual Editor Interference My videos aren t showing up with TubePress API Latency No HTTP transports could execute message Locked Down PHP Installation JavaScript Errors If your website has JavaScript errors they can prevent TubePress from operating correctly TubePress expects your page to load cleanly i e there should be no JavaScript errors caused by other scripts plugins themes etc The reason is that TubePress relies on jQuery s ready function which can get interrupted if other scripts cause errors To diagnose if this is your problem use the following procedure 1 Using Firefox navigate to a page with a TubePress gallery 2 1 TubePress for WordPress 25 TubePress Documentation Release 2 Open up Firebug 3 Open Firebug s Console tab 4 Refresh the page 5 Check Firebug s console for JavaScript errors The image below shows what JavaScript errors look like in Firebug oe R om 7 Console HTML CSS Script DOM Net l Clear Persist Profile All Errors Warnings Info Debug Info NetworkError 404 Not Found http www clicktale net i 45599 gif r S amp UID 835254206 6784481 3 amp new amp 1190782973 is null google K d function a c d e g h this is fd c this pd this Gc 1 this wj The resolution is always to fix the script causing t
43. TubePress There is often a caching delay before videos are available over the API which TubePress uses It s almost always less than an hour but has been know to take up to an entire day The punchline here is it can take up to a day for your gallery to sync up to the video provider Please read YouTube s explanation for more details regarding the API delay for YouTube Locked Down PHP Installation If you get an error message from TubePress that looks like No HTTP transports could execute GET to it means that you PHP installation has been configured to block nearly all network operations This is often done as a security measure to prevent malicious PHP scripts from phoning home TubePress needs to open HTTP connections to talk to video providers like YouTube or Vimeo Under the hood TubePress uses the shortstop HTTP client which attempts to use the following PHP mechanisms e cURL extension HTTP extension 28 Chapter 2 User Manuals TubePress Documentation Release Dashboard Posts All Posts Add New Categories Tags Oy Media iE Pages EALE Dashboard Posts All Posts Add New Categories Tags J Media Lag Comments Some new post Ble ZzEe EHES x Paragraph U SAvrvBMw GO QO a 2 Hello this is some text tubepress Here is some more text Some new post E b j link b quote det ins img ul ol li
44. TubePress Documentation Release TubePress LLC August 13 2014 Contents Introduction 3 l l Features s ins kb be wh EO A a ee Beets eh eee Phe E ee ea 3 I2 How to Get TubePress s aac e e YB Mor ee Hn HORS ORI SE ee ee ee oe Hee k 8 LS License 28 4 4 4 e404 62 be v BE ER OREM BHAA EE wee eRe HOES HA RS 8 LA Contaci NOS osc Fees eae tk cee E yet oe Ae Gos De Bete ea ee ee 8 User Manuals 11 2A MubePressitior WordPress sa se aoe chk dew oe A OE se eb dea ce amp Oe a E F 11 2 2 Tuob Pr ss Manual for PHP 63 69 erea ed 8 Ae HR we Bee eA Ee eS Ne HA Se 30 2 3 lt MADEPTESS TOR WIX p ereng Gage gee Gack Adm amp bb Boe Sig de ach ld aad on BE See amp A 45 24 Official TubePress Add Ons ess e a 244464 04 FEA EAE ea 54 Developer Documentation 73 3 1 Creating a TubePress Add On s saca 2a GS RES Rar ee Ae ae oe BS BS 73 3 2 Theme Development 2 ge eaa roe 64448 bd SORA ee ee ae be 73 Reference 89 Aol OPON e mag Oe He ae ge dk Ee We See We amp a we Se ee I SS Se E E EN 89 d2 AMEX e botnets b gt Bowers ads fxs id te Bs bods iin bee Bros a a due Beds ge thea be deems be amp 123 TubePress Documentation Release TubePress adds dynamic and interactive video features to websites It s highly configurable and designed for website builders and users of any skill level A typical use of TubePress is to embed a video gallery into a web page TubePress is available both as a downloadable package a
45. _thumbnails Description Most 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 Provided with Any TubePress distribution Default value true Valid values true or false Supported Vimeo and YouTube provider s Shortcode tubepress randomize_thumbnails true example Standalone TubePressPro getHtmlForShortcode randomize_thumbnails true PHP example resultsPerPage Option name resultsPerPage Description How many thumbnails to display on each page of a gallery Provided with Any TubePress distribution Default value 20 Valid values Any integer from 1 to 50 Supported provider s Vimeo and YouTube Shortcode example tubepress resultsPerPage 30 Standalone PHP example TubePressPro getHtmlForShortcode resultsPerPage 30 thumbHeight Option name thumbHeight Description The desired height in pixels of video thumbnails Provided with Any TubePress distribution Default value 90 Valid values Any positive integer Supported provider s Vimeo and YouTube Shortcode example tubepress thumbHeight 60 Standalone PHP example TubePressPro getHtmlForShortcode thumbHeight 60 94 Chapter 4 Reference TubePress Documentation Release thumbWidth Option name thumbWidth Description The desired width in pixels o
46. add on Warning It is extremely important to never publicly divulge these credentials 1 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 2 At the bottom of the page you will see a box containing your Access Token and Access Token Secret Consumer Key Client ID and Secret Note Only cloud based TubePress users e g TubePress Express TubePress for Wix etc need to follow these instructions as users of downloadable distributions of TubePress should have completed this step during installation 1 Log in to Vimeo if you haven t already 60 Chapter 2 User Manuals TubePress Documentation Release Ea All TubePress Opti Order videos by id Per page sort order Maximum total videos to retrieve Video blacklist Restrict search results to videos from author Vimeo All Access Vimeo API Client ID the documentation for instructions Vimeo API Client secret e the documentation for instructions Vimeo API Access Token e the documentation for i Vimeo API Access Token Secret the documentation for i Your access token ou can use this OAuth Access Token to access your account with this app dd5a625d8 aef80le5f77bdb Read write delete 2 4 Official TubePress Add Ons 61 TubePress Documentation Release 2 Click here to create a new Vimeo app You can fi
47. and url properties name is the theme author s proper name or company name and ur1 is the theme author s primary URL on the web 84 Chapter 3 Developer Documentation TubePress Documentation Release The author name must be 200 characters or less licenses Required An array of one or more objects defining the license s of this theme Each license object must include a type property which uniquely identifies the software license This can either be an abbreviation of an Open Source License or proprietary for closed source themes The type field must be 100 characters or less Each license object may include a url property which contains a URL that points to the full license text Optional Fields Below is a theme json with all optional fields filled in name tubepress sample yersin 3 2 1 1 title Sample author name TubePress LLC url http tubepress com hy licenses type GPL 3 0 url https www gnu org copyleft gpl html Tz description This is a sample theme used for educational purposes keywords sample bootstrap word urls homepage http foo bar home html docs http docs mytheme com demo http demo site test php download http my site download php bugs http bugs thistheme com report php screenshots relative path to thumb png http abs path to fullsize png
48. arket window will open In the search box at the top left type in tubepress and hit enter 3 The TubePress app will show in your search results Click the Add to Site button to add TubePress to your site 4 TubePress will be added to your site in a box that you may now move around and resize to your liking just like any other Wix element You can repeat steps 4 as many times as you like 2 3 TubePress for Wix 47 TubePress Documentation Release Boc On linea FORM BUILDER 1273Cortact Form Free Premaum Revotuton Sader Free Premeurn 48 Chapter 2 User Manuals TubePress Documentation Release WIX GJ B Page SERVICES 5 aA B Wix App Market x tubepress p Showing 1 results for tubepress Easily add beautiful YouTube and Vimeo video galleries to your TubePress Free Trial The Mobilizers Mobile Marketing Apple Mac 30 Thirty years of innovation g Happy Birthday Mac ZA Apple Mac 30 Apple iPad Air TV Apple iPad Air TV Thirty years of Ad Sound Verse Ad Light Verse innovation 0 31 0 31 2 53 View count 73 813 View count 43 235 View count 1 105 776 2 3 TubePress for Wix 49 TubePress Documentation Release Configuring Simple Configuring TubePress in Wix is extremely simple 1 Click on the TubePress instance that you d like to configure You ll see a popup menu Click the link for App Settings W
49. avaScript Errors After clicking thumbnail video never loads Cross Domain Ajax My videos aren t showing up with TubePress API Latency No HTTP transports could execute message Locked Down PHP Installation JavaScript Errors If your website has JavaScript errors they can prevent TubePress from operating correctly TubePress expects your page to load cleanly i e there should be no JavaScript errors caused by other scripts plugins themes etc The reason is that TubePress relies on jQuery s ready function which can get interrupted if other scripts cause errors To diagnose if this is your problem use the following procedure 1 Using Firefox navigate to a page with a TubePress gallery 2 Open up Firebug 3 Open Firebug s Console tab 4 Refresh the page 5 Check Firebug s console for JavaScript errors The image below shows what JavaScript errors look like in Firebug we y X lt acl Console v HTML CSS Script DOM Net l Clear Persist Profile All Errors Warnings Info Debug Info x NetworkError 404 Not Found http www clicktale net i 45599 gif r 5 amp UID 835254206 67844813 amp new amp 1190782973 c is null google K d function a c d e g h this is fd c this pd this Gc 1 this wj The resolution is always to fix the script causing the error Usually this entails identifying which component of your site script plugin etc is causing the error Unfortunately since sites can
50. be Vimeo etc that TubePress knows how to handle Supported provider s Vimeo and YouTube Shortcode example tubepress video l1JtHNEDnrnyY Standalone PHP example TubePressPro getHtmlForShortcode video LJtHNEDnrnY Thumbnails Thumbnail Options e ajaxPagination e fluidThumbs e hqThumbs e paginationAbove e paginationBelow e randomize_thumbnails resultsPerPage e thumbHeight e thumbWidth ajaxPagination Option name ajaxPagination Description Use Ajax to paginate clicking on Next etc through galleries Provided with rovided w1 TubePress Pro e Any cloud hosted TubePress Default value true Valid values true or false Supported provider s Vimeo and YouTube Shortcode example tubepress ajaxPagination true Standalone PHP example TubePressPro getHtmlForShortcode ajakPagination 92 Chapter 4 Reference TubePress Documentation Release fluidThumbs 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 Provided with All TubePress distributions Default value true Valid values true or false Supported Vimeo and YouTube provider s Shortcode tubepress fluidThumbs false example Standalone TubePressPro getHtmlForShortcode flui
51. d some ad ditional CSS styling to TubePress s output We have even done some of the work for you every TubePress installation is shipped with a very simple base theme designed specifically for this tutorial 1 Locate your TubePress Content Directory and open up the themes subdirectory Inside you will find a direc tory named starter that houses everything needed for your new theme 2 Inside the starter theme directory you will find a file named theme json All themes must have a file named theme json which provides some basic metadata Open this file with your favorite text editor 3 Ata bare minimum you will need to change the theme name You can do this by changing the name field from changeme themename to anything else We suggest lowercase alphanumerics and slashes For instance name ehough mynewtheme If you d like you may change the other lines of the file that indicate they can be changed e g title and description Save this file 4 Rebuild the system cache so that TubePress detects your changes and accepts the new theme 5 Open WP Admin gt Settings gt TubePress gt Theme and ensure that your new theme shows up in the drop down menu Warning If you didn t change the title in Step 3 your theme will show up in the drop down as Theme Title Change Me If you d like to change the title now simply repeat Steps 3 and 4 If you dont see your new theme in the dropdown menu put you
52. dThumbs false PHP example hqThumbs Option name hqThumbs Description Use higher quality thumbnails This allows thumbnail sizes greater than 120px x 90x without causing distor tion Provided with rovided w1 e TubePress Pro e Any cloud hosted TubePress Default value false Valid values true or false Supported provider s Vimeo and YouTube Shortcode example tubepress hqThumbs true Standalone PHP example TubePressPro getHtmlForShortcode hqThumbs true paginationAbove Option name paginationAbove Description Show pagination links Next Prev etc above the thumbnail gallery Provided with Any TubePress distribution Default value true Valid values true or false Supported provider s Vimeo and YouTube Shortcode example tubepress paginationAbove true Standalone PHP TubePressPro getHtmlForShortcode paginationAbove true example 4 1 Options 93 TubePress Documentation Release paginationBelow Option name paginationBelow Description Show pagination links Next Prev etc below the thumbnail gallery Provided with Any TubePress distribution Default value true Valid values true or false Supported provider s Vimeo and YouTube Shortcode example tubepress paginationBelow true Standalone PHP TubePressPro getHtmlForShortcode paginationBelow true example randomize_thumbnails Option name randomize
53. dalone PHP TubePressPro getHtmlForShortcode mode vimeoAppearsIn example vimeoAppearsInValue dabrainkilla Vimeo Click here documentation vimeoChannel Gallery source vimeoChannel Description Videos from a Vimeo channel The channel is identified by the value supplied to the vimeoChannelValue option Shortcode tubepress mode vimeoChannel vimeoChannelValue besthd example Standalone PHP TubePressPro getHtmlForShortcode mode vimeoChannel example vimeoChannelValue besthd Vimeo Click here documentation vimeoCreditedTo Gallery vimeoCreditedTo source Description Vimeo videos for which a particular user has either uploaded or appeared in The Vimeo user is identified by the value supplied to the vimeoCreditedTo Value option Shortcode tubepress mode vimeoCreditedTo example vimeoCreditedToValue thunderingherd Standalone TubePressPro getHtmlForShortcode mode vimeoCreditedTo PHP example vimeoCreditedToValue thunderingherd Vimeo Click here documentation vimeoGroup Gallery source vimeoGroup Description Videos from a Vimeo group The group is identified by the value supplied to the vimeoGroupValue option Shortcode tubepress mode vimeoGroup vimeoGroupValue underachievers example Standalone PHP TubePressPro getHtmlForShortcode mode vimeoGroup example vimeoGroupValue underachievers Vimeo Click here documentation 4 1 Options 119 TubePress Documentation
54. dedHeight and embed dedWidth 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 customers 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 The trick is to set resultCountCap to 1 and orderBy to newest For instance say that you d like to show the latest video from YouTube user engineerguyvideo WordPress users would use the following shortcode tubepress mode user userValue engineerguyvideo resultCountCap 1 orderBy newest enableQuickp Similarly PHP users could use the following invocation of TubePressPro getHtmlForShortcode lt php TubePressPro getHtmlForShortcode mode user userValue engineerguyvideo resultCountCap 1 o The result is an always updating fully customizable single video embed that you can embed anywhere on your site 70 Chapter 2 User Manuals TubePress Documentation Release How a lead acid battery works 4 56 View count 153 850 2 4 Official TubePress Add Ons 71 TubePress Documentation Release 72 Chapter 2 User Manuals CHAPTER 3 Developer Documentation This section of the documentation is targeted at developers and designers who wish to modify or enhance the capabil ities behavior or appearance of TubePress
55. directory is a file named settings php tubepress_pro_x_y_z tubepress content config settings php Open sett ings php with your favorite text editor 3 Near line 39 of settings php you will see containerStoragePath gt some directory Uncomment delete the two leading slashes this line and change some directory to the di rectory path that you identified in step 1 e g containerStoragePath gt the path from step 1 4 Save sett ings php and re upload it to your web server Optionally we recommend first pasting the contents of your newly edited file into an online syntax checker to ensure that you didn t make any typos 38 Chapter 2 User Manuals TubePress Documentation Release 5 Repeat the steps from the previous section to verify that the system cache is now working Rebuild the System Cache You should rebuild the system cache after you perform any of the following actions e upgrade TubePress e add or remove any TubePress themes e add or remove any TubePress add ons The process to rebuild the system cache is really easy 1 Visit any page on your site that is using TubePress 2 In your browser s address bar add tubepress_clear_system_cache true to the end of the URL Here are two examples of what that might look like http foo bar mypage php tubepress_clear_system_cache true or http fooz baz another php some thing amp tubepress_clear_system_cache 3 Hit Enter
56. e 56 Chapter 2 User Manuals TubePress Documentation Release Dashboard TubePress Options Only show options app Posts Here you can set the default options for TubePress Each optio be overridden on a per page past basis with TubePress shortcodes See the documentation for more information O hais Media Pages Which videos ayer Meta Fees Cache Advanced Comments Theme defaut Appearance The TubePress theme to use for this gallery Your themes can be found at Plugins vor wen front wordpress mp content tubepress content themes a default themes can be found at Users vor wea front wordpress mp content plugins tubepress src main resources de Tools Height px of thumbs 99 Settings General Width px of thumbs Writing Reading Ajax enabled pagination Use fluid thumbnails Show pagination above thurnbnails Show pagination below thumbnails Use high quality thurnbnails Randomize thumbnail images Thumbnails per page YouTube Black Bars Remover Hide black bars from YouTube video thumbnails Defau a lefault is 120 Y Y JNa aly set nbnal acing based on the width of ther containe Y Only a es to galleries tha an mu e page Y y tog J TF Toh Note ption cannot be used with the randomize thumbnails feature Y M option each time on swith each video s U h the high q T sth bnails have black r his of verrides arty othe 2 4 Official TubePress Add Ons 57 Tube
57. e example Standalone PHP TubePressPro getHtmlForShortcode https true example Theme 4 1 Options 109 TubePress Documentation Release Theme Options e theme theme Option name theme Description Defines the active TubePress theme by name Please see the TubePress theme documentation for details Provided with All downloadable TubePress distributions Default value tubepress default Valid values Any name of a valid TubePress theme of which TubePress is aware Shortcode example tubepress theme ehough my cool theme Standalone PHP TubePressPro getHtmlForShortcode theme ehough my cool theme example 4 1 2 YouTube Options On This Page e Gallery Sources playlist favorites tag user youtubeMostPopular youtubeRelated e Embedded Video Player autoHide fullscreen modestBranding showRelated youtubeClosedCaptions youtubeDisableKeyboardControls youtubePlayerTheme youtubeShowAnnotations youtubeShowPlayerControls e Video Feed developerKey embeddableOnly filter_racy e Video Meta Display rating ratings Gallery Sources 110 Chapter 4 Reference TubePress Documentation Release General Options playlist e favorites tag user e youtubeMostPopular e youtubeRelated playlist Gallery source playlist D
58. e umentation 4 1 Options 111 TubePress Docu mentation Release user Gallery source user Description YouTube videos uploaded by a specific YouTube user The YouTube user is defined by the value you supply to the userValue attribute Notes Limited to 1000 videos Shortcode tubepress mode user userValue 3hough example Standalone PHP TubePressPro getHtmlForShortcode mode user example userValue 3hough YouTube Click here documentation youtubeMostPopular Gallery youtubeMostPopular source Description The most popular YouTube videos selected using a YouTube algorithm that combines many different signals to determine overall popularity You can supply al1_time or today to the youtubeMostPopularValue option to control the time frame of the results Shortcode tubepress mode youtubeMostPopular example youtubeMostPopularValue all_time Standalone TubePressPro getHtmlForShortcode mode youtubeMostPopular PHP example youtubeMostPopularValue all_time YouTube doc Click here umentation youtubeRelated Gallery source youtubeRelated Description YouTube videos related to a specific YouTube video The target YouTube video is identified by the value supplied to the youtubeRelated Value option Shortcode tubepress mode youtubeRelated example youtubeRelatedValue ZTUVgYoeN_b Standalone TubePressPro
59. ePress is available to all Wix com websites via the Wix App Market Since TubePress LLC manages the hosting of TubePress there is no installation upgrade or maintenance required 2 3 1 Manual Contents Using TubePress in Wix com This page details how to use TubePress for Wix It assumes that you already have a Wix website up and running if not Wix offers excellent documentation to get you started 2 3 TubePress for Wix 45 TubePress Documentation Release 2014 01 09 17 57 37 DEBUG Default Boot Config Service option descriptors caching is enabled 2014 01 09 17 57 37 DEBUG Default Option Descriptor Reference Attempting read contents of cache file at var 2014 01 09 17 57 37 DEBUG Default Option Descriptor Reference Attempting to hydrate from cache file at var w 2014 01 09 17 57 37 DEBUG Default Option Descriptor Reference Successfully hydrated from cache file at var jw 2014 01 09 17 57 37 DEBUG TubePress Bootstrapper Boot completed in 71 796894 milliseconds 2014 01 09 17 57 39 DEBUG Shortcode Parser 2014 01 09 17 57 39 DEBUG Shortcode Parser 2014 01 09 17 57 39 DEBUG Shortcode Parser 2014 01 09 17 57 39 DEBUG Shortcode Parser 2014 01 09 17 57 39 DEBUG Shortcode Parser 2014 01 09 17 57 39 DEBUG Shortcode Parser 2014 01 09 17 57 39 DEBUG Shortcode Parser 2014 01 09 17 57 39 DEBUG Shortcode Parser 2014 01 09 17 57 39 DEBUG Shortcode Parser 2014 01 09 17 57 39 DE
60. ed and activated your own custom TubePress theme Of course that was just a fraction of what s possible with TubePress themes What do to next Explore what else your theme s manifest can do for you e Add your own custom HTML templates e Add additional CSS or JavaScript to your theme e Learn about the power of hierarchical themes e Share your theme with the TubePress community 3 2 2 What s a Theme From a technical standpoint a TubePress theme is a directory on the web server s filesystem that contains e Exactly one manifest file theme json at the directory s root e Zero or more HTML templates e Zero or more CSS stylesheets and or JavaScript scripts e Any other supporting web resources images fonts etc During execution TubePress will expect to find the active theme directory in one of two possible locations on your web server s filesystem 3 2 Theme Development 83 TubePress Documentation Release 1 Inside the TubePress codebase at src main resources default themes This directory holds the themes that are shipped with TubePress While you can modify the themes in this directory any changes will be wiped out when you upgrade TubePress You can refer to this directory for examples of properly structured and functioning themes 2 The themes subdirectory of your TubePress Content Directory This is the directory where you will store all themes that are not shipped with TubePress The director
61. ed for Italian left and Russian right You can tell TubePress which language to use via the lang option Simply supply your two letter language and country code lt php TubePressPro getHtmlForShortcode lang it_IT 40 Chapter 2 User Manuals TubePress Documentation Release My Favorite Videos Dwayne Johnson aka The Rock 1 38 Autore celebrityplaylists Keywords The Rock wrestling Dwayne Johnson URL Categoria People amp Blogs Valutazioni 840 Valutazione 4 64 ID acSwOyBBhio Visualizzazioni 527 256 Pubblicato 2 days ago Dwayne Johnson aka The Rock tells you a little something about his favorite Your State of the Union Submit Now 1 00 Autore citizentube Keywords obama state of the union citizentube speech politics news president of the united states president barack obama google moderator URL Categoria News amp Politics Valutazioni 377 Valutazione 2 60 ID avitxo8ueEA Visualizzazioni 189 419 Pubblicato 4 days ago On Tuesday January 27 President Obama will deliver his first ever State of the Using Add Ons amp Themes One Year In a Closer Look at the Obama Presidency 11 43 Autore PBSNewsHour Keywords President Obama PBS NewsHour Jeffrey Brown Democrats Health Care URL Categoria News amp Politics Valutazioni 598 Valutazione 2 64 ID AzMmLvejHMM Visualizzazioni 122 442 Pubblicato 4 days ago As the one year anniversary
62. efault value Valid values lazyPlay If enabled video playback will auto start after users clicks a video s thumbnail All TubePress distributions true true or false Supported provider s Vimeo and YouTube Shortcode example tubepress lazyPlay true Standalone PHP example TubePressPro getHtmlForShortcode lazyPlay true loop Option name Description Provided with Default value Valid values Supported provider s Shortcode example Standalone PHP example loop If enabled immediately restart playback of each video after it finishes All TubePress distributions false true or false Vimeo and YouTube tubepress loop true TubePressPro getHtmlForShortcode loop true playerImplementation Option name Description Provided with Default value Valid values Supported provider s Shortcode example Standalone PHP example playerImplementation provider_based the standard YouTube pl YouTube tubepress playerImp TubePressPro getHtml Defines the brand of the embedded video player All TubePress distributions except TubePress for Wix provider_based Uses the provider s player i e ayer embedplus Plays videos with EmbedPlus longtail Plays videos with JW Player lementation longt Ail lForShortcode pla yerImplement 4 1 Options 97 TubePress Documentation Release playerLocation Op
63. en from the list of disabled functions Troubleshooting Tools Debugging Mode TubePress s debug mode will print a huge amount of logging statements to the screen It will describe in extreme detail what TubePress is doing behind the scenes To use it you just need to add tubepress_debug t rue to the URL string in your browser s address bar of any page that uses TubePress on it For instance if the TubePress page you re trying to debug has an address of http ehough com page_id 19 then you should add tubepress_debug t rue to the URL to enable debugging http ehough com page_id 19 tubepress_debug tru Most of the debug output is self explanatory If the output is cut off unexpectedly it s likely that TubePress encountered a fatal error Check your PHP error logs for more information Firebug One particular tool which is invaluable in debugging client side problems is Firebug Firebug is an add on for Firefox that gives you x ray vision for any website It s powerful yet easy to use If you re new to Firebug here are some introductory resources to help you learn What is Firebug From the official Firebug site Introductory screencast Shows the general concepts and use cases of Firebug Another introductory screencast A longer more detailed video going over installation and usage Firebug Guide for Web Developers A detailed well written overview of Firebug with pictures 2 3 TubePress for Wix Tub
64. enableQuickplay Option name Description Provided with Default value Valid values Supported provider s Shortcode example Standalone PHP example enableQuickplay Replaces video thumbnail images with fully functional embedded video players QuickPlay add on false true or false Vimeo and YouTube tubepress enableQuickplay true TubePressPro getHtmlForShortcode enableQuickplay true 4 2 Index Documentation Index 4 2 Index 123
65. escription Videos from a YouTube playlist The playlist is defined by the value you supply to the playlistValue attribute Notes Limited to 200 videos Currently only public playlists can be shown with TubePress Shortcode tubepress mode playlist playlistValue 6813408AE8D50E6F example Standalone PHP TubePressPro getHtmlForShortcode mode playlist example playlistValue 6813408AE8D50E6F YouTube Click here documentation favorites Gallery source favorites Description Favorite videos of a YouTube user The YouTube user is defined by the value you supply to the favoritesValue attribute Notes Limited to 50 videos Shortcode tubepress mode favorites favoritesValue 3hough example Standalone PHP TubePressPro getHtmlForShortcode mode favorites example favoritesValue 3hough YouTube Click here documentation tag Gallery tag source Description YouTube videos matching a search term Supply space separated search terms to the tag Value attribute To search for an exact phrase enclose the phrase in double quotes Use the pipe character to indicate a boolean OR and the minus character to exclude a term Notes Limited to approximately 1000 videos Shortcode tubepress mode tag tagValue pittsburgh steelers highlights example playoffs Standalone TubePressPro getHtmlForShortcode mode tag PHP example tagValue pittsburgh steelers highlights playoffs YouTube doc Click her
66. f video thumbnails Provided with Any TubePress distribution Default value 120 Valid values Any positive integer Supported provider s Vimeo and YouTube Shortcode example tubepress thumbWidth 150 Standalone PHP example TubePressPro getHtmlForShortcode thumbWidth 150 Embedded Video Player Embedded Video Player Options e autoNext autoplay e embeddedHeight e embeddedWidth e enableJsApi lazyPlay e loop e playerImplementation e playerLocation e showInfo autoNext Option name autoNext Description Automatically start the next video in a gallery when playback of a video finishes Provided with TubePress Pro e Any cloud hosted TubePress Default value false Valid values true or false Supported provider s Vimeo and YouTube Shortcode example tubepress autoNext true Standalone PHP example TubePressPro getHtmlForShortcode autpNext true 4 1 Options 95 TubePress Documentation Release autoplay Option name Description Provided with Default value Valid values autoplay Automatically start video playback of any embedded video when the page is loaded All TubePress distributions false true or false Supported provider s Vimeo and YouTube Shortcode example tubepress autoplay true Standalone PHP example TubePressPro getHtmlForShortcode autoplay true embeddedHeight Option name Description Pr
67. g client side problems is Firebug Firebug is an add on for Firefox that gives you x ray vision for any website It s powerful yet easy to use If you re new to Firebug here are some introductory resources to help you learn What is Firebug From the official Firebug site Introductory screencast Shows the general concepts and use cases of Firebug Another introductory screencast A longer more detailed video going over installation and usage Firebug Guide for Web Developers A detailed well written overview of Firebug with pictures 2 2 TubePress Manual for PHP TubePress Pro is available to use as a mature PHP library which makes it accessible to nearly any website that runs PHP 2 2 1 Manual Contents Install Upgrade This page details how to install upgrade and uninstall TubePress when used as a standalone PHP library 30 Chapter 2 User Manuals TubePress Documentation Release 2014 01 09 17 57 37 DEBUG Default Boot Config Service option descriptors caching is enabled 2014 01 09 17 57 37 DEBUG Default Option Descriptor Reference Attempting read contents of cache file at var 2014 01 09 17 57 37 DEBUG Default Option Descriptor Reference Attempting to hydrate from cache file at var w 2014 01 09 17 57 37 DEBUG Default Option Descriptor Reference Successfully hydrated from cache file at var jw 2014 01 09 17 57 37 DEBUG TubePress Bootstrapper Boot completed in 71 796894 milliseconds 2014 01
68. g for thi is the song Check out my A tribute video to the city of upcoming Pittsburgh Steeler Ry ee MADDEN 1 2 amp SOME 76 CHANGE STEELERS JAMES HARRISON SOUNDS OFF GAMEPLAY COMMENTARY MADDENEVOLUTION Madden 11 Kilo Replay Episode 3 Pittsburgh Pittsburgh Steelers Big 2 amp Some Change ft Mike Wallace andthe Steelers 1st amp 10 2009 Hits 7 13 11 Pittsburgh Pittsburgh Steelers AFC Championship 3 40 Steelers James Harrisc Madden NFL 11 Sport Baltimore vs Pittsburgh Views 149 Sounds Off Sports 10 15 8 05 some of the biggest hits fron 5 05 Views 2 080 Views 467 the steelers must watch Views 4 981 6 Chapter 1 Introduction TubePress Documentation Release 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 1 Once for displaying the search input and 2 Once more for displaying the user s search results Let s go over each invocation in detail Search Input 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 tubepress output searchInput When invoked on your page this shortcode will print out a search input box along with a submit but ton If you d like to customize the HTML of either of these you can edit your theme s HTML template at search search_input t
69. g with the Community If you ve created a great theme you should share it with the rest of the TubePress community The TubePress Marketplace has a Themes category where you can distribute your theme easily as well as browse for other themes 88 Chapter 3 Developer Documentation CHAPTER 4 Reference 4 1 Options 4 1 1 Core Options 89 TubePress Documentation Release On This Page e General mode output video e Thumbnails ajaxPagination fluidThumbs hqThumbs paginationAbove paginationBelow randomize_thumbnails resultsPerPage thumbHeight thumbWidth e Embedded Video Player autoNext autoplay embeddedHeight embeddedWidth enableJsApi lazyPlay loop playerImplementation playerLocation showInfo e Video Feed orderBy perPageSort resultCountCap searchResultsRestrictedToUser videoBlacklist e Video Meta Display author category dateFormat description descriptionLimit id length relativeDates tags title uploaded url views e Interactive Search searchProvider searchResultsDomId searchResultsOnly searchResultsUrl e API Cache cacheCleaningFactor cacheDirectory cacheEnabled 90 cacheLifetimeSeconds e Advanced debugging_enabled galleryld a on eee 2 ee oa ee Chapter 4 Reference TubePress Documentati
70. gins All TubePress distributions false true or false Vimeo and YouTube tubepress showInfo true TubePressPro getHtmlForShortcode showInfo true Video Feed 98 Chapter 4 Reference TubePress Documentation Release Video Feed Options orderBy e perPagesort e resultCountCap e searchResultsRestrictedToUser e videoBlacklist orderBy Option name orderBy Description Define the overall sort order of the video feed This only applies obviously to video galleries and not individual videos Provided with All TubePress distributions Default value default Valid values commentCount Only applies to YouTube playlist galleries and selected Vimeo galleries Videos with more comments will be shown before others 1 default TubePress chooses the best sort order for the video source e g search based galleries are sorted by relevance and user uploads are sorted by newest duration Only applies to YouTube playlist galleries Longest running videos shown first newest Newest videos first oldest Only applies to the following Vimeo gal leries vimeoUploadedBy vimeoLikes vimeoAppearsiIn vimeoSearch vimeoCreditedTo vimeoGroup position Only applies to YouTube playlist galleries Videos will be shown in the order in which they appear in the playlist random Only applies to Vimeo group based galleries vimeoGroup Retrieves videos in a random order rat
71. gle display of the video title All TubePress distributions true true or false Supported provider s Vimeo and YouTube Shortcode example tubepress title false Standalone PHP example TubePressPro getHtmlForShortcode title false uploaded Option name Description Provided with Default value Valid values uploaded Toggle display of the video upload date All TubePress distributions false true or false Supported provider s Vimeo and YouTube Shortcode example tubepress uploaded true Standalone PHP example TubePressPro getHtmlForShortcode uploaded true url Option name Description Provided with Default value Valid values url Toggle display of the video URL All TubePress distributions false true or false Supported provider s Vimeo and YouTube Shortcode example tubepress url true Standalone PHP example TubePressPro getHtmlForShortcode url true 104 Chapter 4 Reference TubePress Documentation Release views Option name Description Provided with Default value Valid values Supported provider s Vimeo and YouTube Shortcode example tubepress views false Standalone PHP example TubePressPro getHtmlForShortcode views false views Toggle display of the video view count All TubePress distributions true true or false Interactive Search Interactive Search Options
72. he error Usually this entails identifying which component of your site script plugin etc is causing the error Unfortunately since sites can get extremely complicated there s no one size fits all solution Typically by hovering over the JavaScript errors in Firebug you can pinpoint which JavaScript file is causing the trouble Cross Domain Ajax TubePress uses Ajax extensively in the browser e g to asynchronously load the video player whenever a user clicks a thumbnail By virtue of this TubePress is forced to adhere to the same origin policy of JavaScript The same origin policy should be embraced at least until the Internet settles on a new policy as its a crucial guard against malicious sites However this means that a small domain misconfiguration can lead to a broken misbehaving TubePress installation As an example say that you have a domain ehough com and are serving a web site at this address loading up http ehough com works normally for your users and TubePress detects that ehough com is the domain that it will use But you also have the site available without HTTP redirects via http www ehough com Users that access the site via the www ehough com domain will experience a broken TubePress installation as TubePress will attempt to make a cross domain Ajax request to echough com To diagnose if this if your problem use the following procedure 1 Using Firefox navigate to a page with a TubePress galler
73. hen used in WordPress 3 7 or higher Chapier 1 Introduction TubePress Documentation Release Sales If you have a question that you d like to have answered before you buy any products or services from TubePress LLC please post your question in our Pre Sales Questions forum and a TubePress LLC staff member will respond Please do not use this forum for general technical questions 1 4 Contact Us 9 TubePress Documentation Release 10 Chapter 1 Introduction CHAPTER 2 User Manuals Below you can find tailored user manuals for using TubePress and its related software in various environments 2 1 TubePress for WordPress TubePress is available to use as a WordPress plugin which makes it a breeze to use on any WordPress site While the WordPress plugin is available 100 for free we recommend the premium version of the plugin TubePress Pro TubePress Pro includes all the features of the free TubePress plugin plus the following additional capabilities Priority technical support i e you jump to the front of the line Use in WordPress templates outside post or page content Multiple video sources in a single unified gallery e g YouTube Vimeo in the same gallery Auto next playback when a video ends start playback of the next video in the gallery Full HTTPS capability Extended controls for the YouTube video player Highest resolution thumbnails from YouTube and Vimeo Asynchronous pagi
74. how up tubepress output ajaxSearchInput searchResultsDomId somediv searchProvider vimeo For the searchResult sDomId option value just use any jQuery selector that uniquely identifies a DOM element that can accept HTML Like the standard search input you can customize the HTML for the search input elements by editing your theme s HTML template at search ajax_search_input tpl php 1 1 Features 7 TubePress Documentation Release 1 2 How to Get TubePress There are two independent installation paths for TubePress 1 One of two downloadable software packages TubePress for WordPress e TubePress Pro for WordPress and or any PHP site 2 One of two cloud hosted TubePress installations e TubePress Express e TubePress for Wix Either installation path provides nearly identical features but there are a number of drawbacks and advantages to each Cloud hosted TubePress Downloadable TubePress Required technical skills Upgrades and patches Installation time Extra Premium features Ability to modify source Website limitations Pricing None Automatic None All Included automatically None None works on any site 30 day free trial Basic PHP knowledge Manual or Automatic 1 5 minutes usually Must be installed manually Full access Web server must support PHP 5 2 Free and premium versions available 1 3 License The core of TubePress which comprises a very
75. humbHeight 81 unfiltered thumbHeight 81 filtered mode user userValue PenWeddings youtubeHideBlackBars 1 resultsPerPage 12 thumbWidth 144 thumbHeight 81 2014 01 09 17 57 39 DEBUG Search Output Shortcode Handler Not configured for search results 2014 01 09 17 57 39 DEBUG Memory Execution Context Accepted valid value galleryid 1478746967 2014 01 09 17 57 39 DEBUG Thumb Gallery Shortcode Handler Starting to build thumbnail gallery 1478746967 2014 01 09 17 57 39 DEBUG Theme Handler Attempting to load template instance from gallery tpl php with fallb 2014 01 09 17 57 39 DEBUG Theme Handler Requested theme is default 2014 01 09 17 57 39 DEBUG Theme Handler Found gallery tpl php first try at var www front wordpress wp conter 2014 01 09 17 57 39 DEBUG Theme Handler Successfully loaded template from var wwwi front wordpress wp cor 46 Chapter 2 User Manuals TubePress Documentation Release On This Page e Adding the TubePress App e Configuring Simple e Configuring Full Settings Adding the TubePress App TubePress is available to Wix com as an app in the Wix App Market As such Wix provides detailed documentation on how to use the App Market For the sake of completeness here s how to add TubePress to your site 1 Inside the Wix Editor click the App Market button WX Wo a ee cy App Market 2 The Wix App M
76. i resultCountCap Option name Description Provided with Default value Valid values Supported provider s Shortcode example Standalone PHP example resultCountCap Set a maximum limit on the total number of videos in a gallery This can both limit the number of videos that show up on a page if result sPerPage gt resultCountCap or reduce the number of pagination links for a gallery Set to 0 to disable any limit All TubePress distributions 0 Any non negative integer Vimeo and YouTube tubepress resultCountCap 100 TubePressPro getHtmlForShortcode resultCountCap 100 100 Chapter 4 Reference TubePress Documentation Release searchResultsRestrictedToUser Option name Description Provided with Default value Valid values Supported provider s Shortcode example Standalone PHP example searchResultsRestrictedToUser For keyword based galleries or during interactive searching this option can filter the results to videos uploaded by the given user All TubePress distributions empty Any YouTube or Vimeo username Vimeo and YouTube tubepress searchResultsRestrictedToUser 3hough TubePressPro getHtmlForShortcode searchResultsRestrictedToUse videoBlacklist Option name Description Provided with Default value Valid values Supported provider s Shortcode example Standalone PHP example videoBlacklist A list of video ID
77. iX fo QO Page SERVICES v nc AB po The Mobilizers O 2 k Appie Mac 30 Thirty years of innovation y App Settings s ai Settings Show on all pages jpe gt G m f 2 A gt a H ppie Pad n t ppie Pod r Ty ee Ad Sound Verve Ad ght verso oreed tan on ET se 2 A small window will popup which contains some simple settings for TubePress Feel free to click around and change some of the options Your changes will be reflected live so that you can see the result immediately Configuring Full Settings In the previous section you learned how to access a few settings for your TubePress instance However the options found in the small popup window are actually a small fraction of the options available to you We simply hide them so as to not overwhelm new users Here s how to access the rest of the settings 50 Chapter 2 User Manuals TubePress Documentation Release TubePress x TubePress lets you easily add YouTube and Vimeo video galleries to your site Just choose your videos and customize the look E a More Settings Upgrade Now 30 day s remaining in trial osoy GO gt Registration v Source Which videos do you want to display Videos from this YouTube user apple This YouTube playlist F679CB240DD4C112 Videos uploaded by this Vimeo user ayantGardeDiaries Videos from this Vimeo albu
78. ices but that functionality is coming soon 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 e the YouTube playlist F5D324185EE73FEC e uploads from YouTube user bbc e uploads from YouTube user funnyordie e YouTube search for the exact term spirit of truth TubePress Documentation Release Coles Garden wedding 6 24 5 38 4 38 4 43 TubePress Documentation Release e the Vimeo album 140484 This is easy to accomplish with TubePress Pro The trick is to use in some of your shortcode options to combine the sources For the example above the TubePress shortcode might look like this tubepress mode playlist user tag vimeoAlbum playlistValue F5D324185EE73FEC userValue bbc funnyordie tagValue spirit of truth 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 e The resultsPerPage option
79. ing Highest rated videos first relevance Only applies to search based galleries Videos with the highest relevance to the search terms will be shown first gt reversedPosition Only applies to YouTube playlist galleries Videos will be shown in the reverse order of the position sort order title Only applies to YouTube playlist galleries Videos will be shown in alphabetical order of their titles viewCount Most viewed videos first Supported provider s Vimeo and YouTube Shortcode example tubepress orderBy newest Standalone PHP example TubePressPro getHtmlForShortcode ordprBy newest 4 1 Options 99 TubePress Documentation Release perPageSort Option name Description Provided with Default value Valid values perPageSort Defines an additional sorting to apply to each individual page of a video gallery All TubePress distributions none commentCount Videos with more comments will be shown before others duration Longest running videos shown first newest Newer videos first none Do nothing oldest Older videos first random Shuffles the videos rating Highest rated videos first title Videos will be shown in alphabetical order of their titles viewCount Most viewed videos first Supported provider s Vimeo and YouTube Shortcode example tubepress perPageSort title Standalone PHP example TubePressPro getHtmlForShortcode perPageSort t
80. large percentage of the overall codebase is open source and released under the Mozilla Public License 2 0 MPL 2 0 You can browse the source code for TubePress on GitHub The premium products sold by TubePress LLC are built as add ons to TubePress and these products are under a proprietary closed source license 1 4 Contact Us Technical Support The community discussion forum is the official technical support channel TubePress LLC has knowledgeable staff that monitors and responds to new posts in the forums Please post your question in the appropriate forum and you will get a response as soon as possible usually within one or two business days At this time we do not provide email or ticket based support though this capability will be available in the future Accounts and Billing If you have a question regarding your account or billing please submit a ticket to our Accounts and Billing department General billing policies and answers to common account questions can be found here Business Development TubePress LLC is always open to new partnerships To start the discussion please send a message to our Business Development department 1Basic PHP knowledge is only required if using TubePress outside of WordPress The free version of TubePress can be auto updated when used in WordPress 3 7 or higher 3Basic PHP knowledge is only required if using TubePress outside of WordPress 4The free version of TubePress can be auto updated w
81. lery tpl php to mytheme gallery tpl php 3 Rebuild the system cache so that TubePress detects your theme s new template Instructions for rebuilding the cache can be found here for WordPress users and here for standalone PHP users Note Any time you add or remove a template from a theme you will need to rebuild the system cache However simply editing these files does not require a cache rebuild 4 Customize your theme s newly copied template to your liking 3 2 5 CSS amp JS Themes can easily supply their own CSS stylesheets and or JavaScript scripts As a theme developer you simply need to identy which stylesheets scripts your theme needs and TubePress will ensure that the resources are correctly loaded Here s the procedure to add a CSS stylesheet or JavaScript script to your theme 1 Save the CSS or JavaScript file to any location within your theme directory 2 Edit your theme s manifest to include the relative from the theme s root directory path to the new file You should add this to the manifest resources property as explained above For instance if you have saved a single CSS file for your theme at css style css then your manifest s resources property might look something like this resources styles css style css 3 Rebuild the system cache so that TubePress detects your theme s new template Instructions for rebuilding the cache can be found here for WordPress user
82. ll in anything for the fields Below is a sample form that s filled out Then click the Create App button 3 Make a note of the Client ID and Client secret of your new app See the red box below for an idea of what it should look like 2 4 3 Flexible Thumbnail Rows On This Page e Introduction e Manuals TubePress for WordPress Standalone PHP TubePress for Wix Introduction 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 Without this add on TubePress uses a fixed height for the thumbnail rows and any metadata that is taller than the row will be cut off Manuals TubePress for WordPress 1 Purchase and download this add on from the TubePress Marketplace 2 Unzip the file you downloaded f lexible thumbnail rows_x_y_z zip into the add ons subdirec tory of your TubePress Content Directory 3 Rebuild the system cache so TubePress detects the new features 4 Configure this add on from WP Admin gt Settings gt 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 Standalone PHP 1 Purchase and download this add on from the TubePress Marketplace 2 Unzip the file you downloaded f lexible thumbnail rows_x_y_z zip into the add ons subdirec tory of your
83. m 66 Chapter 2 User Manuals TubePress Documentation Release TubePress for Wix This add on is pre installed for users of cloud based TubePress installations e g TubePress Express TubePress for Wix Here s how to use it 1 Open up the full settings page for your TubePress instance 2 In the window that opens navigate to the Thumbnails tab and scroll down to the Flexible Thumb nail Rows box 3 Enable or disable the add on with the checkbox 4 Click the Save button 2 4 4 QuickPlay On This Page e Introduction e Manuals TubePress for WordPress TubePress for PHP e Additional Notes Controlling Height and Width Show the Latest Video from a Collection Introduction 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 Note This add on is currently only available for the downloadable TubePress distributions Manuals TubePress for WordPress 1 Purchase and download this add on from the TubePress Marketplace 2 Unzip the file you downloaded quickplay_x_y_z zip into the add ons subdirectory of your TubePress Content Directory 3 Copy or symlink the directory at wo content tubepress content add ons quickplay_x_y_z tubepress t to wp content tubepress content themes quickplay 4 Rebuild the
84. m 140484 Appearance Set the structure and colors of your gallery lew count 73 lew count SS I View count 1 105 776 2 3 TubePress for Wix 51 TubePress Documentation Release 1 In the basic TubePress settings window click the More Settings button lt as More Settings Registration Source Which videos do you want to display Appearance Set the structure and colors of your gallery 2 A new window will open which contains all of the TubePress settings Feel free change any setting you like and click the Save button once you re done Billing TubePress is available to all Wix com users for a free 30 day trial To continue using the service beyond the trial period we charge a small monthly fee Wix provides detailed instructions on how to pay for TubePress 52 Chapter 2 User Manuals TubePress Documentation Release wix tubepress com settings all instance GQE5CmoqpNxveNxX luv4 5 KfLv jeQYTZhMr_wS3M 10 ey JpbnNOYW5jZUIkIjoiMTMOZDU2NzYtMzljMy 1iYmQ2LTk3YTgtNGE3 All TubePress Options Only show options applicable to select Which videos Thumbnails Player Meta Feed Appearance default 7 A TubePress theme can change the HTML structure and in some cases the overall style of your gallery Height px of thumbs 83 Default is 90 Width px of thumbs 147 Default is 120 C Ajax enabled pagination G Only applies to galleries that span mul
85. me value pair detected Name value pair detected Name value pair detected Name value pair detected mode user unfiltered mode user filtered userValue PenWeddings unfiltere userValue PenWeddings filtered youtubeHideBlackBars true unfilte youtubeHideBlackBars 1 filtered resultsPerPage 12 unfiltered resultsPerPage 12 filtered thumbWidth 144 unfiltered thumbWidth 144 filtered thumbHeight 81 unfiltered thumbHeight 81 filtered mode user userValue PenWeddings youtubeHideBlackBars 1 resultsPerPage 12 thumbWidth 144 thumbHeight 81 2014 01 09 17 57 39 DEBUG Search Output Shortcode Handler Not configured for search results 2014 01 09 17 57 39 DEBUG Memory Execution Context Accepted valid value galleryid 1478746967 2014 01 09 17 57 39 DEBUG Thumb Gallery Shortcode Handler Starting to build thumbnail gallery 1478746967 2014 01 09 17 57 39 DEBUG Theme Handler Attempting to load template instance from gallery tpl php with fallb 2014 01 09 17 57 39 DEBUG Theme Handler Requested theme is default 2014 01 09 17 57 39 DEBUG Theme Handler Found gallery tpl php first try at var www front wordpress wp conter 2014 01 09 17 57 39 DEBUG Theme Handler Successfully loaded template from var wwwi front wordpress wp cor 2 2 TubePress Manual for PHP 31 TubePress Documentation Release On this page e Requireme
86. meoApiAccessT Click here 4 1 5 Flexible Thumbnail Row Options This page documents the options available with the Flexible Thumbnail Rows add on for TubePress 122 Chapter 4 Reference TubePress Documentation Release flexibleThumbnailRows 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 Provided with Flexible Thumbnail Rows add on Default value false Valid values true or false Supported Vimeo and YouTube provider s Shortcode tubepress flexibleThumbnailRows true example Standalone TubePressPro getHtmlForShortcode flexibleThumbnailRows true PHP example 4 1 6 YouTube Black Bars Remover Options This page documents the options available with the YouTube Black Bars Remover add on for TubePress youtubeHideBlackBars Option name Description Provided with Default value Valid values Shortcode example Standalone PHP example youtubeHideBlackBars Hides the black bars on most YouTube thumbnails YouTube Black Bars Remover add on false true or false tubepress youtubeHideBlackBars true TubePressPro getHtmlForShortcode youtubeHideBlackBars true 4 1 7 QuickPlay Options This page documents the options available with the QuickPlay add on for TubePress
87. n Settings gt TubePress On this page you would type tubepress where you want TubePress to inject its content Follow this procedure for unlimited galleries on unlimited posts pages Just use any TubePress option to control TubePress Add TubePress to WordPress Templates Note TubePress Pro is required to use this feature and basic PHP knowledge is recommended Follow these instructions to use TubePress Pro inside WordPress templates The code snippet below shows the world s simplest WordPress template with TubePress Pro added As you can see by the highlighted lines below there are only 2 steps lt php include WP_PLUGIN_DIR tubepress_pro_x_y_z src main php classes TubePressPro php get_header print TubePressPro getHtmlForShortcode mode tag tagValue pittsburgh steelers if have_posts while have_posts the_post the_content endwhile endif get_sidebar get_footer gt Notes on the two highlighted lines above 1 Include the TubePress Pro library file TubePressPro php Not that in the code sample above you will need to replace tubepress_pro_x_y_z with the actual version of TubePress Pro that you downloaded e g tubepress_pro_3_2_6 2 The getHtmlForShortcode static function takes a single string parameter which is any space separated combination of TubePress options It returns the HTML output of TubePress as a string You may repeat this function call as
88. nd via several cloud hosted zero installation services The software is largely open sourced and it s designed and maintained by TubePress LLC a software company based in Pittsburgh Pennsylvania Contents 1 TubePress Documentation Release 2 Contents CHAPTER 1 Introduction 1 1 Features TubePress allows website builders of any skill level to add dynamic video features to their site Click a feature below to learn more about what TubePress can do for your site 1 1 1 Video Galleries Creating video galleries is how TubePress made a name for itself The software lets you easily embed beautiful highly functional thumbnail galleries throughout you site and you complete control over the entire process A live demo of a TubePress gallery can be seen here The process to create a video gallery is always the same 1 Choose which videos to display Out of the box TubePress supports a multitude of YouTube and Vimeo video sources More video providers are on the way 2 Configure TubePress to display those videos Check the user manual for your environment for details on how to do this 3 Add the gallery to a website Again this process is different depending on your environment so please refer to your specific user manual Video Galleries from Multiple Sources Note This feature is currently only available with the downloadable TubePress Pro It is not yet available on the cloud hosted TubePress serv
89. ng through gallery pages video playback does not stop Asynchronous interactive video search Play videos with Fancybox or Tinybox 2 1 1 Manual Contents Install Upgrade This page details how to install upgrade and uninstall TubePress when used as a WordPress plugin 11 TubePress Documentation Release On this page e Requirements e Install Free Version TubePress Pro Vimeo API Setup Optional TubePress Pro Installations x JW Player version 5 x Shadowbox js e Upgrade Free Version TubePress Pro e Optimize for Speed Ensure System Cache is Working Turn On or Configure System Cache Rebuild the System Cache e Uninstall Requirements It s a good idea to first make sure that your web server meets the minimum requirements to run TubePress You will need e PHP 5 2 9 or higher e PHP DOM extension enabled by default in PHP only required for using TubePress with YouTube e PHP PCRE extension built with PCRE version 7 1 or higher enabled in most PHP installations Not sure if your server meets these requirements You should either 1 Ask your hosting provider good idea to include a link to this page 2 Install a WordPress plugin that prints out system information Here are some examples e WordPress phpinfo e WP ServerInfo Install Free Version Installing the free WordPress plugin is simple The easiest method is from your WordPress dashboard 1 Follow these instructions to
90. nt Directory you will find a directory named config And inside the config directory is a file named settings php wp content tubepress content config settings php Open sett ings php with your favorite text editor 3 Near line 39 of settings php you will see containerStoragePath gt some directory Uncomment delete the two leading slashes this line and change some directory to the di rectory path that you identified in step 1 e g containerStoragePath gt the path from step 1 4 Save sett ings php and re upload it to your web server Optionally we recommend first pasting the contents of your newly edited file into an online syntax checker to ensure that you didn t make any typos 5 Repeat the steps from the previous section to verify that the system cache is now working Rebuild the System Cache You should rebuild the system cache after you perform any of the following actions e upgrade TubePress e add or remove any TubePress themes e add or remove any TubePress add ons The process to rebuild the system cache is really easy 2 1 TubePress for WordPress 19 TubePress Documentation Release 1 Visit any page on your site that is using TubePress 2 In your browser s address bar add tubepress_clear_system_cache true to the end of the URL Here are two examples of what that might look like http foo bar mypage php tubepress_clear_system_cache true or http fo
91. nts e Install Vimeo API Setup Optional TubePress Pro Installations x JW Player version 5 x Shadowbox js e Upgrade e Optimize for Speed Ensure System Cache is Working Turn On or Configure System Cache Rebuild the System Cache Requirements It s a good idea to first make sure that your web server meets the minimum requirements to run TubePress You will need PHP 5 2 9 or higher e PHP DOM extension enabled by default in PHP only required for using TubePress with YouTube e PHP PCRE extension built with PCRE version 7 1 or higher enabled in most PHP installations Additiona Multibyte lly if you intend to use TubePress in any language other than English TubePress for PHP requires the PHP String extension enabled in most PHP installations Not sure if your server meets these requirements You should either 1 2 1 Install Ask your hosting provider good idea to include a link to this page Use our PHP file which checks your server for the requirements Here s how to use it Using a web browser visit this URL You ll see some PHP source code Save the source code to disk File gt Save from your web browser s menu or just hit Ct r1 S It should be saved somewhere on your local machine and the name of the file should be check php Upload check php to your website s document root Using a web browser visit http lt yourdomain com gt check php The
92. ny other thumbnail selection options e g Use high quality thumbnails Flexible Thumbnail Rows Flexible thumbnail rows i Equalize the height of thumbnail rows so that no video metadata is cut off szoter com 68 Chapter 2 User Manuals TubePress Documentation Release 4 48 3 42 Here s a list of so 6 24 For their 2014 Spring S things about Kelly amp his g of Oklahoma chose a dramatic day 1 blac e 5 38 There were so many unique things about Wh Norma gt wa Sda hae In 0 00 0 00 3 42 e st of son esome 6 24 For their 2014 S n gs abou Ss wed S TubePress Documentation Release TubePress for PHP 1 Purchase and download this add on from the TubePress Marketplace 2 Unzip the file you downloaded quickplay_x_y_z zip into the add ons subdirectory of your TubePress Content Directory 3 Copy or symlink the directory at tubepress content add ons quickplay_x_y_z tubepress theme to tubepress content themes quickplay 4 Rebuild the system cache so TubePress detects the new features 5 Anytime you add TubePress to a page set the options enableQuickplay true and theme quickplay e g lt php print TubePressPro getHtmlForShortcode enableQuickplay true theme quickplay Additional Notes Controlling Height and Width To control the height and width of the embedded video players you can simply use the embed
93. of President Barack Obama s Inauguration arrives Je My Favorite Videos Dwayne Johnson aka The Rock 1 38 AstTop celebrityplaylists Kmoyessie Cnoga The Rock wrestling Dwayne Johnson ccana Karteropna People amp Blogs Pe tnnrn 840 Pewtunr 4 64 ID acSwOyBBhio fpocmotpos 527 256 Ao6asnen 2 days ago Dwayne Johnson aka The Rock tells you a little something about his favorite Your State of the Union Submit Now 1 00 Asrop citizentube Kaovyessie cnoBa obama state of the union citizentube speech politics news president of the united states president barack obama google moderator ccana KaTeropua News amp Politics Pewtunrn 377 Pewtunr 2 60 ID avitxo8ueEA IpocmoTpos 189 419 Ao6asnen 4 days ago On Tuesday January 27 President Obama will deliver his first ever State of the One Year In a Closer Look at the Obama Presidency 11 43 Astop PBSNewsHour Kmoyessie chosa President Obama PBS NewsHour Jeffrey Brown Democrats Health Care ccana KaTeropua News amp Politics Pewtunrn 598 Pewtunr 2 64 ID AzMmLvejHMM Mpocmorpos 122 442 Ao6asnen 4 days ago As the one year anniversary of President Barack Obama s Inauguration arrives Je On This Page Overview e Overview What is a Theme What is an Add On Get New Add Ons or Themes e TubePress Content Directory e Installing Add Ons amp Themes TubePress can be infinitel
94. on Release General General Options mode output e video mode Option name Description Provided with Default value Valid values mode Defines the source for a video gallery Any TubePress distribution youtubeMostPopular e Any YouTube source e Any Vimeo source Supported provider s Vimeo and YouTube Shortcode example tubepress mode youtubeRelated Standalone PHP example TubePressPro getHtmlForShortcode modp youtubeRe output Option name Description Provided with Default value Valid values Supported provider s Shortcode example Standalone PHP example output Defines what HTML TubePress will generate Unless explicitly set TubePress will generate a video gallery Any TubePress distribution empty searchInput HTML input for interactive searching searchOutput Search results from interactive searching player HTML for a single embedded video player only ajaxSearchInput HTML input for asynchronous interactive searching TubePress Pro only empty HTML for a video gallery Vimeo and YouTube tubepress output searchInput TubePressPro getHtmlForShortcode out put searchl 4 1 Options 91 TubePress Documentation Release video Option name video Description Causes TubePress to generate HTML for a single video embed Provided with Any TubePress distribution Default value empty Valid values Any video ID YouTu
95. on youtube com or vimeo com will not be immediately and exactly identical to what s available to TubePress There is often a caching delay before videos are available over the API which TubePress uses It s almost always less than an hour but has been know to take up to an entire day The punchline here is it can take up to a day for your gallery to sync up to the video provider Please read YouTube s explanation for more details regarding the API delay for YouTube Locked Down PHP Installation If you get an error message from TubePress that looks like No HTTP transports could execute GET to it means that you PHP installation has been configured to block nearly all network operations This is often done as a security measure to prevent malicious PHP scripts from phoning home TubePress needs to open HTTP connections to talk to video providers like YouTube or Vimeo Under the hood TubePress uses the shortstop HTTP client which attempts to use the following PHP mechanisms e cURL extension HTTP extension 44 Chapter 2 User Manuals TubePress Documentation Release e fsockopen e fopenQ e Streams extension So the solution is to allow TubePress to use one or more of these mechanisms You or your hosting provider must perform at least one of the following e Install and allow the cURL extension e Install and allow the HTTP extension e Remove fsockopen from the list of disabled functions e Remove fop
96. ons to finish the manual installation and activation of the plugin Ensure that the system cache is working so that your site operates at maximum performance Vimeo users only Perform the one time Vimeo API setup Dn YS Optional Install support for Shadowbox js and or JW Player 5 Vimeo API Setup Note If you aren t using Vimeo you can safely skip this section In order to use TubePress with Vimeo you are required to obtain a consumer key and consumer secret from Vimeo This is a one time setup required by Vimeo Thankfully it s easy to create these credentials and supply them to TubePress 1 Log in to Vimeo if you haven t already 2 Click here to create a new Vimeo app You can fill in anything for the fields Below is a sample form that s filled out Then click the Create App button 3 Make a note of the Client ID and Client secret of your new app See the red box below for an idea of what it should look like That s it You now simply need to provide these credentials to TubePress You can do this from WP Admin gt Settings gt TubePress gt Feed Make sure not to mix up the key and the secret Optional TubePress Pro Installations Due to licensing restrictions TubePress Pro does not ship with every library that the free WordPress plugin includes However it s very easy to install these optional libraries manually This section provides installation instructions
97. output of this page should be self explanatory and will look similar to the following Here s how to install TubePress Pro when used as a standalone PHP library 1 If you haven t already purchase a TubePress Pro license 2 Download TubePress Pro from here 3 Unzip the file you just downloaded tubepress_pro_x_y_z zip It will expand into a directory named tubepress_pro_x_y_z Note x y and z are the major minor and micro version numbers of TubePress 4 Upl oad the entire tubepress_pro_x_y_z directory to your web server in a place that s web accessible 5 Make a note of the following two items which you ll need when invoking TubePress 32 Chapter 2 User Manuals TubePress Documentation Release Check TubePress requirements Check 1 4 PHP version OK detected PHP version 5 4 3 Check 2 4 DOM extension OK detected dom extension version 20031129 Check 3 4 PCRE extension WARN pcre detected but unable to determine version please manually verify the version below Check 4 4 mbstring extension WARN mbstring extension is missing but this extension is only required if you intend to run TubePress Pro in a standalone PHP environment Checks passed but there were warnings This server might meet the requirements for TubePress Linux web200 webfaction com 2 6 18 274 18 1 el5PAE 1 SMP Thu Feb 9 13 25 50 EST 2012 i686 Configure configure host i686 redhat linux
98. ovide these credentials to TubePress You ll have to provide the key and secret via the vimeoKey and vimeoSecret options in TubePress You can pass these into the getHtmlForShortcode function 2 2 TubePress Manual for PHP 33 TubePress Documentation Release Create a new App App Description App Logo URL App Callback URL agree that my application does not violate the TubePress Documentation Release vuneo My Advanced API Apps my amazing website http foo bar Use TubePress within my website Client ID 172d2148d952d4 Client secret 1e965c515b044d OAuth access token 84013a18a82640572b14a40b555c39f3 Upload Access None Request Upload Access 2 2 TubePress Manual for PHP 35 TubePress Documentation Release lt php print TubePressPro getHtmlForShortcode vimeoKey M7e80GsvU8Ld4TW7e80LsvU8Ld4TM7e80Ls vimeoSse Make sure not to mix up the key and the secret Optional TubePress Pro Installations Due to licensing restrictions TubePress Pro does not ship with every library that the free WordPress plugin includes However it s very easy to install these optional libraries manually This section provides installation instructions JW Player version 5 x TubePress can use JW Player 5 10 to play YouTube videos We are working to integrate JW Player 6 x but this feature is not yet ready for production 1 Download the file player swf from here 2 Upload
99. ovided with Default value Valid values embeddedHeight The height in pixels of the embedded video player that TubePress builds All TubePress distributions 350 Any positive integer Supported provider s Vimeo and YouTube Shortcode example tubepress embeddedHeight 350 Standalone PHP TubePressPro getHtmlForShortcode embeddedHeight 350 example embeddedWidth Option name Description Provided with Default value Valid values embeddedWidth The width in pixels of the embedded video player that TubePress builds All TubePress distributions 425 Any positive integer Supported provider s Vimeo and YouTube Shortcode example tubepress embeddedWidth 350 Standalone PHP example TubePressPro getHtmlForShortcode embeddedWidth 350 enableJsApi Option name Description Provided with Default value Valid values Supported provider s Shortcode example Standalone PHP example enableJsApi Enable or disable the TubePress JavaScript API for this gallery Enabling this API incurs a tiny performance overhead but is required for some features such as autoNext TubePress Pro true true or false Vimeo and YouTube tubepress enableJsApi true TubePressPro getHtmlForShortcode enableJsApi true 96 Chapter 4 Reference TubePress Documentation Release lazyPlay Option name Description Provided with D
100. ovided with All TubePress distributions Default value Mj Y Valid values Any valid format for PHP s date function Supported Vimeo and YouTube provider s Shortcode example tubepress dateFormat 1 jS of F Y h i s A Standalone PHP TubePressPro getHtmlForShortcode dateFormat 1 jS of F Y example Heiss AN description Option name description Description Toggle display of the video description Provided with All TubePress distributions Default value false Valid values true or false Supported provider s Vimeo and YouTube Shortcode example tubepress description true Standalone PHP example TubePressPro getHtmlForShortcode description true 102 Chapter 4 Reference TubePress Documentation Release descriptionLimit Default value 0 Option name descriptionLimit Description The maximum number of characters of a video s description that should be displayed Descriptions over this limit will be truncated with Set to 0 for no limit Provided with All TubePress distributions Valid values Any non negative integer Supported Vimeo and YouTube provider s Shortcode tubepress descriptionLimit 150 example Standalone TubePressPro getHtmlForShortcode descriptionLimit 150 PHP example id Option name Description Provided with Default value Valid values id Toggle display of the video ID All TubePress distributions false true or false
101. oz baz another php some thing amp tubepress_clear_system_cache 3 Hit Enter on your keyboard to reload the page with the new URL At this point TubePress will clear and rebuild the system cache Alternatively a quick and dirty way to rebuild the system cache is to simply deactivate then reactivate the TubePress plugin Uninstall If you d like to completely uninstall TubePress from your WordPress installation for any reason here are the steps 1 Deactivate TubePress from WP Admin gt Plugins 2 Remove the TubePress installation directory from wp content plugins Using TubePress in WordPress On This Page e Configuration e Add TubePress to Posts and Pages e Add TubePress to WordPress Templates e Changing the Language Configuration TubePress comes with a user friendly options page that can be found from your WordPress admin dashboard Simply visit Settings gt TubePress to access the screen Add TubePress to Posts and Pages Follow these instructions to use TubePress free or Pro in WordPress posts and or pages It s dead simple Simply type tubepress anywhere in a WordPress post or page When a user visits this post page TubePress will replace tubepress with its generated HTML content You can configure the default TubePress options from within your WordPress administration dashboard by visiting Settings gt TubePress If you just type tubepress ona post or a page these options will be u
102. p Politics Pevitunrn 377 Pewtuur 2 60 ID avitxo8ueEA ipocmorpos 189 419 Ao6asnen 4 days ago On Tuesday January 27 President Obama will deliver his first ever State of the One Year In a Closer Look at the Obama Presidency 11 43 AsTrop PBSNewsHour Karoyesbie cnoBa President Obama PBS NewsHour Jeffrey Brown Democrats Health Care ccana KaTeropua News amp Politics Pestunru 598 Pewtunr 2 64 ID AZMmLvejHMM fIpocmoTpos 122 442 Ao6asnen 4 days ago As the one year anniversary of President Barack Obama s Inauguration arrives Je TubePress will determine which language to use based on the WP_LANG setting that you can define in wp config php Details for how to switch the language of your WordPress blog can be found here Using Add Ons amp Themes 2 1 TubePress for WordPress 23 TubePress Documentation Release On This Page e Overview What is a Theme What is an Add On Get New Add Ons or Themes TubePress Content Directory e Installing Add Ons amp Themes Overview Much like WordPress itself TubePress can be infinitely customized by add ons and themes This page provides a broad overview of these two extension mechanisms and how they are used with TubePress Note TubePress add ons and themes should not be confused with WordPress plugins and themes While conceptually very similar the two are not interchangeable What is a Theme
103. pl php By default the search form will submit back to the same page If you want the results to show up on another page just set searchResultsUrl1 most users shouldn t need to do this tubepress output searchInput searchResultsUrl http mysite com videos php Now that you have a search input form you ll need to invoke TubePress somewhere else to display the search results Search Results Displaying search results is also easy Add the following shortcode wherever on the page you d like the search results to show up tubepress output searchResults searchProvider vimeo The searchProvider option 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 tubepress output searchResults searchProvider youtube searchResultsOnly true To configure the resulting thumbnail gallery of search results simply add any TubePress options to this shortcode Ajax Enabled Search Results 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 s
104. presents a relative from the theme s root directory path to the image or an absolute URL of the image on the web There are no size restrictions though we recommend no larger than 750px tall by 1000px wide All image paths and URLs must end with either png or jpg As an alternative to an object screenshot may also be an array of image paths and or absolute URLs This eliminates the need to supply both a thumbnail and full sized image but leads to a degraded user experience in the TubePress options GUI We recommend to stick with the approach outlined above parent Optional Defines the parent theme by its name property See theme hierarchy for details on how this works resources Optional An object that contains the scripts and or styles properties which in turn define the JavaScript script files and CSS stylesheets for this theme Both the scripts and styles property values must be arrays containing relative paths from the theme s root directory to a CSS file or JavaScript script CSS file paths must end in css and JavaScript file paths must end in js Resources will be loaded in the order in which they are defined here with any parent theme resources loaded first 3 2 4 Templates During its execution TubePress relies on a number of named PHP HTML templates to produce its HTML output TubePress themes may contain one or more these templates thereby allowing theme designers to have complete control over the structure of
105. ptions 107 TubePress Documentation Release cacheLifetimeSeconds Option name cacheLifetimeSeconds Description How long in seconds before an item in the TubePress API cache is considered to be stale Provided with All downloadable TubePress distributions Default value 3600 Valid values Any non negative integer Supported provider s Vimeo and YouTube Shortcode example tubepress cacheLifetimeSeconds 1800 Standalone PHP TubePressPro getHtmlForShortcode cacheLifetimeSeconds 18d0 example Advanced Advanced Options e debugging_enabled gallerylid httpMethod https debugging_enabled Option name debugging_enabled Description Enables or disables TubePress debugging Keeping this enabled is a slight privacy risk so if you are not experiencing difficulty with TubePress then feel free to disable it Provided with All downloadable TubePress distributions Default value true Valid values true or false Supported Vimeo and YouTube provider s Shortcode tubepress debugging_enabled true example Standalone TubePressPro getHtmlForShortcode debugging_enabled true PHP example 108 Chapter 4 Reference TubePress Documentation Release galleryId Option name Description Provided with Default value Valid values Supported provider s Shortcode example Standalone PHP example gallerylid Explicitly
106. r site into debug mode and look for any warnings or errors Make sure your theme is selected in the theme drop down and click the Save button to activate your theme 74 Chapter 3 Developer Documentation TubePress Documentation Release v al wp content ha index php plugins themes 7 tubepress content add ons config 7 themes b starter dE v themes y __ starter Css D theme json S 3 2 Theme Development 75 TubePress Documentation Release 1 jot 2 name changeme themename ct l version 1 0 0 4 title Theme Title Change Me 5 o author 6 name Your Name Change Me 7 url http tubepress com 8 9 jo licenses 1 jo 11 type MPL 2 0 12 url http www mozilla org MPL 2 0 13 15 description A base TubePress theme that you can modify to suit your needs 16 G resources 17 styles 18 css theme css 19 j 2 j 21 parent tubepress default 22 screenshots 23 1 fot 2 name changeme themename a E version 1 0 0 i 4 i title Theme Title Change Me 5 author 6 name Your Name Change Me Bea url http tubepress com 8 ja 9 j licenses 1 o 11 type MPL 2 0 12 url http www mozilla org MPL 2 0 13 14 l CFE
107. rShortcode embeddableOnly true PHP example YouTube Click here documentation 116 Chapter 4 Reference TubePress Documentation Release filter_racy Option name Description Provided with Default value Valid values Shortcode example Standalone PHP example YouTube documentation filter_racy Filter out restricted content YouTube performs the fil tering much in the same manner as SafeSearch Filtering for Google WebSearch All downloadable TubePress distributions moderate none YouTube will not perform any filtering moderate YouTube will filter some videos strict YouTube will try to exclude all restricted videos tubepress filter_racy strict TubePressPro getHtmlForShortcode filter_racy st Click here Video Meta Display rating Option name Description Provided with Default value Valid values Shortcode example Standalone PHP example rating Toggle display of the video s average rating All TubePress distributions false true or false tubepress rating true TubePressPro getHtmlForShortcode rating true ratings Option name Description Provided with Default value Valid values Shortcode example Standalone PHP example ratings Toggle display of the number of times the video has been rated All TubePress distributions false true or false tubepress ratings true TubePressPro getHtmlFo
108. rShortcode ratings true 4 1 3 Vimeo Options 4 1 Options 117 TubePress Documentation Release On This Page e Gallery Sources vimeoAlbum vimeoAppearsIn vimeoChannel vimeoCreditedTo vimeoGroup vimeoLikes vimeoSearch vimeoUploadedBy e Embedded Video Player playerColor e Video Feed vimeoKey vimeoSecret e Video Meta Display likes Gallery Sources Gallery Sources e vimeoAlbum e vimeoAppearsiIn e vimeoChannel e vimeoCreditedTo e vimeoGroup e vimeoLikes vimeoSearch e vimeoUploadedBy vimeoAlbum Gallery source vimeoAlbum Description Videos from a Vimeo album The album is identified by the value supplied to the vimeoAlbumValue option Shortcode example tubepress mode vimeoAlbum vimeoAlbumValue 852694 Standalone PHP TubePressPro getHtmlForShortcode mode vimeoAlbum example vimeoAlbumValue 852694 Vimeo documentation Click here 118 Chapter 4 Reference TubePress Documentation Release vimeoAppearsiIn Gallery source vimeoAppearsin Description Vimeo videos in which a given user appears The Vimeo user is identified you supply to the vimeoAppearsInValue attribute Notes Limited to 50 videos Shortcode tubepress mode vimeoAppearsIn example vimeoAppearsInValue dabrainkilla Stan
109. re you use TubePress Pro edit TubePressPro setBaseUrl1 and the path to TubePressPro php to point to your new install location 4 Rebuild the system cache 36 Chapter 2 User Manuals TubePress Documentation Release Shadowbox js Download This page allows you to create a custom build of Shadowbox that includes only the feat project Compiling all of the necessary source files into one improves performance and Choose the adapter you ll be using Select the player s for the types of content you want to display Images External sites and pages Inline and or dynamic HTML Flash swf files Flash video flv files QuickTime Windows Media Player E EAE e E O E E OTE English F include support for using CSS selectors to select links The current version of Shadowbox is 3 0 3 2 2 TubePress Manual for PHP TubePress Documentation Release Optimize for Speed On the web speed is king By taking two minutes to read this section you can ensure that TubePress keeps your site running at maximum performance When TubePress is invoked on a new server for the very first time it needs to look around to see what system resources are available to it To save time TubePress can perform this discovery process once and cache its findings on the filesystem This makes subsequent invocations lightning fast We refer to this cache as the TubePress system cache Ensure System Cache is Working To use its s
110. ributions Default value false Valid values true or false Shortcode example tubepress youtubeDisableKeyboardControls true Standalone PHP TubePressPro getHtmlForShortcode youtubeDisableKeyboardControls true example YouTube Click here documentation 114 Chapter 4 Reference TubePress Documentation Release youtubePlayerTheme Option name Description Provided with Default value Valid values Shortcode example Standalone PHP example YouTube documentation youtubePlayerTheme The color theme of the video player All TubePress distributions dark dark or Light tubepress youtubePlayerTheme Llight TubePressPro getHtmlForShortcode youtubePlayerTheme light Click here ee ee youtubeShowAnnotations Option name Description Provided with Default value Valid values Shortcode example Standalone PHP example YouTube documentation youtubeShowAnnotations Show video annotations by default All TubePress distributions false true or false tubepress youtubeShowAnnotations true TubePressPro getHtmlForShortcode youtubeShowAnnotations t Click here youtubeShowPlayerControls Irue Option name Description Provided with Default value Valid values Shortcode example Standalone PHP example YouTube documentation youtubeShowPlayerControls Toggles display of the video controls All TubePress distributions
111. ro in a PHP environment make sure that the domain you set with TubePressPro setBaseUrl matches your preferred domain Missing tubepress js_ Any page that uses TubePress needs to have tubepress js loaded somewhere in the document If this file is missing your gallery s thumbnails won t respond to clicks To diagnose if this if your problem you can view your HTML source or use Firebug to verify if this file is being loaded correctly The image below shows what a correct load will look like in Firebug In WordPress this file will be automatically loaded via your theme s wp_head function invocation However some custom themes will accidentally or intentionally omit this call Switching back to the Twenty Thirteen WordPress theme will verify if your custom theme is the culprit Here is some further information on including the wp_head function in your theme Multiple Instances of jQuery This problem is much more prevalent in WordPress based sites where other plugin and theme authors fail to include jQuery the right way Multiple loads of jQuery will not only significantly hurt the load time of your site but it will also break TubePress There are two ways to see if your site is loading jQuery more than once 1 Inspect your HTML source hit Ct r1 F and search for jquery You should only see one JavaScript file loaded for jQuery 2 Use Firebug s Net tab to examine the scripts loaded on your page The
112. s and here for standalone PHP users Note Any time you add or remove a CSS or JavaScript file from a theme you will need to rebuild the system cache However simply editing these files does not require a cache rebuild 3 2 6 Hierarchical Themes TubePress themes can optionally have a parent theme by defining a parent property in the manifest This allows themes to easily customize one another Warning Be aware that child themes can be very sensitive to changes to their parents If you are concerned about stability hierarchical themes may not be the right choice 3 2 Theme Development 87 TubePress Documentation Release Here s how the theme hierarchy works during TubePress s execution e If a theme does not contain a template the theme s hierarchy will be searched until the template is located In other words child theme templates take priority e CSS and JS files will be loaded in a recursive parent first manner To clarify let s look at how CSS files are loaded in the following theme hierarchy Theme name Theme parent CSS files grandchild parent css one css arent randparent P g P css three css css two css grandparent none css four css The CSS files for the grandchild theme would be loaded into the browser in the following order l css four css 2 css three css 3 css two css 4 css one css The same logic applies to JavaScript scripts 3 2 7 Sharin
113. s that should never appear in TubePress s output All TubePress distributions empty A comma separated list of YouTube or Vimeo IDs Vimeo and YouTube tubepress videoBlacklist HSrtIrvcm64 BnS rTbFw2g 3045633 TubePressPro getHtmlForShortcode videoBlacklist HSrtIrvcm64 r 3hough BnS rTbFw2g 3045633 Video Meta Display author Video Meta Display Options category dateFormat description descriptionLimit id length relativeDates tags title uploaded ied views 4 1 Options 101 TubePress Documentation Release author Option name author Description Toggle display of the video uploader s username Provided with All TubePress distributions Default value false Valid values true or false Supported provider s Vimeo and YouTube Shortcode example tubepress author true Standalone PHP example TubePressPro getHtmlForShortcode author true category Option name category Description Toggle display of the video category Provided with All TubePress distributions Default value false Valid values true or false Supported provider s YouTube Shortcode example tubepress category true Standalone PHP example TubePressPro getHtmlForShortcode category true dateFormat Option name dateFormat Description Set the textual formatting of date information for videos See date for examples Pr
114. s_thumb img webkit border radius 15px moz border radius 15px border radius 15px dd tubepress_meta_title font weight 200 dd tubepress_meta_runtime font style italic This will round off the corners of all TubePress thumbnails lighten the font of the video titles and italicize the video runtime Save this file 8 Head back to your test page from Step 6 and hit refresh You should see the changes from your new CSS Congratulations You have successfully created and activated your own custom TubePress theme Of course that was just a fraction of what s possible with TubePress themes What do to next 78 Chapter 3 Developer Documentation TubePress Documentation Release Sai OKC Golf Club whimsical Whitney Kay Brian Scott Twin Hills wedding wedding Shore Lodge wedding 4 28 4 54 6 45 Wai NAYS XY Brides of Oklahoma gown Pear Tree Estate wedding Hotel Zaza St Anne s The shoot 4 48 Corinthian wedding 3 42 6 24 e Explore what else your theme s manifest can do for you e Add your own custom HTML templates e Add additional CSS or JavaScript to your theme e Learn about the power of hierarchical themes e Share your theme with the TubePress community 5 Minute TubePress Theme Tutorial for Standalone PHP For this tutorial you will create a child theme of the default TubePress theme Your theme will simply add some ad ditional CSS styling to TubePress s outp
115. sed The real power of the plugin lies in the ability to be invoked in unique ways on multiple posts and pages This is done by passing options to the tubepress shortcode For example say on one page you want to display a gallery of 20 Chapter 2 User Manuals TubePress Documentation Release A Dashboard TubePress Options Here you can set the default options for TubePress Each option here can be overridde per page post basis with TubePress shortcodes See the documentation for more info Which videos Thumbnails Player Meta Feed Cache AC Comments Vimeo Appearance Plugins Videos from this Vimeo album 40484 Users Videos in this Vimeo channel splitscreenstuff Tools Settings Vimeo search for cats playing piano General Writing Videos uploaded by this Vimeo user mattkaar Reading ne Videos this Vimeo user appears in royksopp Media Permalinks a er Videos credited to this Vimeo user patricklawler TubePress either appears in or uploaded by 2 1 TubePress for WordPress 21 TubePress Documentation Release YouTube videos that are tagged with football want 15 videos per page and want to play the videos in an HTML poupup window On this page you would type tubepress mode tag tagValue football playerLocation popup resultsPerPage 15 on the page where you want the gallery to show up And say on another page you want to display a different gallery with the options that you seti
116. ser Manuals TubePress Documentation Release Ensure System Cache is Working To use its system cache TubePress needs a writable directory on the web server In many installations no configuration is necessary TubePress writes to and reads from the system temp directory However it s a very good idea to verify that the system cache is indeed working on your web server Simply log in to your WordPress admin dashboard If you do not see the following warning message at the top of the screen then you know that TubePress s system cache is working normally and no further action is necessary WE a Dashboard TubePress is not configured for optimal performance and could be slowing down your site Fix it now or dismiss this message Dashboard At a Glance Act Though not required you can also follow the procedure for TubePress in PHP to verify if the system cache is working Turn On or Configure System Cache Note If you have verified using the instructions in the previous section that the system cache is working you can safely skip this section If TubePress cannot write its system cache to the filesystem you will need to supply the path to a directory on your web server for which TubePress has read write access 1 Determine the absolute path of a directory on your web server to which TubePress can read and write Your hosting provider can help you with this step if you are unsure 2 Inside your TubePress Conte
117. system cache so TubePress detects the new features 5 Anytime you add TubePress to a post or page set the options enableQuickplay true and theme quickplay e g tubepress enableQuickplay true theme quickplay 2 4 Official TubePress Add Ons 67 TubePress Documentation Release ES All TubePress Options Only show options applicable to select Which videos layer Meta Feed Appearance Theme default A TubePress theme can change the HTML structure and in some cases the overal style of your gallery Height px of thumbs 83 Default is 90 width px of thumbs 147 Default is 120 Ajax enabled pagination Show pagination above thumbnails m m n ct y a et Only applies to galler span multiple p w ve m Show pagination below thumbnails Only applies to galleries that span multiple pages Use high quality thumbnails Note this option cannot be used with the randomize thumbnails feature Randomize thumbnail images g Most videos come with several thumbnails By selecting this option each time someone views your gallery they will see the same videos with each video s thumbnail randomized Note this option cannot be used with the high quality thumbnails feature Thumbnails per page 3 Default is 4 Maximum is 50 YouTube Black Bars Remover Hide black bars from YouTube 2 video thumbnails Not all YouTube thumbnails have black bars This option overrides a
118. t 78e79e9a16fe1e7003 Media Click here to register for a consumer key and secret Permalinks TubePress 16 Chapter 2 User Manuals TubePress Documentation Release Shadowbox js Download This page allows you to create a custom build of Shadowbox that includes only the feat project Compiling all of the necessary source files into one improves performance and Choose the adapter you ll be using Select the player s for the types of content you want to display Images External sites and pages Inline and or dynamic HTML Flash swf files Flash video flv files QuickTime Windows Media Player E EAE e E O E E OTE English F include support for using CSS selectors to select links The current version of Shadowbox is 3 0 3 2 1 TubePress for WordPress TubePress Documentation Release 3 Copy the contents of this directory not the directory itself to your TubePress Pro installation at lt tubepress_home gt src main web players shadowbox lib 4 Optional You may see scrollbars in the Shadowbox js display To fix this simply edit lib shadowbox css On line 8 remove the overflow auto attribute i e change it from sb player html height 100 overflow auto to sb player html height 100 Upgrade This page details the official upgrade procedures for TubePress The installation steps are different depending on if you are using TubePress Pro or the free version of TubePress Free
119. t T lt 7 gt i D D lt lt Th eee DIDA Th w name changeme themename version 1 0 0 title Theme Title Change Me author name Your Name Change Me url http tubepress com Licenses type MPL 2 0 url http www mozilla org MPL 2 0 l description A base TubePress theme that you can modify to suit your needs resources styles css theme css parent tubepress default screenshots version TOA title Theme Title Change Me author name Your Name Change Me url http tubepress com Licenses type MPL 2 0 url http www mozilla org MPL 2 0 l description A base TubePress theme that you can modify to suit your needs resources styles css theme css parent tubepress default screenshots 3 2 Theme Development 81 TubePress Documentation Release 4 Rebuild the system cache so that TubePress detects your changes and accepts the new theme Make sure your theme is selected in the theme drop down and click the Save button to activate your theme 5 Open any page with TubePress on it so that we can test Edit the argument to TubePressPro getHtmlForShortcode to include the theme option using the name of your new theme from Step 3 TubePressPro getHtmlForShortcode
120. t searching Provided with All TubePress distributions Default value false Valid values true or false Supported Vimeo and YouTube provider s Shortcode tubepress searchResultsOnly true example Standalone TubePressPro getHtmlForShortcode searchResultsOnly true PHP example searchResultsUrl Option name Description Provided with Default value Valid values Supported provider s Shortcode example Standalone PHP example searchResultsUrl A URL defining where TubePress should send the user s search terms By default this is S_SERVER PHP_SELF All TubePress distributions empty Any absolute URL Vimeo and YouTube tubepress searchResultsUrl http mysite com search php TubePressPro getHtmlForShortcode searchResultsUrl http mygite com sear API Cache API Cache Options e cacheCleaningFactor e cacheDirectory e cacheEnabled e cacheLifetimeSeconds 106 Chapter 4 Reference TubePress Documentation Release cacheCleaningFactor Option name Description Provided with Default value Valid values Supported provider s Shortcode example Standalone PHP example cacheCleaningFactor Defines how often TubePress will perform a full clean of its API cache If you enter x the API cache will be cleaned approximately every 1 x cache writes Enter 0 to disable all cache cleaning All downloadable TubePress distributions 20
121. tion name Description Provided with Default value Valid values playerLocation Defines the location of the embedded video player This allows you to choose the location and effect of how the embedded videos play All TubePress distributions though availability varies normal normal Embedded player is placed above thumbnail gallery popup Videos play in an HTML popup window youtube User is taken to the video s home on youtube com for viewing vimeo User is taken to the video s home on vimeo com for viewing shadowbox Video plays in a modal window with Shadowbox js jqmodal Video plays in a modal window with jq Modal solo Page refreshes and video player replaces the thumbnail gallery static Like normal but each thumbnail click trig gers a page refresh tinybox Video plays in a modal window with Tiny Box Not available in free WordPress plugin fancybox Video plays in a modal window with Fan cybox Not available in free WordPress plugin verLocation Supported provider s Vimeo and YouTube Shortcode example tubepress playerLocation popup Standalone PHP example TubePressPro getHtmlForShortcode pla showInfo Option name Description Provided with Default value Valid values Supported provider s Shortcode example Standalone PHP example showInfo Show or hide the video s title description and other meta information on the embedded video itself before playback be
122. tiple pages Show pagination above thumbnails 4 Only applies to galleries that span multiple pages Show pagination below thumbnails C Note this option cannot be used with the randomize thumbnails feature Use high quality thumbnails a Most videos come with several thumbnails By selecting this option each time someone views your gallery they will see the same videos with each video s thumbnail randomized Note this option cannot be used with the high quality thumbnails feature Randomize thumbnail images Thumbnails per page 2 3 TubePress for Wix 53 TubePress Documentation Release Common Questions e How many sites can I use TubePress on e I started a new website How do I transfer my TubePress purchase e What happens if I miss a payment How many sites can I use TubePress on Wix bills on a per site basis For instance if you have two Wix com websites that are both using TubePress you will be billed twice once for each website However there is no limit to the number of times that you may add TubePress to any website Even if you use TubePress in twenty different places on your site you will still just be billed once I started a new website How do I transfer my TubePress purchase Since Wix handles billing on our behalf you will need to contact Wix to transfer your upgraded apps to your new site What happens if I miss a payment If your trial period ends before payment or
123. ut We have even done some of the work for you every TubePress installation is shipped with a very simple base theme designed specifically for this tutorial 1 Locate your TubePress Content Directory and open up the themes subdirectory Inside you will find a directory named starter that houses everything needed for your new theme 2 Inside the starter theme directory you will find a file named theme json All themes must have a file named theme json which provides some basic metadata Open this file with your favorite text editor 3 At a bare minimum you will need to change the theme name You can do this by changing the name field from changeme themename to anything else We suggest lowercase alphanumerics and slashes For instance name ehough mynewtheme If you d like you may change the other lines of the file that indicate they can be changed e g title and description Save this file 3 2 Theme Development 79 TubePress Documentation Release tubepress_pro_x_y_z A index php LICENSE sample code src EE af tubeopress ohp TAI p pnp vendor _ tubepress content add ons u config ban themes b al starter v themes T al starter css aes ba theme json S 80 Chapter 3 Developer Documentation TubePress Documentation Release PRR Pee pe pad NN ws NN of cazar Ce D AP ees lt lt D D l
124. vigate 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 Standalone PHP 1 Purchase and download this add on from the TubePress Marketplace 2 Unzip the file you downloaded youtube black bars remover_x_y_z zip into the add ons sub directory of your TubePress Content Directory 3 Rebuild the system cache so TubePress detects the new features 4 This add on introduces the youtubeHideBlackBars option that you may _ supply to TubePressPro getHtmlForShortcode e g lt php print TubePressPro getHtmlForShortcode mode user userValue 3hough youtubeHideBlackBars tr 2 4 2 Vimeo All Access On This Page e Introduction e Manuals TubePress for WordPress TubePress for PHP TubePress for Wix e Obtaining API Credentials Access Token and Secret Consumer Key Client ID and Secret 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 TubePress powered site To make a video private choose the last radio icon in the privacy settings for the video as shown below Manuals TubePress for WordPress 1 Purchase and download this add on from the TubePress Marketplac
125. with the web accessible URL of your TubePress Pro installation 3 Include this statement in the HTML head of your document to print out the required TubePress CSS and JavaScript libraries It takes a single parameter which indicates whether or not to include jQuery If you are already including jQuery in your document use false for this parameter 4 The getHtmlForShortcode function takes a single string parameter which is any valid TubePress short code It returns the HTML output of TubePress You may repeat this function call as many times as you like Changing the Language TubePress is available in the following languages Language Country Locale Arabic ar Chinese China zh_CN Chinese Thaiwan zh_TW English en Finnish Suomi fi French Fran ais France fr_FR German Deutsch Germany de_DE Greek eAAnuik el Hebrew Israel he_IL Hindi India hi_IN Italian Italiano Italy it IT Japanese ja Korean South Korea ko_KR Norwegian Bokm l Norway nb_NO Persian Tran fa_IR Polish Jezyk Polski Poland pl_PL Portuguese Portugu s Brazil pt_BR Russian Russia ru_RU Spanish Espa ol Mexico es_MX Spanish Espa ol Spain es_ES Swedish Svenska Sweden sv_SE We are always eager to provide more translations and update existing translations If you are interested in contributing please submit a ticket describing how you can help The image below is an example of TubePress when configur
126. y 2 Open up Firebug 3 Open Firebug s Console tab 4 Click on any TubePress thumbnail You should see a new XHR request show up as TubePress performs its Ajax request ay Console HTML CSS Script DOM Net Cookies J ooo ig Clear Persist Profile All Errors Warnings Info Debug Info Cookies gt GET http tubepress org wp content plugins tubepress pro 2 4 2 sys scripts ajax playerHtml php tubepress video hHuGtuWQoC4 amp tubepress shortcode 255Bqallery tubepress 2520galleryid 253D 25221006 jquery min js line 4 5 Expand this request using the expand icon on the left to view the results You should see a small medium JSON result If you see anything else here or nothing at all then something is wrong To fix this issue Google recommends to choose a preferred domain and stick with it Here are some guidelines on how to achieve this 26 Chapter 2 User Manuals TubePress Documentation Release we lt Y v Consolev HTML CSS Script DOM Net Cookies pJ KTT ig Clear Persist Profile All Errors Warnings Info Debug info Cookies Y GET http tubepress org wp content plugins tubepress pro 2 4 2 sys scripts ajax playerHtml php tubepress video hHuGtuWQoC4 amp tubepress shortcode 255Bgallery tubepress 2520galleryid 253D 25221006 jquery min js line 4 Params Headers Response HTML JSON Cookies title Championt20spot light 3A820Evelynn82C820the 20Widowmaker html 83Cdiv 20class 3D 2
127. y customized by means of add ons and themes This page provides a broad overview of these two extension mechanisms and how they are used with TubePress What is a Theme A TubePress theme is a set of files that work together to produce the structure and style of TubePress s output Themes provide you with very fine grained control over how TubePress integrates with your website s existing design In other words a theme is the skinning mechanism for TubePress Themes are typically shared as compressed ZIP files and can be added to or removed from TubePress easily What is an Add On TubePress add ons are software packages that extend the functionality of TubePress Much like themes add ons are typically shared as compressed ZIP files and can be added to or removed from Tube Press easily 2 2 TubePress Manual for PHP 41 TubePress Documentation Release Get New Add Ons or Themes The central source for all TubePress add ons and themes is the TubePress Mar ketplace There you can find add ons and themes developed by both TubePress LLC as well as the TubePress user community If you are interested in creating your own add on or theme please head over to our developer documentation TubePress Content Directory Both add ons and themes are stored in the TubePress Content Directory which is a special directory inside your TubePress installation located at tubepress_pro_x_y_z tubepress
128. y is upgrade safe meaning that its contents will be preserved when you upgrade TubePress This is where you should save your custom themes 3 2 3 Manifest File Each theme must have a manifest file named theme json at the root of the theme directory This is a simple JSON file that contains metadata about the theme When editing your own theme json we strongly suggest that you run its contents through an online JSON validator to ensure there are no syntax errors Required Fields Below is a minimal theme json with all required fields filled in name tubepress sample version 2 1 1 title Sample author name TubePress LLC url http tubepress com licenses type MIT type GPL 3 0 url https www gnu org copyleft gpl html Let s go through each field one by one name Required The globally unique name of this theme You can use nearly any value here but we recommend using a vendor name e g your GitHub username company name or last name followed by a slash followed by the theme name This field must be 100 characters or less and is case insensitive version Required The semantic version of this theme Used in TubePress s options GUI title Required The human readable title of this theme Used in TubePress s options GUI This field must be 255 characters or less author Required An object with both name
129. ystem cache TubePress needs a writable directory on the web server In many installations no configuration is necessary TubePress writes to and reads from the system temp directory However it s a very good idea to verify that the system cache is indeed working on your web server Here s how to check 1 Put your site into debug mode 2 Make sure that you see the following message in the debug output use Ct r1 F to search We can boot from cache Excellent If you see that message you re all set The cache is working and your site is running at top speed If the cache is not working you ll see the message We cannot boot from cache Will perform a full boot instead TubePress will still operate normally but at a greatly reduced speed The next section describes how to resolve this situation Turn On or Configure System Cache Note If you have verified using the instructions in the previous section that the system cache is working you can safely skip this section If TubePress cannot write its system cache to the filesystem you will need to supply the path to a directory on your web server for which TubePress has read write access 1 Determine the absolute path of a directory on your web server to which TubePress can read and write Your hosting provider can help you with this step if you are unsure 2 Inside your TubePress Content Directory you will find a directory named config And inside the config

TubePress Documentation

Contents

Download Pdf Manuals

Related Search

Related Contents