Version1.

WordPressTheme

Auserguidetohelpyousetupanduseyourbrandnew
HeroTheme.

Thankyouforpurchasingthistheme,yoursupportistrulyappreciated!

Thisuserguidewillwalkyouthroughsettingupyourtheme,usingitsvariousfeaturesand
answeringcommonissuesandproblems.Werecommendfollowingthisguidetosetupyour
website.

Ifyouhaveanyquestionsthatarebeyondthescopeofthemanualpleasefeelfreetosubmit
asupportrequesthere:
http://herothemes.com/support

1of20

Getting Started

ToinstallthethemeyoumusthaveWordPressalreadyinstalled.PleaseseetheWordPress
CodexformoreinformationoninstallingWordPress:
http://codex.wordpress.org/Installing_WordPress

Theme Installation

UpdateNote
:Ifyouareupgradingfromapreviousversionofthetheme,pleaseensureyou
readtheseparateThemeUpgradedocumentationtoensureasuccessfulupgrade.

Youcaninstallthethemeintwoways:

WordPressUpload
:IntheWordPressadminpanelnavigateto
Appearance>Add
NewThemes>Upload
.Gotobrowseandselectthezippedthemefolder.Pressinstall
nowandthethemewillbeuploadedandinstalled.Thiswillbehelpguru.ziporsimilar.
Itisnotthezipfilethemeforestxxxxthemename.zip,ifyouonlyhavethisfile,youwill
needtoextractthehelpguru.zipfirst.
FTPUpload
:UsingyourFTPprogramuploadtheunzippedthemefolderintothe
/wpcontent/themes/
folderofyourWordPressinstallation.

Oncethethemeisuploaded,youneedtoactivateit.Goto
Appearance>Themes
and
activateyourtheme.

ThemeinstallationandactivationfromtheWordPressAdmin>Appearancepage

2of20

Install and Activate Required Plugins

Themerequiredpluginsnotice

Uponactivation,youmaybepromptedtoinstallHeroicKnowledgeBase,HeroicVotingand
(optional)bbPress.Thesearepluginswhichenablethefunctionalityofthistheme.

SelectBegininstallingpluginsandselectallthepluginsandtheninstallfromthedropdown.
ClickApply.Thepluginswillbedownloadedwhereappropriate.Whenthemessageappears
again,returntotheinstallrequiredpluginspageandactivateeachofthepluginsinturn.

Youmustensurealltherequiredpluginsareinstalledandactivatingbeforecontinuing,
repeattheinstallationandactivationprocessuntilnonoticeappearswarningof
uninstalled/inactiverequiredplugins.

3of20

Home/Blog Page Setup

Firstweneedtosetupthehomepagepageandblogpage.Simplygoto
Pages>AddNew
andcreatethefollowingpageswithnocontent:

Blog
Homepage(UsingthecustompagetemplateHomepage)

Selectingthetemplatefromthepageattributesmetabox

NextweneedtoassignthesepagesinWordPressasourhomepageandblogpage.Goto
Settings>Reading
andsetthesettingslikethis:

Controllingthefrontpageoptions

4of20

Using the Knowledge Base as your Homepage

TousetheKnowledgeBaseasthehomepage,setFrontpagetoKnowledgeBaseArchive(a
dummypagecreatedbytheKnowledgeBaseplugin)in
Settings>Reading
.

Readingsettingsusingtheknowledgebaseasthefrontpage

Setting up the Knowledge Base

Whenthethemeisinstalled,youmayseeanotificationremindingyoutoactivatetheHeroic
KnowledgeBaseandVotingPlugin.Oncethesepluginsareactivatedyoucancreateyour
knowledgebasearticlestoformthestructureoftheknowledgebasesectionofyoursite.

RefertotheseparateHeroicKnowledgeBasedocumentationforthemoredetailsonhowto
createandconfiguretheknowledgebase.Forbestresultswiththistheme,categorizearticles
intoatleastonetoplevelknowledgebasecategory.

Settinguptheknowledgebase

5of20

Setting up bbPress forums

ThisthemesupportsbbPress,apopularforumpluginforWordPress.WithbbPressyoucan
addforumstoyourHeroThemepoweredsite.

