Readme WP Documentation

Overview of the theme, its contents, and how to get started with the theme.

Thank you for purchasing our theme. If you have any questions that are beyond the scope of this help file, you can sign in to our support forums with your Item Purchase Code. And please rate the theme on ThemeForest if you liked it. Thanks so much!

- Pixelwars Team

Support Forums

Any questions that are beyond the scope of this help file, use support forums.

Visit Support Forums

Follow Us

Follow us on ThemeForest and don't miss new upcoming premium themes.

Follow us on ThemeForest

Rate Theme

If you liked the theme you can rate it on ThemeForest in your downloads menu.

Rate on ThemeForest

We assume you have basic knowledge of WordPress. In this doc you will learn how to setup, use and customize the theme.

Install Theme

Install the theme via WP admin.

Go to: Appearance > Themes > Add New > Upload.

Install and activate the theme.

OTHER WAYS TO INSTALL A THEME

How To Update The Theme

Before you update, it is best practice to always make a backup of your theme folder.

Download the new theme package from your ThemeForest account.

The theme is under "Theme" folder in the package.

Choose to upload the theme via FTP or via WordPress.

Update Your Theme via FTP

There are two ways of getting files onto your site, and once there, changing them.

  1. By using an FTP client.
  2. By using the file manager provided in your host's control panel.
  • Go to "/wp-content/themes/" location and backup your current theme folder by saving it to your computer, or you can choose to simply delete it. Your content will not be lost. (The translation files are located under languages folder in the theme folder.)
  • Retrieve the new zipped theme file from your new ThemeForest download, and extract the file to get the theme folder.
  • Then simply drag-and-drop (Upload) the new theme folder into "/wp-content/themes/" location, and activate the theme in the "Appearance > Themes" section. (Choose to "Replace" the current one if you did not delete it.)

Update Your Theme via WordPress

  • You need to deactivate your theme in the "Appearance > Themes" section by simply activating a different theme. Once you activate a different theme, you can delete your theme. Don't worry, your content will not be lost. (The translation files are located under languages folder in the theme folder.)
  • Then simply upload the new theme file in the "Appearance > Themes" section.
  • Once it uploads, choose to activate the theme.

WordPress Settings

Go to: Settings > Permalinks.

Select post name option for using Portfolio and Gallery.

Sample Data

Go to: Tools > Import > WordPress.

WordPress might offer you to install the WordPress Importer plugin, if you haven't installed it before do it now.

Install and activate the plugin.

Once you've installed WordPress Importer plugin, browse to the package folder, select XML data file and upload it.

Go to: Settings > Reading. Select homepage and blog page.

Go to: Appearance > Menus. Select theme location for the imported custom menu.

Custom Menu

Go to: Appearance > Menus. Create a custom menu.


Check theme location for the custom menu.

Custom Theme Widgets

This theme has custom widgets. Drag and drop widgets to widget locations.

Go to: Appearance > Widgets.

Shortcode Generator

Use shortcode generator to add shortcodes. Click the "Insert Shortcode" button from the content editor.

Post Formats

Aside:

Use [aside_wrap] shortcode.

Example:

[aside_wrap]Text here.[/aside_wrap]

Link:

Use [link_wrap] shortcode.

Example:

[link_wrap]Link here.[/link_wrap]

Quote:

Use [quote] shortcode.

Example:

[quote align="" name=""]Text here.[/quote]


align="" ... alignleft, alignright

Chat:

Write this type of conversation.

Example:

JOHN: Hey there

MARY: Aye, matey!

JOHN: Huh?

Gallery:

Use slider box to add images to your post.

Audio:

Use media box to add audio to your post.

Video:

Use media box to add video to your post.

Activate

Activate the slider from Theme Options > Blog > Main Slider.

Main Slider shows sticky posts.

  • Go to: Posts > Add New.
  • Set featured image.
  • Edit visibility option in the Publish box to make sticky post.
  • Publish your post.

Note: This theme uses custom image sizes. If you have images in your Media Library, run Regenerate Thumbnails plugin once. Install and activate the plugin then go to Tools > Regen. Thumbnails.

Template

This theme have custom page templates you can use for certain pages that might have additional features or custom layouts. You can see them in the Template dropdown menu.

Select a template for your pages from Page Attributes box.

Portfolio Page

