# TrueMag - Videos and Magazine Wordpress Theme - v4.0

## The Documentation

- Created: December 5th 2013
- Latest Update: August 29th 2015
- By: CactusThemes
- http://themeforest.net/user/cactusthemes
- Email: hi@cactusthemes.com

For support please checkout CACTUSTHEME SUPPORT FORUM

### TrueMag Layout

### Install and Update

Always remember to download the latest version from your ThemeForest account. The Installable Wordpress Themes is just the installable Wordpress theme files. The Main Files includes these following files and folders:

- Documentation Folder - contains this document and other materials
- Installation Files Folder - contains all installable files, including theme & plugins
  - theme/wp-theme-truemag.zip - TrueMag theme
  - plugins/plg-truemag-shortcodes.zip - A plugin which contains all shortcodes for theme. It contains Visual Composer plugin which helps you visually build pages
  - plugins/plg-truemag-movie.zip - A plugin which enables Movie feature for theme
  - plugins/plg-truemag-rating.zip - A plugin which enables Rating feature for theme
  - plugins/plg-ct-member.zip - A plugin which enables Member feature for theme
  - plugins/plg-video-ads.zip - provide "in-video" advertising solution
  - plugins/plg-cactus-video.zip - provide video-playlist feature
  - plugins/plg-cactus-channel.zip - provide video-channel feature
  - plugins/plg-mashmenu.zip - A (premium) plugin which displays menu in different way
  - plugins/plg-advance-search-form.zip - A (premium) plugin which adds more features to default search form
  - plugins/plg-revslider.zip - The amazing (premium) Revolution Slider which creates beautiful image sliders for your website.
  - plugins/jw-player-plugin-for-wordpress.zip - (not-supported) JW Player for WordPress
- Sample Data Folder - contains sample data files
  - TrueMag-data.xml All Data
  - TrueMag-themeoptions-settings.txt Theme Options Settings
  - TrueMag-revslider-home.zip Sampple Revolution Slider

Step 1. Log into your WordPress Admin area.
Step 2. Look down the left hand column for “Appearance” and then click on the word “Themes”.
Step 3. In the "Themes" page, click “Install Themes”
Step 4. In the "Install Themes" page, click "Upload", then click “Browse” to browse for the theme installation file in [path-to-your-downloaded-package]/Installation File/TrueMag.zip). Click "Install Now".
Step 5. After installed successfully, click "Activate" to make the theme active
Step 6. Install optional plugins if needed. The four included plugins are optional, but we recommend to install at least TrueMag Shortcodes and TrueMag Movie plugin to have full features. Navigate to Plugins > Add New to install and activate plugins. Besides, we recommend using these extra plugins (free). All has been tested and used on our demo page

- Custom Sidebar - Allows to create your own widgetized areas and custom sidebars, and select what sidebars to use for each post or page.
- Contact Form 7 - Simple but flexible contact form plugin
- Black Studio TinyMCE Widget - A WYSIWYG widget
- TinyMCE Advanced - Enables advanced features and plugins in TinyMCE, the visual editor in WordPress
- WP PageNavi - Adds a more advanced paging navigation to your WordPress blog
- Category Images - Allows to add image to category

#### 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

#### Manual Update

You can also update new version in traditional way:

1. Deactive current theme by going to Appearance > Themes and activate any other themes such as the default Wordpress 3.8's Twenty Fourteen.
2. Delete older version by clicking on Delete link. Confirm to delete.
3. Update and re-install new version.

All posts and settings will be saved. This is data-safe method.

### Install Sample Data

##### One Click Install

Before starting, there are some notes worth checking:

1. Make sure you have installed all recommended plugins before importing sample data
2. It is better to install sample data on a fresh Wordpress installation. Therefore, you may want to reset your site to default settings. Install and use Wordpress Reset plugin to do that. After installed, go to Tools > Reset
3. The import process may take several minutes due to large data and your server capacity. If your server setting "Max Execution Time" is too low, increase it (as your hosting provider). Please do not close the browser until it finishes. If it fails, you can run this process again until seeing the "Success Message". Demo Images are not installed due to some copyrighted licenses
4. Install Sample Revolution Slider if needed. Go to Revolution Slider, click Import Slider and browse for /Sample-Data/revslider-home.zip in the full download package
5. If you have to run the process more than once, menu items may be duplicated. Just go to Appearance > Menus and edit/delete Main Menu items

Go to Appearance > Theme Options, scroll to bottom, you will see a button Import Sample Data. Click on that and confirm to install sample data. That's all!
Feature Images are just for demo purposes. Do not worry about the image size. Once you replace them with your own images, they will look like our demo page.
Additional step: go to Appearance > Widget, in Home Sidebar, open the first Text widget and enter no-border in Custom Variation field. This will change the style of Testimonial widget in home page.

##### Traditional way to import

Alternatively, you can use traditional way to import data. In /Sample Data/ folder, you can find there are:

- truemag-data.xml All Data
- themeoptions-settings.txt Theme Options Settings
- revslider-home.zip Sample Revolution Slider
- widget_data.json Widget configuration

To install sample data as seen on our demo page, following these steps
Step 0. Make sure you have installed TrueMag 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 on Activate Plugin & Run Importer
Step 4. Browse for [path-to-your-downloaded-package]/Installation File/Sample Data/TrueMag-data.xml 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/widget_data.json file
Step 11. Go to Option Tree > Settings > Import and paste content of Sample-Data/theme-options.txt into Theme Options text field, then click Import Theme Options button.
Step 12. OK, done!

### How To Create Menu

Three are three menu locations in theme:

- Primary Menu
- Footer Menu

In which, you can turn on Mega Menu feature for Primary Menu (beside the Multi-Level Dropdown Menus style) in Theme Options > Main Navigation > Enable MegaMenu > ON. Mega Menu has 3 sub-level-menu styles including List Style, Column Style and Preview Mode. Please check next sections to see how to configure the Mega Menu.
If you have imported demo content, follow Existing Menu or else follow Creating a New Menu to create a new menu.