Whenthethemeisinstalledandactivated,youmayseeanotificationadvisingyouthat
bbPressisrecommendedpluginandpromptingtoinstallbbPress.Ifthisdoesnotappear,or
youwanttoinstallbbPresslatersearchbbPressfrom
Plugins>AddNew>Search
.

InstallandactivatebbPress.Onceinstalled,youwillbegreetedbybbPressthewelcome
screenandhavethreenewmenusinyouradministrationpanelmenuForums,Topicsand
Replies.Thethemewillalsodisplayalinktotheforumfromthefrontpageofyoursiteifyou
havethefrontpagesetupasdescribedabove.

Createyourfirstcategoriesandforumsbyselecting
Forums>NewForum
.Youandyour
userscancreatecategories,forums,topics,makerepliesandbuildacommunityto
complementyourHeroThemespoweredsite.

ActivatingbbPress

ForadditionalhelpandsupportaroundthegeneraluseofbbPress,consulttheSupport
sectionat
https://bbpress.org/
.

6of20

Important note on Categories and Forums

Whenyousetuptheforumsfromscratch,itisimportanttoconsiderthestructureofthe
forumsandsetupseveralcategorieswithsubforumstoensureitlooksaesthetically
pleasing.

Firstyouneedtocreateseveralforum
Category
types,egGeneral,ProductSupport,Other.
Intotheseyoushouldputyour
Forum
types,egAnnouncements,FeedbackandSuggestions,
MyAppSupport,TheirAppSupport,etc.Thesearethesectionswhereuserscanstart
individualtopics/threads.

CategoriesandForumsarecreatedinasimilarwaybyselecting
Forums>NewForum
.The
forumtypeisthensetontherightunderForumAttributes.SettheparentCategoryTypes
undertheTypedropdownoption.Forforums,selectForumastheTypeandtheParentas
theparentcategoryyouwishtheforumtoappear

Step1.Creatingaparentcategory

Step2.Creatingaforumintheparentcategory

7of20

ThebbPressforumsontheHelpGurudemositeat
http://demo.herothemes.com/helpguru/forums/
,areconfiguredwithtwoparentCategories
GeneralandProductSupport.IneachofthesethereareseveralForumsAnnouncements,
FeedbackandSuggestions,TulipAppSupport,ProductoSupport,ApplioSupport

Theconfigurationoftheforumsonthedemosite

Thisresultsinastructuredappearanceinthecommunityforumssectionofthesite

Theappearanceoftheforumsonthedemosite

8of20

Customizer Settings

YoucancustomizevariousvisualaspectsofthethemeusingtheWordPressLive
Customizer.Goto
Appearance>Customize
.Takesometimetotakealookthroughthe
optionsandcustomizethemforyoursite.

Header Options
SiteTitle
Thetitleforyoursite
Tagline
Ataglineforyoursite
SiteLogo
Addacustomlogo,recommendedsizeis200pxwideand55pxtall.

Footer Options
SiteCopyright
Enteryoursitecopyrightmessage

Styling Options

LinkColor(Hover)
Selectusingthiscolorpicker
LinkColor
Selectusingthiscolorpicker
HeaderBGColor
Selecttheheaderbackgroundcolorusingthiscolorpicker
HeaderFontColor
Selecttheheaderfontcolorusingthiscolorpicker
PageHeaderBGColor
Selectthebannerbackgroundcolorusingthiscolorpicker
PageHeaderFontColor
Selectthebannerfontcolorusingthiscolorpicker

Header / bbPress / Blog / Knowledge Base Options

Headline
Theheadlinethatappearsinthetopbanneronthispage
Tagline
Ataglineforbeneaththetaglineonthispage

Navigation Options
PrimaryNavigation
selectthemenuyouwanttouseforthemainnavigation,these
canbecreatedoreditedfrom
Appearance>Menus
.

Widgets (bbPress Sidebar and Footer Widgets)

WidgetsShown
add/editwidgetsfromthelivecustomizer.Thesecanalsobe
controlledfrom
Appearance>Widgets
.

9of20

Custom Menus

Tosetupyourcustommenus,navigateto
Appearance>Menus
.Giveyourmenuanameand
builditupusingtheavailablewidgets.Youcanaddavarietyofitemsincludingpages,
categories,customlinks.Toextendtheavailablewidgets,clickthescreenoptionstabatthe
verytopofthescreenandconfigureyouroptions.

