Introduction

Thank you very much for choosing our theme. We truly appreciate and really hope that you'll enjoy our theme!
If you like this theme, Please support us by rating us 5 stars (How to rate?)     

Need Support?
If you have any questions regarding to theme issues, please submit a ticket at http://support.goodlayers.com/ (Registration Required)

You may found some hanging issues when you edit the 'Theme Option' on 'Safari Browser in Maverick OS system'. We'd suggest to change it to Chrome or Firefox instead since it cannot handled the large page very well and takes very long time to init the page.

Theme Installation

Once you purchase the theme from themeforest, you'll be able to load 2 file type.
  1. All Files and documentation
  2. Installable Wordpress Theme File
If you select to download all files and documentation ( the zip name will be themeforest-xxx-xxxxx.zip ), you have to extract it out ( to get themename-vxx_xx.zip file ) before installing it to wordpress system.
Install theme via Wordpress Dashboard
  1. Go to 'Appearance > Theme' section
  2. Click 'Add New' and select the 'Upload' option
  3. Upload the zip file
  4. All Done :)
Install theme via FTP
  1. Access to the file on your server using ftp editor program
  2. Go to 'wp-content/themes' folder
  3. Extract the zip file and put the themename-vxx_xx folder there
  4. Go to 'Wordpress Dashboard > Appearance > Theme' section to activate the theme
  5. All Done :)
Install Plugins
After you install the theme, there'll be a list of suggested and recommended plugins at the top of the wordpress dashboard.



If you already hide it out, you can go to 'Appearance > Install Plugins' section instead too.

Importing Demo Content

After activating the theme, there'll be suggested plugin listed at the top ( if there aren't, you can go to 'Appearance > Install Plugins' section as well ).

Try installing and activating these following plugins ( as it effects the importing process ). You can also install all suggested plugins at this step as well.
  1. Goodlayers Importer
  2. Goodlayers Cause
  3. Goodlayers Portfolio
  4. Woocommerce ( optional )
  5. Contact Form 7 ( optional )
Then, go to 'Tools > Import' and select 'Goodlayers Importer' option.



Follow the steps mentioned on the screen, then, you'll get the site like the demo :)

Theme Translation

  • try installing the 'Codestyling Localization' plugin. ( Can be found in 'Plugin > Add New' section )
  • Go to 'Tools > Localization' section.
  • Select our theme or plugin you want to translate to add new language
  • Select the language of your wordpress installation ( Defined in wp-config.php file. Default is en_US )
  • Click rescan, then edit the string
  • Translate the word you want and click the generate .mo file button
You can learn more about how to localize / translate the wordpress string from here as well

Theme Customization / Updatation

Adding new style / script
There're an option at the 'Theme option > General > Page Style > Additional Style / Script' section ( You can add the code directly without any style / script tag )

Adding / modify php code
If you don't want to modify the theme files everytime you update the theme, you have to create the child theme to modify the php code for this. You can find the tutorial about how to create the child theme here



Our theme wrap every function with if( !function_exists('some_function') ) command, so if you want to use any function, just declare it in the function.php file of the child theme and it'll overwrite the existing one.
Updating the theme
There're no auto update function in our theme, so you have to manually install it again. Try following this steps for this.
  1. Download the zip file from themeforest again
  2. Install it to different folder ( or just simply uploading via wordpress dashboard without removing the old one)
  3. Activating new theme version
  4. Set the menu to themes location at the 'Appearance > Menu' section.
  5. Save the theme option once
  6. Make sure everything is working properly and you can remove the old theme files out
You can also follow the theme status update from our facebook or our twitter as well.

Child Theme

To create child theme
If you don't want to modify the theme files everytime you update the theme, you have to create the child theme to modify the php code for this. You can find the tutorial about how to create the child theme here



Our theme wrap every function with if( !function_exists('some_function') ) command, so if you want to use any function, just declare it in the function.php file of the child theme and it'll overwrite the existing one.

Header Style

You can see the header structure from the below image

Creating Menu

1.) First Step
You can create menu by going to 'Appearance > Menu' section.

2.) Mega Menu
There're 2 submenu type in our theme. Normal submenu can be created by indenting the menu as the first screenshot. To create mega menu, you have to select the 'Enable Mega Menu' option on top-level menu, then select the column on the second-level menu.



Here's the sample scenario of how the mega menu is created.

3.) Assign Menu
After you finished creating the menu, try assigning it to themes location at the 'Manage Location' section.

Creating Homepage

Go to 'Page > Add New' to create new page.

