First of all, thank you for buying this theme. To make your experience pleasant, we've added as much info as needed in this documentation.

While we have tried to keep an easy-to-use user interface, we understand that you might have some questions about installing and using our theme. Following is a detailed step-by-step guide to help you with most of the questions or issues that you may be experiencing.

How to Use This Document

To help you quickly locate what you are looking for, we have created an extensive menu for this document at your left side. Please use it to navigate to the desired section.

Can't find what you need? Contact us via this form. We will respond in the shortest time possible.

There are two methods to install the theme. If the normal installation method (a) is not supported by your web host, you will have to use the alternate option (b).

a. Normal Installation

  1. Log into your WordPress admin panel and go to Appearance » Themes
  2. Click the Add New button at the top.
  3. Click the Upload Theme button at the top.
  4. Click the Choose File button and navigate to the location of the theme zip file.
  5. Click Install Now to begin the installation.
  6. Wait for the success message, then click Activate.

b. FTP Installation (alternate method)

  1. Unzip the theme zip file.
  2. Using an FTP client to access your host web server. Go to /wp-content/themes/ and place the theme folder inside it.
  3. Log in to your WordPress admin panel and go to Appearance » Themes
  4. Locate the theme thumbnail and click the Activate link.

WordPress child theme allows you change the functionality of the theme without having to edit the original/parent theme template files. If you plan to making any customization, we recommend to create a child theme instead of editing the theme template files. Since the child theme is stored separately, you don't need to redo the changes next time you upgrade the theme.

Creating a Child Theme

There's a plugin you can use that will create a child theme from within the WordPress dashboard: http://wordpress.org/plugins/child-theme-configurator/or you can download Beginner blank child theme.

Download it here.

More About Child Theme

You can read more about Child theme on WordPress Codex →

If you are migrating from another theme, then upon activating Beginner you may find previously added images display strangely with weird aspect ratios and sizes. Don't worry. It is normal. The image thumbnails are required to be recreated using Beginner's presets.

There is a very easy fix to this issue. Just install Force Regenerate Thumbnails plugin.

How To Use It?

  1. After you install it, go to Tools > Force Regenerate Thumbnails
  2. Click the Regenerate All Thumbnails button
  3. Depending upon the number of images and server speed, the process may take long to complete.
  4. After it done, you can deactivate and delete the plugin.

Beginner recommends a few free plugins to extend it's functionality. These plugins can be installed automatically from the notification in WordPress Administration Panel (Dashboard). Although, Beginner will work perfectly without any of these plugins, you may want to extend the theme's features with them.

Recommended Plugins

  • FreshThemes Deals
    Strongly Recommended

    This is the main plugin to add coupon functionality to your site. We recommend you to install this plugin.

How to Install the Plugins

  1. Log into your Dashboard page.
  2. Go to Appearance » Install Plugins.
  3. Click install link below the plugin you want to install.

We have included the exported XML file from our demo, which allows you to quickly set up your theme with Beginner demo content.

  • The XML file is included within the theme package inside the readme directory.
  • Find dummy-data.xml file.
  • Navigate to WP Admin > Tools > Import
  • Select and install WordPress Importer
  • Once its installed, select the XML file and upload it. It will take a few minutes to install and upload all content

All of our themes include a language file to make translating to a different language easy. Inside the theme folder /wp-content/themes/themename/languages, you'll find a language file named themename.pot. Or in this theme file named beginner.pot

Configure WordPress

Before translating the theme, you'll need to make sure WordPress is setup correctly with your locale. Open wp-config.php and modify the line below.

  
/**
 * WordPress Localized Language, defaults to English.
 *
 * Change this to localize WordPress. A corresponding MO file for the chosen
 * language must be installed to wp-content/languages. For example, install
 * de_DE.mo to wp-content/languages and set WPLANG to "de_DE" to enable German
 * language support.
 */
define( 'WPLANG', '' );

