Newstube - Wordpress Theme

The Documentation

For support please checkout CACTUSTHEME SUPPORT FORUM

NEWSTUBE - WORDPRESS THEME

Welcome to Newstube!

Thanks for Buying

Created By: CactusThemes

Support Site: http://ticket.cactusthemes.com

Version: 1.0

NEWSTUBE LAYOUT

MAIN LAYOUT

Main Layout is applied to all pages (configure in Appearance > Theme Options > Theme Layout > Main Layout). There are 2 Main Layouts with many variations, including:

  1. Boxed
    main1
  2. Full width
    main2

FRONT PAGE LAYOUT

Front Page Layout is applied to Front Page only (configure in Appearance > Theme Options > Front Page > Default Layout). There are 2 layouts for Front Page with many variations, including:

main_container

  1. Style 1
    main_container1
  2. Style 2
    main_container2

NAVIGATION STYLE

Choose one of 4 styles for header (configure in Appearance > Theme Options > Theme Layout > Navigation Style):

navigation

  1. Navigation style 1
    navigation1
  2. Navigation style 2
    navigation2
  3. Navigation style 3 
    navigation3
  4. Navigation style 4
    navigation4

HEADER LAYOUT

Header Layout is applied to Front Page only (configure in Appearance > Theme Options > Front Page > Header - Featured Posts Layout). Choose one of 9 layouts for Front Page Header:

  1. Posts Gird Layout 1
    hd1
  2. Posts Gird Layout 2
    hd2
  3. Posts Gird Layout 3 
    hd3
  4. Posts Slider
    hd4
  5. Posts Classic Slider Layout 1 
    hd5
  6. Posts Classic Slider Layout 2
    hd6
  7. Posts Carousel 
    hd7
  8. Posts ThumbSlider
    hd8
  9. Posts Parallax 
    hd9

POSTS LAYOUT

Posts Layout is applied to posts page (blog) and archive pages (such as categories, tags, author) (configure in Appearance > Theme Options > Archives > Layout). Choose one of the following 7 layouts:

layout

  1. Layout 1
    bl_l1
  2. Layout 2
    bl_l2
  3. Layout 3
    bl_l3
  4. Layout 4
    bl_l4
  5. Layout 5
    bl_l5
  6. Layout 6
    bl_l6
  7. Layout 7
    bl_l7

Installation

The Full Package includes these following files and folders:
  • Documentation folder - Contain this document and other materials
  • Installation Files folder - Contain all installable files, including theme & plugins
    • themes/newstube.zip - WordPress Theme Installation file
    • plugins/plg-newstube-shortcodes.zip - enables shortcodes for NewsTube theme
    • plugins/plg-cactus-channel.zip - enables Channel feature for theme
    • plugins/plg-cactus-video.zip - enables Video feature and Playlist feature for theme
    • plugins/plg-cactus-ads.zip - enables Ads feature for theme
    • plugins/plg-cactus-poll.zip - enables Poll feature for theme
    • plugins/plg-cactus-rating.zip - enables Rating feature for theme
    • plugins/plg-visual-composer.zip - Visual Composer, a drag&drop page builder plugin (Premium)
  • Sample Data folder - Contain sample data files
OptionTree plugin is required for the theme to work properly

INSTALL VIA WORDPRESS

  1. Login to WordPress Admin
  2. In the left menu panel go to Appearance > Themes > Add New to install theme, or Plugins > Add New > Upload to install plugins
  3. Click Upload
  4. Browse your download package to select installation files
  5. Click Install Now button
  6. Once it's uploaded, click the Activate link

INSTALL VIA FTP

  1. Use your FTP software to browse to wp-content/themes folder to install theme or wp-content/plugins folder to install plugins
  2. Extract the installation files to their corresponding folders, for example newstube.zip to newstube and upload to server
  3. Once it's uploaded, go to your WordPress Admin, browse to Appearance > Themes or Plugins > Installed Plugins
  4. Click the Activate link
After the process of installation is finished, your page will be displayed in form of a blog page

Note: You can install optional plugins if needed. We recommend using these extra plugins (free). All have been tested and used on our demo page.
Go to Plugins > Add New to install and activate plugins
  • Contact Form 7 - Simple but flexible contact form plugin
  • WP PageNavi - Add a more advanced paging navigation to your WordPress blog
  • Custom Sidebars - Allow you to create widgetized areas and custom sidebars. Replace whole sidebars or single widgets for specific posts and pages.
  • TinyMCE Advanced - Enable advanced features and plugins in TinyMCE
  • WP Twitter Feeds - Add latest tweets on sidebar to your WordPress blog
  • BAW Post Views Count - Enable Post Views count
  • W3 Total Cache - Enable caching, dramatically improve the speed and user experience of your site
  • WTI Like Post - Enable Post Like

AUTO UPDATE

  1. Go to Plugins > Add News > Upload, find and install /plugins/envato-wordpress-toolkit.zip file (in the download package)
  2. To establish an Envato Marketplace API connection navigate to the Envato Toolkit page and insert your Marketplace username and secret API key in the designated input fields. To obtain your API Key, visit your "My Settings" page on any of the Envato Marketplaces
  3. Once the API connection has been established you will see a list of themes that can be auto installed. If you don't see any themes and are certain you've done everything correct, there is a good chance the theme author has not updated their theme to be available for auto install and update. If that's the case, please contact the theme author and ask them to update their theme's information
  4. Note Only theme is updated. Related plugins must be updated manually. Please check release logs to see if you need to update plugins

INSTALL SAMPLE DATA

IMPORT MANUALLY

Alternatively, you can use traditional way to import data. In /Sample Data/ folder, you can find there are:
  • newstube.xml All Data
  • theme-options.txt Theme Options Settings
  • newstube-widgets.json Widgets Settings
To install sample data as seen on our demo page, following these steps

Step 0. Make sure you have installed the blog theme and all recommended plugins

Step 1. Go to Tools > Import, then click on Wordpress

Step 2. If it is not yet installed before, you have to install it. On the popup window, click on "Install Now"

Step 3. After installed successfully, click Activate Plugin & Run Importer

Step 4. Browse for [path-to-your-downloaded-package]/Sample Data/newstube.xml or newstube.xml.gz and click Upload File and Import.

