Copy the file and rename the file with the relevant WordPress locale, for example if you were translating the file into French, rename the file ht-knowledge-base-fr_FR.po.

Using a program such as PO Edit (http://poedit.net/), you can edit the translations directly.

Ensure all your plugin folder (ht-knowledge-base) is on your local machine before starting the translation.

1. Open the PO translation file in PO Edit, first click Update to update the translation source.

2. Open the Catalog Properties from Catalog > Properties and select the language, select OK.

3. Now you can go through the source text and enter your translations.

4. Click Validate then Save the translations, the PO file will be updated and an MO file will be generated.

5. Upload the new/updated language files to your WordPress installation.

6. Set your WordPress language, either with a plugin such as WordPress localize or WPML. Or manually update the WP_LANG constant in your WordPress config.php file.

// WordPress Localized Language, defaults to English.
define ('WPLANG', 'fr_FR');

Resources

• Poedit – http://poedit.net/
• WordPress Lanugage Plugin – http://wpml.org/documentation/related-projects/wordpress-language/
• WPML – http://wpml.org/

Please comment below to raise a new FAQ.

With the Heroic Knowledge Base, you can create, edit and control custom categories and tags for your
knowledge base articles.

Knowledge base categories can be created in two ways:

1. From Knowledge Base > Article Categories.
2. From an article add/edit page, under the Knowledge Base Category

In certain themes, category images and colours can be controlled from the edit knowledge base
category page.

Adding an article category

Controlling the Knowledge Base Category Order

The knowledge base category order can be controlled from the Knowledge Base > Article
Category Ordering page. Drag and drop categories to re­order and change the order they are
displayed on your site.

The parent category and nesting options can be controlled from the edit category page.

Using the category ordering screen

The new knowledge base menu in the dashboard

Select Add New Article to create a new Heroic Knowledge Base Article
From this page, you can control everything about your article:

● Title The title of the article
● Content ­ The body content of the article
● Options ­ Add attachments and allow voting (if voting plugin also installed)
● Format ­ The format of article (may be used by theme)
● Categories ­ Custom knowledge base categories the article will be classified under.
● Tags ­ Custom knowledge base tags to associate with the article.

Adding a new knowledge base article

Settings

The settings menu from Knowledge Base > Settings allows you to control various options for the
whole Knowledge Base.

A note on slugs: The knowledge base allows you to define custom slugs for Heroic Knowledge
Base articles, categories and tags. These can be controlled from Knowledge Base > Settings >
Slugs. On updating the slugs, you may need to ‘flush’ your permalinks by visiting Settings >
Permalinks, this forces WordPress to update the relevant slugs.

The knowledge base options screen

Linking to the knowledge base

You can link to any of the knowledge base articles as with any other post. To add the knowledge
base to a menu, goto Appearance > Menus and add the ‘Heroic Knowledge Base Archive’ to any of
the menus.

Using the knowledge base as on the homepage

In certain themes, you can set the knowledge base to appear as your sites homepage, by enabling
the ‘Knowledge Base Home’ setting from Knowledge Base > Settings > Knowledge Base Settings.
This will override the ‘front page displays’ setting in Settings > Reading.

Voting

With the Heroic Voting module installed and activated, visitors to the knowledge base can vote on
articles and comments. Top articles and contributors are assigned badges, depending on theme
support.

Using Articles in Posts or Pages

The knowledge base articles, categories and tags are self­contained, and you can link them from
any other page or post. The articles archive page links to all the other articles and categories  eg
www.example.com/articles.

Thank you for choosing the Hero Themes Knowledge Base plugin,
this plugin will add a knowledge base to your WordPress powered
site and features:

● Simple and powerful Knowledge Base
● Live search functionality
● Custom knowledge base post types
● Custom categories and tags
● Add attachments
● Vote articles (with Heroic Voting plugin)

Hero Themes are the creators of the #1 premium Knowledge Base theme for WordPress. This
guide documents how to set up and configure the Knowledge Base plugin.

Installation

To install Heroic Knowledge Base you will require a self­hosted WordPress version 3.5 or higher
installation. A supporting Hero Theme is not required but offers additional functionality and
enhanced experience.

You can install the plugin in a number of ways:

● From Zip File: In the WordPress admin panel navigate to Plugins > Add New, select the
‘Upload’ and browe to the zipped plugin file, and hit install now.
● FTP Upload: Using your FTP program upload the un­zipped plugin folder into the
/wp­content/plugins/ folder of your WordPress installation.

Once the plugin has been installed, you need to activate it. Go to Plugins > Installed Plugins and
activate Heroic Knowledge Base

This section contains various helps and tips for making the most out of your Hero Theme.
Hero Themes plugins

These complementary plugins provide additional functionality for your site:

Heroic Social Widget

Heroic Social Widget allows you to add links to all your social media in a widget, with over 80
icons available, this plugin caters for a wide variety of social links.
Get it at http://wordpress.org/plugins/heroic­social­widget/
or search ‘Heroic Social Widget’ from Plugins > Add New > Search

Heroic Favicon Generator

Add favicons to your site with ease. This plugin allows you to upload most images for use as
favicons.
Get it at http://wordpress.org/plugins/favhero­favicon­generator/
or search ‘Heroic Favicon Generator’ from Plugins > Add New > Search

Heroic Posts Widgets

The Heroic Posts Widget is a more advanced posts widget for displaying certain posts.
Enhanced options include excluding and reversing post order.
Get it at http://wordpress.org/plugins/heroic­posts­widget
or search ‘Heroic Posts Widget’ from Plugins > Add New > Search

Dedicated Support

Need support? We are here to help! Head over to http://herothemes.com/support/ to access our
dedicated support portal.
You will need your themeforest purchase code to register for a free HeroThemes.com account,
this can be found when you are logged into your themeforest account under downloads > item
download > license certificate and purchase code.

Thanks again for your purchase, we hope you enjoy using your new Hero Theme. If you have any
feedback or queries, please get in touch via our support portal.

Missing style sheet error when installing the theme?

A common issue that can occur with users new to installing WordPress themes is a “Broken
theme and/or stylesheets missing” error message being displayed when trying to upload or
activate the theme. This error message does not mean that the theme you have purchased is
broken, it simply means it has been uploaded incorrectly. Luckily, there is a very easy fix.
(http://support.envato.com/index.php?/Knowledgebase/Article/View/269)

To setup your custom menus, navigate to Appearance > Menus. Give your menu a name and
build it up using the available widgets. You can add a variety of items including pages,
categories, custom links. To extend the available widgets, click the screen options tab at the very
top of the screen and configure your options.

Once you have built and saved your menu, simply select the theme location by selecting the ‘Primary Navigation’ tickbox.

Note: If you do not see a desired menu item, select Screen Options in the top right of the page and select all the items.

Settings up menus

Widgets

This theme features several Widgetized areas, which you can drag ‘n’ drop widget items to
show snippets of content in areas such as headers, sidebars and footers using the WordPress
widget manager which can be accessed from Appearance > Widgets.

The Knowledge Base plugin come with several widgets including a Knowledge Base Articles
widget for displaying knowledge base articles across your site and Knowledge Base Authors to
quickly view top authors. bbPress also comes with a number of widgets to display content and
functionality from the forums.

The widgetized areas include the default sidebar, BBPress Sidebar (if active), Knowledge Base
Sidebar, Footer Widgets and Homepage Widgets. To use a widget in one of these areas, drag it
from the Available Widgets panel on the left into one of the boxed areas on the right. Various
options can then be set, including the title of the widget and what content appears.
Widget availability may depend on what plugins are installed and activated.
An example of how the widgets are configured in the demo

Widget options as configured on the demo site.

Featured Images

The theme supports the use of featured images. The theme supports auto­resizing of the
featured images. Auto­resizing will only occur however when the image is uploaded for the first
time, images that have previously been uploaded will not be resized. You can however use the
following plugin to regenerate the thumbnails:
http://wordpress.org/extend/plugins/regenerate­thumbnails/

To upload a post thumbnail, go to Posts > Add New  or open an existing post in editing mode.
Locate the Featured Image module and click the Set featured image link.
Clicking the link will open up the usual WordPress image uploader where you will upload your
image. Simply make sure that it is either the same size or larger than what the final thumbnail
will be. Once you’re done uploading the image, simply click the link that says “Set Featured
Image”, which is next to the button to insert it into the post.

For more on how to use the WordPress’ Post Thumbnail feature you can view this article ­
http://en.support.wordpress.com/featured­images/

Header Options

● Site Title ­ The title for your site
● Tagline  ­ A tagline for your site
● Site Logo ­ Add a custom logo, recommended size is 200px wide and 55px tall.

Footer Options

● Site Copyright – Enter your site copyright message
Styling Options
● Link Color (Hover) ­ Select using this color picker
● Link Color ­ Select using this color picker
● Header BG Color ­ Select the header background color using this color picker
● Header Font Color ­ Select the header font color using this color picker
● Page Header BG Color ­ Select the banner background color using this color picker
● Page Header Font Color ­ Select the banner font color using this color picker

Header / bbPress / Blog / Knowledge Base Options

● Headline ­ The headline that appears in the top banner on this page
● Tagline  ­ A tagline for beneath the tagline on this page

Navigation Options

● Primary Navigation ­ select the menu you want to use for the main navigation, these
can be created or edited from Appearance > Menus.
Widgets (bbPress Sidebar and Footer Widgets)
● Widgets Shown ­ add/edit widgets from the live customizer. These can also be
controlled from Appearance > Widgets.

http://codex.wordpress.org/Installing_WordPress

Theme Installation

Note: If you are upgrading from a previous version of the theme, please ensure you read the
separate Theme Upgrade documentation to ensure a successful upgrade.

You can install the theme in two ways:

1. WordPress Upload: In the WordPress admin panel navigate to Appearance > Add New
Themes > Upload. Go to browse and select the zipped theme folder. Press install now
and the theme will be uploaded and installed. This will be helpguru.zip or similar. It is not
the zip file themeforest­xxxx­themename.zip, if you only have this file, you will need to
extract the helpguru.zip first.

2. FTP Upload: Using your FTP program upload the un­zipped theme folder into the
/wp­content/themes/ folder of your WordPress installation.
Once the theme is uploaded, you need to activate it. Go to Appearance > Themes and activate
your theme.

Theme installation and activation from the WordPress Admin > Appearance page

Theme installation and activation from the WordPress Admin > Appearance page

Install and Activate Required Plugins

Upon activation, you may be prompted to install Heroic Knowledge Base, Heroic Voting and
(optional) bbPress. These are plugins which enable the functionality of this theme.

Select Begin installing plugins and select all the plugins and then install from the drop down.
Click Apply. The plugins will be downloaded where appropriate. When the message appears
again, return to the install required plugins page and activate each of the plugins in turn.

Theme required plugins notice

Home/Blog Page Setup

First we need to setup the homepage page and blog page. Simply go to Pages > Add New and
create the following pages with no content:

● Blog
● Homepage (Using the custom page template ­ Homepage)

Selecting the template from the page attributes meta box

Next we need to assign these pages in WordPress as our homepage and blog page. Go to
Settings > Reading and set the settings like this:

Controlling the front page options

Using the Knowledge Base as your Homepage

Instead of using static pages as described above, you can use the knowledge base as the front
page. Select Knowledge Base > Settings > General Settings and select the Knowledge Base
Home option. This will override the front page displays setting in Settings > Reading.

The knowledge base as home option

Setting up the Knowledge Base

When the theme is installed, you may see a notification reminding you to activate the Heroic
Knowledge Base and Voting Plugin. Once these plugins are activated you can create your
knowledge base articles to form the structure of the knowledge base section of your site.

Refer to the separate Heroic Knowledge Base documentation for the more details on how to
create and configure the knowledge base. For best results with this theme, categorize articles
into at least one top­level knowledge base category.

Setting up the knowledge base

Setting up bbPress forums

This theme supports bbPress, a popular forum plugin for WordPress. With bbPress you can
add forums to your Hero Theme powered site.

When the theme is installed and activated, you may see a notification advising you that bbPress
is recommended plugin and prompting to install bbPress. If this does not appear, or you want to
install bbPress later search ‘bbPress’’ from Plugins > Add New > Search.

Install and activate bbPress. Once installed, you will be greeted by bbPress the welcome screen
and have three new menus in your administration panel menu ­ Forums, Topics and Replies.
The theme will also display a link to the forum from the front page of your site if you have the
front page set up as described above.

Create your first forums by selecting Forums > New Forum. You and your users can create
topics, make replies and build a community to complement your Hero Themes powered site.

Activating bbPress

Many of the following Content Import scripts can be found under Tools → Import menu of your WordPress administration interface.

If you run into specific problems, a search on the WordPress Support Forum will likely lead to a solution, or try the Codex FAQ. Users of a blogging system not listed here who wish to switch to WordPress are invited to ask for help in the WordPress Support Forum as well.

To help you understand the differences between WordPress and other existing software, we recommend you review the WordPress Features and more on Working with WordPress.

Before Importing

If your exported file is very large, the import script may run into your host’s configured memory limit for PHP.

A message like “Fatal error: Allowed memory size of 8388608 bytes exhausted” indicates that the script can’t successfully import your XML file under the current PHP memory limit. If you have access to the php.ini file, you can manually increase the limit; if you do not (your WordPress installation is hosted on a shared server, for instance), you will have to break your exported XML file into several smaller pieces and run the import script one at a time.

If the import process is run again with the same data file after stopping midway through, it could result in duplicate data, missing data or other errors in the destination database.

For those with shared hosting, the best alternative may be to consult hosting support to determine the safest approach for running the import. A host may be willing to temporarily lift the memory limit and/or run the process directly from their end

Importing from [X]HTML

Using trial and error one can make an e.g., perl script to concatenate [X]HTML files as RSS <item>s, saving into a single file.xml, then import that as RSS. Note however to first remove any newlines between <p>..</p>s, as mentioned above.

The format allowed is quite simple in fact. Just make each HTML file into an <item> as below and concatenate them together:

<item>
 <pubDate>Wed, 30 Jan 2009 12:00:00 +0000</pubDate>
 <category>Kites</category>
 <category>Taiwan</category>
 <title>Fun times</title>
 <content:encoded><p>What great times we had...</p><p>And then Bob...</p></content:encoded>
</item>
<item>...

Just be sure the <content:encoded> line is a single long line with no newlines embedded.

If your HTML is well-formed, you can try using the Import HTML plugin.

Importing from a Site of Static Pages

A discussion in February 2011 on the wp-hackers email list involved importing 6,000 static pages into WordPress. A number of responses recommended using the PHP Simple HTML DOM Parser to facilitate the porting of the pages.

Google Blog Converters

In case the above methods don’t work, you can try Google Blog Converters.

This tool can convert Blogger export into WordPress format. It also supports conversion from Movable Type & LiveJournal to Blogger format. You can take the Blogger format then convert it again into WordPress format.