You can assign the page sidebar, header background and attribute at the page option area ( Normally it's below where you update the page and select the page template )



You can also load the demo page scenario ( without images included ) at the 'Load Demo Page' section below the page option as well. Please use this option with caution that it will overwrite all settings in this page and this cannot be undone.

Set the page as Homepage
Go to 'Setting > Reading' area. Choose the front page as static page and select the page you want to be homepage.



You have to leave the post page option blank and use blog item ( in our page builder area ) to create the blog page instead.

Creating Slider

There're 3 kinds of slider in this theme.
  1. Layer Slider
  2. Flex/Nivo Slider
  3. Post Slider
Layer Slider
1.) Make sure that Layerslider plugin is being activated



2.) You can learn how to use Layer slider via this video > http://www.youtube.com/watch?v=ZY9SxVyugx4 Or this document http://www.docs.purethemes.net/sukces/layerslider/documentation/documentation.html

3.) Go to edit page that you need to put Layer slider and add page item 'Layer Slider'.



4.) Click on gear icon on page item.



5.) Select slider name that you created in 2.)





Flex/Nivo Slider
1.) Go to page that you need to put slider and add page item 'Slider'.



2.) Click on the gear icon on page item to choose option.

3.) Add images, select slider type and choose thumbnail size.





Post Slider(From Blog Posts)
1.) Go to page that you need to put slider and add page item 'Post Slider'.



2.) Click on the gear icon on page item to choose option.

3.) Select blog category, thumbnail size and other options.





Sidebar Creation

Sidebar can be created at the appearance > widget area.



After you create new sidebar, you can drag any widget into it to fill the content. ( red cross button allow you to remove that sidebar out. )

Assigning the sidebar
After you create sidebar, you can assign it to any page/post/portfolio you want in the page/post/portfolio option area. You can also set the default sidebar for blog page, archive/search page, woocommerce product and woocommerce single page at the 'Theme option > General' section as well.

Page Builder Component

Page builder divided to 3 types
  1. Wrapper Item
  2. Content / Post Type Item
  3. Media Item
Wrapper Item
Wrapper item is the container which allow you to changes the size, layout and style of the displayed item. It divided to 4 different main component.
  1. Full Width : Allows you to display the content out of the container area. ( full width across window screen )
  2. Color Wrapper : Allows you to changes the section background color.
  3. Background Wrapper : Allows you to put custom image or select predefined pattern as background. There're also option to move background while you scroll ( parallax ) the site as well
  4. Column Wrapper : Allows the ability to divide the item to columns. Can put this item inside Background Wrapper and Color Wrapper
Once you add the full width, color or background ( not column ) wrapper item, you can click the gear sign to edit the item parameter

Content / Post Type / Media item
This is an item which display the actual content on your site. You can put these item within the wrapper item. Here's the list of all content / post type and media item ( you can click the link to view image in lightbox )


Once you add the item, you can click the gear sign to edit the item parameter.



Page Item Area

We have 3 sections for page item area.
  1. Above Sidebar Section
  2. Content (With Sidebar) Section
  3. Below Sidebar Section


See how it works here...



Creating Blog

1.) Go to 'Post > Add New' and fill the info you want.


2.) You can set the post sidebar at the 'Goodlayers Post Option' area.


3.) Assign category(s).


4.) Select featured image for thumbnail.(You may skip this if you use post format,... see below for detail) and publish the post


5.) Create a new page and add page item 'blog'.




6.) Click on gear icon on page item to set options.


7.) Select category(s), blog layout, thumbnail size and many other options here.


8.) Publish the page.

Default Sidebar And Thumbnail Size
The default post sidebar(also applied to old posts before activating theme) and the thumbnail size of individual post page can be set at the 'Theme option > General > Blog Style'

Post Format
Normally, when you add images, video, audio in to the content of each post, it'll show among the content area. Post format give you an ability to style them in different ways. You can see all post format style at the top of this link on our demo site.

Here's the list of how each post format will react when you place different content.
  1. Standard : Feature image will be shown above post title | screenshot1 | screenshot2
  2. Image : Place the url of the image at the top of the post and it'll show up above the post title screenshot1 | screenshot2
  3. Gallery : Place the gallery shortcode at the top of the content and it'll show a slideshow above post title | screenshot1 | screenshot2
  4. Aside : All content in aside post format will shows like this | screenshot1
  5. Link : Place link url at the top of the content and it'll link the title of the post to the link you want | screenshot1 | screenshot2
  6. Quote : Place quote html at the top and the rest content will shows as quote author | screenshot1 | screenshot2
  7. Audio : Place audio url or shortcode at the top and it'll showing up above post title | screenshot1 | screenshot2
  8. Video : Place video url or shortcode at the top and it'll showing up above post title | screenshot1 | screenshot2


Creating Portfolio

1.) Go to 'Portfolios > Add Portfolios' and fill the info you want.


2.) You can set the portfolio sidebar / Turn off the portfolio info at the 'Goodlayers Post Option' area.


3.) Assign category(s).


4.) Select featured image for thumbnail and publish the post.


5.) Create a new page and add page item 'Portfolio'.