Step 5. After uploaded, the confirmation page appears. Check the Download and import file attachments option and click Submit If you have trouble with importing (it might breaks in the middle due to long execution time), try again with this option Unchecked! Or, try to import separate files as they are smaller

Step 6. After uploaded, the confirmation page appears. Check the Download and import file attachments option and click Submit

Step 7. When you see message "All done. Have fun!", you will know that the import is done.  Note: you may need to re-import the second time if the data is large. Back to Step 1. until you see the message below

Step 8. Go to Settings > Reading, set Front page displays to A Static page. Choose Home Page page as Front page and Blog as Posts page

Step 9. Go to Appearance > Menus, choose Main Navigation menu as Primary Menu


Step 10. Install Widget Settings Importer/Exporter and go to Tools > Widget Settings Import to import Sample-data/newstube-widgets.json file

Menu Management

There are four menu locations in the theme:
  • Primary Menu
  • Top Nav Menu
  • Footer Menu
  • Logged In User Menu
In which, you can turn on Mega Menu feature for Primary Menu (beside the default multi-Level Dropdown Menus style) in Theme Options > Theme Layout > Enable MegaMenuMega Menu has 3 sub-level menu styles including List StyleColumn Style and Preview Mode. Please check next sections to see how to configure the Mega Menu.

Logged In User Menu is the menu on top-right of the page and only appears when users logged in

If you have imported demo content, go to Existing Menu or else go to Creating a New Menu to create a new menu.

  1. Go to Appearance > Menus
  2. In the Manage Locations area, assign menu to appropriate Theme Locations. Click Save Changes

menu

  1. Go to to Appearance > Menus

  2. Click Create a new menu. Enter a menu's name and click Create Menu

  3. Check the menu item in the boxes in the left column, click Add to Menu to add items to the menu and drag/drop to arrange them.

    createmune
  4. Click Save Menu

  5. Now assign your newly created menu to appropriate locations

MEGA MENU

To turn on Mega Menu mode, go to Theme Options > Theme Layout > Mega Menu first and choose ON, then go to Appearance > Menus to configure the menu structure. Mega Menu can contains three sub-menu styles: List StyleColumn Style and Preview Mode

List Style is the traditional dropdown-menu style.

list

We call Parent Level Menu Level 0. Then, next levels are Level 1Level 2...

  1. Add Menu Level 0, Level 1... normally by using drag & drop
  2. Click on a Menu Level 0 (Parent Level Menu ) item and select List Style in Menu Style selectbox (this selectbox is only displayed for Menu Level 0)
    list_stylemenu1
  3. You can configure Display Logic option to control the appearance of this menu item. Please note that Display Logic only works for Primary Menu
    • Always visible - Always display menu for Guests and Admin Users. It is visible
    • Only Visible to Guests - Menu is only displayed for Guests when they visit your website, but not display for Admin Users
    • Only Visible to Members - Menu is only displayed for User Members, but not display for Guests
  4. "Click Save"
Column Style is a multi-column style menu to display menu items (such as posts, pages, categories) and widgets like below figure
column
  1. Column Style MUST HAVE Level 0Level 1 (also called Heading of Column), and Level 2 menu items. 
    menu1
  2. Click on a Level 0 menu item and select Column Style in Menu Style (Menu Style is only displayed for Menu Level 0)
    menu2
  3. You can configure Display Logic option to control the appearance of this menu item. Please note that Display Logic only works for Primary Menu
    • Always visible - Always display menu for Guests and Admin Users. It is visible
    • Only Visible to Guests - Menu is only displayed for Guests when they visit your website, but not display for Admin Users
    • Only Visible to Members - Menu is only displayed for User Members, but not display for Guests
  4. "Click Save"
The Preview mode looks like below figure. In this mode, visitors will see latest posts in a category or a tag
preview
  1. In this mode, menu only has 2 levels (Level 0 and Level 1). Level 1 MUST BE one of the following type: Categories, Tags, Posts, Pages and WooCommerce/JigoShop Product Categories
  2. Click on Level 0 menu item and select Preview Mode in Menu Style (Menu Style is displayed for Menu Level 0)
    menu4
  3. You can configure Display Logic option to control the appearance of this menu item. Please note that Display Logic only works for Primary Menu
    • Always visible - Always display menu for Guests and Admin Users. It is visible
    • Only Visible to Guests - Menu is only displayed for Guests when they visit your website, but not display for Admin Users
    • Only Visible to Members - Menu is only displayed for User Members, but not display for Guests
  4. "Click Save"

HOW TO CREATE HOME PAGE

  1. Create two new pages in WordPress (under Pages > Add new), and publish them 

    For the purpose of demonstration, we’ll call these “Home” (for the Front, or Home page)
  2. Go to Settings > Reading Settings, and under “Front page displays”, click the radio button for A static page 

    Select “Welcome” in the first drop down (for Front page). Save the changes

POPULAR POSTS PAGE-TEMPLATE

NewsTube provides a page template called Popular Posts to configure special Front Page (or Home). This page template can list posts under various conditions such as Most Viewed or Most Liked

  1. Go to Pages > All Pages and edit “Home” page created in previous step
  2. Choose Popular Posts in Template. The corresponding metadata will appear in the boxes Popular Posts Content Settings & Page Settings in the left.
    fp-header
  3. Configure settings in Popular Posts Content Settings & Page Settings boxes
    • Popular Posts Content Settings

      Conditions Condition to query Popular Posts
      • Latest: posts are queried and ordered by Published Date Time (latest posts are on top)
      • Most Viewed: posts are queried and ordered by number of Post Views (posts having highest views are on top)
      • Most Liked: posts are queried and ordered by number of Post Likes (posts having highest likes are on top)
      • Most Commented: posts are queried and ordered by number of Post Comments (posts having highest number of comments are on top)
      Time range Time range of condition to query Popular Posts
      • All time
      • A Day ago
      • A Week ago
      • A Month ago
      • A Year ago
      Listing Layout Layout of Popular Posts: the same as Posts Layout
      Show Popular Posts select box Show a select box to switch between Popular Posts and Latest Posts page (Blog page)
    • Page Settings

      Sidebar Select "Default" to use settings in Theme Options
      • Default
      • Left
      • Right
      • Hidden (hide sidebar)