Onceyouhavebuiltandsavedyourmenu,simplyselectthethemelocationusingthewidget
ontheleft.

Addingcustommenus

10of20

Widgets

ThisthemefeaturesseveralWidgetizedareas,whichyoucandragndropwidgetitemsto
showsnippetsofcontentinareassuchasheaders,sidebarsandfootersusingthe
WordPresswidgetmanagerwhichcanbeaccessedfrom
Appearance>Widgets
.

TheKnowledgeBaseplugincomewithseveralwidgetsincludingaKnowledgeBaseArticles
widgetfordisplayingknowledgebasearticlesacrossyoursiteandKnowledgeBaseAuthors
toquicklyviewtopauthors.bbPressalsocomeswithanumberofwidgetstodisplaycontent
andfunctionalityfromtheforums.

Thewidgetizedareasincludethedefaultsidebar,BBPressSidebar(ifactive),Knowledge
BaseSidebar,FooterWidgetsandHomepageWidgets.Touseawidgetinoneofthese
areas,dragitfromtheAvailableWidgetspanelontheleftintooneoftheboxedareasonthe
right.Variousoptionscanthenbeset,includingthetitleofthewidgetandwhatcontent
appears.

Widgetavailabilitymaydependonwhatpluginsareinstalledandactivated.

Anexampleofhowthewidgetsareconfiguredinthedemo

11of20

Featured Images

Thethemesupportstheuseoffeaturedimages.Thethemesupportsautoresizingofthe
featuredimages.Autoresizingwillonlyoccurhoweverwhentheimageisuploadedforthe
firsttime,imagesthathavepreviouslybeenuploadedwillnotberesized.Youcanhowever
usethefollowingplugintoregeneratethethumbnails:
http://wordpress.org/extend/plugins/regeneratethumbnails/

Touploadapostthumbnail,goto
Posts>AddNew
oropenanexistingpostineditingmode.
LocatetheFeaturedImagemoduleandclicktheSetfeaturedimagelink.

ClickingthelinkwillopenuptheusualWordPressimageuploaderwhereyouwilluploadyour
image.Simplymakesurethatitiseitherthesamesizeorlargerthanwhatthefinalthumbnail
willbe.Onceyouredoneuploadingtheimage,simplyclickthelinkthatsaysSetFeatured
Image,whichisnexttothebuttontoinsertitintothepost.

FormoreonhowtousetheWordPress'PostThumbnailfeatureyoucanviewthisarticle
http://en.support.wordpress.com/featuredimages/

12of20

Setting up the Demo

Describedbelowisanoverviewofthestepsnecessarytoreproducethedemosite,
accessibleat
demo.herothemes.com/helpguru
.Thesestepsareonlynecessaryifyouwant
yoursitetolooklikethedemositeasyoucanaddyourowncontentimmediatelywithout
goingthroughthesesteps.

1. Installthethemeaspertheinstructionsabove
2. Installandactivateallthefollowingplugins
a. bbPress
b. HeroicKnowledgeBase(includedandautomaticallyactivatedinthetheme)
c. HeroicPostsWidget
d. HeroicSocialWidget
e. HeroicVoting(includedandautomaticallyactivatedinthetheme)
3. ImportthedemoXMLfile
a. Includedinthethemeforestallfiles&documentationpackageisthe
helpguru.wordpress.demo.xml
file.Toimportthedemodata,gotoyour
WordPressdashboardandnavigateto
Tools>Import
selectWordPressand
installtheWordPressimporterifprompted.Active&RuntheImporter.
b. Selectchoosefileandlocatethehelpguru.wordpress.demo.xmlfileonyour
computer.
c. ClickUploadfile&import.
4. Setupthemenus
a. Navigateto
Appearance>Menus
b. Createanewmenucalled
PrimaryNav
andassignthefollowingmenuitems
i.
HomeLink,acustomlinktoyourhomepageeg.
http://demo.herothemes.com/helpguru/
ii.
KnowledgeBaseKnowledgeBaseArchive
iii.
ForumsLink,acustomlinktoyourhomepageeg.
http://demo.herothemes.com/helpguru/forums/
iv.
NewsPage
v.
ContactPage
5. Homepagesettings
a. Navigateto
Settings>Reading
b. Assignfrontpagedisplays
i.
FrontpageHomepage
ii.
PostspageNews
6. Setupthewidgets
a. ThereareanumberofwidgetareasinHelpGuru,seethescreenshotinthe
widgetssectionaboveforanoverviewandthedetailsbelow
i.
Defaultsidebar,contains
13of20