#### Existing Menu

1. Go to Appearance > Menus
2. In the Manage Locations area, under Main Navigation, select menu for Primary Menu, Secondary Menu or Footer Menu. Click Save

#### Creating a New 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.

4. If you would like to use this menu in navigation, in the Manage Locations area, assign your newly created menu to Primary Menu, Secondary Menu or Footer Menu. Click Save

5. Click Save Menu and that is all

### Mega Menu

To turn on Mega Menu mode for main navigation, go to Theme Options > Main Navigation > Enable MegaMenu and choose ON, then go to Appearance > Menus to configure the menu structure. Mega Menu can contain three sub-menu styles: List Style, Column Style and Preview Mode

#### Column Style

Column Style is a multi-column style menu to display menu items (such as posts, pages, categories) and widgets like in below figure

1. Column Style MUST HAVE Level 0, Level 1 (also called Heading of Column), and Level 2 menu items.
2. Click on a Level 0 menu item and select Column Style in Menu Style (Menu Style is only displayed for Menu Level 0)
3. To put a widget into a column, (widget is only put into Level 1), prepare a sidebar to contain widgets first. It is recommdended to use Custom Sidebar plugin to register new sidebar for this purpose. Then, drag widgets that you want to display in menu into the new Sidebar.
   After widgets are set up, go back Menus and click on a Level 1 menu item. Choose sidebar in Display widgets area.

   Note: Display widgets area is only displayed in Menu Level 1

4. You can configure Display Logic option to control the appearance of this menu item
   - 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
5. Click save

#### List Style

List Style is the traditional dropdown-menu style.

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

1. Add Menu Level 0, Level 1... normally 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)
3. You can configure Display Logic option to control the appearance of this menu item
   - 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

#### Preview Mode

The Preview mode looks like below figure. In this mode, visitors will see latest posts in a category or a tag

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)
3. You can configure Display Logic option to control the appearance of this menu item
   - 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

### Theme Options

TrueMag comes with a lot of options to help you totally customize the look & feel of your site. Go to Appearance > Theme Options to configure.
There are settings for General, Colors, Fonts, Main Navigation, Front Page, Single Post/Video, Single Page, Blog, Category, Headline Section, Search, 404, Advertising, Social Account, Social Sharing and Theme Update. It is quite straight-forward to learn the use of these sections

### Shortcodes & Visual Composer

When TrueMag-Shortcodes plugin is installed, you will get Visual Composer mode and a full list of shortcodes. Visual Composer is a great plugin which helps you to visually build page layout. You can find full documentation of Visual Composer in [Documentation\Visual Composer] folder
TrueMag has a great bunch of built-in shortcodes. Below is list of TrueMag shortcodes:

- 1. Smart Content Box
- 2. Carousel
- 3. Member
- 4. Icon Box
- 5. Headline
- 6. Testimonial
- 7. Alert
- 8. CheckList
- 9. Button
- 10. Tooltip
- 11. Dropcap

## Smart Content Box

## Carousel

## Member (Available when CT-Member plugin is installed)

##

## Icon Box

##

## Headline

## Testimonial

## Alert

## CheckList

Checklist can be added using classic editor (OR you can add a text box shortcode to a row by using Visual Composer)
Step 1: In classic editor panel, use checklist button to add checklist shortcode. There are 2 types of checklist shortcode for you. (See image bellow)
After step 1, you will have the code for checklist as
[checklist id="checklist_6" icon="icon-check"][/checklist]
Step 2: Add Content by using ul tag (see image bellow)

## Button

## Tooltip

## Dropcap

Update soon...

### How to use Smart Content Box

Step 1: Go to Pages → Add New → Backend Editor to configure, After that choose “Add element”

Step 2: Go to Smart Content Box

Step 3: Enter values for the following parameters:

- Title: Describes a category of names
- Layout: There are 5 settings of layout. You can one of these types of layout to display posts

  • Grid: Displays posts according to in form of grid, just shows images without description

  • Small carousel: Lists all of the descriptive images of posts
  • Medium carousel: Displays descriptive images above and descriptive texts below
  • Medium carousel with Navigation: Displays images and the title of posts in the form of sliding posts
  • Single: Displays as single image text on the left and the description on the right

- Column
- Row
- Condition

  • Latest: Shows the latest posts
  • Most Viewed: Shows the most viewed posts
  • Most Liked: Shows the most liked posts
  • Most commented: Shows the most commented posts
  • Title: Order by title alphabetically
  • Modified: Ordered by the last modified date
  • Random: Shows the posts randomly

- IDs
- Number of Slides
- Categories: To choose portfolio of posts and displays
- Tags: To fill in the tags of posts
- Orderby: Arranges posts in order of ascending or descending
- Url-viewall: Inserts your links to the affiliate of any sites
- Label for Url-viewall
- Show title: Displays the post’s title
- Show excerpt: Displays the post’s excerpt
- Rating Value: Displays rating value when you vote for the post
- Show Duration: Displays the duration of post
- Show view count: Displays the number of viewers, one click is considered as one view
- Show comment count: Displays the number of viewers’ comments
- Show like count: Displays the number of viewers’ like
- Show author: Only uses for Medium carousel and Single style
- Show date: Only uses for Medium carousel and Single style
- Number of excerpt to show
- Enable Quick view info: Quick View Info / Quick View Video Hover Popup

### Setting HomePage & Blog