Translating the Theme

  1. Download and install Poedit.
  2. Open beginner.pot in Poedit. Translate as needed.
  3. Save the file with the locale. For example, if you translate the theme to German language then you would save your files as de_DE.po.
  4. Copy both these files(de_DE.po and de_DE.mo) under the languages folder of beginner.

Our theme options are powered by WordPress Customizer. WordPress Customizer is a new and exciting feature that combines theme options with the ability to live preview those changes before saving them!

How To Access it?

  • Select Appearance
  • Then Click Customize
  • We provide a lot of options for you to customize your website easily and with live preview!

General Setup

Beginner Customizer General

For starter, in the General panel you can setup some options like:

  • Change your default RSS feed url to something like FeedBurner.
  • Hide comments and comment form on all pages.
  • Customize your Post Date. More about this, see next section.
  • Choose your Static Front Page.
  • Enter your social links to be displayed on Header and/or Footer.
  • Setup a Newsletter Form on the header. See newsletter section for details.
  • Customize the footer text.

Beginner has some options to display the Post Date.

Beginner Customizer Post Date
  • Select Appearance > Customizer
  • Choose General > Post Date
  • Choose the Date Style:
    • Absolute (e.g. June 20, 2015 10:19 am - depends on your WordPress settings)
    • Relative (e.g. 1 week ago)
  • Choose the Date Type:
    • Published Date is the date when the Post is created.
    • Modified Date is the date when your last Post is updated.

You can have a Newsletter Form section on your header. It's located right under Secondary Menu.

Beginner Newsletter

How to Set Newsletter Form

  • Select Appearance > Customizer
  • Choose General > Newsletter
  • You can modified the default text for the form's Heading, Title and Description
  • For Newsletter Type, if you choose FeedBurner, you just need to enter your FeedBurner ID.
  • Beginner Customizer Newsletter FeedBurner
  • If you choose Custom Code instead for Newsletter Type, you'll get a textarea to enter your custom code (e.g. MailChimp, AWeber, etc.) for the Newsletter Form.
  • Beginner Customizer Newsletter Custom

You can also choose where do you want to show the Newsletter. By default, it's on Front and Home page. But you can also choose to show it on other Archive Page, Search Page, Single Post, Single Page, or even on your 404 Page.

Beginner Customizer Newsletter Visibility

The Site Icon is used as a browser and app icon for your site. Icons must be square, and at least 512px wide and tall.

How to Upload your Icon?

  • Select Appearance > Customizer
  • Choose Header > Site Title
  • You will see the Site Icon uploader.
  • Upload your icon at least 512px x 512px

If you'd like to have custom icons in your menu like this:

Custom Menu Icons

It's easy. Just follow these steps.

  1. Go to Appearance » Menus .
  2. To create a new custom menu, click the create a new menu link, give the menu a name, and click Save Menu button.
  3. You can add any between pages, categories or custom link's to the menu using the boxes at the left, but the most important part is the next step.
  4. In the Navigation Label, add this following kind of code before your Menu Label/Name:

    <i class="fa fa-usd"><i>

    usd is Font Awesome code for $ like in the example above.

    For complete reference of the icons, check out this Font Awesome Icons list.

  5. When you are done, click Save Menu.
Custom Menu Icons Setup

Predefined skins is an alternative color you can use for the theme. Beginner comes with 5 predefined skins you choose.

  1. Default 
  2. Green 
  3. Cyan 
  4. Magenta 
  5. Blue 

How to Choose it?

  • Select Appearance > Customizer
  • Choose Color > Predefined Skins
  • You will see the option to choose the skins.

By default, Beginner uses Merriweather font as primary font family and Droid Sans font as secondary font family. But Beginner provides an option to change them to your preferences. It is easy to change it, please follow the steps below.

Beginner Customizer Typography
  • Select Appearance > Customizer
  • Choose Typography > Global
  • You will see the Typography switcher.
  • You can choose the primary and secondary font there.
Beginner Customizer Advertisement

Beginner provide 3 spots to place an ads.

  • Header
  • Single post before content
  • Single post after content

The option also come with two method, first you can upload your image and add the url. Or second, you can use the textarea to put the ads code like AdSense. See the picture below.

Beginner Customizer Header Ads

Beginner offers 3 layouts for the blog page.

  1. Full Width: Display the content in a full width mode (without sidebar).
  2. Right Sidebar: Display the content with sidebar on the right.
  3. Left Sidebar: Display the content with sidebar on the left.

Setup the Layouts

  • Select Appearance > Customizer
  • Choose Layouts > Global Layout
  • You will see the option to choose the Global Layout.

You can choose to hide some elements in your blog post. First, you need to:

  • Select Appearance > Customizer
  • Choose Layouts > Posts

And here are the options you can show/hide:

Beginner Customizer Post Header
Beginner Customizer Post Footer

If you prefer, you can choose to hide Page Title in all your pages.

  • Select Appearance > Customizer
  • Choose Layouts > Page
  • Switch the Show page title to Off.
Post Formats

Post formats is a custom presentation of a post and Beginner offers 8 post formats you can choose.

  1. Standard
  2. Audio
  3. Video
  4. Gallery
  5. Image
  6. Aside
  7. Quote
  8. Link

Beginner comes with optional Team page template to display your website description and team. Please check the demo to see it in action. But, to display the team data you need to install our Team plugin.

To install Team Plugin

  1. To display the team data, first you need to install our Team content plugin.
  2. Please download on http://wordpress.org/plugins/theme-junkie-team-content/
  3. Or you can go to Appearance » Install Plugins. Click install under FreshThemes Team Content.
  4. You will see a new Teams menu on the left.
  5. To add new member data, just go to Teams » Add New.

Displaying The Page

Team Page Template
  1. Assuming you're at new page screen (Pages » Add New)
  2. Add the title with Teams or About Us or anything.
  3. Add the description in the Editor.
  4. Under Page Attributes switch the Template to Teams template
  5. Click publish button.

You can use a custom Contact Form by installing Ninja Form plugin from WordPress.org repository for free. Please check the demo to see it in action.

  1. Please download http://wordpress.org/plugins/ninja-forms/
  2. Or you can go to Appearance » Install Plugins. Click install under Ninja Forms.
  3. Then go to the post or page editing screen.
  4. You should see Append A Ninja Form metabox (see image below) under the Featured Image metabox (around your bottom right corner screen).
  5. Select the Form you have created previously. Or use the default one to see how it'll look on your page.
    Note: you should check again and setup the default form to make it works as your preference (i.e. sending it to your Email as Admin)
  6. Alternatively, you can also put a shortcode to your Post/Page content to show the form.
    Sample shortcode: [ninja_forms id=1]
  7. Finally, click the Publish or Update button to update your Post/Page.

FreshThemes Deals (or TJ Deals for short) is the main plugin you need to install to have the coupon functionality on your site.

How To Install TJ Deals

  • Log in to your WordPress Admin panel.
  • Go to: Appearance » Install Plugins. Click install under TJ Deals.
  • After you install the plugins, now the link under TJ Deals become activate. Make sure you click it to activate the plugin.
  • You will see a new Deals menu on the left.
  • To add new Deal data, just go to Deals » Add New.
  • TJ Deals also equipped with a custom taxonomy called Deal Categories. You can add, edit, or delete it from Deals » Deal Categories, or you can add it on the fly from Add/Edit Deal screen, just like a regular Category in the Add/Edit Post.

Add New Deal

For each Single Deal, you can have:

  • Deal Title
  • Deal Content
  • Deal Excerpt
  • Deal (Featured) Image
  • Deal Categories
  • Order Attributes
  • Coupon Code
  • Destination URL
  • Button Text
Beginner Deal Settings

For how the last three (3) custom fields above is used, see below:

  • Coupon Code (1) will be displayed like in the picture below. Your visitor can then Click to Copy it and they will be redirected to the URL in Destination URL (2) field.
  • You will also get an additional button after your Deal Content like in the picture below (3). You can customize its text using the Button Text (3) field. When the button is clicked, your visitor will be redirected to the same Destination URL (2).
Beginner Deal Single

Related Deals

Below your Single Deal content, you can show/hide Related Deals.

Beginner Related Deals

To customize this section, follow these steps:

  1. Select Appearance > Customizer
  2. Choose Deals > Single Deals
  3. Switch the Show related deals to Off, if you don't want to show Related Deals.
  4. You can modified the default text for Related Deals Title.
  5. Switch the Show related deals thumbnails to Off, if you don't want to show images for Related Deals.
Beginner Customizer Deal Single

By default, you can access your list of Deals (Archive Deals) by going to http://yourdom.ain/deal/

Check out on the demo or see how it looks here:

Beginner Deal Archive

You can customize the Archive Deals Title (1) and Description (2) by following these steps:

  1. Select Appearance > Customizer
  2. Choose Deals > Archive Deals
  3. Change the default text for Archive Deals Title and Description there.
Beginner Deal Single

Beside the default Archive Deal link, Beginner also comes with optional Deals page template to display your list of deals. Please check the demo to see it in action.

How to Use Deals Page Template

Deals Page Template
  1. Go to Pages » Add New.
  2. Add the Page Title, it will become the Archive Deals Title (1 - see Archive Deals screenshot).
  3. Add the description in the Editor, it will become the Description (2 - see Archive Deals screenshot).
  4. The most important part, under Page Attributes switch the Template to Deals template.
  5. Click publish button.

Last but not least, Beginner can also display Featured Deals section on your site. It's located below your main content. If you have enabled Featured Posts as well, Featured Deals will be placed right after that.

Beginner Featured Deals

How to Set Featured Deals

  • Select Appearance > Customizer
  • Choose Deals > Featured Deals
  • Choose a specific Deal Category. If you leave it empty, it will show the most recent deals.
  • Enter how many deals to be displayed.
  • Select how it should be ordered by (date, random or custom). Custom will sort the Deals by Order Attributes you entered when you create a New Deal.
  • Order Attributes
  • You can also modified the default text for Featured Title and More Text
Beginner Customizer Deals Featured

You can also choose where do you want to show the Featured Deals. By default, it's on Front and Home page. But you can also choose to show it on other Archive Page, Search Page, Single Post, Single Page, or even on your 404 Page.

Beginner Customizer Featured Visibility

Beside the Global Layout you can set in the Customizer, you can also setup the layout per post or page. This is done when you add or edit the post or page. There are 3 types layout you can choose:

Post Layouts Type

  1. Post Full Width: Display the content in a full width mode (without sidebar).
  2. Post Right Sidebar: Display the content with sidebar on the right.
  3. Post Left Sidebar: Display the content with sidebar on the left.

Page Layouts Type

  1. Page Full Width: Display the content in a full width mode (without sidebar).
  2. Page Right Sidebar: Display the content with sidebar on the right.
  3. Page Left Sidebar: Display the content with sidebar on the left.

Per Page/Post Basis Layout

Per Page/Post Basis Layout
  1. Assuming you're at the new post or page screen (Posts > Add New) or (Pages > Add New)
  2. After you create the post or page, scroll down and find Layout meta box.
  3. Choose the layout.

You can use these shortcodes by installing our Shortcodes plugin which available for free! You can see the shortcodes in action here.

  1. Please download on http://wordpress.org/plugins/theme-junkie-shortcodes/
  2. Or you can go to Appearance » Install Plugins. Click install under TJ Shortcodes.
  3. Then go to the post or page editing screen.
  4. You should see Add Shortcode button(see image below) beside the Add Media button.
  5. Click on it, then you will see a selectbox to choose the shortcodes you wish to use.
  6. Finally, click the Insert Shortcode button.