ii.

iii.

iv.

v.

1. Categorieswidget
2. (bbPress)RecentTopicswidget,showing4topicsfromany
bbPresssidebar,contains
1. (bbPress)LoginWidget
2. (bbPress)RecentTopics,showing5topicsfromany
3. (bbPress)Statistics
KnowledgeBaseSidebar,contains
1. KnowledgeBaseArticles,5posts,sortingbypopular,showing
numberofcomments,showarticlerating
2. KnowledgeBaseAuthors,2authors,showinguseravatar
FooterWidget,contains
1. Textwidget,sometextaboutthetheme,automaticallyadd
paragraphs
2. HeroicPostsWidget,Allcategories,2posts,Sortingbydate,
showingpostthumbnail
3. HeroicSocialWidget
HomepageWidgets,contains
1. KnowledgeBaseArticle(PopularArticles)5posts,sortedby
Popular
2. MostHelpfulArticles(MostHelpfulArticles)5posts,sortedby
Helpful
3. (bbPress)RecentTopics5topicsfromany

14of20

Help and Tips

ThissectioncontainsvarioushelpsandtipsformakingthemostoutofyourHeroTheme.

Hero Themes plugins

Thesecomplementarypluginsprovideadditionalfunctionalityforyoursite:

Heroic Social Widget

HeroicSocialWidgetallowsyoutoaddlinkstoallyoursocialmediainawidget,withover80
iconsavailable,thisplugincatersforawidevarietyofsociallinks.

Getitat
http://wordpress.org/plugins/heroicsocialwidget/
orsearch
HeroicSocialWidget
from
Plugins>AddNew>Search

Heroic Favicon Generator

Addfaviconstoyoursitewithease.Thispluginallowsyoutouploadmostimagesforuseas
favicons.

Getitat
http://wordpress.org/plugins/favherofavicongenerator/
orsearch
HeroicFaviconGenerator
from
Plugins>AddNew>Search

Heroic Posts Widgets

TheHeroicPostsWidgetisamoreadvancedpostswidgetfordisplayingcertainposts.
Enhancedoptionsincludeexcludingandreversingpostorder.

Getitat
http://wordpress.org/plugins/heroicpostswidget
orsearch
HeroicPostsWidget
from
Plugins>AddNew>Search

15of20

Customizing the Theme

Thethemehasbeendevelopedtolookgreatonarangeofdevicesandofferarangeof
functionality,thisguidehighlightstherangeofoptionsandconfigurabilityprepackagedwith
thetheme.

Forthoselookingtogobeyondwhatisofferedbythethemepackage,toenhanceormodify
thedefaultlookandfunctionalityoftheWordPressorthetheme,thiscanbedonewithplugins
orcustomization.

Plugins

PluginscanextendWordPresstoprovideavarietyofdifferentfunctionality.Pluginscanbe
addeddirectlyfrom
Plugins>AddNew
.Usethesearchfunctionalitytoinstalldirectlyfromthe
WordPressplugindirectory
orselect
UploadPlugin
atthetopofthepagetouploada
premiumpluginfromamarketplacesuchas
CodeCayon
.

Pleasenotethatwecannotsupport3rdpartyplugins,youmaywishtocontacttheplugin
authortoobtainsupport.Thefirststepweadviseusersthatarehavingissueswiththetheme
istodeactivateadditionalpluginsthatmayconflictwiththetheme.

Customization

Thisthemeincludesaprepackagedchildtheme,whichallowsforcompletelybespoke
developmentofthebase(parent)theme.Youmaywishtoreadthe
ChildThemes
summary
onWordPress.org.

Thekeybenefitsofusingachildthemeisthatitallowsdeveloperstooverridethemestyles
andfunctionality,whileleavingthebasethemeunaltered.Thismakesdevelopmentquicker
andensurescustomizationsareunaffectedbyupdatestotheparenttheme.

