# VideoTube - documentation

- By: phpface
- Updated: July/02/2017

# Introduction

Welcome to the VideoTube WordPress theme documentation, by Phpface. Use the menu to left side to navigate quickly through the documentation.

If you're having an issue with the theme and can't find the answer here, then please send us an email through our profile page: http://themeforest.net/user/phpface and we will try to answer you as quick as possible.

Please read the documentation carefully before sending a support request. The chance you could find the answer here is big and would save you a lot of time!

# Installation

Extract the zipped package downloaded from ThemeForest to your desktop, in the extracted package you will find videotube.zip file which is the wordpress theme.

You can install the theme in two different ways:

- FTP Extract videotube.zip file and upload the extracted folder to /wp-content/themes/ folder on your server.

- WordPress Navigate to Apperance -> Add New Themes -> Upload page. Select videotube.zip file. Press the Install Now button to upload and install the theme.

After uploading the theme, you have to activate it. Navigate to Appearence -> Themes page to activate the theme.

TIP: Check this page made by Themeforest on how to install a WordPress theme correctly: ThemeForest Knowledgebase

# Import Demo Data

- Step 1 Go to Tools/Import (See Image)

- Step 2 Click on Wordpress and click "Install Now" button. (See Image)

- Step 3 Click Activate Plugin & Run Importer, (See Image)

- Step 4 Click on the "Choose File" button and choose XML file, which is included in Videotube Zip file, click "Upload file" and import (See Image)

- Step 5 Click on "Download and import file attachments", and click the Submit button (See Image)

# Menu

Videotube supports one location for custom WordPress menus - Home Page Navigation. The menu supports 3 levels of dropdown.

To setup the menu, navigate to Apperance -> Menus page. Enter a name for your menu and add links to the menu by using the options given on the left sidebar. You can manage your menus using the drag and drop functionality. After setting up your menu, select the menu you just created from the theme locations dropdown box and hit the "Save" button.

TIP: Read more about the WordPress Menus: WordPress Menu User Guide

# Install Plugins

VideoTube comes bundled with 6 plugins.

- Advanced Custom Fields Adds custom fields to the video custom post type.

- Video Thumbnails Gives you the functionality to automatically get a thumbnail from a video embedded from Youtube, Vimeo, etc.

- Social Count Plus Adds the Social Counter Widget.

- WPBakery Visual Composer Wordpress Page Builder $25 values.

- Advanced Custom Fields: Gallery FieldGallery for ACF, $25 AUD values.

Once you activate VideoTube you will get a notification, click the "Begin Installing Plugins" and install and activate all the required plugins.

# Setup Login/Register page

- Step 1 Create new or edit existing page.

  - - Enter Title

  - - Enter [videotube_login] shortcode. (See image)

  - Click on Update/Publish.

- Step 2 Go to Theme Options > Misc section

- Step 3 On Login/Register dropdown, choose the page you just created. (See image)

# Setup Homepage

- Step 1 Create new or edit existing Homepage (if you have imported demo XML), (See image)

  - - Enter Title

  - - Choose Main Homepage in the Page Template dropdown section in the right sidebar.

  - Click on Update/Publish.

- Step 2 Go to Settings > Reading

- Step 3 In the "Front page shows as" option, chose "A static page" and then choose the Homepage page you just created. (See image)

# Homepage Builder.

Since Version 1.1, The homepage/landing page is built with Visual Composer so you can build the homepage as your requirements.

We provide 9 demo pages:

- Homepage V1 – 2 Columns – Left Sidebar => Shortcodes.
- Homepage V1 – 2 Columns – Right Sidebar => Shortcodes.
- Homepage V2 – Fullwidth – 3 Columns => Shortcodes.
- Homepage V3 – Fullwidth – 4 Columns => Shortcodes.
- Homepage V4 - Fullwidth - 6 Columns => Shortcodes.
- Homepage V5 – 1 Column – Left Sidebar => Shortcodes.
- Homepage V5 – 1 Column – Left Sidebar – Version 2 => Shortcodes.
- Homepage V5 – 1 Column – Right Sidebar => Shortcodes.
- Homepage V5 – 1 Column – Right Sidebar – Version 2 => Shortcodes.
- Layout with 4 Columns and Featured Widget => Shortcodes.

Also you can drag and drop the "Page Builder" to build layout you can imagine.

# Setup Widgets

Go to Appearance > Widgets, you may need to remove all default widgets in the Featured Videos sidebar (See Image)

- Featured Widget Area

  - Find the VT Featured Video Widget and drag it to the Featured Video Sidebar.

  - Enter the options for the Featured Videos widget and click save (See Image)

