This has the writen documentation for the Earth WordPress Theme. For video instructions please checkout the Theme Page. Please read the documentation and watch the videos before seeking support. Thanks!

Installing The Theme

You'll want to install this theme just like any other WordPress theme, either by uploading the main theme folder via FTP (unzipped) or the zipped file via the Wordpress theme upload section

Using FTP

  • Log into your site via FTP
  • Browse to your folder located at wp-content/themes
  • Upload the MAIN theme folder. This is the folder located inside the "upload" folder in the zip file that you downloaded from Themeforest.
  • Log Into Wordpress and go to Apperance --> Themes
  • Find the theme and click to activate

Using Wordpress

  • Log into your WP dashboard
  • Browse to Apperance --> Themes
  • Click to "add new" and then follow the instructions on the screen
  • When it askes to select a file find the zipped theme folder located in the "upload" folder in the zip downloaded from Themeforest.

Uploading The Sample Data

This theme includes a sample.xml data file which will allow you to upload some dummy content to your site to help you get started with the theme.

  • Unzip the folder you downloaded from themeforest
  • Browse to the folder called "SampleData"
  • Find the sample-data.xml file
  • Log into WordPress
  • Go to Tools --> Import
  • Click on "WordPress"
  • If you don't have it already, install the plugin. Once done, return to the previous screen
  • Click to select your file
  • Choose the "sample-data.xml" file located previously

Theme Settings Panel

This theme includes a whole Administration panel that will allow you to change various aspects of the theme such as the logo, color scheme, gallery options...etc.

To access the theme settings panel simply...

  • Log into your WordPress dashboard
  • Go to Apperance --> Theme Options

Featured Images

You must know how to add featured images to your theme. If you don't know how, please checkout the following video - http://www.youtube.com/watch?v=BqdL2AUV-yo&list=UUrV9S06EqgWVAOAxnWE-AnQ&index=1&feature=plcp

Change Featured Image Cropping Location

By default WordPress crops all images right in the middle. If you want to change this I suggest downloading and using the "Focus Point" plugin, but there are many other great options for changing the location of the featured image crop.

Setting Up Your Homepage

By default this theme will automatically show the blog style homepage. To show the homepage layout like in the demo you must create a new page, select the homepage template and then under Settings --> Reading use this page as the "static page" option.

Homepage Modules

The homepage is custommizable via the theme panel. If you go to Apperance --> Theme Options and click on the home tab you can see all the homepage options. Easily move the modules around to enable/disable them as well as customize via the available fields/options.

Click on a Module to drag and re-order it or disable it.
Highlights - Shows your HP Highlight posts in 3 columns. Supports text, title, shortcodes, featured images.

Events & Blog - Shows your events farthest away in the future or your featured events on a left column and then your recent blog posts or featured blog category on a right column

Gallery - Shows your 12 latest gallery items.

Static page - You can pull the "content" of any static page onto the homepage. Great for adding shortcodes to your homepage.

Help I can't see my homepage modules!- try clicking the reset button in the theme panel, this should fix the issue.

This theme makes use of the latest WP menu system.

  • Go To Apperance --> Menu
  • Create A New Menu by clicking the little + tab
  • Add your menu items by selecting them on the left side
  • Choose your menu location. This theme includes 3 menu locations: one for the top bar, one for the main navigation and one in the footer.

Adding A Home Button

Adding a home button to your site is really easy. Simply go to the "pages" section on the left and click the "ALL" tab. The first option should be to add a home link

Adding Sliders

* Adding a sliders to your site is very easy. All you need to do is create your slides via the custom post type called "Slides"

* Each post is 1 slide and you can organize these into categories (sliders). So you can choose which to show where.

* For the homepage it will automatically show all your slides unless you define a specific category in the theme panel under the homepage tab.

* For pages/posts you can select your slider via the drop-down meta option.

Creating A Gallery Page

To create your gallery page all you have to do is...

  • Log Into WordPress
  • Create a new page
  • Under "Page attributes"select the "Gallery Template
  • Publish
  • Your gallery items will appear automatically

Creating The Blog Page

  • Log into Wordpress
  • Add a new page
  • Select The Blog Page template
  • Publish
  • All your blog posts will show up automatically

If you are having any issues with the blog, make sure under Settings --> Reading that the value for "Posts Page" is left blank.

Adding Events