Duetothebespokenatureofcustomization,itisoutsidethescopeofthemesupportandwe
cannotsupportmodifiedthemesorchildthemedevelopment.Forassistancewith
customizations,considertheuseofafreelancedeveloper,suchasthoselistedonthe
Envato
Studio
site.

16of20

Translating the Theme

Thethemeandpackagedpluginsaretranslationready.Totranslatethethemesorplugins
youneedtocopyandeditthePOfilecontainedinthelanguagesfolderofthethemeand
pluginsonyoursite.

Ensureallthethemeorpluginfolderofthetranslationtargetisonyourlocalmachinebefore
startingthetranslation.

Copythefileandrenamethefilewiththerelevant
WordPresslocale
,forexampleifyouwere
translatingthefileintoFrench,renamethefilefr_FR.po,orinthecaseofaplugin
plugintextdomain
fr_FR.po,whereplugintextdomainisthenameofthetextdomainthatthe
pluginloads.

Usingaprogramsuchas
POEdit
(http://poedit.net/),youcaneditthetranslationsdirectly,
withthefollowingsteps,outlinedbelow:

1. OpenthePOtranslationfileinPOEdit,firstclick
Update
toupdatethetranslation
source.

UsingPOEdittoparsethetranslationstrings

17of20

2. OpentheCatalogPropertiesfrom
Catalog>Properties
andselectthelanguage,
selectOK.

POEditCatalogProperties

3. Nowyoucangothroughthesourcetextandenteryourtranslations.

4. Click
Validate
then
Save
thetranslations,thePOfilewillbeupdatedandanMOfile
willbegenerated.

5. Uploadthenew/updatedlanguagefilestoyourWordPressinstallation,totherelevant
lang
or
languages
folder.

Anexampleofhowthefilesmaylookinatranslatedplugin/themedirectory
(noteonlyplugintranslationsneedtobeprefixedwiththetextdomain.)

6. SetyourWordPresslanguage,eitherwithapluginsuchas
WordPresslocalize
or
WPML.OrmanuallyupdatetheWP_LANGconstantinyourWordPress
config.php
file.

// WordPress Localized Language, defaults to English.

define ('
WPLANG
', '
fr_FR
');

Foradditionalsupportandguidancewithtranslations,refertothe
TranslatingWordPress
on
theWordPressCodex.
18of20

19of20

Dedicated Support

Needsupport?Weareheretohelp!Headoverto
http://herothemes.com/support/
toaccess
ourdedicatedsupportportal.

YouwillneedyourthemeforestpurchasecodetoregisterforafreeHeroThemes.com
account,thiscanbefoundwhenyouareloggedintoyourthemeforestaccountunder
downloads>itemdownload>licensecertificateandpurchasecode
,see
http://herothemes.com/images/finditempurchasecode.png
formoredetails.

Thanksagainforyourpurchase,wehopeyouenjoyusingyournewHeroTheme.Ifyouhave
anyfeedbackorqueries,pleasegetintouchviaoursupportportal.

Missing style sheet error when installing the theme?

AcommonissuethatcanoccurwithusersnewtoinstallingWordPressthemesisaBroken
themeand/orstylesheetsmissingerrormessagebeingdisplayedwhentryingtouploador
activatethetheme.Thiserrormessagedoesnotmeanthatthethemeyouhavepurchasedis
broken,itsimplymeansithasbeenuploadedincorrectly.
Luckily,thereisaveryeasyfix
.
(
http://support.envato.com/index.php?/Knowledgebase/Article/View/269
)

Images arent loading, pixelated or are missing?

Anotherissue,thistimeaffectingusersinstallingthethemetoreplaceanotheristhatposts
aremissingimages.Thisisbecausethethememayusedifferentimagesizestotheprevious
onewhentheimageswereuploaded.Ensureyouhaveseta
featuredimage
where
appropriate.

Usethe
regeneratethumbnails
plugintoregeneratethethumbnails,availablefrom
Tools>
Regen.Thumbnails
whenthepluginisinstalled.

Getting a 404 error on some pages?

Thiscommonproblemcanberesolvedbyflushingyourpermalinksbyvisiting
Settings>
Permalinks
,thisforcesWordPresstoupdatepermalinks.

20of20