6.) Click on gear icon on page item to set options.


7.) Select category(s), portfolio layout, thumbnail size and many other options here.


8.) Publish the page.


Portfolio Thumbnail Type

Thumbnail in portfolio list page
You can select type as 'Featured image', 'Video', 'Slider' and for 'Featured image', you'll be able to open lightbox with image, video or you can also let it link to specific url as well.



Thumbnail in portfolio single post
You can select type as 'Image', 'Video', 'Slider' and 'Stack images'.



You can learn more about thumbnail management in 'FAQ > Video Tutorial > Thumbnail Management'.

Portfolio Single Post Layout

There're 3 individual portfolio style which can be changed in the 'Theme option > General > Portfolio' section. ( Also the thumbnail size can be changed at the same place as well. )

Creating Cause

1.) Go to 'Cause > Add Causes' and fill the info you want.


2.) You can set the cause sidebar at the 'Goodlayers Cause Option' area.


3.) Assign category(s).


4.) Select featured image for thumbnail and publish the post.


5.) Create a new page and add page item 'Causes'.




6.) Click on gear icon on cause item to set item options.


7.) Select category(s), cause layout, thumbnail size and many other options here.


8.) Publish the page.


Cause Info

You can fill the cause info at the cause option when you edit each cause.

Current funding value will be automatically increase after there're donation. ( Please see how to set up a paypal account at the FAQ section of this document )

Or if you fill the number, it can overwrited the value set by paypal

Shortcodes

Complete Shortcodes List Available Here
http://demo.goodlayers.com/charityhub/typography/
Or You can use shortcodes easily by clicking on shortcode generator button.



You can also put it in any content/text area.






Thumbnail Size

There're several predefined thumbnail size in our theme. Which you will be able to select it at 'Thumbnail Size' option in theme option, blog item, portfolio item, etc.

You can add, change and delete the size by going to function-size.php file. At the top, you'll see $gdlr_thumbnail_size variable



Try adding ( removing or changing ) new size by adding the line of code in this format.

'SIZE_NAME' => array( 'width'=>'NUMBER', 'height'=>'NUMBER', 'crop'=>true ),
Since the changes only effects the newly uploaded images, after you successfully changed the image size, you may use the 'Regenerate Thumbnail' plugin to generate the thumbnail for old images as well.

The image will be crop ONLY when the uploaded image size is larger than the defined proportion.

If crop option is set to true, it'll cut the excess proportion out ( to maintain the defined proportion ). And when the crop option is set to false, it'll only resize the image to fit the defined width / height. ( so the resized image stays out of the defined proportion in most case. )
Changing the thumbnail size via Child Theme
In case you want to modify the code via child theme, simply add this to function.php file of the child theme for this.

add_filter('gdlr-thumbnail-size', 'my_custom_image_size');
function my_custom_image_size( $size ){
	return array(
		'post-thumbnail-size' => array('width'=>650, 'height'=>265, 'crop'=>true),
		'small-grid-size' => array('width'=>400, 'height'=>300, 'crop'=>true),
		'portfolio-detail' => array('width'=>400, 'height'=>230, 'crop'=>true),
		'portrait' => array('width'=>440, 'height'=>550, 'crop'=>true),
		'post-slider-bottom' => array('width'=>650, 'height'=>385, 'crop'=>true),
		'post-slider-side' => array('width'=>650, 'height'=>325, 'crop'=>true),
		'full-slider' => array('width'=>980, 'height'=>380, 'crop'=>true),
	);
}

Changing Theme Color / Font

Changing Theme color
There're 2 ways to change the theme color
  1. Theme option
  2. Wordpress Customizer
Using wordpress customizer, you can see the color changes in realtime. You can edit this option by going to 'Appearance > Customizer' section.
Font Size / Family
You can change the font size / family at the 'Theme option > Font Settings' area.

To upload new font, go to 'Theme option > Font Settings > Upload Font' section. Add new font, fill the font name and upload the eot AND ttf font in the provided fields. ( Both font type are necessary for support of font among different browsers )

Setting Up Donation Form

You have to fill the donation form field at 'theme option > general > cause style' ( or on each individual cause option ) with this shortcode.

		
[gdlr_paypal user="YOUR_PAYPAL_USER" action="https://www.paypal.com/cgi-bin/webscr" stripe_receiver_email="YOUR_EMAIL" stripe_secret_key="" stripe_publishable_key="" stripe_currency_code="usd" ]		


After that try accessing to your paypal account, go to 'Profile > My Selling Tools' and click to update the 'Instant payment notifications' section.



Then fill your site url + ?paypal at the notification url section



After doing this the current amount of each cause and an email will be sent to the customer after their donation is complete.
Testing Paypal
Sandbox is a test paypal platform that helps you setting up the test environment. You can register the developer and create sandbox account here

To Test the sandbox account you have to
  1. change the shortcode action url to https://www.sandbox.paypal.com/cgi-bin/webscr
  2. go to plugin/paypal.php file (in the theme folder), around line 134, change
    					
    $ch = curl_init('https://www.paypal.com/cgi-bin/webscr');
    
    to
    	
    $ch = curl_init('https://www.sandbox.paypal.com/cgi-bin/webscr');
    
  3. fill the user CREATED FROM SANDBOX account
DON'T FORGET TO CHANGE IT BACK TO NORMAL PAYPAL ACCOUNT AFTER THE TESTING IS DONE TOO.
Testing Stripe
- Go to this url and logging in to your stripe account to get the API Key https://dashboard.stripe.com/account/apikeys



- Fill the stripe API infomation in the shortcode mentioned above

- If you fill the test key, you can the test card from this link https://stripe.com/docs/testing

How to Update Theme

To update the theme, You need to login to your Themeforest profile page, click on 'download' tab, then download the theme again. After that,
  1. After you downloaded file from Themeforest. Do not upload it yet. Extract it!
  2. You will find 6-7 folders and some files inside. You'll see the file called 'THEMENAME-vx-xx.zip'
  3. Upload this file through wp backend and activate the theme.
  4. After that go to 'appearance > menu' and assign menu location again then go to admin panel and click 'save changes'.
  5. Go to 'Appearance > Plugins', active Goodlayer plugin again.
*BTW, Make sure that you haven't changed or customize any theme code.. if you did, you have to do it again. All setting in admin panel and page will be the same.

Please also read 'Updating GoodLayers Plugin' and 'Updating Layer Slider' if it get updated.

How to GoodLayers Plugins

First of all, please note that you can't use this method with Layer Slider and Revolution Slider.
  1. Go to 'Appearance > plugin', deactivate Goodlayers plugins and delete them. :
  2. After you delete them, you'll see this message :

    Click on 'Begins installing plugins'
  3. Install them and don't forget to activate too! :

How to Layer Slider

  1. After you download theme package from Themeforest, Extract the package and go to folder 'THEMEMAME-vx-xx'
  2. Go to the path, 'include/plugin/plugins/LayerSlider.zip'
  3. Extract the file, then copy the folder 'LayerSlider'
  4. Access to your site via FTP, to the path 'wp-content/plugins'
  5. Replace the existing folder in this path with the one you copied from 3.)

How to get twitter authentication info

There're 4 fields available when you use twitter widget. You have to follow these following steps to get all twitter access info for this.
  • Click the 'Create Access Token' button
  • Fill the data you get on to the provided twitter info fields.

How to get twitter authentication info

There're 4 fields available when you use twitter widget. You have to follow these following steps to get all twitter access info for this.
  • Click the 'Create Access Token' button
  • Fill the data you get on to the provided twitter info fields.

Snippet Code

Footer 1 : place this in footer widget

[gdlr_icon type="icon-phone-sign" size="14px" color="#dadada"]Phone : 1800-222-222
[gdlr_space height="10px"]
[gdlr_icon type="icon-envelope" size="14px" color="#dadada"]Email : [email protected]
[gdlr_space height="10px"]
[gdlr_icon type="icon-home" size="14px" 
color="#dadada"]Address : 654 Kingsland Rd. Bighouse London 198765 

[gdlr_icon type="icon-facebook" size="20px" color="#fff"] [gdlr_icon type="icon-twitter" size="20px" color="#fff"] [gdlr_icon type="icon-dribbble" size="20px" color="#fff"] [gdlr_icon type="icon-pinterest" size="20px" color="#fff"] [gdlr_icon type="icon-google-plus" size="20px" color="#fff"] [gdlr_icon type="icon-instagram" size="20px" color="#fff"]
Footer 4 : place this in footer widget


Praesent commodo cursus magna, vel scelerisque nisl consectetur et. Donec sed odio dui. Nullam id dolor id nibh ultricies vehicula ut id elit.
Top bar right text : place this in 'Theme option > Overall Elements > Top Bar > Top Bar Right Text'

FAQ | What We Do | Our Story | Be A Volunteer | Contact Us
Logo right text : place this in 'Theme option > Overall Elements > Header / Logo > Logo Right Text'

[gdlr_icon type="icon-phone" size="13px" color="#ffff"] 1800-222-223-22 [gdlr_icon type="icon-envelope" size="13px" color="#ffff"] [email protected]
Copyright right text : place this in 'Theme option > Overall Elements > Copyright > Copyright right text'

FAQ | What We Do | Our Story | Be A Volunteer

Video Tutorials

Don't forget to change video quality to 720p(HD) by clicking on the gear icon at the bottom right.
Theme Installation
Setting Up as Demo
Creating Blog
Creating Gallery
Thumbnail Management
Create Portfolio / Filter Portfolio
Creating Cuase List