GoodNews WordPress Theme

The Documentation


For support please checkout CACTUSTHEME SUPPORT FORUM

GoodNews WordPress Theme


Welcome to GoodNews!

Thanks for Buying

First of all, thank you for buying our theme. We are a team of developers making awesome WordPress Theme- GoodNews- A minimalistic magazine theme with lots of useful, unique and awesome features. It’s perfect for reviews, audio, video for all kinds of news and blog sites. The theme is highly flexible and incredibly easy to use. It is very easy to customize the theme. Both experienced developers and users with no programming background can customize this theme with minimal effort. To make your experience pleasant, we have added as much information as needed in this documentation. If you're stuck with anything, please refer to be supported.

Created By: CactusThemes.com

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

Version: 1.0

GoodNews Layout


Installation


The Main Files 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/goodnews.zip - GoodNews theme
    • plugins/plg-cactus-rating.zip - A plugin which enables Rating feature for theme
    • plugins/plg-visual-composer.zip - Visual Composer plugin, a drag&drop page builder (Premium).
  • Sample Data folder - contain sample data files

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 goodnews.zip to goodnews 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.

Install Sample Data


One+ Click Install

Before starting, It is noted that

  • 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
  • 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
  • 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
  • Feature images are not imported (We use licensed photos on our demo page)

Go to Appearance > Theme Options, scroll to bottom, you will see a button Import Sample Data. Click that button and confirm to install sample data.

Import Manually

Alternatively, you can use traditional way to import data. In /Sample Data/ folder, you can find there are:
  • goodnews.xml All Data
  • theme-options.txt Theme Options Settings
  • goodnews-widgets.wie Widgets Settings
To install sample data as seen on our demo page, following these steps
 
Step 0. Make sure you have installed GoodNews 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]/Installation File/Sample Data/goodnews.xml or goodnews.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 and Top Nav as Secondary Menu
Step 10. Install Widget Settings Importer/Exporter and go to Tools > Widget Settings Import to import Sample-data/goodnews-widgets.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 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) and “Blog”.
  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), and select “Blog” in the second one (for Posts page). Save the changes.

Frontpage Template

GoodNews provides a page template called Front Page to configure special Frontpage (or Home).

  1. Go to Pages > All Pages and edit “Home” page created in previous step
  2. Choose Front Page in Template. The corresponding metadata will appear in the box Front Page Header Settings and Front Page Content in the left.
  3. Configure settings in Front Page Header Settings and Front Page Content boxes. To make it look like our demo page, see our video here
    • Layout settings


      SidebarSelect "Default" to use the settings in Theme Options > Single Page > Sidebar. Otherwise, you can choose “Left” sidebar , “Right” sidebar or no sidebar (“Hidden“)
    • Front Page Header Settings


      Featured Posts Style Choose header style, which can be:
      • Posts Tab
      • Posts Carousel
      • Posts Grid
      • Posts Slider
      Number of postsEnter number of posts to display
      Post categoriesEnter category IDs or slugs to get posts from, separated by a comma
      Post tagsEnter tags to get posts from, separated by a comma
      Post IdsEnter post IDs, separated by a comma.If this parameter is used, other parameters are ignored
      Order by Ordered by the following conditions
      • Post date: Display posts according to published date
      • Random: Display random posts
    • Front Page Content Settings


      Content Choose displaying contents in Body page. In which
      • This Page Content: Display contents in Body page by using shortcodes, html or text to build a page
      • Blog (latest post): Display all posts in form of blog (If you use shortcodes to build a page and also choose this feature, shortcodes'content will not be shown)
      Post categoriesEnter category IDs or slugs to get posts from, separated by a comma (Display appointed posts belonging to categories)
      Post tagsEnter tags to get posts from, separated by a comma (Display appointed posts belonging to tags)
      Post IdsEnter post IDs, separated by a comma. If this parameter is used, other parameters are ignored (Display appointed posts)
      Order byOrdered by the following conditions
      • Post date: Display posts according to published date
      • Random: Display random posts

Widgets


  1. GoodNews - Headline widget
    • Headline Text - Text that appears before item titles
    • Category - Category IDs or slugs to query posts, separated by a comma
    • Tags - Tags to query posts, separated by a comma
    • Post IDs - IDs of posts to display, seperated by a comma. If this parameter is used, other parameters are ignored.
    • Number of headlines - Number of posts to display
  2. GoodNews - Recent Posts Widget
    • Category - Category IDs or slugs to query posts, separated by a comma
    • Tags - Tags to query posts, separated by a comma
    • Post IDs - IDs of posts to display, seperated by a comma. If this parameter is used, other parameters are ignored.
    • Number of posts - Number of posts to display
  3. GoodNews - Posts Tab widget
    • Categories (required) - list of categories ID (or slug), separated by a comma. Order of tab must be the same with order of IDs provided
      • Post type (optional) – default ‘post’
      • post: default post
    • Posts per tab (optional) – default 2 for standard layout, 1 for compact layout
    • Order (optional) – default DESC
      • ASC|DESC
    • Order by (optional) – default DATE
      • 'none' - No order
      • 'ID' - Order by post id. Note the captialization.
      • 'author' - Order by author.
      • 'title' - Order by title.
      • 'name' - Order by post name (post slug).
      • 'date' - Order by date.
      • 'modified' - Order by last modified date.
      • 'parent' - Order by post/page parent id.
      • 'rand' - Random order.
      • 'comment_count' - Order by number of comments
      • 'menu_order' - Order by Page Order. Used most often for Pages (Order field in the Edit Page Attributes box) and for Attachments (the integer fields in the Insert / Upload Media Gallery dialog), but could be used for any post type with distinct 'menu_order' values (they all default to 0).
      • 'meta_value' - Note that a 'meta_key=keyname' must also be present in the query. Note also that the sorting will be alphabetical which is fine for strings (i.e. words), but can be unexpected for numbers (e.g. 1, 3, 34, 4, 56, 6, etc, rather than 1, 3, 4, 6, 34, 56 as you might naturally expect). Use 'meta_value_num' instead for numeric values.
      • 'meta_value_num' - Order by numeric meta value (available with Version 2.8). Also note that a 'meta_key=keyname' must also be present in the query. This value allows for numerical sorting as noted above in 'meta_value'.
      • 'post__in' - Preserve post ID order given in the post__in array
    • Meta key (optional) - name of meta key for ordering
    • Show rating (optional) - default 1/true - show rating of posts. Only available when Rating plugin is installed
      • 1/true
      • 0/false
    • Show social count (optional) - default 1/true - show Likes, Tweets, Shares count
      • 1/true
      • 0/false
    • Show date (optional) – default 1/true - show or hide published date.
      • 1/true
      • 0/false
    • Show category (optional) - default 1/true - show category name of post
      • 1/true
      • 0/false
    • Show comment count (optional) - default 1/true - show number of comments of post
      • 1/true
      • 0/false
  4. GoodNews - Posts Carousel widget
    • Post Type (optional) – default ‘post’
      • post: default post
    • Categories (optional) - list of categories ID (or slug), separated by a comma
    • Tags (optional) - list of tags
    • Number of Posts - default 10 - number of posts
    • Order (optional) – default DESC
      • ASC|DESC
    • Order by (optional) – default DATE
      • 'none' - No order
      • 'ID' - Order by post id. Note the captialization.
      • 'author' - Order by author.
      • 'title' - Order by title.
      • 'name' - Order by post name (post slug).
      • 'date' - Order by date.
      • 'modified' - Order by last modified date.
      • 'parent' - Order by post/page parent id.
      • 'rand' - Random order.
      • 'comment_count' - Order by number of comments
      • 'menu_order' - Order by Page Order. Used most often for Pages (Order field in the Edit Page Attributes box) and for Attachments (the integer fields in the Insert / Upload Media Gallery dialog), but could be used for any post type with distinct 'menu_order' values (they all default to 0).
      • 'meta_value' - Note that a 'meta_key=keyname' must also be present in the query. Note also that the sorting will be alphabetical which is fine for strings (i.e. words), but can be unexpected for numbers (e.g. 1, 3, 34, 4, 56, 6, etc, rather than 1, 3, 4, 6, 34, 56 as you might naturally expect). Use 'meta_value_num' instead for numeric values.
      • 'meta_value_num' - Order by numeric meta value (available with Version 2.8). Also note that a 'meta_key=keyname' must also be present in the query. This value allows for numerical sorting as noted above in 'meta_value'.
      • 'post__in' - Preserve post ID order given in the post__in array
    • Meta key (optional)
      • name of meta key for ordering
  5. GoodNews - Top Rated widget (available when Rating plugin is installed)
    • Number of posts - default 3
    • Time range (select)- Period of time to count for top rated videos
      • 1 day
      • 1 week
      • 1 month
      • 1 year

Theme Options


GoodNews 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. Mega Menu: Enable mega menu feature
  2. Enable Search: Enable or disable default search form in every pages (it appears on Top Navigation menu bar)

  3. SEO - Echo Meta Tags: By default, GoodNews 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
  4. Copyright Text: Appear in footer

  5. RTL Mode: Support right-to-left language

  6. Custom CSS: Enter custom CSS. Ex: .class{ font-size: 13px; }
  7. Custom Code: Enter custom code or JS code here. For example, enter Google Analytics
  8. Favicon: Upload favicon (.ico) is image file of page's title section

  9. Logo Image: Upload your logo image

  10. 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.
  11. Login Logo Image: Upload your Admin Login logo image

  12. Scroll Top button: Enable Scroll Top button (when clicking "Top", it will scroll site which is at the bottom of page to top of the page)

  13. Latest News Section - Number of days: Number of days to count for latest news
  14. Latest News Section - Maximum number of articles: Maximum number of articles to display

Theme Layout


Configure some features for website such as setting layout, change background, change font
  1. Layout: (select) - Choose theme layout
    • Fullwidth

    • Boxed

  2. Background: Set theme background. Only visible in boxed layout
  3. Main Color: Choose main color of theme (default- #DE4B39)
  4. Google Fonts: Use Google Fonts (On/Off)
  5. Main Font Family: Enter font-family name here (default - Raleway). 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
  6. 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.Only few heading texts are affected
  7. Main Font Size: Select base font size
  8. Custom Font 1: Upload your own font and enter name "custom-font-1" in "Main Font Family" or "Heading Font Family" setting above
  9. Custom Font 2: Upload your own font and enter name "custom-font-2" in "Main Font Family" or "Heading Font Family" setting above

Archives


Archives are item-listing pages such as Categories page, Tags page, Blog page, Gallery page, Search page and Author page
  1. Sidebar: Select options
    • Right Sidebar: Archives pages with the right sidebar (default)
    • Left Sidebar: Archives pages with the left sidebar
    • Hidden sidebar: Archives pages without sidebar (These pages are full-width)
    For example, figure below is Author page with Right Sidebar

  2. Pagination: 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 advanced
    • Default WordPress

    • Ajax

    • WP PageNavi

Single post


Configure features only for Single Post page
  1. Sidebar: Hide/show left or right Sidebar
  2. Author: Enable Author information
  3. About Author: Enable About Author information
  4. Published Date: Enable Published Date information
  5. Categories: Enable Categories information
  6. Tags: Enable Tags information
  7. Social Share count: Enable Social Share number
  8. Comment Count: Enable Comment Count Info
  9. Posts Navigation: Enable Post Navigation
  10. Related Posts: Enable Related Posts
  11. Related Posts by: Get related posts by categories or tags (random order)

Single Page


Configure the feature "turn on/turn off comment" in Single page, or configure "hide/show sidebar" in Single page
  1. Sidebar: Hide/show left or right Sidebar. This setting can be overriden in each page
  2. Enable Comments by default: Enable comments on single pages. This setting can be overridden in each page

404


Creating a page to report bugs when clients visit or access to the page which does not exist

Social Accounts


Turn on/turn off Social items. Social Account icons appear at the top-right corner of page, on the Headline bar, under Primary Menu

  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. Custom Social Account:Add more social accounts using Font Awesome Icons
  10. Open Social Link in new tab: Open link in new tab?

Social Sharing


Turn on/turn off Social Items appearing in Single Post page
  1. Facebook: Enable Facebook Share button
  2. Twitter: Enable Twitter Share button
  3. LinkedIn : Enable LinkedIn Share button
  4. Tumblr : Enable Tumblr Share button
  5. Google +: Enable Google+ Share button
  6. Pinterest: Enable Pinterest Pin button
  7. Email: Enable Email button
  8. Social Share Count - Twitter Tweet: Enable Number of Tweet info for each post
  9. Social Share Count - Facebook Like: Enable Number of Like info for each post
  10. Social Share Count - Facebook Share: Enable Number of Share info for each post

Advertising


Allow you put advertisements in pages such as Category page, Gallery page, Single Post page, or 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. Body Ads - AdSense Ads Slot ID: If you want to display Adsense in Body, enter Google AdSense Ad Slot ID here. If left empty, " Body Ads - Custom Code” will be used.
  5. Body Ads - Custom Code: Enter custom code for Body Ads
  6. Single Post Ads - AdSense Ads Slot ID:If you want to display Adsense in Single Post, enter Google AdSense Ad Slot ID here. If left empty, "Single Post Ads - Custom Code” will be used.
  7. Single Post Ads - Custom Code: Enter custom code for Single Post Ads
  8. Single Image Post Ads - AdSense Ads Slot ID: If you want to display Adsense in Single Image Post , enter Google AdSense Ad Slot ID here. If left empty, " Single Image Post Ads - Custom Code” will be used.
  9. Single Image Post Ads - Custom Code: Enter custom code for Single Image Post Ads
  10. Category Ads - AdSense Ads Slot ID: If you want to display Adsense in Category page, enter Google AdSense Ad Slot ID here. If left empty, "Category Ads - Custom Code” will be used.
  11. Category Ads - Custom Code: Enter custom code for Category Ads
  12. 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
  13. Wall Ads Left - Custom Code: Enter custom code for Wall Ads Left
  14. Wall Ads Left - Width:Specify width for Wall Ads Left, in pixels
  15. Wall Ads Left - Top Margin: Specify Top Margin for Wall Ads Left, in pixels
  16. 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
  17. Wall Ads Right - Custom Code: Enter custom code for Wall Ads Right
  18. Wall Ads Right - Width: Specify width for Wall Ads Right, in pixels
  19. Wall Ads Right - Top Margin: Specify Top Margin for Wall Ads Right, in pixels
Note: There are 5 pre-defined positions for placing ads (see figures below):
  • Top Ads: Appears in all pages, located under the Secondary Menu and above the Logo
  • Body Ads: Appears in all pages, located under the Main Bottom Sidebar and above Footer sidebar.
  • Single Post Ads: Only appears in Single Post page, located in Body and under the content of Single Post page
  • Single Gallery Post Ads: Appears in Gallery page
  • Category Ads: Appears in Category page, and repeat after every 6 items



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:

Auto Update


Allow you to activate the feature "AUTO UPDATE" of GoodNews Theme. If you want to update the new versions of GoodNews theme automatically, you need to enter some information below
  1. Envato Username: Enter your Envato username.
  2. Envato API: Enter your Envato API. You can find your API under in your Envato Profile page > My Settings > API Keys
  3. Allow Auto Update: Allow Auto Update or Not. If not, you can come back here and click on the "Update Theme" button

GoodNews Shortcodes


Shortcodes can be used in either Classic Editor or Visual Composer mode (require Visual Composer plugin installed). You can type shortcode directly in Classic Editor or use Visual Composer element to configure the shortcode

Most of the properties of shortcodes are optional. You only need to include properties when needed

Posts Tab

The content is displayed in form of Tab.

The [post-tab] shortcode has the following variables/options:

  1. categories (required) - list of categories ID (or slug), separated by a comma. Order of tab must be the same with order of IDs provided
  2. layout (optional) - default 'standard'
    • standard
    • compact
  3. post_type (optional) – default ‘post’
    • post: default post
  4. posts_per_tab (optional) – default 2 for standard layout, 1 for compact layout
  5. order(optional) – default DESC
    • ASC|DESC
  6. oderby: Arranging criteria
    • 'none'- No order
    • 'ID'- Order by post id. Note the captialization.
    • 'author'- Order by author.
    • 'title'- Order by title.
    • 'name'- Order by post name (post slug).
    • 'date'- Order by date.
    • 'modified'- Order by last modified date.
    • 'parent'- Order by post/page parent id.
    • 'rand'- Random order.
    • 'comment_count'- Order by number of comments
    • menu_order - Order by Page Order. Used most often for Pages (Order field in the Edit Page Attributes box) and for Attachments (the integer fields in the Insert / Upload Media Gallery dialog), but could be used for any post type with distinct 'menu_order' values (they all default to 0).

    • meta_value - Note that a 'meta_key=keyname' must also be present in the query. Note also that the sorting will be alphabetical which is fine for strings (i.e. words), but can be unexpected for numbers (e.g. 1, 3, 34, 4, 56, 6, etc, rather than 1, 3, 4, 6, 34, 56 as you might naturally expect). Use 'meta_value_num' instead for numeric values.

    • meta_value_num - Order by numeric meta value (available with Version 2.8). Also note that a 'meta_key=keyname' must also be present in the query. This value allows for numerical sorting as noted above in 'meta_value'.

    • post_in - Preserve post ID order given in the post__in array
  7. meta_key (optional) - Name of meta key for ordering
  8. show_rating (optional) - default 1/true (0/false) - show rating of posts. Only available when Rating plugin is installed
  9. show_social_count (optional) - default 1/true (0/false) - show Likes, Tweets, Shares count
  10. show_date - default 1/true(0/false)- show or hide published date.
  11. show_category (optional) - default 1/true(0/false) - show category name of post
  12. show_comment_count (optional) - default 1/true (0/false) - show number of comments of post
  13. heading_bg (optional) - default theme color - Background color of heading
    • hexa value. For example, #FF0000
The [post-carousel] shortcode has the following variables/options:
  1. post_type (optional) – default ‘post’
    • post: default post
  2. categories(optional): list of categories ID (or slug). Separated by a comma. Ex. 1,2,3,4
  3. tags (optional): list of tags. Separated by a comma. Ex. Tag1, tag2, tag3
  4. heading (optional) - heading text. If this value is empty, heading is hidden
  5. heading_bg (optional) - default theme color - Background color of heading
    • hexa value. For example, #FF0000
  6. count (optional) – default 10 - number of posts
  7. order (optional) – default DESC (ASC|DESC)
  8. orderby (optional) – default DATE
    • 'none'- No order
    • 'ID' - Order by post id. Note the captialization.
    • 'author' - Order by author.
    • 'title' - Order by title.
    • 'name' - Order by post name (post slug).
    • 'date' - Order by date.
    • 'modified' - Order by last modified date.
    • 'parent' - Order by post/page parent id.
    • 'rand' - Random order.
    • 'comment_count' - Order by number of comments
    • 'menu_order' - Order by Page Order. Used most often for Pages (Order field in the Edit Page Attributes box) and for Attachments (the integer fields in the Insert / Upload Media Gallery dialog), but could be used for any post type with distinct 'menu_order' values (they all default to 0)

    • 'meta_value' - Note that a 'meta_key=keyname' must also be present in the query. Note also that the sorting will be alphabetical which is fine for strings (i.e. words), but can be unexpected for numbers (e.g. 1, 3, 34, 4, 56, 6, etc, rather than 1, 3, 4, 6, 34, 56 as you might naturally expect). Use 'meta_value_num' instead for numeric values

    • 'meta_value_num' - Order by numeric meta value (available with Version 2.8). Also note that a 'meta_key=keyname' must also be present in the query. This value allows for numerical sorting as noted above in 'meta_value'.

    • 'post__in' - Preserve post ID order given in the post__in array
  9. meta_key (optional): name of meta key for ordering
  10. layout (optional) - default 'standard'
    • standard
    • compact

Posts Slider

The [post-slider] shortcode has the following variables/options:
  1. post_type (optional) – default ‘post’
    • post: default post
  2. categories (optional)- list of categories ID (or slug). Separated by a comma. Ex. 1,2,3,4
  3. tags (optional)- list of tags. Separated by a comma. Ex. Tag1, tag2, tag3
  4. heading (optional) - heading text. If this value is empty, heading is hidden
  5. count (optional) – default 10 - number of posts
  6. order (optional) – default DESC (ASC|DESC)
  7. orderby (optional) – default DATE
    • 'none'- No order
    • 'ID' - Order by post id. Note the captialization.
    • 'author' - Order by author.
    • 'title' - Order by title.
    • 'name' - Order by post name (post slug).
    • 'date' - Order by date.
    • 'modified' - Order by last modified date.
    • 'parent' - Order by post/page parent id.
    • 'rand' - Random order.
    • 'comment_count' - Order by number of comments
    • 'menu_order' - Order by Page Order. Used most often for Pages (Order field in the Edit Page Attributes box) and for Attachments (the integer fields in the Insert / Upload Media Gallery dialog), but could be used for any post type with distinct 'menu_order' values (they all default to 0)

    • 'meta_value' - Note that a 'meta_key=keyname' must also be present in the query. Note also that the sorting will be alphabetical which is fine for strings (i.e. words), but can be unexpected for numbers (e.g. 1, 3, 34, 4, 56, 6, etc, rather than 1, 3, 4, 6, 34, 56 as you might naturally expect). Use 'meta_value_num' instead for numeric values

    • 'meta_value_num' - Order by numeric meta value (available with Version 2.8). Also note that a 'meta_key=keyname' must also be present in the query. This value allows for numerical sorting as noted above in 'meta_value'.

    • 'post__in' - Preserve post ID order given in the post__in array
  8. meta_key (optional): name of meta key for ordering
  9. show_readmore (optional) - default 1/true - show readmore button
    • 1/true
    • 0/false
  10. ids (optional) - IDs of specific posts to display, separated by a comma

Posts Category

The [post-category] shortcode has the following variables/options:
  1. post_type (optional) – default ‘post’
    • post: default post
  2. categories (required)- categories ID (or slug)
  3. count (optional) – default 4 - number of posts
  4. order (optional) – default DESC (ASC|DESC)
  5. orderby (optional) – default DATE
    • 'none'- No order
    • 'ID' - Order by post id. Note the captialization.
    • 'author' - Order by author.
    • 'title' - Order by title.
    • 'name' - Order by post name (post slug).
    • 'date' - Order by date.
    • 'modified' - Order by last modified date.
    • 'parent' - Order by post/page parent id.
    • 'rand' - Random order.
    • 'comment_count' - Order by number of comments
    • 'menu_order' - Order by Page Order. Used most often for Pages (Order field in the Edit Page Attributes box) and for Attachments (the integer fields in the Insert / Upload Media Gallery dialog), but could be used for any post type with distinct 'menu_order' values (they all default to 0)

    • 'meta_value' - Note that a 'meta_key=keyname' must also be present in the query. Note also that the sorting will be alphabetical which is fine for strings (i.e. words), but can be unexpected for numbers (e.g. 1, 3, 34, 4, 56, 6, etc, rather than 1, 3, 4, 6, 34, 56 as you might naturally expect). Use 'meta_value_num' instead for numeric values

    • 'meta_value_num' - Order by numeric meta value (available with Version 2.8). Also note that a 'meta_key=keyname' must also be present in the query. This value allows for numerical sorting as noted above in 'meta_value'.

    • 'post__in' - Preserve post ID order given in the post__in array
  6. meta_key (optional): name of meta key for ordering
  7. show_rating (optional) - default 1/true - show rating of posts. Only available when Rating plugin is installed
    • 1/true
    • 0/false
  8. show_social_count (optional) - default 1/true - show Likes, Tweets, Shares count
    • 1/true
    • 0/false
  9. show_date (optional) – default 1/true - show or hide published date.
    • 1/true
    • 0/false
  10. show_category (optional) - default 1/true - show category name of post
    • 1/true
    • 0/false
  11. show_comment_count (optional) - default 1/true - show number of comments of post
    • 1/true
    • 0/false
  12. show_tag (optional) - default 1/true - show tag (category name) on first item
    • 1/true
    • 0/false
  13. tag_bg (optional) - default theme color - Background color of tag
    • hexa color. For example, #FF0000
  14. show_heading (optional) - default 1/true- show heading (category name) of shortcode
    • 1/true
    • 0/false
  15. heading_bg (optional) - default theme color - Background color of heading
    • hexa color. For example, #FF0000
  16. heading_link (optional) - default 1/true - put link on heading text
    • 1/true
    • 0/false
The [featured-post] shortcode has the following variables/options:
  1. post_type (optional) – default ‘post’
    • post: default post
  2. categories required - list of category slugs or IDs, separated by a comma. Order of tabs must be the same with order of Ids (slugs) in the param.
  3. post_per_tab (optional) - default 5 - Number of posts per page (tab)
  4. order (optional) – default DESC (ASC|DESC)
  5. orderby (optional) – default DATE
    • 'none'- No order
    • 'ID' - Order by post id. Note the captialization.
    • 'author' - Order by author.
    • 'title' - Order by title.
    • 'name' - Order by post name (post slug).
    • 'date' - Order by date.
    • 'modified' - Order by last modified date.
    • 'parent' - Order by post/page parent id.
    • 'rand' - Random order.
    • 'comment_count' - Order by number of comments
    • 'menu_order' - Order by Page Order. Used most often for Pages (Order field in the Edit Page Attributes box) and for Attachments (the integer fields in the Insert / Upload Media Gallery dialog), but could be used for any post type with distinct 'menu_order' values (they all default to 0)

    • 'meta_value' - Note that a 'meta_key=keyname' must also be present in the query. Note also that the sorting will be alphabetical which is fine for strings (i.e. words), but can be unexpected for numbers (e.g. 1, 3, 34, 4, 56, 6, etc, rather than 1, 3, 4, 6, 34, 56 as you might naturally expect). Use 'meta_value_num' instead for numeric values

    • 'meta_value_num' - Order by numeric meta value (available with Version 2.8). Also note that a 'meta_key=keyname' must also be present in the query. This value allows for numerical sorting as noted above in 'meta_value'.

    • 'post_in' - Preserve post ID order given in the post__in array
  6. meta_key (optional): name of meta key for ordering
  7. show_rating (optional) - default 1/true - show rating of posts. Only available when Rating plugin is installed
    • 1/true
    • 0/false
  8. show_social_count (optional) - default 1/true - show Likes, Tweets, Shares count
    • 1/true
    • 0/false
  9. show_date (optional) – default 1/true - show or hide published date.
    • 1/true
    • 0/false
  10. show_category (optional) - default 1/true - show category name of post
    • 1/true
    • 0/false
  11. show_comment_count (optional) - default 1/true - show number of comments of post
    • 1/true
    • 0/false
  12. heading_text (optional) - text on heading
  13. heading_link (optional) - - URL on heading text. Leave empty if do not use link on heading
    • 1/true
    • 0/false
  14. heading_bg (optional) - default theme color - Background color of heading
    • hexa color. For example, #FF0000
  15. Note: first item is set as 'big'

Post Grid

The [post-grid] shortcode has the following variables/options:
  1. post_type (optional) – default ‘post’
    • post - default post
    • event -(custom post type)
    • course -(custom post type)
  2. order (optional) – default DESC (ASC|DESC)
  3. orderby (optional) – default DATE
    • 'none'- No order
    • 'ID' - Order by post id. Note the captialization.
    • 'author' - Order by author.
    • 'title' - Order by title.
    • 'name' - Order by post name (post slug).
    • 'date' - Order by date.
    • 'modified' - Order by last modified date.
    • 'parent' - Order by post/page parent id.
    • 'rand' - Random order.
    • 'comment_count' - Order by number of comments
    • 'menu_order' - Order by Page Order. Used most often for Pages (Order field in the Edit Page Attributes box) and for Attachments (the integer fields in the Insert / Upload Media Gallery dialog), but could be used for any post type with distinct 'menu_order' values (they all default to 0)

    • 'meta_value' - Note that a 'meta_key=keyname' must also be present in the query. Note also that the sorting will be alphabetical which is fine for strings (i.e. words), but can be unexpected for numbers (e.g. 1, 3, 34, 4, 56, 6, etc, rather than 1, 3, 4, 6, 34, 56 as you might naturally expect). Use 'meta_value_num' instead for numeric values

    • 'meta_value_num' - Order by numeric meta value (available with Version 2.8). Also note that a 'meta_key=keyname' must also be present in the query. This value allows for numerical sorting as noted above in 'meta_value'.

    • 'post_in' - Preserve post ID order given in the post__in array
  4. meta_key (optional): name of meta key for ordering
  5. show_date (optional) – default 1/true - show or hide published date (for post) or start-date (for course, event)
    • 1/true
    • 0/false
  6. categories (optional) - list of category slugs or IDs, separated by a comma.
  7. tag (optional) - list of tags, separated by a comma

Blockquote

Blockquote: Create content of quotation, the quoted content is always indented a little space and highlighted with background’s color
For example

Text Block

Text Block:
pos - default 'center' - Position of text block

Button

The [button] shortcode has the following variables/options:
  1. size (optional) – default “small”
    • small
    • big
  2. bg_color (optional)
    • default theme color

Dropcaps

Dropcaps creates uppercase for the first character of the line. “Drop cap” is one of the commonly used typography in the magazine on paper as well as electronic magazine.

Dropcaps shortode is only available in Classic Editor. Click the Shortcode icon on formatting toolbar > choose Dropcap
Dropcap shortcode is defined as follow:




Accordion & Toggle

These are default elements of Visual Composer plugin.

Step 1: Click "plus sign" icon to add contents into Accordion

Step 2: If contents are Text, choose Text Block shortcode

then enter contents in Text Block shortcode and save it

Step 3: After contents are fully added and saved, its result will appear as the image below

Tab

Tab: Create tabs containing post’s content.
Tab is default element of Visual Composer plugin

Step 1: Click "plus sign" icon to add contents into Tab

Step 2: If contents are Text, choose Text Block shortcode

then enter contents in Text Block shortcode and save it

Step 3: After contents are fully added and saved, its result will appear as the image below


Tour

Tour: Create tabs containing post’s content.
Tour is default element of Visual Composer plugin

Step 1: Click "plus sign" icon to add contents into Tour

Step 2: If contents are Text, choose Text Block shortcode

then enter contents in Text Block shortcode and save it

Step 3: After contents are fully added and saved, its result will appear as the image below

Banner

The [banner] shortcode has the following variables/options:
  1. 'heading' - Heading text
  2. 'content' - Content text
  3. 'button_text' - button text
  4. 'href' - URL of banner (on button)
  5. 'img' - URL of image
  6. 'width' - Width of banner in pixels. Default is 300(px)
  7. 'height' - Height of banner in pixels. Default is 300(px)
  8. 'align' - (select)
    • 'left' (margin: 0 20px 20px 0)
    • 'right' (margin: 0 0 20px 20px)
    • 'center' (margin: 0 auto)

Adsense

The [adsense] shortcode has the following variables/options:
  1. 'pub' - Google Adsense Publisher ID
  2. 'slot' - Google Adsense Slot ID
  3. 'class' - Custom CSS class
Display all attached images in a post. You could use default Media Management of WordPress to insert a gallery into post content




Compare Table

There are two ways to add Compare Table shortcode
  1. Add Compare Table shortcode with "Classic Mode" editor interface
  2. Add Compare Table shortcode with Visual Composer
How to use Compare Table shortcode with Classic Mode
Step 1: Go to Pages > Add New Page > click icon "Shortcode" and choose Compare Table
Step 2: Enter values for options in Compare Table shortcode.
Step 3: Shortcode structure is appeared as follows, you need to enter the content of lines
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
  3. [c-row]
    • class (text) - custom CSS class
    • color (hexa color) - text color of row
    • bg_color (hexa color) - background color of row
  4. [price]
    • currency (text) - currency symbol
    • text (text) - additional text
How to use Compare Table shortcode with Visual Composer
Step 1: Go to Pages > Add New Page > Backend Editor
Step 2: Click Add element
Step 3: Click Row shortcode to insert a line
Step 4: Click the option to choose the number of columns you need to use, for example: the number of columns are 3
Step 5: Click "plus sign" icon, then choose Compare Table shortcode

Step 6: Enter values in Compare Table shortcode
In order to add row containing contents in Compare Table shortcode, click "plus sign" icon in Compare Table shortcode to insert line and choose "Row"

Step 7: Enter values for the Row
Step 9: In order to insert more rows, click "plus sign" icon under of Compare Table shortcode and follow the same steps as step 6,7. It is unlimited to insert more rows
Step 10: In order to insert Button shortcode, click "plus sign" icon as the image below and choose Button shortcode
After adding components for Compare Table shortcode in column 1 is completed, let's move to column 2 or 3, then follow with the above steps and save it, resulting as the image below

Category Page


  1. Go to Posts > Categories

  2. There are two options to display on page's Header of Category Page: Featured Posts in Big Carousel or Featured Posts in Slider mode in Category Listing Layout. Posts on header are posts marked Featured Post (In order to have posts marked Featured Post, go to Posts > Add New/Edit Post > Post Settings > Featured Post > Choose "YES")
    • Featured Posts in Big Carousel: Display featured posts in a Big Carousel

    • Featured Posts in Slider mode: Display featured posts in a Slider

Pages


Page Templates

There are 2 templates available

Layout Settings

Posts


Layout Settings

Post Settings

Featured Post: Make this post featured (when a post marked 'featured', it will be displayed in Category Page's header).

Post Format

GoodNews supports Standard, Video, Gallery, Image and Audio Post Format

Gallery Post


  1. Go to Posts > Add New
  2. Choose Gallery in Format

  3. Click Add Media > Create Gallery > Upload Files > Select files > choose image from your computer to upload and click Create a new gallery, continue uploading some images to create a Gallery album

  4. If you want to insert gallery into post content, click Insert Gallery. It is equavilient to [gallery] shortcode. If not, just close the popup. Images will only appear on header carousel

  5. Enter necessary information such asTitle, Categories and tags,etc...then click Publish to save

Other settings


Widget Custom Variation

In every widgets, 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

Widget Width

Note: When you drag widgets into Footer Sidebar, you can set Widgets manually by using Select Box (col-md-X). Make sure that the total width of each row is 12 column. For example: you have inserted 4 Widgets into Footer Sidebar, you want to split the width of the widget evenly, you need to select the width to be (col-md-3) in Widget width or a Widget named "Recent Posts", you can set its width to be (col-md-3) ​​or you can set its width randomly.

GoodNews Rating Plugin


  1. The Rating plugin is included in the packge (/Installation Files/Plugins/plg-goodnews-rating.zip). Once installed, you can access the settings page from Rating menu in admin

  2. 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.
    In addition,rating also allows Guests to evaluate for your posts. Here is the final results: the rating meta box for a post

RTL & Translation


GoodNews is a WMPL compatible and multi-language ready theme. To translate this theme:
  • Download and install this tool POEdit
  • Open POEdit and load [/Goodnews/languages/goodnews.po]
  • Translate the text and save the file
  • A file named goodnews.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');
GoodNews 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 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/