If you haven't installed sample data, then you can follow this section. When first installed, your home page is blog page. To set up home page, follow the steps below
Step 1. Create a page named Home Page (or whatever you like). Go to Pages > Add New.
Step 2. Disable Comments on this page
If you do not see Discussion box, click on Screen Options grips on top of page and check Discussion
Step 3. Build content of home page using shortcodes and other elements
Step 4. Go to Appearance > Theme Options > Front Page. In this tab, you set-up Header Style for Home Page Header and other conditions to query items for Header
Step 5. Go to Settings > Reading and set Front page displays to A static page. Then set Front Page to the page you created in previous step (Home Page)

##### To set up blog, follow the steps below

Step 1. Create a page named Blog (or whatever you like)
Step 2. Go to Settings > Reading and set Front page displays to A static page. Then set appropriate Posts Page to the page you created in previous step (Blog)
Step 3. Go to Appearance > Theme Options > Blog to configure your blog page.
Step 4. Go to Appearance > Widgets and drag widgets to Main Sidebar or Blog Sidebar if Blog Layout is set to Sidebar Left or Sidebar Right layout in previous step.
If there is any widget in Blog Sidebar, it will be used in stead of Main Sidebar

### Configure Header Style

There are two ways to configure Header Style

- Configure in Pages
- Configure in Theme Options if you choose Hesder Style to be Default

Use Header Slyle with the following options

#### Configure Header Style with Big Carousel

You need to follow these steps:

- Step 1: Go to Pages > Add New Page. In Template box, choose "Front Page" and choose "Big Carousel" in Header Style box and save.
- Step 2: If you want that page to be Homepage, go to Settings > Reading > A Static Page > select Front Page.

#### Configure Header Style with Sidebar (Boxed Carousel)

You need to follow these steps:

- Step 1: Go to Pages > Add New Page. In Template box, choose "Front Page" and choose "Sidebar" in Header Style box.
- Step 2: Go to Appearance > Widgets > Drag widget name "Text" or "Visual Editor"(If possible) in "Main Top Sidebar". enter HTML code in widget "Text" or use "Smart Content Box" in widget "Visual Editor" and save it.
- Step 3: If you want that page to be Homepage, go to Settings > Reading > A Static Page > select Front Page.

#### Configure Header Slyle with Sidebar (FullWidth Carousel)

You need to follow these steps:

- Step 1: Go to Pages > Add New Page. In Template box, choose "Front Page" and choose "Sidebar" in Header Style box.
- Step 2: Go to Appearance > Widgets > Drag widget name "Text" or "Visual Editor"(If possible) in "Main Top Sidebar". enter HTML code in widget "Text" or use "Smart Content Box" in widget "Visual Editor" and save it.
- Step 3: If you want that page to be Homepage, go to Settings > Reading > A Static Page > select Front Page.

#### Configure Header Slyle with Metro Carousel (Metro Slider)

You need to follow these steps:

- Step 1: Go to Pages > Add New Page. In Template box, choose "Front Page" and choose "Metro Carousel" in Header Style box and save.
- Step 2: If you want that page to be Homepage, go to Settings > Reading > A Static Page > select Front Page.

#### Configure Header Slyle with Siderbar use Revolution Slider

You need to follow these steps:

- Step 1: Go to Pages > Add New Page. In Template box, choose "Front Page" and choose "Sidebar" in Header Style box.
- Step 2: Go to Appearance > Widgets > Drag widget named "Revolution Slider" in "Main Top Sidebar". Select a slider in this widget and save it.
- Step 3: If you want that page to be Homepage, go to Settings > Reading > A Static Page > select Front Page.

#### Configure Header Slyle with Classy Slider 2(Horizon)

You need to follow these steps:

- Step 1: Go to Pages > Add New Page. In Template box, choose "Front Page" and choose "Classy Slider 2(Horizon)" in Header Style box and save.
- Step 2: If you want that page to be Homepage, go to Settings > Reading > A Static Page > select Front Page.

#### Configure Header Slyle with Classy Slider 3(Horizon & Big Image)

You need to follow these steps:

- Step 1: Go to Pages > Add New Page. In Template box, choose "Front Page" and choose "Classy Slider 3(Horizon & Big Image)" in Header Style box and save.
- Step 2: If you want that page to be Homepage, go to Settings > Reading > A Static Page > select Front Page.

#### Configure Header Slyle with Video Slider

You need to follow these steps:

- Step 1: Go to Pages > Add New Page. In Template box, choose "Front Page" and choose "Video Slider" in Header Style box and save.
- Step 2: If you want that page to be Homepage, go to Settings > Reading > A Static Page > select Front Page.

#### Configure Header Slyle with Classy Slider( Vertical)

You need to follow these steps:

- Step 1: Go to Pages > Add New Page. In Template box, choose "Front Page" and choose "Classy Slider( Vertical)" in Header Style box and save.
- Step 2: If you want that page to be Homepage, go to Settings > Reading > A Static Page > select Front Page.

#### Configure Header Slyle with Amazing Slider

You need to follow these steps:

- Step 1: Go to Pages > Add New Page. In Template box, choose "Front Page" and choose "Amazing Slider" in Header Style box and save.
- Step 2: If you want that page to be Homepage, go to Settings > Reading > A Static Page > select Front Page.

#### Configure Header Slyle with HomePage Photo

You need to follow these steps:

- Step 1: Go to Pages > Add New Page. In Template box, choose "Front Page" and choose "Sidebar" in Header Style box.
- Step 2: Go to Appearance > Widgets > Drag widget named "Text" in "Main Top Sidebar". enter HTML code in widget "Text" and save it.
- Step 3: If you want that page to be Homepage, go to Settings > Reading > A Static Page > select Front Page.

#### Configure Header Slyle with Light Version

You need to follow these steps:

- Step 1: Go to Pages > Add New Page. In Template box, choose "Front Page" and choose "Big Carousel" in Header Style box and save.
- Step 2: Go to Appearance > Theme Options > Main Navigation choose Dark in Top Navigation Style
- Step 3: If you want that page to be Homepage, go to Settings > Reading > A Static Page > select Front Page.