- Main Video Widget Area

  - Find the VT Main Video Widget, drag it to "Main Homepage" sidebar (See Image)

  - Enter the options and click the Save button (See Image)

  - Drag in all the widgets you like (See Image) or use Widget Importer & Exporter plugin to import the example Widgets data

Videotube also comes with various other widget areas: Homepage Right (Homepage sidebar widgets), Innerpage Right (Page sidebar), Footer Sidebar, Video single below content (Use this area to add your related widget), Post single below content (Use this area to add your related widget) and Login/Profile

TIP: How to quickly setup the main homepage

# Setup Scrolling page

- Create new or edit existing page, (See image)

  - - Enter Title

  - - Choose Rolling Page in the Page Template dropdown section in the right sidebar.

  - Click on Update/Publish.

# Setup Channel/Author Page

Go to Appearance > Theme Options > Misc, choose YES in User Channel option (See Image)

# Setup Profile Page

The Theme compatible with Profile Builder, make sure you installed it

Create a new page or edit an exists page and use this shortcode [wppb-edit-profile], noted: We do not provide the support for this plugin.

# Video Thumbnails

With VideoTube you can either add a featured image for your videos manually or use the smart Video Thumbnail functionality. This way the theme will automatically grab a screenshot from the video and use it as the featured image. Here's how you set it up:

- Step 1 Go to Settings > Video Thumbnails

- Step 2 Click on Video in Post Type section

- Step 3 Enter video_url in the "Custom Field (optional) field"

- Step 4 Your settings should now look like this, remember to save your changes.

# Shortcode

- [videotube_upload] display the submit video form, allow the user submit the video at Frontend.

  Since Version 1.2, You can include/exclude the category in the form by cat_exclude, cat_include option.
  Example [videotube_upload cat_exclude="1,2"], 1,2 is Video Category ID.
  The cat_include option will ignore cat_exclude.

  Another options:
  - vcategory: on/off: display/hide the Category field, "on" is default.
  - vtag: on/off: display/hide the Tag field, "on" is default
  - cat_orderby: order by "name" by default.
  - cat_order: order "DESC" by default.

- [videotube] display the listing of videos with the options as below:

  - title: The Title of listing, eg:title="Lastest Videos" NULL by default.
  - cat: is categories (taxonomy) ID, eg: cat="1" or cat="1,2,3", NULL by default.
  - tag: is video_tag (taxonomy) ID, eg: tag="1" or tag="1,2,3", NULL by default.
  - orderby: eg: orderby="ID", Order by ID is default, all available parameters are: author, title,name, date, modified, rand, comment_count, views, likes.
  - order: eg: order="DESC" or order="ASC", DESC is default.
  - show: How many videos will be shown?, eg: show="10".
  - author: Show the video of this authors, eg: author="1" or author="1,5,7,9".
  - ids: this option only display the video is configured. eg: ids="1" or ids="1,2,3", if this option is configured, the result will ignore cat and tag option.
  - author: Show the video of this authors, eg: author="1" or author="1,5,7,9".
  - type: is this the widget or the main content, if type="main" then the page navigation is supported, have 2 options: main or widget, "main" is default.
  - navigation: Shows the page list navigation, have 2 options: on/off, "off" is default.
  - carousel: enable Carousel slider, have 2 options: on/off, "off" is default, this featured only works if you set type="widget".
  - rows: How many rows will be shown? 1 by default, example: rows="1", this featured only works if you set carousel="on".
  - columns: How many columns will be shown? 3 by default, example: columns="3".
- Example: view some examples at http://videotube.marstheme.com/shortcodes/

- [videotube_login] display the Login and Register Form, is handled in Appearance > Theme Options > Login/Register section

# Sources & Credits

We have used the following opensource projects or other files as listed.

- jQuery http://jquery.com/

- jQuery Cookie https://github.com/carhartl/jquery-cookie

- Bootstrap http://getbootstrap.com/

- bootstrap-multiselect.js https://github.com/davidstutz/bootstrap-multiselect

- Google Font http://fonts.googleapis.com/css?family=Lato:300,400,700,900

- Redux Theme Option http://reduxframework.com/

- https://www.flickr.com/photos/58782395@N03/

- https://www.flickr.com/photos/jonathankosread/

- https://www.flickr.com/photos/kjcs/

- https://www.flickr.com/photos/h-k-d/

- https://www.flickr.com/photos/whatmegsaid/

- https://www.flickr.com/photos/swolff13/

- https://www.flickr.com/photos/e3000/

- https://www.flickr.com/photos/jonathankosread/

- https://www.flickr.com/photos/pedrosimoes7/

- https://www.flickr.com/photos/hdworld/

- https://www.flickr.com/photos/dexxus/

# Changelogs

http://themeforest.net/item/videotube-a-responsive-video-wordpress-theme/7214445