TrueMag - Videos and Magazine Wordpress Theme

The Documentation

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/ - TrueMag theme
    • plugins/ - A plugin which contains all shortcodes for theme. It contains Visual Composer plugin which helps you visually build pages
    • plugins/ - A plugin which enables Movie feature for theme
    • plugins/ - A plugin which enables Rating feature for theme
    • plugins/ - A plugin which enables Member feature for theme
    • plugins/ - A (premium) plugin which displays menu in different way
    • plugins/ - A (premium) plugin which adds more features to default search form
    • plugins/ - The amazing (premium) Revolution Slider which creates beautiful image sliders for your website.
  • Sample Data Folder - contains sample data files
    • TrueMag-data.xml All Data
    • TrueMag-themeoptions-settings.txt Theme Options Settings
    • 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/ 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

Update TrueMag

TrueMag has a greate auto-update feature:
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/ 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
  • 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!

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:

Smart Content Box


Member (Available when CT-Member plugin is installed)

Icon Box





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

Step 2: Add Content by using ul tag (see image bellow)




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:

Setting Menu

Go to Appearance > Menus to manage menu items. Create a menu and set Theme location to Main Navigation. Create another menu and set Theme locations to Footer Navigation

MashMenu Integration

If you would like to use MashMenu, here are steps to integrate:
  • Step 1. Install MashMenu plugin (find installation file in /Installation Files/Plugins/
  • Step 2. See document for MashMenu here: and setup your menu in Appearance > Menus
  • Step 3. Go to MashMenu Settings page and add this CSS code in Advance CSS field

    In addition, set these values: "Main Color" > 171717; "Hover Color" > 343434; "Channel Title Color" > 2B2B2B

  • Step 4. Go to Theme Options > Main Navigation > Hide Main Navigation > Yes

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

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

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

Other Settings

Advanced Search Form

Gameplan package includes premium plugin Advanced Search Form (ASF). The installation file is in /Installation Files/Plugins/ 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


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. Below is a sample contact form for this feature
  • 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.


More FAQs can be found here

  1. Using Row Background & Padding

    Row (Visual Composer mode) is the most common element you will use when editing a page or post. In TrueMag, Row has been extended to have more properties than default version in Visual Composer. Click on the Pencil icon (as seen in the right figure) to open Row Properties form.
    • Background Image Upload new image or choose from your media library to set up background for Row.
    • Background Color Choose background color for Row.
    • Padding Top Set Top Padding for Row. Default is 30px
    • Padding Bottom Set Bottom Padding for Row. Default is 30px
    • Full width If choose Yes, Padding Left and Right will be set to 0
  2. Using Padding shortcode to create horizontal space

    Padding shortcode is an empty content shortcode which does one thing: set margin top and bottom to create space between elements before and after it. Padding shortcode can be found in both Classic Editor and Visual Composer mode

  3. List of widgets

    Below is the list of built-in TrueMag widgets and additional widgets by plugins
    • TM-Popular Video - Show video (posts) with highest
    • TM-Recent Comments - Show recent comments
    • TM-Related News - Show posts which are related to current post
    • TM-Top Author - Show authors who have the highest number of posts
    • TM-Top Categories - Show list of categories and their post count
    • TM-Trending Videos - Show most liked, viewed posts in a period of time
    • Advance Search Form - Avaible when Advanced Search Form plugin is installed
    • Recently Liked Posts - Show recently liked posts
  4. Different Widgets for different Pages

    This theme has prepared several sidebars for using in different pages.
    Go to Appearance > Widgets
    • Main Sidebar - Used by every pages has Left Sidebar or Right Sidebar layout.
    • Home Sidebar - Used by Front Page or Front Page Template only. If leave empty, Main Sidebar will be used.
    • Main Top Sidebar - Used by Front Page or Front Page Template only
    • Headline Sidebar - Used to replace default Headline section
    • Pathway Sidebar - Used to replace default Pathway
    • Search Box Sidebar - Used to replace default Search Box
    • Footer Sidebar - Used in Footer
    • Footer 404 Page Sidebar - Used in Footer of a 404 page
    • Blog Sidebar - Used in Blog page, Blog Listing Template and Categories with Blog Listing style. If empty, Main Sidebar will be used
    • Video Listing Sidebar - Used in Blog page, Video Listing template and Categories with Video Listing style. If empty, Main Sidebar will be used
    • Single Blog Sidebar - Used in a single Post page
    • Single Video Sidebar - Used in a single Video (post-format) page
    • Search Page Sidebar - Used in Search Result page
    • Single Page Sidebar - Used in a single Page
  5. Custom Sidebar - Unique sidebar for a specific page

    If you want a specific page to have unique sidebar (different from other pages), follow these steps:
    • Install Custom Sidebar (free) plugin
    • Go to Appearance > Custom Sidebars to create new sidebar
    • Go to Appearance > Custom Sidebars, click Edit on the sidebar you have created
    • Enter these parameters
      • Before Title: <h2 class="widget-title maincolor2">
      • After Title: </h2>
      • Before Widget: <div id="%1$s" class="widget widget-border %2$s">
      • Before Title: </div>
    • Go to Appearance > Widget and drag widgets into the sidebar you have created
    • Choose to use that sidebar in post or page you want
  6. Easter Egg - Custom Variation for Widget

    If you want to setup special style for a specific widget, use Custom Variation field to add CSS Class to widgets, then write your custom CSS code somewhere else, for example in style.css or in Appearance > Theme Options > General > Custom CSS text field.

    There are some pre-defined CSS class you can use to style your widgets.
    • no-border - No Border style for widget

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 is created. Rename it with Code Name of your language. For example, for German - Deutsche. See language code list here
  • 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


Used Assets


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


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