WIDGETS

  1. Newstube - Popular Posts Widget, displays posts under specific conditions
    • Title - Title of widget
    • Style - choose box style. Possible values
      • Style 1
        popular_posts1
      • Style 2
        popular_posts2
    • Category - (optional) Category IDs or slugs to query posts, separated by a comma
    • Tags - (optional) Tags to query posts, separated by a comma
    • Post IDs - (optional) IDs of posts to display, seperated by a comma. If this parameter is used, other parameters are ignored
    • Number of items - Number of posts to display
    • Number of days - Period of time to count for popular posts
      • 1 day
      • 1 week
      • 1 month
      • 1 year
    • Order by - (optional) default value is LATEST
      • Latest: order posts by Published Date Time (latest posts are on top)
      • Most Viewed: order posts by number of Views (most viewed posts are on top)
      • Most Liked: order posts by number of Likes (most liked posts are on top)
      • Most Commented: order posts by number of Comments (posts having highest number of comments are on top)
      • Featured: query posts which are marked Featured
  2. Newstube - Author Widget, displays information about an Author
    • Title  - Title of widget
    • IDs - IDs of author to display
    • author
  3. Newstube - Recent Comments Widget, displays recent comments
    • Title - Title of widget
    • Number of comments to show - Number of comments to show
    • recent_comment
  4. Newstube - Post Suggestion Widget, suggests a related post when user read to the end of the post
    • Title - Title of widget
    • Suggest post in - select criteria to display related posts
      • Same Categories
      • Same Tags
    • Suggest post order - select order of related posts
      • Latest
      • Random
    suggession

    Note: This widget should be in Footer Sidebar

  5. Newstube - Headline Widget, displays post titles as headlines
    • Headline Text - Text to be appeared in front of headlines
    • Category - (optional) Category IDs or slugs to query posts, separated by a comma
    • Tags - (optional) Tags to query posts, separated by a comma
    • Post IDs - (optional) IDs of posts to be displayed, seperated by a comma. If this parameter is used, other parameters are ignored
    • Number of headlines - Number of posts to be displayed
    • Number of days - Period of time to count for headlines
      • 1 day
      • 1 week
      • 1 month
      • 1 year
    • Order by - (optional) – default value is LATEST
      • Latest: order posts by Published Date Time (latest posts are on top)
      • Most Viewed: order posts by number of Views (most viewed posts are on top)
      • Most Liked: order posts by number of Likes (most liked posts are on top)
      • Most Commented: order posts by number of Comments (posts having highest number of comments are on top)
      • Featured: query posts which are marked Featured
      headline

      Note: Headline widget should be in Headline Sidebar

THEME OPTIONS

NewsTube comes with a lot of options to help you totally customize the look & feel of your site. Go to Appearance > Theme Options to configure.
Below is the detail of how to use those functions.

GENERAL

The general configuration for website
  1. Enable Search: Enable or disable default search form in every pages (it appears on Top Navigation menu bar)
    gene1

  2. SEO - Echo Meta Tags: By default, The Blog generates its own SEO meta tags (for example: Facebook Meta Tags). If you are using another SEO plugin like YOAST or a Facebook plugin, you can turn off this option
  3. RTL Mode: Support right-to-left language
    gene3

  4. Custom CSS: Enter custom CSS. Ex:

    .class{ font-size: 13px; }
  5. Custom Code: Enter custom code or JS code here. For example, enter Google Analytics
  6. Logo Image: Upload your logo image
    gene4

  7. Logo Image For Sticky Menu: Upload your logo image for sticky menu

  8. Retina Logo (optional): Retina logo should be two time bigger than the custom logo. Retina Logo is optional, use this setting if you want to strictly support retina devices.
  9. Login Logo Image: Upload your Admin Login logo image
    gene6

  10. Copyright Text: Enter copyright text
    gene7
  11. User Info Area: Show login/logout links on top-right of the page
    gene8

  12. Turn on/off Link on Date Time: Turn on/off link on Date Time info of each item in an archive page (blog, categories, tags or author)

  13. Scroll Effect: Enable Page Scroll effect

COLOR AND FONTS

  1. Main color: Choose main color of the theme

    color1
    color2

  2. Google Font: Enable this feature to use Fonts from Google Fonts repository. When On is chosen, settings for Main Font Family & Navigation Font Family & Heading Font Family below will be effective
  3. Main Font Family: Enter font-family name here. Google Fonts are supported. For example, if you choose "Source Code Pro" Google Font with font-weight 400,500,600, enter "Source Code Pro: 400,500,600"
    main_font

  4. Main Font Size: Select base font size for body text
  5. Navigation Font Family: Enter font-family name here. Google Fonts are supported. For example, if you choose "Source Code Pro" Google Font with font-weight 400,500,600, enter Source Code Pro: 400,500,600
    navigation_font

  6. Navigation Font Size: Select base font size for navigation items
  7. Heading Font Family: Enter font-family name here. Google Fonts are supported. For example, if you choose "Source Code Pro" Google Font with font-weight 400,500,600, enter Source Code Pro: 400,500,600
    heading_font

  8. Heading Font Size: Select base font size for headings
  9. Custom Font 1(woff): Upload your own font (.woff) and enter name "custom-font-1" in "Main Font Family", "Navigation Font Family" or "Heading Font Family" setting above
  10. Custom Font 1(woff2): Upload your own font (.woff2) and enter name "custom-font-1" in "Main Font Family", "Navigation Font Family" or "Heading Font Family" setting above
  11. Custom Font 2(woff): Upload your own font (.woff) and enter name "custom-font-2" in "Main Font Family", "Navigation Font Family" or "Heading Font Family" setting above
  12. Custom Font 2(woff2): Upload your own font (.woff2) and enter name "custom-font-2" in "Main Font Family", "Navigation Font Family" or "Heading Font Family" setting above
  13. Custom Font 3(woff): Upload your own font (.woff) and enter name "custom-font-3" in "Main Font Family", "Navigation Font Family" or "Heading Font Family" setting above
  14. Custom Font 3(woff2): Upload your own font (.woff2) and enter name "custom-font-3" in "Main Font Family", "Navigation Font Family" or "Heading Font Family" setting above

THEME LAYOUT

  1. Main Layout: The Main Layout of theme includes Boxed and Fullwidth (see Main Layout)
  2. Navigation style: Navigation with 4 kinds of style (see Navigation Layout):
  3. Mega Menu: Enable mega menu feature, see Mega Menu section
  4. Sticky Menu: Enable sticky menu
  5. Sticky Main Sidebar: Make Main Sidebar float
  6. Background: Set theme background image (for Boxed Main Layout)
  7. Background Link: Set hyperlink for background image