Create a new page. Select "Portfolio" template from Page Attributes box.

Add Portfolio Item

Go to: Portfolio > Add New:

Set featured image.

Select type from Details box.

Shortcode Generator

Use shortcode generator to add shortcodes. Click the "Insert Shortcode" button from the content editor.

Portfolio Item Types

Lightbox Gallery

Use [portfolio_lightbox_image] shortcode.

Example:

[portfolio_lightbox_image first_item="" title="" url=""]


first_item="yes" ... Use for the first item.

url="" ... An image url. Upload your image to your Media Library, then copy its url and use in this parameter.


Example 1: (one image)

[portfolio_lightbox_image first_item="yes" url=""]


Example 2: (two images)

[portfolio_lightbox_image first_item="yes" url=""]
[portfolio_lightbox_image url=""]


Example 3: (three images)

[portfolio_lightbox_image first_item="yes" url=""]
[portfolio_lightbox_image url=""]
[portfolio_lightbox_image url=""]

Lightbox Audio

Use [portfolio_lightbox_audio] shortcode.

Example:

[portfolio_lightbox_audio first_item="" title="" url=""]


first_item="yes" ... Use for the first item.

url="" ... A media url.


Example:

[portfolio_lightbox_audio first_item="yes" url="https://w.soundcloud.com/player/?url=https%3A//api.soundcloud.com/tracks/138713427&auto_play=false&hide_related=false&visual=true"]

Lightbox Video

Use [portfolio_lightbox_video] shortcode.

Example:

[portfolio_lightbox_video first_item="" title="" url=""]


first_item="yes" ... Use for the first item.

url="" ... A media url.


Example:

[portfolio_lightbox_video first_item="yes" url="http://vimeo.com/79380715"]

Multiple Portfolios

Note: Read carefully and try to understand how this functionality works.

You need a page with the template “Portfolio” if you want to use only one page portfolio on your site. But you don’t need any page for multiple portfolios on your site. Because the unlimited portfolio functionality doesn’t need any page to show portfolio items on your site. It works based on departments.

In multiple portfolios, every parent department works a different portfolio page.

Shortly:

Create parent departments. They will be your different portfolio pages. And create sub departments for your parent departments. These will be your portfolio filters.

Go to Appearance > Menus. Open the Departments box from the Screen Options panel.

Add your parent departments to your menu. These are portfolio pages.

Add new portfolio items to your sub departments.

Books Page

Create a new page. Select "Books" template from Page Attributes box.

Add Book

Go to: Books > Add New.

Use content editor and Details box.

Shortcode Generator

Use shortcode generator to add shortcodes. Click the "Insert Shortcode" button from the content editor.

All Shortcodes

Grid

[row]Column shortcode here.[/row]

[column width=""]Content here.[/column]


width="" ... 1 to 12. (required). 12 = 100%, 6 = 50%, 3 = 25%.

width_xs="" ... 1 to 12. (optional). Extra small devices - Phones (<768px).

width_md="" ... 1 to 12. (optional). Medium devices - Desktops (≥992px).

width_lg="" ... 1 to 12. (optional). Large devices - Desktops (≥1200px).

section_title

[section_title align="" text=""]


align="" ... center

button

[button text="" url="" target="" color="" size="" icon=""]


target="" ... _blank

color="" ... red, green, blue, yellow

size="" ... small, big

icon="" ... heart, paper-plane, down-outline, thumbs-up

launch_button

[launch_button]Button shortcode here.[/launch_button]

call_to_action

[call_to_action title="" text=""]Button shortcode here.[/call_to_action]

project_action

[project_action]Button shortcode here.[/project_action]

social_icon

[social_icon_wrap]
[social_icon type="" url=""]
[social_icon type="" url=""]
[social_icon type="" url=""]
[/social_icon_wrap]


type="" ...

facebook, twitter, linkedin, google-plus,

pinterest, github, behance, dribbble, instagram,

lastfm, vimeo, forrst, skype, picasa, youtube, flickr,

tumblr, blogger, delicious, digg, friendfeed, wordpress,

foursquare, xing, soundcloud, slideshare, fivehundredpx,

weibo, stack-overflow, vine, vkontakte, rss


Note: You can use your site's feed url for the rss icon: http://www.yoursite.com/feed/

portflio_field