### Theme Purpose: Video theme-mode and Magazine theme-mode

TrueMag can work as a video site or magazine site. Go to Appearance > Theme Options > General > Theme Purpose to change this mode. All "Videos" text will be replaced by "Posts" and vice-versa. The most different thing between these two modes is when you use Page Template, Smart Content Box shortcode and the Category-Top Carousel in Category page. See below figures:

##### Blog Listing

##### Video/Grid Listing

Style of main Posts Page can be set in Appearance > Theme Options > Blog. If you have Page Template to display posts, note that:

- In Video theme-mode: Video/Grid Listing template only displays video (post-format) posts and Blog Listing template only displays the other post-format posts (Standard, Gallery and Audio).
- In Magazine theme-mode: Both Video/Grid Listing and Blog Listing template display all kind of post-formats (Standard, Video, Gallery, and Audio)

Same thing applies to Smart Content Box (SCB) shortcode. In Video theme-mode, SCB shortcode and Category-Top Carousel only display video (post-format) posts. In Magazine theme-mode, they display everything (Standard, Video, Gallery and Audio)
See next section, Pages & Posts, for Page Template.

### Category Page

Category Page can be in Blog Listing or Video/Grid Listing mode (see Theme Purpose. When adding/editing category, you can choose Category Layout as "Default" (use setting in Theme Options), "Video/Grid Listing" or "Blog Listing". You can also control Category Header Style using numberous options in Category Edit page. It is required to install Category Images plugin first
There are 4 options for Category Header Style: Default (use setting in Theme Options), Carousel (show most popular posts in category), Banner Image (use uploaded image) and Do Not Show (hide header). You can also set Height and Link for Header.

##### Carousel Header

##### Banner Header

### Pages & Posts (Videos)

Before reading next, see document for Visual Composer to learn how to use Rows & Columns to build page!
Although common settings for Pages can be done in Appearance > Theme Options > Single Page & Single Post/Video, each page/post can have its specific settings.
When adding new page, there are 2 sections to setup: Page Attributes & Page Settings

##### Page Attributes

Choose Page Template for this Page. There are 4 templates available

- Default Template Page will have the same layout which is set in Appearance > Theme Options > Single Page
- Front Page Page will have layout of Home Page
- Full Width (no-sidebar) Page will be full width. There is no column for sidebar
- Left Sidebar Page will have left sidebar column. Go to Appearance > Widgets and drag widgets to Main Sidebar. The width-ratio between main column and sidebar column is defined in Theme Options > General
- Right Sidebar Page will have right sidebar column. Go to Appearance > Widgets and drag widgets to Main Sidebar. The width-ratio between main column and sidebar column is defined in Theme Options > General
- Blog Listing If you choose this template, page will display all posts (in Magazine theme-mode) or all non-video posts (in Video theme-mode) in listing-style layout
- Video Listing If you choose this template, page will display all posts (in Magazine theme-mode) or all video-format posts (in Video theme-mode) in grid-style layout

##### Page Settings

- Header Style This setting is effective when Page Template is Front Page

##### Post Format

TrueMag supports Standard, Video, Gallery and Audio Post Format

##### Post Settings

- Video URL Paste Video URL from YouTube, Vimeo or may other video networks (like Dribbble) here. Feature Image, Title, Description and Duration of video will automatically be fetched (YouTube & Vimeo supported), so you don't need to enter these information. After fetching, you can edit these information or choose not to fetch again by checking Do Not Fetch checkbox
- Video File If you self-host video files, enter video file URL here
- Video Code For other video networks, you can use embed code, such as <object>, <embed>, <iframe>
- Duration is the duration of video, in minutes
- Video Layout Video Player can be full width (Full Width layout) and in left column (Inboxed layout)
- Page Layout If this is set to Default, it follows setting in Appearance > Theme Options > Single Post/Video > Single Post Layout. If set (other than Default), it will override default setting

### TrueMag Rating plugin

TrueMag recommends Taqyeem - WordPress Review Plugin. This is a great plugin to add rating feature to your website. If you just like a simple (but useful) alternative, TrueMag Rating plugin is a choice (free, packed with TrueMag). You will find it in /Installation Files/Plugins/plg-truemag-rating.zip. Once installed, there is a setting page for it in admin
Once you have set some default things here, in Post editing page, you will see Review where you can configure more settings or override default settings
Here is the final results: the rating meta box for a post

### Cactus Channel plugin

#### Channel Management

Added since True Mag 4.0, Cactus Channel plugin adds the ability to create videos channel and playlist for administrator. Registered Users can subscribe favourite channels to follow the latest videos in specific categories. A channel can contain multiple videos and playlists. A playlist in turn can contain multiple videos. To have playlist feature, please update "Cactus-Video" plugin to the latest version. Below is a screenshot of a sample channel

To create a new channel, from main admin navigation, go to Channel > Add New Channel. To add a video to a channel, edit that video post and assign a channel for the post. Similarly, to add a playlist to a channel, edit the playlist and assign a channel for the playlist

To enable/disable discussion for a channel, uncheck the "Allow Comments" checkbox in "Discussion" box in Channel Edit page (if you do not see the "Discussion" box, scroll to top of the page and click on "Screen Options" button, then check the "Discusson" checkbox in the opening panel)

#### Channel Subscription - "Subscribed Channels" page template

Registered Users are able to subscribe a channel to follow latest videos in that channel. To create a Subscribed Channels page, go to Pages > Add New Page and choose Subscribed Channels page template. Name this page anything you want. Note that this page can only be accessed by logged-in users. When an user visits this page, he/she will see latest videos from their subscribed channels

Now go to Menus management page and add a menu item that links to that page. Use Display Logic to make this menu item Only visible to Members

#### Channel Settings

From main admin navigation, go to Cactus Channel Settings

- Channel Slug

  Change single Channel slug. Remember to save the permalink settings again in Settings > Permalinks

- Channel Listing page

  Assign Channel Listing page to a page. By default, if the Channel Slug is channel, the Channel Listing page will be http://yoursite.com/channel. If you create a page with slug all-channels and set this option to that page, the Channel Listing page will be http://yoursite.com/all-channels. Remember to save the permalink settings again in Settings > Permalinks

- Single Channel Sidebar

  Select sidebar position for all single channel pages

### Video Playlist

#### Video Playlist Management

Added since True Mag 4.0 (True Mag - Playlist plugin), administrators are now able create video playlists. A playlist is a collection of videos which allow users to view all at once (in a video slider). To create a playlist, from main admin navigation, go to Playlist > Add New Playlist.

Below is a screenshot of a sample playlist

To add a video to a playlist, edit that video post and assign a playlist for the post.

A playlist may or may not belong to a Video Channel (require Cactus Channel plugin to be installed). To add a playlist to a channel, edit that playlist and assign a channel for it

When viewing a video post which belongs to a playlist, the post layout turns into playlist layout

#### Video Playlist Settings

From main admin navigation, go to Cactus Playlist Settings page.

- Playlist Slug

  Change single playlist slug. Remember to save the permalink settings again in Settings > Permalinks

- Single Playlist Sidebar

  Assign Playlist Listing page to a page. By default, if the Playlist Slug is playlist, the Playlist Listing page will be http://yoursite.com/playlist. If you create a page with slug all-playlists and set this option to that page, the Playlist Listing page will be http://yoursite.com/all-playlists. Remember to save the permalink settings again in Settings > Permalinks

- Single Channel Sidebar

  Select sidebar position for all single playlist pages

### Other Features

#### Advertising Spaces

You can add advertising spaces (Google Adsense banners, text ads OR your own banners) to, basically, everywhere on this theme beside 6 pre-defined ad spaces (Top ads 1, Top ads 2, Body ads 1, Body ads 2, Foot ads, Recuring ads). To add Ads in predefining positions, you need to set in Appearance > Theme Options > Advertising with the following attributes

- Google AdSense Publisher ID: Enter your Google AdSense Publisher ID
- Top Ads 1 - AdSense Ad Slot ID: If you want to display Adsense in Top Ads 1 section, enter Google AdSense Ad Slot ID here. If left empty, "Top Ads 1 - Custom Code” will be used.
- Top Ads 1 - Custom Code: Enter custom code for Top Ads 1 position.
- Top Ads 2 - AdSense Ad Slot ID: If you want to display Adsense in Top Ads 2 section, enter Google AdSense Ad Slot ID here. If left empty, "Top Ads 2 - Custom Code” will be used.
- Top Ads 2 - Custom Code: Enter custom code for Top Ads 2 position.
- Body Ads 1 - AdSense Ad Slot ID: If you want to display Adsense in Body Ads 1 section, enter Google AdSense Ad Slot ID here. If left empty, "Body Ads 1 - Custom Code” will be used.
- Body Ads 1 - Custom Code: Enter custom code for Body Ads 1 position.
- Body Ads 2 - AdSense Ad Slot ID: If you want to display Adsense in Body Ads 2 section, enter Google AdSense Ad Slot ID here. If left empty, "Body Ads 2 - Custom Code” will be used.
- Body Ads 2 - Custom Code: Enter custom code for Body Ads 2 position
- Foot Ads - AdSense Ad Slot ID: If you want to display Adsense in Foot Ads section, enter Google AdSense Ad Slot ID here. If left empty, "Foot Ads - Custom Code” will be used.
- Foot Ads - Custom Code: Enter custom code for Foot Ads position.
- Recuring Ads - AdSense Ad Slot ID: If you want to display Adsense in Recuring Ads section, enter Google AdSense Ad Slot ID here. If left empty, "Recuring Ads - Custom Code” will be used
- Recuring Ads- Custom Code: Enter custom code for Recuring Ads position. This Ad will appear after each Ajax paginated-page in blog listing, categories or search result pages.
- Single Content Ads - AdSense Ad Slot ID: If you want to display Adsense in Single Content Ads section, enter Google AdSense Ad Slot ID here. If left empty, "Single Content Ads - Custom Code” will be used
- Single Content Ads - Custom Code: Enter custom code for Single Content Ads position.
- Left Side Ads - AdSense Ad Slot ID: If you want to display Adsense in Left Side Ads section, enter Google AdSense Ad Slot ID here. If left empty, "Left Side Ads - Custom Code” will be used.
- Left Side Ads - Custom Code: Enter custom code for Left Side Ads position.
- Right Side Ads - AdSense Ad Slot ID: If you want to display Adsense in Right Side Ads section, enter Google AdSense Ad Slot ID here. If left empty, "Right Side Ads - Custom Code” will be used.
- Right Side Ads - Custom Code: Enter custom code for Right Side Ads position.
- Side Ads Width: Enter your side ads (Left & Right) width (Ex: 100px)

#### Advanced Search Form

Truemag package includes premium plugin Advanced Search Form (ASF). The installation file is in /Installation Files/Plugins/plg-advanced-search-form.zip. Following these steps to integrate the ASF into TrueMag:

- Step 1. Install ASF plugin
- Step 2. Go to Appearance > Widgets and drag Advance Search Form widget into Search Box sidebar. Check "Show categories list" and "Search suggestion" checboxes. Leave "Title" empty.
- Step 3. If you would like to configure advance things, go to ASF Settings page (look for menu item in the left).

#### Headline section

By default (first installed), Headline section will be displayed on top of page (below Logo). Configuration for Headline is done in Appearance > Theme Options > Headline Section.
If you want to replace this section, go to Appearance > Widgets and drag other widget into Headline sidebar. Note that Headline Section and Headline Sidebar is displayed only in Home Page.

#### Breadcrumb / Pathway

Breadcrumb (or Pathway) is displayed only in inner pages (not Home Page). If you want to replace default breadcrumb, go to Appearance > Widgets and drag something into Pathway sidebar

#### Favourite Videos - User Playlist

Check this demo: Playlist Demo. To enable playlist feature, you will need to install WP Favorite Posts. Note that Playlist feature only works with BuddyPress enabled.
You can then configure Playlist settings in Appearance > Theme Options > BuddyPress

#### Google Adsense

There are several default positions for using Google Adsense in TrueMag. It is set up in Theme Options > Advertising. You can, however, add Google Adsense in any places using the following shortcode

    [adsense pub="" slot="" class=""]

pub is Publisher ID
slot is Slot ID
class (optional) is CSS Class that you want to assign to the adsense box

#### User Submit Post

This feature requires Contact Form 7 plugin to work. To configure this feature:

- 1. Create a contact form with fields having these names:
  - video-title
  - video-description
  - video-url
  - video-excerpt
  - tag
  Use shortcode [category] to display list of categories so users can choose which category to submit. Go to Theme Options > User Submit Post for more settings. Below is a sample contact form for this feature
  Please fill in all information bellow to submit video. <p>Your Email<br /> [email* your-email] </p> <p>Video URL<br /> [url* video-url] </p> <p>Video Title<br /> [text* video-title] </p> <p>Video Description<br /> [textarea* video-description] </p> <p>Tags<br /> [text* tag] </p><br> <p>Categories<br /> [category] </p><br> <p>[submit "SUBMIT"]</p>
- 2. Copy the contact form shortcode, for example [contact-form-7 id="325" title="Suggest video"]. 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 > User Submit Video, change Enable User Submit Video Feature to Enable. You can configure other settings here also.
- 4. If you want to send an mail (to users) to notify about the acceptance of the submited video, please Enable the feature Notification in Theme Options > User Submit Video

#### How to use Video Ads Management 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

##### Create a Video Ads Management

Go to Advs > Add New
Include the following attributes

- Upload Fields - Choose the form of advertisement to be banner or video and configure the advertising's position
  - File advanced upload: Upload advertising image or video( These advertising image or video will be displayed when clicking "Play" video in single video page. If you want the advertisement not to be continued running - Click "Skip Ads" and the main video of Post will be run)
  - Video url: Enter URL from YouTube or Vimeo

  Note:These advertising image or video will be displayed above video of single video page. When clicking "Play" to see video, the advertisement will appear and automatically run. After number of seconds, "Skip Ads" button will be appeared. When clicking this button, the advertisement will be stopped and the main video of Single video page will be played. If you do not click "Skip Ads" button, the advertisement will completely run, then automatically move to the main video. If Ads is added in two positions File Advanced Upload and Video URL, it will show File Advanced Upload, not show video Ads in Video URL

  - Expiry date: Expiration date of the advertisement
  - URL: Appear link when clicking the advertisement
  - URL Target: Open advertisement's link at the new window or the current window
  - Position: Advertisement's position

##### Video Ads Configuration

Go to Ads Config

1. General - Configure to turn on/turn off, duration for displaying the advertisement
   - Enable Ads: Turn on/Turn off the advertisement
   - Show close button after: Display "Turn off Ads" button after the number of seconds you want
   - Ads play again after: The advertisement will automatically run after the number of seconds you want
   - Close Button Position: The position of "Turn off Ads" button
2. Brand - Ads Logo is located above video player
   - Enable Brand: Turn on/ Turn off Ads Logo
   - Upload Logo: Upload Ads Logo
   - Ads Text: Logo in form of text will be shown when there is no logo image
   - Position: Logo's position
   - Opacity: The opacity of logo in form of text
   - Text color: Choose color for logo in form of text

##### Assign a Video/Image Ads into Single Post Page

Step 1: Go to Posts > Add New/ Edit post > Video Ads
Step 2: Enter ID in Ads ID, if leave ID empty, ads will be selected randomly from the active Advs
Step 3: click Publish and save

##### Bulk Set Ads ID

This feature allows admin to set an Ads ID to all posts. Go to Cactus-Video Ads > Bulk Set Ads ID and enter Ads ID in the textfield. That's all

#### OnePress Social Locker Plugin

OnePress Social Locker Plugin is a plugin used to hide a portion of page's content. The text will be displayed when users "Like, Share" or use Google plus for that text
There are two versions in OnePress Social Locker plugin: https://wordpress.org/plugins/social-locker/ (free) and http://codecanyon.net/item/social-locker-for-wordpress/3667715(premium)

##### Learn More about Social Locker Plugin

The Social Locker plugin allows you to use shortcodes in order to lock content. During installation, the plugin created for you the shortcode [sociallocker] named "Default Locker".

You can create shortcodes for whatever you need them for. For instance, you could create one for locking video players or another one for locking download links. Each shortcode has its own settings.

Let's examine how to use the Default Locker.

1. Open the editor
   Move to Social Locker -> All Social Locker in the admin menu
   Click on the shortcode titled “Default Locker” to open the locker editor
2. Configure the locker
   - Set the URL that will receive likes/tweets/plus ones or leave the field empty.
   - Set a clear title that attracts attention or creates a call to action (see the example below).
   - Describe what the visitor will get after they unlock the content. This is very important, as visitors need to be aware of what they are getting. And please, only promise things you can deliver.
     Congratulations! The locker is ready to use.
3. Place the locker shortcode
   Decide what content you would like to lock. It might be:
   - A download link (for instance, a free graphic, an audio file, video resources, or a printable pdf of your article).
   - A promo code (for instance, a 10% off discount, if the visitor shares your promo page).
   - The end of your article (for instance, you might show the beginning of the article to gain interest, but hide the ending).
   Basically, you can hide any content that would be important for visitors who are visiting your site.
   However, you should never:
   - Lock all of your content, posts or pages.
   - Lock boring content or content that is not interesting.
   In other words, don’t try to trick your visitors. If you do, people will become annoyed and will remove the likes/tweets/+1s after unlocking your content, which will not have the desired result.
   Open the post editor for the post where you want to put the locker. Then wrap the content you want to lock within the locker shortcode. For instance: [sociallocker] Locked Content Goes Here [/sociallocker]:
   That’s it! Save your post and see it on your site!

##### OnePress Social Locker is compatible with TrueMag in a Single Post page

In order to clock video player in a page, go to Posts > Edit post you want to remove, enter Locker's shortcode into box Social Locker Shortcode
This shortcode can be found in Shortcode column in a list of Lockers management

##### OnePress Social Locker is compatible with TrueMag in all Single Post pages

In order to clock the entire content of video in header at all single pages, follow these steps below
Step 1: Go to Social Locker > Alockers > New Locker - Create Social Locker with the following attributes

- URL to share: Enter the URL that you want your visitors to like, tweet or +1. Or, you can leave this field empty to use the URL of the page where the locker is located. Need a separate URL for each button, try a premium version of the plugin.
- Locker header: Type a header which attracts attention or calls to action. You can leave this field empty
- Locker message: Type a message which will appear under the header. Shortcodes: [post_title], [post_url]

Step 2: Create a Locker (a Default Locker is often made available)
Step 3: Press Setup Batch Lock, choose tab CSS Selector and enter the value #player-embed
Step 4: Click Update and save

#### Conditional Code for Video Player

This feature allows admin to control the apperance of video player using a condition (PHP) code or a shortcode. An alternative content will appear to replace the video player until the contional code returns true.
In order to use this feature, follow these steps:

- Step 1: Go to Posts > Add new/Edit post > Player Logic
- Step 2: Enter shortcode ( for example: [my_shortcode][player][/my_shortcode], [player] is required]) or condition function (ex: is_user_logged_in() && is_sticky() ) to control video player visiblitily in Player logic. Content in Alternative Content field will appear when the condition function return false
- Step 3: Save