FRONT PAGE

These features is only configured for Front Page
  1. Default Layout: Choose default layout for Front page (see Front Page Layout)
  2. Header - Featured Posts Layout: Choose layout for Featured Posts section in Front Page (see Header Layout)
  3. Header - Featured Posts Count: Number of items to query for Featured Posts section
  4. Header - Featured Posts Categories: List of Category IDs or slugs of Featured Posts section, separated by a comma
  5. Header - Featured Posts Autoplay: Some layouts are slider and they have the ability to autoplay. Use this option to enable autoplay for those sliders
  6. Header - Hide in second and next pages: Hide or show header slider in second and next pages

Archives

These settings apply for blog (posts page) and archives page (categories, tags, author)
  1. Enable Popular Posts page: Display a select box in Blog Page to switch between Latest Posts and Popular Posts page
  2. Layout: Select bog layout, see Post Layout
  3. Related Posts - Integrate YARPP Plugin: Enabling this will allow you to use YARPP (Yet Another Related Posts Plugin) in Archive Layout 1 & 2. YARPP must be installed first
  4. Sidebar: Select position of sidebar
    • Right Sidebar: Archives pages with the right sidebar (default)
    • Left Sidebar: Archives pages with the left sidebar
    • Hidden sidebar: Archives pages without sidebar (full-width)

    For example, figure below is an Author page with Right Sidebar

    sidebar
  5. Page Navigation: Choose type of pagination for all archives pages. There are three options: Default WordPress, Ajax, and WP PageNavi. If you choose WP PageNavi, make sure you have installed WP PageNavi plugin in advance
    • Default WordPress
      pagi1

    • Ajax

    • WP PageNavi
      pagi3

SINGLE POST

These options are applied for Single Post pages
  1. Sidebar: Hide/show the main Sidebar. This setting can be overriden in each post
  2. Default Standard Layout: choose default layout for standard posts
  3. Default Video Layout: choose default layout for video posts
  4. Show share post popup when video is ended: show Share Post popup when video finishes
  5. Default Audio Layout: choose default layout for audio posts
  6. Default Gallery Layout: choose default layout for gallery posts
  7. Scroll To Next Posts: When users scroll to bottom of a single post, next posts will be loaded automatically
  8. Scroll Next - Condition: Choose how to load next posts
    • Next posts in all blog
    • Next posts in same Categories
    • Next posts in same Tags
    • Custom Categories
    • Custom Tags
  9. Scroll Next Order: Load newer posts or older posts
    • Load newer posts
    • Load older posts
  10. Scroll Next - Change URL when scrolling: When next posts are scrolled to, change browser URL (without reloading page)
  11. Show Tags: Show/hide Tags in Single Post
  12. Show Social Buttons: Show/hide Social Buttons in Single Post
  13. Show About the Author: Show/hide "About the Author" section in Single Post
  14. Number of More Posts: Set number of posts in "More Posts" section
  15. More Posts in: Choose how to query for "More Posts"
    • In blog order
    • In same categories
    • Having same tags
    • Same playlist, then tags
    • Same playlist, then categories
  16. Next/Previous Post in: Choose how to link to next/previous posts
    • In same categories
    • In blog order
  17. Show Related Posts: Show "Related Posts" section in single post page
  18. Related Posts - Select: Get Related Posts by Categories or Tags
  19. Related Posts - Count: Number of related posts
  20. Related Posts - Order By: Order related posts randomly or by published date
  21. Related Posts - Integrate YARPP plugin: Enabling this will allow you to use YARPP (Yet Another Related Posts Plugin) in single post. YARPP must be installed first
  22. Show Comment: Show Comment section in single post
    single_post

Front-end Post Submission

This function allows users to submit post or video (post format) from front-end, see more at Front-end Post Submission
  1. Enable: Enable Front-end Post Submission feature
  2. Login Required: Select whether only logged-in users can submit or not
  3. Submit Button - Label: Enter text you want to show
  4. Submit Button - Background Color: Choose a color for Button Background Color
  5. Submit Button - Text Color: Choose a color for Button Text Color
  6. Submit Button - Background Hover Color: Choose a color for Button Background Hover Color
  7. Submit Button - Text Hover Color: Choose a color for Button Text Hover Color
  8. Default Status for submitted posts:
    • Pending
    • Publish
  9. Default Post Format for submitted posts:
    • Video
    • Standard
  10. Exclude Category from Categories List: Enter list of category IDs that you don't want to be displayed in category checkboxes list (ex: "1,68,86")
  11. Limit number of tags that users can enter: Use 0 for unlimited
  12. Notification: Send notification email to user when post is published
    submit2

SINGLE PAGE

These options are applied for Single Page pages
  1. Sidebar: Hide/show Sidebar. This setting can be overriden in each page
  2. Disable Comments by default: Disable comments in single pages

CATEGORIES

These options are applied for Categories
  1. Sidebar: Select position of main sidebar in Category pages
    • Right Sidebar
    • Left Sidebar
    • Hidden sidebar (full-width)
  2. Enable Category Popular Posts page: When Category Popular Posts page is enabled, a select box in Category Page will appear to allow users to switch between Latest Posts (default category page) and Category Popular Posts page
  3. Popular Posts - Condition: Select condition to query for popular posts
    • Most Viewed
    • Most Liked
    • Most Commented
  4. Popular Posts - Time Range: Select time range to query for popular posts
    • All time
    • A Day ago
    • A Week ago
    • A Month ago
    • An Year ago
  5. Default Layout: Select default layout for a category page. This layout can be set for each category
    • Category Layout 1 - Featured Posts section is in left column
      layout_cat1

    • Category Layout 2 - Featured Posts section is full-width

  6. Featured Posts - Layout: Select default layout for Featured Posts Section (see Header Layout). Featured Posts are posts marked "Featured", see Post Settings
  7. Featured Posts - Count: Enter number of Featured Posts to display
  8. Featured Posts - Autoplay: Enable autoplay on Featured Posts

404 - PAGE NOT FOUND

These options are is only applied for 404 - Page Not Found page
  1. Page Title: Enter title for the page
  2. Page Content: Enter content for the page
    404

SOCIAL ACCOUNTS

Specify links to your Social Network profiles
  1. Facebook: Enter full link to your profile page
  2. Twitter: Enter full link to your profile page
  3. LinkedIn: Enter full link to your profile page
  4. Tumblr: Enter full link to your profile page
  5. Google Plus: Enter full link to your profile page
  6. Pinterest: Enter full link to your profile page
  7. YouTube: Full link to your profile page
  8. Flickr: Enter full link to your profile page
  9. Email: Enter email contact
  10. Custom Social Account: Add more social accounts using Font Awesome Icons
  11. Open Social Link in new tab: Open link in new tab
    social_account

SHARING

Turn on/turn off sharing buttons appearing in Single Post page and in each item in an Archive page
  1. Facebook App ID: Enter your Facebook App ID (optional)
  2. Facebook: Enable Facebook Share button
  3. Twitter: Enable Twitter Share button
  4. LinkedIn: Enable LinkedIn Share button
  5. Tumblr: Enable Tumblr Share button
  6. Google +: Enable Google+ Share button
  7. Pinterest: Enable Pinterest Pin button
  8. Email: Enable Email button
    social_sharing

ADVERTISING

Allowing putting your advertisement in specific pages or in all pages
  1. Google AdSense Publisher ID: Enter your Google AdSense Publisher ID
  2. Top Ads - AdSense Ads Slot ID: If you want to display Adsense in Top, enter Google AdSense Ad Slot ID here. If left empty, "Top Ads - Custom Code" will be used
  3. Top Ads - Custom Code: Enter custom code for Top Ads
  4. Bottom Ads - AdSense Ads Slot ID: If you want to display Adsense in Bottom, enter Google AdSense Ad Slot ID here. If left empty, "Bottom Ads - Custom Code" will be used
  5. Bottom Ads - Custom Code: Enter custom code for Bottom Ads
  6. Single Post/Bottom Ads - AdSense Ads Slot ID: If you want to display Adsense at Bottom of Single Post, enter Google AdSense Ad Slot ID here. If left empty, "Single Post/Bottom Ads - Custom Code" will be used
  7. Single Post/Bottom Ads - Custom Code: Enter custom code for Single Post/Bottom Ads
  8. Wall Ads Left - AdSense Ads Slot ID: If you want to display Adsense in Wall Ads Left, enter Google AdSense Ad Slot ID here. If left empty, "Wall Ads Left - Custom Code" will be used
  9. Wall Ads Left - Custom Code: Enter custom code for Wall Ads Left
  10. Wall Ads Left - Width: Specify width for Wall Ads Left, in pixels
  11. Wall Ads Left - Top Margin: Specify Top Margin for Wall Ads Left, in pixels
  12. Wall Ads Right - AdSense Ads Slot ID: If you want to display Adsense in Wall Ads Right, enter Google AdSense Ad Slot ID here. If left empty, "Wall Ads Right - Custom Code" will be used
  13. Wall Ads Right - Custom Code: Enter custom code for Wall Ads Right
  14. Wall Ads Right - Width: Specify width for Wall Ads Right, in pixels
  15. Wall Ads Right - Top Margin: Specify Top Margin for Wall Ads Right, in pixels
    advertising
    Note: Any HTML or shortcode can be used in Custom Code for Advertising. For example, you can use [cactus-ads] shortcode
    advertising2
  16. Ads can be Google Adsense or custom code which is defined in Theme Options > Advertising. If you don't have Google Adsense ID, you can use custom code to place banners, for example:
    <a href="http://website-url.com" title="Click here"><img src="http://yoursite.com/images/banner.jpg" title=""/></a>

MOBILE ICON

  1. For non-Retina iPhone, iPod Touch, and Android 2.1+ devices: Use the correct file name: apple-touch-icon-precomposed.png (57x57px)
  2. For first- and second-generation iPad: Use the correct file name: apple-touch-icon-72x72-precomposed.png (72x72px)
  3. For iPhone with high-resolution Retina display: Use the correct file name: apple-touch-icon-114x114-precomposed.png (114x114px)
  4. For third-generation iPad with high-resolution Retina display: Use the correct file name: apple-touch-icon-144x144-precomposed.png (144x144px)
  5. For Chrome on Android devices: Use the correct file name: touch-icon-192x192.png (192x192px)
    mobile_icon

Mobile Icon feature has been removed since NewsTube 1.3 due to the native support of WordPress 4.3. Now you can go to Appearance > Customize to change theme's favicon and mobile icon

AUTO UPDATE

Enable auto-update feature for the theme. Please note that only the theme is auto-updated. All related plugins must be updated manually
  1. Envato Username: Enter your Envato username
  2. Envato API: Enter your Envato API. You can find your API under in Profile page > My Settings > API Keys on your Envato profile page
  3. Allow Auto Update : Allow Auto Update or Not. If not, you can go to Appearance > Themes and click on Update link
    auto_update

NEWSTUBE SHORTCODES

Most of the properties of shortcodes are optional. You only need to include properties when needed. The shortcode button generator can be found in Classic Editor or Visual Composer

SMART CONTENT BOX

THE CODE

[scb title="" layout="" count="" condition="" order="" cats="" tags="" featured="" ids="" items_per_page="" enable_cat_filter="" show_meta="" show_category_tag="" show_datetime="" show_author="" show_comment_count="" show_like="" show_dislike="" show_view="" heading_color="" heading_bg="" big_thumbnail="" offset=""]

TABS

tab1
Step 1: In Backend Editor, click Newstube Tabs
tab4
Step 2: Click "+" icon, then choose Tab Item shortcode. You can have as many Tab Item as you want
tab5
Step 3: Enter Title and Content for the each Tab Item. In Content, you can add any kinds of shortcode (in the example above, we use Smart Content Box shortcode) as well
tab6
Step 4: Repeat Step 2 and Step 3 to add more Tab Items
tab7

POSTS GRID

THE CODE

[xgrid layout="" condition="" count="" order="" cats="" tags="" featured="" ids="" speed=""]

POSTS THUMBSLIDER

post_thumbslider

THE CODE

[xthumbslider condition="" order="" cats="" tags="" featured="" ids="" height="" autoplay=""]

POSTS CLASSIC SLIDER

THE CODE

[xclassicslider layout="" count="" condition="" order="" cats="" tags="" featured="" ids="" autoplay=""]

POSTS PARALLAX

post_parallax

THE CODE

[xparallax layout="" count="" condition="" order="" cats="" tags="" featured="" ids=""]

POSTS SLIDER

post_slider

THE CODE

[xslider count="" condition="" order="" cats="" tags="" featured="" ids="" autoplay=""]

LIVE CONTENT

live_content

THE CODE

[live time="" title=""] content text [/live]

post_caruosel

THE CODE

[xcarousel count="" condition="" order="" cats="" tags="" featured="" ids="" autoplay="" visible=""]

TESTIMONIALS

testimonials

THE CODE

[xtestimonial scroll="1"] [xtestimonial_item name=" " title=" " avatar=""] Testimonial content [/xtestimonial_item] [/xtestimonial]

COMPARE TABLE

There are two ways to add Compare Table shortcode
  1. Add Compare Table shortcode in "Classic Mode" editor interface
  2. Add Compare Table shortcode in Visual Composer
HOW TO USE COMPARE TABLE SHORTCODE IN CLASSIC MODE
Step 1: Go to Pages > Add New Page > click icon "Shortcode" shortcode and choose Compare Table
Step 2: Enter values for options in Compare Table shortcode.
compare2
Step 3: Shortcode structure is appeared as follows, you need to fill the content


The [comparetable] shortcode has the following variables/options:
  1. [comparetable]
    • class (text) - custom CSS class
    • id (text) - custom ID. If not provided, random ID is generated
    • color (hexa color) - main color of compare table
  2. [c_column]
    • class (text) - custom CSS class. Use "recommended" class to turn this column into special one
    • column (number) - number of columns in this compare table. It should match number of [c-columns] shortcode within [comparetable]
    • color (hexa color) - text color of column
    • bg_color (hexa color) - background color of column
    • title (text) - Title of column
    • price (number) - Price value
    • currency (character) - Currency symbol
    • price_text (text) - additional text after price
    • price_color (hexa color) - color of price text
  3. [c_row]
    • class (text) - custom CSS class
HOW TO USE COMPARE TABLE SHORTCODE WITH VISUAL COMPOSER
Step 1: Go to Pages > Add New Page > Backend Editor
compare3
Step 2: Click Add element
compare4
Step 3: Click Row shortcode to insert a line
compare5
Step 4: Click the option to choose the number of columns you need to use, for example: the number of columns are 3
compare6
Step 5: Click "plus sign" icon, then choose Compare Table shortcode. This is actually a [c_column] shortcode, so each column should have a [c_column] shortcode
compare7
compare8

Step 6: Enter values for this column
compare15
Step 7:Now add rows to the column. Click "plus sign" icon in Compare Table shortcode and choose "Row"
compare9
compare10

Step 8: Enter values for the Row
compare11
Step 9: In order to insert more rows, click "plus sign" icon under of Compare Table shortcode and follow the same steps as step 7,8. It is unlimited to insert more rows
compare12
Step 10: In each row, you can add any content or shortcode. For example, to insert Button shortcode, click "plus sign" icon as the image below and choose Button shortcode
compare13
Step 11: After adding components for Compare Table shortcode in column 1 is completed, move to column 2 or 3, then follow the above steps
compare14

DOWNLOAD BOX

download_box

THE CODE

[xdownload icon="" text="" url="" target=""]

ICON BOX

icon_box

THE CODE

[xicon-box icon="" title=""] Content [/xicon-box]

TOPIC BOX

THE CODE

[xtopic title="" layout="" alignment="" count="" condition="" order="" cats="" tags="" featured="" ids=""]

BUTTON

button

THE CODE

[button size="" bg_color="" href=""] Text [/button]

BLOCKQUOTE

blockquote

THE CODE

<blockquote class="">Text here</blockquote>

Please note that it is HTML code. You must switch the editor into Text mode to enter this code.

TOOLTIP

Tooltip shortode is only available in Classic Editor.
tooltip

THE CODE

[tooltip title=""] Text [/tooltip]

DROPCAP

Dropcap shortode is only available in Classic Editor.
dropcap

THE CODE

[dropcap]D[/dropcap]

DIVIDER

divider

THE CODE

[divider layout="" color=""] Title [/divider]

CATEGORIES & TAGS LISTING

cats listing

THE CODE

[c_cats tax=""]

CACTUS ADS

To call an advetising image/video into content

cactus_ads

THE CODE

[cactus-ads id=""]

To get Ads ID, go to Advs > All Advs and check the first column

cactus_ads2

ADSENSE

The [adsense] shortcode has the following variables/options:

THE CODE

[adsense pub="" slot="" class=""]
  • pub - Google Adsense Publisher ID
  • slot - Google Adsense Slot ID
  • class - Custom CSS class

CATEGORY PAGE

  1. Each category has its own options which allow you to override settings in Theme Options > Categories
    category
  2. Custom parameters:
    • Category Background: select background image for this category
    • Background Link: set Hyperlink on background image. This will overrides default setting in Theme Options > Categories
    • Category Background Color: Choose category color
    • Category Text Color: Choose color of category name to match with category background color
      • Light
      • Dark
    • Blog Layout: Choose blog layout for this category (see Blog Layout)
      • Default (use setting in Theme Options > Archives > Layout)
      • Layout 1
      • Layout 2
      • Layout 3
      • Layout 4
      • Layout 5
      • Layout 6
      • Layout 7
    • Featured Posts Section: Choose featured posts section for this category (see Category Layout)
      • Default (use setting in Theme Options > Categories)
      • Layout 1 (inbox Featured Posts)
      • Layout 2 (full-width Featured Posts)
    • Featured Posts Layout: Choose layout for Featured Posts section (see Header Layout and Smart Content Box)
      • Default (use setting in Theme Options > Front Page > Header - Featured Posts Layout)
      • Posts Gird Layout 1
      • Posts Gird Layout 2
      • Posts Gird Layout 3
      • Posts Slider
      • Posts Classic Slider Layout 1
      • Posts Classic Slider Layout 2
      • Posts Carousel
      • Posts ThumbSlider ( Note: Posts ThumbSlider only works when layout 2 is chosen in Category Layout )
      • Smart Content box 1 ( Note: SCB 1 only works when layout 1 is chosen in Category Layout )
      • Smart Content box 2
      • Smart Content box 3
      • Smart Content box 4
      • Smart Content box 5
      • Smart Content box 6 ( Note: SCB 6 only works when layout 1 is chosen in Category Layout )
    • Number of Featured Posts: Number of featured posts to display
    • Wall Ads Left - Adsense Slot: Enter Google Adsense Slot ID (this will overrides default setting in Theme Options > Advertising)
    • Wall Ads Left - Custom Code: Enter custom HTML ads for this position if you do not use Google Adsense (this will overrides default setting in Theme Options > Advertising)
    • Wall Ads Right - Adsense Slot: Enter Google Adsense Slot ID (this will overrides default setting in Theme Options > Advertising)
    • Wall Ads Right - Custom Code: Enter custom HTML ads for this position if you do not use Google Adsense (this will overrides default setting in Theme Options > Advertising)

PAGES

POPULAR POSTS PAGE-TEMPLATE

This page template is used to list popular posts and often used for Front Page. See Home Page Setup

NEWSTUBE SUBSCRIBED PAGE-TEMPLATE

NewsTube provides a Subscribe Page Template to list all channels that an user has subscribed. To use this page template, Cactus Channel plugin needs to be installed first. Link to this page should be put in Logged In User Menu so that only logged in users can see it (go to Appearance > Menus and create a menu, then assign that menu to Logged In User Menu location. See more at How To Create Menu). If you haven't setup this menu, default menu items will be added ("Subscribed", "Edit Profile" and "Logout").

    subsrcibe1
  1. Go to Pages > All Pages and Add New page. Name it Subscribed
  2. Choose NewsTube - Subscribed in "Template" select box. Leave the page content empty as it is ignored.

    subsrcibe2

Below is a sample of a "subscribed channels" page

subsrcibe3

PAGE SETTINGS

POSTS

POST SETTINGS

POST LAYOUT

Choose layout for this post (also see Post Format)

POST FORMAT

NewsTube theme supports Standard, Video, Audio and Gallery Post Format. Each post format has several layout options

format

  1. Standard Layout: Select layout for standard posts. Choose "Theme Options" to use setting in Theme Options > Single Post
    standard
  2. Video Post: Select layout for video posts
    video
  3. Audio Post: Select layout for audio posts
    audio
  4. Gallery Post: Select layout for gallery posts
    gallery

VIDEO SETTINGS

These settings are applied for Video Post Format. You need to install the Cactus Video plugin to use this feature

POST REVIEW

You need to install the Cactus Rating plugin to use this feature

Here is the final results: the rating meta box for a post

post_rating2

ILIST POST

iList Post is to break a long post into multiple pages. You can use this smart-list post to demonstrate a gallery of images or a collection of stories. If a post have one or more of page break HTML code (<!--nextpage-->), it will be understood as iList Post. In each pages, use an H2 tag to make a heading
ilist_post

THE CODE

<h2>Title</h2>
Content
<!--nextpage-->

OTHER SETTINGS

WIDGET CUSTOM VARIATION

In every widget, there is a textbox called Custom Variation. It is used when you want to customize the widget using custom CSS. The value entered in this textbox is added to the CSS class property of the widget box in front-end, then you can write CSS for this widget

custom1
custom2
Custom Variations List
no-bottomRemove padding bottom of any widget in Main Top Sidebar

FRONT-END POST SUBMISSION

submit
This feature requires Contact Form 7 plugin to work. To configure this feature:
  1. Create a contact form with fields having these ids:
    • post-title
    • video-url (needed if Video Post Format is submitted)
    • post-description (needed if Standard Post Format is submitted)
    • tag
    • category (needed if users need to choose which category to submit post to)
  2. Copy the contact form shortcode, for example [contact-form-7 id="2517" title="Submit"]. Go to Appearance > Widgets and drag a text widget into User Submit Video Sidebar. Paste the contact form shortcode into widget content.
  3. Go to Appearance > Theme Options > Front-end Post Submission, change Enable to Enabled
  4. If you want to send an mail (to users) to notify about the acceptance of the submited video, please enable option Notification in Theme Options > Front-end Post Submission

PLAYLIST

You need to install cactus-video plugin to enable this feature

  1. Click Add New Playlist
  2. Enter title and description for the playlist
    playlist1
  3. Edit a post and add that post to a desired playlist
    playlist2

CHANNEL

You need to install cactus-channel plugin to enable this feature

CREATE CHANNEL
  1. Click Add New Channel
  2. Enter title and description for this channel
    channel1
  3. Choose layout for this channel
  4. Edit a post and add that post to a desired channel
    channel4

POLL

Poll is to ask users to vote/answer a question. A poll can be added anywhere using [cactus-poll] shortcode

poll2

You need to install cactus-poll plugin to enable this feature

  1. Click Add New Poll
  2. Enter title (which is Question of the poll) and description of the poll
  3. Enter Answers for the poll in Poll Settings > List Answers. Choose other settings for the poll here too
    poll1
    • List answers: Add answers for the poll
    • Enable multiple choices: Allow users to choose more than one answer for the poll
    • Enable captcha: Enable Captch feature for the poll. Make sure you have configured ReCaptch API in Poll Settings page
    • Who can vote: Allow all visitors to vote, or only logged-in users are able to vote
    • Vote Limit: Allow an user to vote only 1 time or 1 time a day
    • Expiry date: Choose expiry date for the poll. After this date, users cannot vote
    • Display result settings: Choose when to display poll results, after users vote or when poll is expiried
  4. Copy Poll ID and use this shortcode [cactus-poll id=""] in a post to display poll

    Note: One post may contain several polls

FACEBOOK COMMENT

face

This section guides you to integrate Facebook Comment into posts using Facebook Plugin

  1. You will need to register a Facebook App first. Please follow this link: Facebook Developer
  2. In administrator, go to Facebook > General
  3. Enter App ID and App Secret of your Facebook App
    face2
  4. Go to Facebook > Comments Box to enable/disable comment box for certain post types
    face3
  5. Click Save Changes

AUTHOR's SOCIAL ACCOUNT

Specify links to your Social Network profiles

social_author
  1. Click User > Your Profile
  2. Complete your profile
    social_author1
    • Twitter: Enter your Twitter profile url
    • Facebook: Enter your Facebook profile url
    • LinkedIn: Enter your linkedin profile url
    • Google+: Enter your Google+ profile url
    • Tumblr: Enter your Tumblr profile url
    • Pinterest: Enter your Pinterest profile url
    • Email: Enter your Email profile url
    • Custom Social Accounts: Add more social accounts using Font Awesome Icons. Icons List can be found here FontAwesome Icons

