Blackfyre WordPress Theme by Skywarrior Themes
Welcome to the getting started guide for Blackfyre WordPress theme! Thanks for purchasing one of our awesome themes!
This document will cover the most important functionality of the theme and will help you start using your Blackfyre based website.
Need support? Go to support.skywarriorthemes.com
To install Blackfyre you must have a working version of WordPress already installed. For more info on how to install WordPress please see the WordPress Codex: http://codex.WordPress.org/Installing_WordPress
Once you have a running version of WordPress, extract the zipped package downloaded from ThemeForest to your desktop. In the extracted folder you will find the blackfyre.zip file, which is the installable WordPress theme file.
You can install the theme in two ways:
FTP: Extract blackfyre.zip file and upload the extracted folder to the /wp-content/themes/ folder on your server. Change the ftp client transfer mode to Binary if you haven't done it already: Click here if you don't know how.
WordPress: Navigate to the Appearance -> Add New Themes -> Upload page. Select the blackfyre.zip file. Press the Install Now button to upload and install the theme.
After uploading the theme, you have to activate it. Navigate to the Appearance -> Themes page to activate the theme.
Changing the URL structure
To change the URL structure so the URL looks more user-friendly (and will also improve your SEO) navigate to Settings -> Permalinks and under 'Common Settings' select 'Post name' or any other option except default.
Installing the demo data - One Click Install
To do this you will need to head to Theme Options -> One Click Install page of your WP admin panel:
Once there, click on the import button. Please do not navigate outside the page while the data is being imported. After the data is successfully installed, a success message should pop up and the button should be grayed out.
Admin panel options
To customize the look and feel of Blackfyre you need to use the Theme Options panel:
Inside the General Settings tab you will be able to customize the logo and favicon (small icon that appears in the browser tab) by uploading your own images. You will also be able to switch the login area in the header on or off, input you contact e-mail, designate T&C page, enable image reveal effect and customize your ticker news.
Some basic SEO options for your site. You can input your Google Analytics code here.
Fancy some more customizable SEO plugin? We recommend All in One SEO Pack plugin for Wordpress, its free and awesome!
Look and feel customization options for the theme. You'll be able to upload custom backgrounds here, as well as change typography and color scheme.
Information that will appear in the footer of your webpage: copyright text and year.
This section will let you setup login/registration via social networks. Available networks include:
For each of these social networks you will have to create an app and input the app's details into appropriate fields on the Social Settings page.
This section gives you control over social media icons that appear in your website's header and footer area. You can turn on/off each social network icon and input your profile URL for that social network.
One Click Install
This section will let you perform a one-click import of demo content and settings. Head to Installation section for more info.
Special mention: Backgrounds
As outlined in the previous section, you can change your website's background by uploading your background images in Customization section of Theme Options.
As you may have seen, there is also the option to make the footer background repeat. This option will allow you to have a repeated pattern underneath the header background should you wish to do so.
Unfortunately we cannot sell the images that you see in the demo for copyright reasons. However, if you are interested in them you may be able to find some help in the support forum ;)
Setting up the home page
First thing you will probably want to the after installing your new theme is set up its home page. To do this, you will have to create a page with Homepage template, then set that page to be your "Front page" in WordPress' Reading settings. If you are not yet familiar with how to do that, here's a step by step guide:
- In your WordPress admin panel, go to Pages -> Add New.
- Add a title to your page (probably "Home") and add some content to your page.
- On the right-hand side you will see a Page Attributes section - choose Home or Homepage from Template menu.
- Publish your page by clicking a blue button in the top-right side of your screen.
Now that you have successfully created your home page, head to Settings / Reading in your WordPress admin panel. In the Front page displays setting choose the A static page (select below) option. Select the page you have just created from Front page select menu.
Once your home page is ready, head to the next section to learn how to add a slider to your home page!
You can create and manage sliders in Blackfyre Sliders section of your WordPress admin panel. To create a new slider go to Add New Slider page.
There are two ways of setting up a slider: it can either automatically create slides based on chosen post category, or you can manually create slides and upload an image and add a description for each one.
Auto slide creation from post category
You can set your slider to automatically create slides from a chosen post category by choosing a category from the Post category dropdown. Setting this option will force the slider to ignore all slides that you've created manually.
Manual slide management
To manually manage your slides, choose Do not use post slider from the Post category dropdown menu. Then, scroll down and press the Add Image button - a new slide will be created. You can use this method to create as many sliders as you'd like.
For each slide you can upload an image by clicking the slide's gray Add Image button, and add a text by editing the Image description textarea.
It is also possible to reorder already created slides by using drag and drop gesture on the slide's left-most gray area.
Remember that slides that you've added to your slider using this method will be ignored once you select any category from the Post category dropdown!
Using the slider on your pages
Once you are done with editing you slider, hit the publish button and the return back to the Blackfyre Sliders page. Here you'll see a list of all your sliders. Each slider has its own shortcode - copy it.
You can paste this shortcode into the content of any page. To use the slider on a home page you would paste it into Slider shrortcode area when creating a page with Homepage template. This will ensure that your homepage slider it displayed in the main area of the page.
Blackfyre uses Visual Composer addon for page creation. Visual Composer is a complex tool that gives you full control over your WordPress pages with a nice drag and drop editor.
Visual Composer is a complex tool and if you do not know how to use it - we suggest to visit Visual Composer's website: http://vc.wpbakery.com/video-academy/. There you will find a complete set of video tutorials that will help you get started with Visual Composer.
While the content of your WordPress pages can be controlled via Visual Composer, there is also few special page templates, like homepage or blog templates. Page templates often have special layouts or even special functionality.
'Homepage' template, for example, will accept a slide shortcode and display it above page content, while 'Blog' templates won't display any page content (that includes Visual Composer content), but will instead show a list of your blog posts. The same can be said about 'All clans' or 'All matches' page templates, which will ignore page content and display all clans registered on your website.
'Login' and 'My account' templates are speciality pages that are required in order for frontend login functionality to work. 'Login' page will display login and registration forms, while 'My account' page will be used to display user's profile management page. These pages, however, will be automatically created by Blackfyre when the theme is activated.
You can assign templates to pages by editing the Template field in Page Attributes section when creating / editing a page.
Clan Wars is the most unique feature of Blackfyre theme. It lets your users register on your website, create and manage clans and and their members, and, most importantly, challenge other clans!
The website admin (you) has to do some setup before your users can use every feature of Clan Wars. Follow the guide below to setup your Blackfyre website for Clan Wars!
- Install BuddyPress WordPress plugin by going to Appearance -> Install Plugins section of your WordPress admin panel.
Setup BuddyPress with the following components:
- Create pages with the 'All clans' and 'All matches' page templates (page creation guide) and include them in your menu
- Optional: install bbPress WordPress plugin if you want to have a forum functionality on your website. Forums will be integrated into user profiles - when viewing a user profile your users will be able to see forum topics created by the user. Head on to Forums section to learn more.
Create Clan Wars games and maps:
- Games and maps can me managed in Clan Wars section of your WordPress admin panel.
- Only the website admin (you) has privileges to create games and maps so you have to set them up before your users can add games to their clan profiles and your users' clans can challenge each other in these games.
- Games can be created by going to Clan Wars -> Games -> Add New section in your admin panel.
Once you create a game, go back to Clan Wars -> Games, and under the game that you've just created - select the Maps links. From here you can choose Add New to add new map.
Once this initial setup is done, your users will be able to enjoy all features that Blackfyre has to offer!
From now on, the rest of this guide will focus entirely on the frontend of your website, unless noted.
A clan can be created using the Create clan button in the top right corner of the page. Each user can create any number of clans, and can be a member to any number of clans created by others.
When creating a clan, a user can select clan's name, avatar and custom background. He/she will even have access to Visual Composer to create a layout of the clan's page!
Important! During clan creation process, clan admin has to select which games his/her clan plays. Otherwise other clans won't be able to challenge his/her clan. To do that, the clan admin has to add a Games Block Visual Composer element to the clan's page. Here's how to do that:
Click the Add element button
Select the Games Block element
Select games that your clan plays
Becoming a member of another clan
Every user has a possibility to become a member of another clan. To do that, visit another clan's page and click the Request to join button.
Once the request is sent, the clan's admin will see your request on his clan's 'Members' page. Clans admin can then accept or refuse the request.
Clan admins can designate other clan users for administrator role. This can be done from the clan's 'Mambers' tab.
Keep in mind that only one user (the original clan creator) can be a Super Admin of the clan. Only Super Admins can manage clan's page and settings.
Challenging other clans for a match!
Each clan can challenge any other clan (that plays the same game) for a match. To do that, a member of one clan has to visit another clan's page and click the Challenge * Clan button. Once the challenge has been sent, it will appear in another clan's Matches tab, where that clan's user can either accept or refuse the challenge.
Once the challenge has been accepted, the match will appear in both clans' Matches tab.
Once the match expires, users of a clan that took part in that match will be able to input the score for that match. The score has to be accepted by the opposing clan - only then it will be displayed for everyone to see.
Reporting / Flagging matches
Every user can report / flag a match. This can be done by clicking the flag icon in the top-left corner of a match page.
Reported matches will only visible to the website administrator, in the WordPress backend. They will be marked in the Reported column in Clan Wars -> Matches section of WP admin panel.
Website admin will then have a choice to lock the match:
Forums - bbPress
To be able to have forums in your site, you will need to install bbPress, which is free plugin for Wordpress. Blackfyre is fully compatible with bbPress, and you won't need to do any additional steps for it to look as the demo site.
Setting up blog
Blog posts can be added / managed in Posts section of your WordPress admin panel.
Creating a blog post is as easy as going to Posts -> Add New, inputting a title, post content, uploading an image and setting it as a post's featured image (in the bottom right corner of the page). Once you have written a post, you can publish it by pressing the blue Publish button in the right column.
Blog posts will appear on pages with Blog page template - please go to Pages section to learn how to assign a template to a page.
Blog posts can be also used in a slider - go to Slider section of this document to learn more.
WooCommerce - Set up your own shop
Now you can add your own shop to your site with WooCommerce compatibility. To get started you will need to install the free WooCommerce plugin, which you can do from Plugins section of your WordPress admin panel. Here is a list of external documentation that you may need to work with WooCommerce:
- WooCommerce Plugin Page – This is the official WooCommerce plugin page
- WooCommerce Documentation - This is the WooCommerce Online documentation created by WooThemes
- WooComerce Community Forums - This is the community forum for WooCommerce plugin created by WooThemes
- WooComerce Built-In Shortcodes - These are the included shortcodes for WooCommerce, our custom shortcodes are not included in this.
The price tables follow the same principle as the page builder. Once you have created one, simply copy the code and paste it in the page where you want it to appear
To create a price table you need to:
- Go to the Price Tables section of your WP admin panel.
- Add a new table
- Start adding columns and add the information you want
- You can drag the columns and rows to re-arrange them
- You can also add more features with the add link
- Once happy click on publish
On the right side, under the publish button, you will notice a code:
- Copy it and paste it in the page, where you want the table to appear
This template supports 7 widget-ready areas: 1 for the footer area, 1 for the clan war pages, 1 general sidebar, 1 for the homepage, 1 for BuddyPress pages, 1 for the blog and 1 for WooCommerce pages.
The general sidebar are there just in case you want to add some different sidebar to a page
Adding widgets is very easy, just head to 'Appearance' and then 'Widgets'.
Here you will be able to drag and drop the widgets that you want in one of the four sidebars.
What we can help you with
We can help you with any questions about how the theme works and any bugs or errors you might find, for example:
- Which file is some particular code in?
- What can the theme do (and what it can't do)?
- Are there future updates and enhancements planned?
- I found a bug/error!
What we cannot help you with
Themeforest does not require authors to give support in any way shape or form, nor does your purchase of a ThemeForest item come with any guarantee of support in any way. However, we still spend a great deal of time each week providing support for our themes because it's important to us that you get a top-notch product and service.
That said, it is not feasible for us time-wise to provide support beyond questions about how the theme works and fixing any bugs or errors. This includes:
- Customizing the theme
- Adding or modifying the theme functionality
- Teaching you how to use WordPress
- Teaching you how to use image editing programs like Photoshop
- Teaching you how to code
- Support for external plugins
Understood, take me to the support forum!
If you believe that you have found any errors or bugs, do not hesitate to let us know via our support forum. We will try to get it fixed as soon as possible.
Do you like Blackfyre? Rate it!
We hope you guys enjoy using Blackfyre! If you are happy with it, please don't forget to rate it on ThemeForest! (We will love you forever ^^)