For Example: enter with the following shortcode into Player Logic
[scb layout="small_carousel" column="6" row="1" condition="latest" order="DESC" show_title="1" show_excerpt="1" show_rate="1" show_dur="1" show_view="1" show_com="1" show_like="1" show_aut="1" show_date="1" quick_view="def" categories="5" count="2"][player][/scb]
The result is as follows

#### Multi Links

Its main function is to create alternative links for a video post, so users can choose to view the video using one of available links. When a link is clicked, it will directly run in the player. Fill the following properties for Multi Links box:

- Group Title: Create title for Group
- Links: Enter your videos link and title. Enter one per line.
  For Example:
  Trailer 1 http://www.youtube.com/watch?v=nTDNLUzjkpg Trailer 2 http://www.youtube.com/watch?v=nTDNLUzjkpg
  This is how it appears in front-end

#### Movie Series

Its main function is to create a list of videos which belong to a same series.

1. Go to Theme Options > Video Series > Enable Video Series > ON
2. Go to Posts > Series
3. Create a new Series, then enter some information and save it
4. Go to Posts > Add New to create a post and then choose Series for Post
5. Create a Series page by going to Menus > Series > Choose a series > Add to Menu
   Note: If Series is not displayed in the left box, go to Screen Options > Series to activate this feature
6. Save Menu

Note 1: In order to configure Video Series, go to Theme Options > Video Series and configure the settings:

- Series Header Style - Choose Series header style, including styles: Playlist, Baner Image, Do not show
- Series Listing Style - Select style for listing, including styles: Video listing (Grid), Blog listing
- Video Series Slug - Give a name for Video Series slug. After saving, go to Settings > Permalinks and re-save the settings

Note 2: For single video post of a same Series, related video posts in the same series will be displayed under the video player
Note 3: Use Series shortcode: go to Pages > Add New Page > Backend Editor > Add Element > Series or enter with code follow
[movie-series series='' count='' ids='']
properties

- series: Enter Video Series ID or Slug, videos located in a Series will be displayed
- ids: Enter specific post IDs to display (ex: 6,9,18), Series video according to the specific posts will be displayed
- count: Enter the number of posts, only the number of videos you entered will be displayed (Leave blank to display all)

#### Report Video

Added since TrueMag 4.2.3. This feature requires Contact Form 7 plugin to work. To configure this feature:

- 1. Create a contact form with fields having these names:
  - your-email
  - your-message
  Please fill in all information bellow to report video. [report_url] <p>Your Email<br /> [email* your-email default:user_email] </p> <p>Please tell us why do you think this video is inappropriate<br /> [textarea* your-message] </p> <p>[submit "Send"]</p>
- 2. Get the form ID, for example in this form shortcode, [contact-form-7 id="2236" title="Report video"], form ID is 2236. Go to Appearance > Theme Options > Single Post/Video, change Enable Video Report to Enable. Paste the form ID into "Video Report Form ID".
- 3. Go to Reports to see a list of reports.

#### Export Video Sitemap

TrueMag 3.2.5 added Video Sitemap Export feature. To export sitemap, go to Pages > Add New and choose Video - Sitemap template. Give the page a name (slug), for example "video-sitemap", then save it. Now you can save Video Sitemap by going to that URL "http://yourdomain.com/video-sitemap"

If you have a lot of videos, the full sitemap may be two long. To prevent this, edit the Video - Sitemap page template and scroll to Video Sitemap Settings box. Set the value for Export Video From and Number of Videos to truncate the full sitemap into smaller files.

#### VIDEO YOUTUBE V3 API

This feature allows to retrieve the data automatically including title, pictures and content from YouTube when admin add/save a post. Since April 2015, it is required to have a Google API key. Please see instructions on how to get the key here: https://developers.google.com/youtube/registering_an_application
In order to use this feature, follow these steps:

- Step 1: Go to Theme Options > Single Post/ Video > Google API Key
- Step 2: Enter the Google API Key. How to get your YouTube API key, please refer documentation here
- Step 3: Save

For Example: When adding a post, enter YouTube Video URL to this field: Video URL of Post Settings
The result is as follows

#### How to use Kaltura video

TrueMag supports for videos from http://videos.kaltura.com. In order to use videos from Kaltura, follow this instruction below

1. For Kaltura's public videos
   - Go to http://videos.kaltura.com/ page
   - Click choose a video
   - Click the icon Share at the right corner of video
   - Copy video's embed code
   - Paste this code into Post's Video Code(Posts > Add New > Video Code and enter the embed code here)
   - Click Publish post and save
   - Check the result
2. For Kaltura's private videos
   - First, register an account at http://videos.kaltura.com/ , then upload your own videos
   - Second, install and activate Kaltura All-in-One Video Plugin
   - After plugin is successfully installed, go to Settings > All in one video and declare your account registered at http://videos.kaltura.com/
   - Go to Posts > Add new post > click the Kaltura video icon at format toolbar
   - When the window Add Kaltura Media is appeared, choose tab Browse Existing Media to see the list of medias in your account
   - Click on a video and change some attributes such as video size, types of display player
   - Click Insert into post to add video into post, then click tab Text next to the tab Visual
   - The code segment includes video's ID. Copy video's ID shown as the image below (Note: After ID's video is copied and pasted, please delete this code segment completely to remove the video you have just added. This step is only used to get ID's video)
   - Paste this ID into Video ID and choose Video in Format and Publish post

#### JWPlayer 6 - Video Sub-title

Since True Mag 3.4, you are able to add sub-titles for videos if you use JWPlayer WordPress plugin 6. You will need a sub-title file which looks like this: http://assets-jp.jwpsrv.com/tracks/2UEDrDhv.txt. JWPlayer supports captions in two format:

- WebVTT, a plain text format that's part of the HTML5 standard.
- SRT, a plain text format that's popular amongst file sharers.

To use this feature, go to a video post and find the "Closed Captions" setting box. Upload sub-title files somewhere and then paste the link to Video Caption fields. Each field is for a language

#### JWPlayer 7 - Integration

Since JWPlayer 7, the plugin's author has removed the official WordPress plugin for JWPlayer. We now support the (unofficial) JWPlayer 7 for WordPress

To make it work, make sure you have registered a free account at this link: http://www.ilghera.com/support/topic/jw-player-self-hosted-setup/ and follow the steps

Go to Theme Options > Single Post/Video > JWPlayer version and change to JWPlayer 7

#### WordPress Automatic

When setting up a Campain in WP Automatic, you need to config to add video url to Video URL field, pls follow these steps:

- Step 1: Enable "Add custom fields to the posts" option
- Step 2: Enter Field name: tm_video_url option
- Step 3: Enter Value:[source_link]
- Step 4: Save

### Hooks

True Mag provides some "hooks" that allow developers to customize the theme (using child-theme or plugin)

No. | Name | Purpose | Since | Sample Code
1 | cactus_player_hook | To replace the video player by your own player | 3.2 | In this case, you want to use JWPlayer instead of default video player (True Mag had automatically recognized JWPlayer)
     function jwplayer_hook($player_html, $url, $id_post) {
    		$file = get_post_meta($id_post, 'tm_video_file', true);
    		if($file!=''){
    			if(class_exists('JWP6_Plugin')) {
    				if (JWP6_USE_CUSTOM_SHORTCODE_FILTER)
    					add_filter('tm_video_filter', array('JWP6_Shortcode', 'widget_text_filter'));
    			}
    			if(function_exists('jwplayer_tag_callback')) {
    				add_filter('tm_video_filter', 'jwplayer_tag_callback');
    			}
    			$jwplayer_shortcode = '[jwplayer config="firstplayer" file="'.$file.'" ]';
    			echo apply_filters('tm_video_filter', $jwplayer_shortcode);
    		}else{
    			return $player_html;
    		}
    	}
    	add_filter( 'cactus_player_hook', 'jwplayer_hook',10,3 );

### Translation & RTL

TrueMag is a WMPL-compatible and multi-language ready theme. To translate this theme:

- Download and install this tool POEdit
- Open POEdit and load [/TrueMag/languages/TrueMag.po]
- Translate the text and save the file
- A file named TrueMag.mo is created. 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
- Open [{wordpress root}/wp_config.php] and find this line define('WPLANG', '');. Change it with your language code, for example define('WPLANG', 'de_DE');

TrueMag also supports RTL - Right To Left languages. If your language is RTL, go to Apperance > Theme Options > RTL mode and check Enable RTL

### Licenses

Used Assets

- Revolution Slider (Extended License) - http://codecanyon.net/item/slider-revolution-responsive-wordpress-plugin/2751380
- Visual Composer (Extended License) - http://codecanyon.net/item/visual-composer-for-wordpress/242431
- Option Tree (GPL2 License) by Derek Herman - http://wp.envato.com
- BootStrap (Apache License v2.0) - http://twitter.github.io/bootstrap/
- Font Awesome (GPL License) by Dave Gandy - http://fontawesome.io
- Mobile Detect (MIT License) by Serban Ghita and Victor Stanciu (until v. 1.0) - http://mobiledetect.net
- jQuery Scrollbox by Hunter Wu - http://github.com/wmh/jquery-scrollbox
- Caroufredsel by dev7studios - MIT license http://dev7studios.com/plugins/caroufredsel/
- Hammer by Jorik Tangelder @ Eight Media - MIT license http://eightmedia.github.com/hammer.js

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

### Support

If you face 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/