ONEPRESS SOCIAL LOCKER PLUGIN

This section guides you to integrate OnePress Social Locker Plugin into posts. This plugin helps t drive traffic, build quality followers and improve your website ranking

  1. Go to Social Locker > New Locker to create new Locker
  2. Copy the Locker Shortcode, for example [sociallocker id="5648"] [/sociallocker] and add into Player Logic field of a post this code [sociallocker id="5648"][player][/sociallocker]. It will lock the player unless a visitor like or share the post

To disable the whole content of all posts, please follow these steps

  1. Go to Social Locker > New Locker to create new Locker
  2. Add Setup Batch Lock and enter this value .single-post-content article.cactus-single-content

To disable the whole content of a specific post, please follow these steps

  1. Go to Social Locker > New Locker to create new Locker
  2. Add Setup Batch Lock and enter this value article#post-4201 where 4201 is the ID of the post

NEWSTUBE - RATING PLUGIN

If you just like a simple (but useful) alternative, NewsTube Rating plugin is a choice (free, packed with NewsTube). You will find it in /Installation Files/Plugins/plg-newstube-rating.zip. Once installed, there is a setting page for it in admin

rating
There are 2 formats for Rating values: Point and Star
  • Point
    rating1
  • Star
    rating2

NEWSTUBE - ADS PLUGIN

Video Ads Management plugin is a plugin used to insert an advertisement in form of image or video above a video player. This plugin is developed by CactusThemes, it must be installed via uploading. You can find the installation files in the download package. After Video Ads Management plugin is installed, tab Video Ads will be appeared in Theme Options to turn on/turn off advertising function for the entire site. When advertising function is turned on for the entire site, it is default that the advertisment will be randomly taken from a list of Ads.

In order to configure Video Ads, go to menu Ads Config. In order to manage the advertisement, go to menu Advs. In order to appoint a specific advertisement for a post, go to Posts

General Settings

Go to Ads Config

ads3
  1. General: configure general settings
    ads4
    • Enable Ads: disable/enable advertising feature

    • Show close button after: (seconds) display "Turn off Ads" button after a number of seconds

    • Ads play again after: (seconds) the advertisement will automatically run after a number of seconds

    • Close Button Position: select position of the "Turn off Ads" button
  2. Branding - configure branding logo
    ads5
    • Enable Brand: Turn on/off Branding

    • Brand Logo: upload Brand Logo

    • Brand Text: use text for branding if Brand Logo is empty

    • Position: select position of the brand

    • Opacity: choose opacity for Brand Text

    • Text color: choose color for Brand Text

    ads6

Create a Video Ads

  1. Go to Advs > Add New

    ads1
  2. Settings for this Ads
    • Ads Type: Choose type of advertisement. There are 3 types:
      • Image
      • Video
      • HTML
      ads2
    • File Advanced Upload (Ads Type > Image): Upload advertising images. It allows you to upload up to 3 images to prepare for different screens (i.e. responsiveness):
      • First Image: will appear on screen > 1024px
      • Second Image: will appear on screen > 768px
      • Third Image: will appear on screen < 768px
      ads2_0


    • URL (Ads Type > Image|URL): Navigating URL when images/video is clicked

    • URL Target (Ads Type > Image|URL): Open URL in a new window or in current window

    • Position (Ads Type > Image|HTML): Advertisement's position

    • Video URL (Ads Type > Video): Enter URL from YouTube or Vimeo
      ads2_1
    • HTML Ads (Ads Type > HTML): Enter HTML content
      ads2_2

    • Expiry date: Expiration date of the advertisement

Use Video Ads

  1. Step 1: go to Posts > Add New/ Edit post > Video Ads
    ads7
  2. Step 2: enter ID in Ads ID. To select randomly from active Advs, enter 0
  3. Step 3: click Publish and save
    ads8

NEWSTUBE - VIDEO PLUGIN

This plugin enables all video-related features for the theme such as Video and Play List.

video1
Go to Cactus Video Settings to configure general settings for this plugin
  1. General
    video2
  2. Youtube Settings
    video3
  3. Playlist Settings
    video4

NEWSTUBE - CHANNEL PLUGIN

This plugin enables Channel feature

channel_plugin1
Go to Cactus Channel Settings page to configure general settings for this plugin
  1. General
    channel_plugin2
    • Channel Slug: change channel slug. Remember to save the permalinks setting after changed (go to Settings > Permalinks)
    • Channel Listing Page: choose a page to become Channel Listing page. Remember to save the permalinks setting after changed (go to Settings > Permalinks)
    • Channel Listing layout: choose layout for Channel Listing page
    • Subscribed Channels page - Number of items per channel: enter number of items per channel in Subscribed Channels page template

NEWSTUBE - POLL PLUGIN

This plugin enables Poll feature

poll_plugin1
Go to Poll Settings page to configure this plugin
  1. reCaptcha API
    poll_plugin2
    • Site Key & Secret Key: obtain from Recaptcha. You will need to register a key for this feature

RTL & Translation


Newstube is a WMPL-compatible and multi-language-ready theme. To translate this theme:
  • Download and install this tool POEdit
  • Open POEdit and load [/newstube/languages/newstube.po]
  • Translate the text and save the file
  • A file named newstube.mo is created. Save it in /newstube/languages/ folder. Rename it with Code Name of your language. For example, de_DE.mo for German - Deutsche. See language code list here http://codex.wordpress.org/WordPress_in_Your_Language
  • For WordPress 4.0 and above, go to Settings > General and choose Site Language
  • For WordPress 3.9.2 and below, open [{wordpress root}/wp_config.php] and find this line define('WPLANG', '');. Change it with your language code, for example define('WPLANG', 'de_DE');
The blog also supports RTL - Right To Left languages. If your language is RTL, go to Appearance > Theme Options > General > RTL mode and check Enable RTL

Licenses


The list might not be complete by accident. Authors who think you owe a license in this theme, please contact us at hi@cactusthemes.com

Support

If you face any problems with the installation or customization of our product, please do not hesitate to contact us via our support ticket system:

http://ticket.cactusthemes.com/