[portflio_field]Content here.[/portflio_field]

lightbox

[lightbox_wrap type="" thumbnail=""]
[lightbox_image first_item="yes" title="" url=""]
[lightbox_image title="" url=""]
[lightbox_image title="" url=""]
[/lightbox_wrap]


[lightbox_wrap type="" thumbnail=""]
[lightbox_audio title="" url=""]
[/lightbox_wrap]


[lightbox_wrap type="" thumbnail=""]
[lightbox_video title="" url=""]
[/lightbox_wrap]


type="" ... image, audio, video

first_item="" ... yes

portfolio_lightbox_image

[portfolio_lightbox_image first_item="" title="" url=""]


first_item="yes" ... Use for the first item.

url="" ... An image url. Upload your image to your Media Library, then copy its url and use in this parameter.


Example 1: (one image)

[portfolio_lightbox_image first_item="yes" url=""]


Example 2: (two images)

[portfolio_lightbox_image first_item="yes" url=""]
[portfolio_lightbox_image url=""]


Example 3: (three images)

[portfolio_lightbox_image first_item="yes" url=""]
[portfolio_lightbox_image url=""]
[portfolio_lightbox_image url=""]

portfolio_lightbox_audio

[portfolio_lightbox_audio first_item="" title="" url=""]


first_item="yes" ... Use for the first item.

url="" ... A media url.


Example:

[portfolio_lightbox_audio first_item="yes" url="https://w.soundcloud.com/player/?url=https%3A//api.soundcloud.com/tracks/138713427&auto_play=false&hide_related=false&visual=true"]

portfolio_lightbox_video

[portfolio_lightbox_video first_item="" title="" url=""]


first_item="yes" ... Use for the first item.

url="" ... A media url.


Example:

[portfolio_lightbox_video first_item="yes" url="http://vimeo.com/79380715"]

intro & rotate_words

[intro image=""]
[rotate_words titles=""]
[/intro]


titles="" ... Seperate with commas.


Example:

[intro]
Hello. I am a [rotate_words titles="writer,freelancer"]
[/intro]

tagline

[tagline]Text here.[/tagline]

drop_cap

[drop_cap]Text here.[/drop_cap]

quote

[quote align="" name=""]Text here.[/quote]


align="" ... alignleft, alignright

full_width_image

[full_width_image]
Image here.
[/full_width_image]

alert

[alert type="" title=""]Text here.[/alert]


type="" ... info, success, error

contact_form

[contact_form captcha="" to="" subject=""]


captcha="yes"

latest_from_the_blog

[latest_from_the_blog items="" category_slug="" meta=""]


items="" ... Number of items to show.

category_slug="" ... Separate with commas.

meta="" ... time, date, category.


Example 1:

[latest_from_the_blog]


Example 2:

[latest_from_the_blog items="10" category_slug="cat-a,cat-b" meta="date"]

slider

[slider autoplay="" animation="" direction="" pause_on_hover="" interval="" animation_speed=""]
[slide title="" image=""]
[slide title="" image=""]
[slide title="" image=""]
[/slider]


image="" ... An image url. Upload your image to your Media Library, then copy its url and use in this parameter.

autoplay="" ... true, false.

animation="" ... slide, fade.

direction="" ... horizontal, vertical.

pause_on_hover="" true, false.

interval="" ... 3000 (millisecond).

animation_speed="" ... 600 (millisecond).


Example 1:

[slider]
[slide image=""]
[slide image=""]
[slide image=""]
[/slider]


Example 2:

[slider autoplay="false" animation="slide" direction="horizontal" pause_on_hover="true" interval="3000" animation_speed="600"]
[slide title="" image=""]
[slide title="" image=""]
[slide title="" image=""]
[/slider]

tab

[tab_wrap titles="" active=""]
[tab]Text here.[/tab]
[tab]Text here.[/tab]
[tab]Text here.[/tab]
[/tab_wrap]


titles="" ... Separate with commas.

accordion

[accordion_wrap]
[accordion title=""]Text here.[/accordion]
[accordion title=""]Text here.[/accordion]
[accordion title=""]Text here.[/accordion]
[/accordion_wrap]

toggle

[toggle_wrap]
[toggle title=""]Text here.[/toggle]
[toggle title=""]Text here.[/toggle]
[toggle title=""]Text here.[/toggle]
[/toggle_wrap]