Adding events is really easy and should be pretty straight foward

  • Log into Wordpress
  • Click on the Events Tab
  • FAdd title at the top, description in the post editor and then fill out the details below.
  • Publish

Creating The Events Page

  • Add a new page
  • Select the Event page template
  • Publish

Create The Events Calendar page

  • Log into Wordpress
  • Click to add a new page
  • Select the events calendar template.
  • Publish

Shortcodes

The theme has a built-in shortcodes editor..

Shortcodes Reference List

However, if you want to add them manually, check out the shortcodes below.



HR (divider)

[hr style=dashed-line margin_top=35 margin_bottom=0]
Options:
  • style: dashed-line, double-line, dotted-line, solid-line

Lists

The shortcode: 
[list type=bullets-blue]Your UL List[/list]
Options:
  • Type: check, bullets-gray, bullets-red, bullets-purple, bullets-blue, bullets-black

Alerts

[alert color=black align=""]Your Text[/alert]
Options:
  • color: red, green, blue, yellow
  • align: none, left, right

Buttons

[button color='pink" url="#" target=""]Button Text[/button]
Options:
  • color: gray, blue, green, orange, black, rosy, pink, purple, brown, light-gray, gold, copper, teal
  • target (optional): blank, self

Accordion

[accordion]
    [accordion_section title="Section 1"]
        Etiam rhoncus accumsan elit sed porta. Suspendisse potenti.
    [/accordion_section]
    [accordion_section title="Section 2"]
        Etiam rhoncus accumsan elit sed porta. Suspendisse potenti.
    [/accordion_section]
[/accordion]

Toggle

[toggle title="This Is Your Toggle Title"]
	Etiam rhoncus accumsan elit sed porta. Suspendisse potenti.
[/toggle]

Tabs

[tabgroup set="2" titles="tab 1, tab 3, tab 3, tab 4, tab 5"]
	[tab set="2" position="1"]This is tab 1[/tab]
	[tab set="2" position="2"]This is tab 2[/tab]
	[tab set="2" position="3"]This is tab 3[/tab]
	[tab set="2" position="4"]This is tab 4[/tab]
	[tab set="2" position="5"]Tab 5[/tab]
[/tabgroup]

Each tabgroub needs a unique set value and the inner tabs must also have this set attribute. Seperate the titles for the tabs using comas. Shortcodes are allowed inside tabs.

Google Map

    [googlemap width="420" height="300" src="YOUR HERE"]

Simply change the width and height values to what you want and the SRC value to your google map url. See image below:

Normal Columns

[column size=half position=first]Your Content[/column]
Options:
  • size: half, third, fourth
  • positon: first, inner, last
  • offset: one, two (one for third and fourth sizes)

If you experience any floating issues with the columns, use the [clear] shortcode to clear the floats.

Offset Columns (1/3 + 2/3)

[column offset=one size=third position=first]content[/column]
[column offset=two size=third position=last]content[/column]

Offset Columns (1/4 + 3/4)

[column offset=one size=fourth position=first]content[/column]
[column offset=three size=fourth position=last]content[/column]

Adding A Contact Form

This theme doesn't have a built-in contact form, but it does have included styles for the Contact Form 7 Plugin. So I would highly recommend using that plugin. Of course any should work.

Translating The Theme

This theme has been localized and it includes a .po and .mo file so you can translate the theme to your own language.

Step 1: Copy Default.po File

Located in the "lang" folder of the theme is a file called default.po. Copy this file to your desktop for editing.

Step 2: Edit Default.po File

Open the .po file using a program like PoEdit.

Click on the text to edit and enter your translation in the bottom box

Step 3: Save Default.po File

Next you have to save your .po file using the naming convention is based on the language code (e.g. pt for Portuguese) followed by the country code (e.g. _BR for Brazil). So, the Brazilian Portuguese file would be called pt_BR.po.

When saing your .po it will automatically create a new .mo file for you, with the same naming convention ( so using the example above, the file would be called pt_BR.mo

Step 4: Upload New Files

Upload the .po and .mo files you just created to your /lang folder so they are in the same directory as the default.po and default.mo

Step 5: Edit Your WP-Config File

The last step is to tell WordPress what languange to show

Open your wp-config.php file in a text editor and search for:

define ('WPLANG', '');

Edit this line according to the .mo file you've just downloaded, e.g. for the Portuguese spoken in Brazil you must add: 

define ('WPLANG', 'pt_BR');

Resources Used

The following resources where used in the development of this theme: