# Music Club

Theme Document By Goodlayers
Need Support

### 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 (Full Style)

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 Portfolio
3. Goodlayers Event
4. Goodlayers Song
5. Woocommerce ( optional )
6. 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 :)

### Setting up boxed style

After importing the full demo content style, you can set up the boxed style by

1. Set the boxed layout at the 'Theme option > General > Page Style' section
2. Set the boxed homepage at the 'Settings > Reading' area

### 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

There're 2 option for change header style in this theme, that is

##### Transparent Navigation

Setting this option will enable the navigation to have an opacity which allow you to see the content ( or images ) behind it as you can see here.

##### Hide Title

When you create a page, there'll be option to hide the title out incase you don't want it on any specific page just like the home page on our demo site.

##### Default Navigation Settings

You can apply the default transparent navigation setting at the 'Theme option > General > Page Style' section.

### Changing Logo

You can changing logo at the 'Theme option > Overall Elements > Header / Logo' section. You can upload 2x size image, then specifying the logo size to make it look sharp on retina device as well.

### 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. Revolution Slider
2. Flex/Nivo Slider
3. Post Slider

##### Revolution Slider

1.) Make sure that Revolution Slider plugin is being activated
2.) Please see the slider tutorial document in the zip file you downloaded from themeforest
3.) Go to edit page that you need, then, add page item named 'Revolution Slider'.
4.) Click on gear icon on page item.
5.) Fill the slider alias that you set when you create slider for this.

##### 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.

### 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 )
Content
Box Icon
Column Service
Divider
Feature Media
Notification
Pie Chart
Service With Image
Stunning Text
Skill Bar
Styled Box
Title
Post Type / List Item
Accordion / Toggle Box
Blog Full
Blog Medium
Blog Column
Event Widget
Event List
Event Counter
List With Icon
Portfolio Classic
Portfolio Modern
Member
Price Table
Testimonial
Tab
Media
Banner
Gallery
Gallery Thumbnail Type
Image / Frame
Post Slider
Slider
Album
Player Item
Video
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 and description at the 'Goodlayers Portfolio 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', 'Gallery' and 'Stack images'.
The Slider Title / Caption and Caption Position will be omitted when you select the 'Gallery' type in inside post thumbnail
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 Event

##### 1.) Go to 'Event > Add Events' and fill the info you want.

##### 2.) You can set the event sidebar at the 'Goodlayers Event 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 'Event'.

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

##### 7.) Select category(s), style, thumbnail size and many other options here.

##### 8.) Publish the page.

### Creating Song / Album

##### 1.) Go to 'Song > Add Songs' and fill the song title.

##### 2.) Assign album.

##### 3.) Fill the song info in goodlayers song option.

You can see the list of browser support audio format here

##### 4.) Create a new page and add media item named 'Music Player' Or 'Album List'.

##### 5.) Click on gear icon on page item to set options.

##### 6.) Publish the page.

### Album Styling

##### 1.) Go to Song > Album to create or edit the album

### Shortcodes

##### Complete Shortcodes List Available Here

http://demo.goodlayers.com/flawless/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 )

### 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.....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.

### 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 Revolution 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(revslider.zip)'
3. Extract the file, then copy the folder 'Layerslider(revslider)'
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.

- Go to https://dev.twitter.com/apps
- Sign in on your twitter account
- Click 'Create New Application' button
- fill all required fields

- Click the 'Create Access Token' button
- Fill the data you get on to the provided twitter info fields.

### Snippet Code

Contact Info in Sidebar : place this in text widget

    184 Main Collins Street West Victoria 8007 Australia

    [gdlr_icon type="icon-phone" size="16px" color="#ffffff"] 1800-222-222

    [gdlr_icon type="icon-envelope" size="16px" color="#ffffff"] Contact@flawlesswp.com

    [gdlr_icon type="icon-time" size="16px" color="#ffffff"] Everyday 9:00-17:00

### 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 Album

##### Creating Event

##### Thumbnail Management

##### Create Portfolio / Filter Portfolio

##### Page Builder