service

[service icon="" icon_url="" title="" title_url="" text="Text here."]Or text here.[/service]


icon="" ... feather, camera-outline, android, apple

icon_url="" ... A target url.

fun_fact

[fun_fact icon="" icon_url="" text="" text_url=""]


icon="" ... thumbs-up, github-circled, mic-outline, pin-outline

icon_url="" ... A target url.

skill

[skill_wrap]
[skill title="Fireworks" percent="90"]
[skill title="Photoshop" percent="70"]
[skill title="Illustrator" percent="50"]
[/skill_wrap]

testimonial

[testimonial_wrap]
[testimonial image="" title="" sub_title=""]Text here.[/testimonial]
[testimonial image="" title="" sub_title=""]Text here.[/testimonial]
[testimonial image="" title="" sub_title=""]Text here.[/testimonial]
[/testimonial_wrap]


image="" ... An image url. Upload your image to your Media Library, then copy its url and use in this parameter.


Example:

[testimonial_wrap]
[testimonial image="http://themes.pixelwars.org/readme-wp/wp-content/uploads/2014/08/testo-01.jpg" title="Vincent Wood" sub_title="CEO / Gravity Inc."]He is a great and hardworking guy. I am so proud of i have him as my asistant. He helped me so much. Also i am so proud of i have him as my asistant. He helped me so much.[/testimonial]
[testimonial image="http://themes.pixelwars.org/readme-wp/wp-content/uploads/2014/08/testo-02.jpg" title="Gary Morgan" sub_title="Chemist / Freelancer"]He was a great co-worker and a friend. I would't be where i am without his support.[/testimonial]
[testimonial image="http://themes.pixelwars.org/readme-wp/wp-content/uploads/2014/08/testo-03.jpg" title="Jason Wilson" sub_title="Lab Geek / Miami Metro"]He is ok. I don't really know him. He looks nice.[/testimonial]
[/testimonial_wrap]

tag

[tag_wrap]
[tag text=""]
[tag text=""]
[tag text=""]
[/tag_wrap]

link_wrap

[link_wrap]Link here.[/link_wrap]

aside_wrap

[aside_wrap]Text here.[/aside_wrap]

timeline

[timeline]
[event_group_title icon="" text=""]
[event current="" date="" title="" sub_title=""]Text here.[/event]
[event current="" date="" title="" sub_title=""]Text here.[/event]
[event current="" date="" title="" sub_title=""]Text here.[/event]
[/timeline]


icon="" ... bookmark-empty, graduation-cap

current="" ... current

media_wrap

Embed Media: YouTube, Vimeo, SoundCloud etc.


[media_wrap]iframe code here.[/media_wrap]

Self-hosted Video

Self-hosted Video:


[media_wrap][video url="" poster=""][/media_wrap]


url="" ... Video file url.

poster="" ... Image url.

Self-hosted Audio

Self-hosted Audio:


[media_wrap][audio url="" poster=""][/media_wrap]


url="" ... Audio file url.

poster="" ... Image url.

Theme Options

This theme has a settings panel for customization.

Go to: Appearance > Theme Options.

Theme Customizer

This theme supports the live theme customizer.

Go to: Appearance > Customize.

Disable Comments

Every post/page has a "Quick Edit" link when you hover in the item list. Click the link to open "QUICK EDIT" menu then uncheck the "Allow Comments" option.

Related Posts

Use this plugin: Yet Another Related Posts Plugin ( YARPP )

YARPP Style Customization:
  • Go to: Settings > YARPP.
  • Change "Before / after related entries:" inputs like this:
  • For before: <div class="related-posts"><h3>RELATED POSTS</h3><ol>
  • For after: </ol></div>

This theme is ready for localization. We have made every string translatable, use Codestyling Localization plugin or Poedit editor.

The translation files are located under languages folder in the theme folder.

How to use Codestyling Localization plugin?

  • Install and activate the plugin,
  • Go to: Tools > Localization > Themes,
  • Select your language flag in the flag list that must be bold text or click Add New Language button to add new one,
  • Firstly click Rescan button and scan the theme files then click Edit button,
  • All translatable strings will listed in the table,
  • Every string has Edit link in the opposite of it, click the link to translate,
  • Finally click generate-mo file button at the top side of the page.