# Real Factory

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)

##### Video Tutorials

You can change video quality to 720p(HD) by clicking at the gear icon at the bottom right of the video.
Installation
Importing Demo
Creating Portfolio
Creating Personnel
Creating Blog
Goodlayers Page Builder

### 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 file name will be themeforest-xxx-xxxxx.zip ), you have to extract it out ( to get realfactory.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 "realfactory.zip" file
4. All Done :)

##### Install theme via FTP

1. Access to the file on your server using hosting control panel or ftp editor application
2. Go to "wp-content/themes" folder on your wordpress installation
3. Extract the zip file and put the "realfactory" folder there
4. Go to "Appearance > Theme" section to activate the theme
5. All Done :)

### Plugins Installation

After you install and activate the theme, the "goodlayers-core" plugin will automatically installed and redirect you to the "Getting Start" page. You may click the "Install Required Plugins" button to proceed the plugin installation.
If the "Goodlayers > Getting Start" section is not showing up, you may manually go to "Appearance > Install Plugins" section to install the necessary plugins.
** If you want to reset your website to initial state for import process, you may check this article

### Importing Demo Content

After you finished installing theme and plugins, go to "Goodlayers > Getting Start / Import" section, you'll see an "Import Demo" tab.
Selecting the site you need to import from the list and click "Start Import Demo" button, then wait a few minute and it's done !!
If something is missing, you can start the import process again and it'll continue where it left off.
You can also check the server status tab to see the necessary server settings for the import process as well.

### Theme Updates

To enable the "Automatic Updates" feature, please go to "Goodlayers > Getting Start / Import" section, then, choose the "Get Automatic Updats" tab.
After clicking the "Get Envato Plugin Now" button, the "Envato Market" plugin will automatically installed and redirect you to the authentication page.
Try following the instruction on the "Envato Market" page to add the item you purchased to get automatic updates.
If there're update available for the theme, you can click the update button here ( or at the "Appearance > Themes" area ) to update the theme.
After you update the theme, you may check if there're any plugin update at the the "Goodlayers > Install Plugins" section as well.

### Child Theme & Theme Customization

##### To create child theme

If you need to customize the theme code, of course, you do not want to modify it everytime you update the theme. That's where the child theme take action.
We provided the child theme for you within the zip file you downloaded from themeforest. All you need to do is uploading the "realfactory-child.zip" file to "Appearance > Themes" section and activate it. ( just like how you upoad the theme )
You can also learn more about child theme creation here

##### Adding / modify php code

Our theme wrap every function with if( !function_exists('some_function') ) command. If you need to modify any function, just declare it in the function.php file of the child theme and it'll overwrite the existing one.
However, you need to use hook and action to modify the plugins since the plugin is loaded before the theme files.

##### Adding new style / script

You can add custom css / javascript code directly to the "Customize ( or Theme Option ) > Miscellaneous > Custom Css/Js" area. If you only need to add some style / script to the site, there're no need to create the child theme. We provided the custom input option which you can see the changes live !!

###### Customize

###### Theme Option

### Theme Option / Customize

Theme option / Customize area is one of the main feature in our theme. They give you abilities to made a changes to your site without touching a single line of code.
"Customize" give you an ability to live preview changes on the site while "Theme Option" give you an ability to search through the options and do some specific task ( Add thumbnail size, Add Skin and Upload Custom font ) which will be explained later.

###### Customize

You can go to theme customize at "Appearance > Customize" section from wordpress admin area

###### Theme Option

You can go to theme option at "Goodlayers" section in wordpress admin area

### Thumbnail Size

You can add custom image size to uses in page builder and themes by going to "Theme option > Miscellaneous > Thumbnail Sizing" section.
New tumbnail size only effects the newly uploaded images, so after you successfully added the image size, you may use the 'Regenerate Thumbnail' plugin to generate the thumbnail for old images as well.
The image will be cropped to the destined size ONLY when the uploaded image is larger than the defined size. Filling 0 will force the image to crop at the same proportion ( eg. 500x0 will crop the image width to 500 while the height is in the same proportional of the orignal images. )

### Skin Settings

##### Creating Skin

Skin gives you an ability to change the elements color that resides in the wrapper / column ( Page builder items ). You can create new skin at the "Theme option > Color > Skin" area.

##### Assigning Skin

After you created the skin, you can assign it at the page builder "Wrapper" and "Column" item. Try clicking edit while you hovering over the item, then, select the skin tab for this.

### Upload Custom Font

You can upload custom font at the "Theme option > Typography > Upload font" section. Both EOT and TTF font need to be supplied to make the font support across all devices.
You can generate the font file here

### Header / Logo

You can set the header style in the "Customize" page. Header area consists of 5 section under the general tab.

##### Top Bar

Topbar is an area that resides above logo & navigation.

##### Header Style

Header is an area that includes logo and navigation. You can select "header style" in header tab, then set the logo / navigation spaces from the corresponding tabs.

### Creating Page & Set The Homepage

Go to 'Page > Add New' to create new page.
You can set page sidebar, title background, caption and header slider at the "Page Option" area. ( at the very bottom of the page )
You can also use "Page Builder" ( which will be explained later ) to create more advance layout as well.

##### 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 page builder ) to create the blog page.

### Creating Blog

##### 1.) Creating New Articles

Go to "Post > Add New" to create new articles.

##### 2.) Creating Blog Item ( list of articles )

Create new page at "Page > Add New". At the page builder area, add the "Blog Item" then, publish the page.

##### 3.) Post Format

Post format give you an ability to style the post in different ways. You can see an example of the post format style here.
First, you need to select the post format option.
Here's the explanation of the each post format type.

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

You need to install the "gdlr-core-portfolio" plugin before continuing this section. You can learn more about the plugin installation at the "Getting Start > Install Plugin" section.

##### 1.) Create new portfolio post.

Add new portfolio at the "Portfolio > Add New" section. Fill the title, category, tag as you want.
We also set the content in page builder as a default layout for portfolio for you.

##### 2.) Creating portfolio item ( list of portfolios ).

Create new page at "Page > Add New". At the page builder area, add the "Portfolio Item" then, publish the page.
Double click or hover over the portfolio item to edit the portfolio item options.

### Metro Layout

"Metro" is a layout that align the element in masonry style. You can select different column width and thumbnail type for each items which result to more attractive display style.
We provided the support for the metro layout on "Blog Item" and "Portfolio Items". ( You can learn more about these two elements on previous section )
You may select the style of the "Blog Item" or "Portfolio Item" to metro style to enable the metro layout.
Try editing "blog/portfolio" single page which you need to the layout to be differnt. In page option area, you'll see the "Metro Layout" tab, try selecting the column and thumbnail size as you need.
Selecting "Default" means to use the settings you selected in "Blog/Portfolio Item"

### Creating Personnel

You need to install the "gdlr-core-portfolio" plugin before continuing this section. You can learn more about the plugin installation at the "Getting Start > Install Plugin" section.

##### 1.) Create new personnel post.

Add new personnel at the "Personnel > Add New" section. Fill the title, category, and page option according to the personnel information.
Use page builder to create the content to shown in single ( individual ) personnel page.

##### 2.) Creating personnel item ( list of personnel ).

Create new page at "Page > Add New". At the page builder area, add the "Personnel Item" then, publish the page.
Double click or hover over the personnel item to edit the personnel item options.

### Page Builder

"Page Builder" is the main feature of our theme which help you easily manage content and layout. You'll see page builder when you create page/post/portfolio/personnel post type.
There're 2 main types of item in page builder.

1. Wrapper item : is an item which can accept another item inside it. Wrapper item divided in to 3 types
   - Background Wrapper : can accept column and element item inside it
   - Sidebar Wrapper : is simiar to "Background Wrapper" item, but you can assign the sidebar widget to this item.
   - Column Wrapper : is the item that divide each row in to section. You can drag a element item inside it.
2. Element item : is an item that has individual feature. Currently, there're over 40 items in our page builder and we'll continue to add more items on future updates.

Below is an explanation of the feature of the page builder.

### Page Builder Wrapper

Wrapper is an item that can contains an "Element Item" in side it. You can use it to create sections/layout/parallax background. You can find wrapper at the first tab of the page builder. Try clicking or draging the item to add it to the container area.
In live "live view mode", blue frame represents background/sidebar wrapper item, yellow frame represents column item. Hovering over the item and you'll see the tools bar for managing the wrapper item. You can use double click as a shortcut to edit each item as well.

### Page Builder Element

"Element Item" provides an ability for you to create different item style. You can find the element item list at the second tab of the page builder. You can add the element item by clicking or dragging the element you want to the container area.
Unlike wrapper, in "live view mode", you will only see the item's frame when you're hovering over them. You can double click on the item to edit the item options or hovering over the item and you'll see the tool bar for you to manage the item.

### Page Builder Template

Template is a set of pre-built elements that was shown on the demo site. You can find it at the third tab of the page builder area. Clicking or dragging the elements to the container area to add the template items to page builder content area.
The content you added will be slightly different due to the difference of "Image ID" and "skin settings" on your site
We also provide the pre-built block which is a set of elements that we oftenly used to create the site.

### Page Builder Custom Template

The last section of the page buidler tab is "Custom Template". Custom Template gives you an ability to save the template you oftenly use for later uses.
To save the custom template, you need to click on the "Save Template" button on any elements.
Clicking the save template at the page builder head area will save the whole page as a template.
After clicking the save button, there'll be an input box showing for you to fill the template name.
You can remove the template by clicking the close button while hovering over the template you want to remove.

### Revolution Slider

The purchase code for slider is not necessary. It's used for auto updater. However, the slider that's included in this theme is being used as 'Extended license', it's considered as a bonus file which doesn't support auto updater. If you need to use auto updater, you have to purchase slider's regular license separately. However, as mentioned, It's not necessary, you can still use slider that come with the theme like its regular license.

##### Installation

Revolution Slider should already be installed if you followed the instruction at "Getting Stars > Install Plugins". However, if you don't see this plugin, Go to Appearance > Install Plugins and install it from there.

##### Import Slider Demo Content

1.) Go to the theme package folder and seek for the folder "Demo Stuffs".
2.) Go to "Revolutions slider demo content" folder and choose the demo file that you want to use.
3.) Go to 'Revolution Slider' menu on the left in your WordPress backend and click on import and import the zip file from "Revolutions slider demo content" folder in here.

##### Using Revolution Slider

https://www.themepunch.com/revslider-doc/slider-revolution-documentation/

##### Updating Revolution Slider

After you update the theme, you'll see list of plugins that's available for update. ( If you already disable the notification bar, you can check the "Appearance > Install Plugins" section instead. )
Clicking the update button and wait for the installation. After that, activate the plugin and it's done !!

### Layer Slider

The purchase code for slider is not necessary. It's used for auto updater. However, the slider that's included in this theme is being used as 'Extended license', it's considered as a bonus file which doesn't support auto updater. If you need to use auto updater, you have to purchase slider's regular license separately. However, as mentioned, It's not necessary, you can still use slider that come with the theme like its regular license.
Since "Layer Slider" isn't included within the "Appearance > Install Plugins" tab, you need to follow the instruction below for the plugin installation.

##### Install Plugin

1.) In theme package folder, go to "Additional Plugins" folder and you will see the file in there.
2.) Go to "Plugin > Add New > Upload Plugins" and upload the file from 1.)

###### *Please note that we don't have any demo slides content with this slider. Demo slides content only come with Revolution Slider plugin. This plugin is considered as a bonus file.

##### Using Layer Slider

https://support.kreaturamedia.com/docs/layersliderwp/documentation.html

##### Updating the Layer Slider

1.) Download the newer version of theme package from Themeforest, extract it and go to folder 'Additional Plugins'
2.) Extract the file 'layersliderwp-x.x.x.installable.zip' and now you will get the folder 'LayerSlider'.
3.) Access to your site via FTP and go to the path 'wp-content/plugins'
4.) Replace the folder 'LayerSlider' in this path with the one you get from 2.)

### Master Slider

The purchase code for slider is not necessary. It's used for auto updater. However, the slider that's included in this theme is being used as 'Extended license', it's considered as a bonus file which doesn't support auto updater. If you need to use auto updater, you have to purchase slider's regular license separately. However, as mentioned, It's not necessary, you can still use slider that come with the theme like its regular license.
Since "Master Slider" isn't included within the "Appearance > Install Plugins" tab, you need to follow the instruction below for the plugin installation.

##### Install Plugin

1.) In theme package folder, go to "Additional Plugins" folder and you will see the file in there.
2.) Go to "Plugin > Add New > Upload Plugins" and upload the file from 1.)

###### *Please note that we don't have any demo slides content with this slider. Demo slides content only come with Revolution Slider plugin. This plugin is considered as a bonus file.

##### Using Master Slider

http://masterslider.com/doc/wp//

##### Updating the Master Slider

1.) Download the newer version of theme package from Themeforest, extract it and go to folder 'Additional Plugins'
2.) Extract the file 'masterslider-installable.zip' and now you will get the folder 'masterslider'.
3.) Access to your site via FTP and go to the path 'wp-content/plugins'
4.) Replace the folder 'masterslider' in this path with the one you get from 2.)

### Contact Form 7

We provided the full layout as a default style for contact form 7 plugin.
We also provide a snippet code if you want to add a layout and style to the form as well.

    						[text* your-name placeholder "Full Name*"]
    						[email* your-email placeholder "Email*"]

    						[text* your-subject placeholder "Subject*"]

    						[textarea* your-message placeholder "Message*"]
    						[submit class:gdlr-core-full "Submit Now"]

Here's the explanation of what each class do

### Translation & Localization

Translation is a wordpress function that helps you translate the theme's string or change the wording within the same language.

###### Translate using Wordpress Plugins

http://support.goodlayers.com/document/translation-loco-translate-plugin/

###### Translate using PO EDIT Application

http://support.goodlayers.com/document/translation-po-edit/

###### Fully Compatible Multilingual Plugins

- WPML
- Poly Lang

### Shortcodes

Shortcode is a simple set of functions that easily helps you create an element in the area that does not supported the page builder feature. You can easily find the shortcode list at the "Visual mode of wordpress WYSIWYG Editor"
You can also see list and description of the shortcode attribute online here.

### Snippet Code

Top Bar Left : place this at "Customize > General > Top Bar > Top Bar Left" area

    					[gdlr_core_dropdown_tab]

    					[gdlr_core_tab title="Hamburg"]

    					[gdlr_core_icon icon="fa fa-phone" size="16px" color="#f7c02e" margin-left="" margin-right="10px" ] +49 3656 4567 [gdlr_core_icon icon="fa fa-clock-o" size="16px" color="#f7c02e" margin-left="24px" margin-right="10px" ] Mon - Fri 09:00 - 17:00  [gdlr_core_icon icon="fa fa-location-arrow" size="16px" color="#f7c02e" margin-left="24px" margin-right="10px" ]12 Main Street Pt. Hamburg Germany
    					[/gdlr_core_tab]

    					[gdlr_core_tab title="New York"]

    					[gdlr_core_icon icon="fa fa-phone" size="16px" color="#f7c02e" margin-left="" margin-right="10px" ] +1 2223 4567 [gdlr_core_icon icon="fa fa-clock-o" size="16px" color="#f7c02e" margin-left="24px" margin-right="10px" ] Mon - Fri 09:00 - 17:00 [gdlr_core_icon icon="fa fa-location-arrow" size="16px" color="#f7c02e" margin-left="24px" margin-right="10px" ]4th Avenue Kingston St. New York
    					[/gdlr_core_tab]

    					[gdlr_core_tab title="San Francisco"]

    					[gdlr_core_icon icon="fa fa-phone" size="16px" color="#f7c02e" margin-left="" margin-right="10px" ] +1 8887-3342 [gdlr_core_icon icon="fa fa-clock-o" size="16px" color="#f7c02e" margin-left="24px" margin-right="10px" ] Mon - Fri 09:00 - 17:00 [gdlr_core_icon icon="fa fa-location-arrow" size="16px" color="#f7c02e" margin-left="24px" margin-right="10px" ]55th Floor Paulsson Bd. SF[/gdlr_core_tab]

    					[/gdlr_core_dropdown_tab]

Footer 1 : place this at "Appearnce > Widget > Footer 1" section

    					[gdlr_core_space height="-2px"]

    					[gdlr_core_space height="7px"]

    					Far far away, behind the word mountains, far from the countries Vokalia and Consonantia, there live the blind texts.

Footer 4 : place this at "Appearnce > Widget > Footer 4" section

    					[gdlr_core_icon icon="fa fa-location-arrow" size="20px" color="#f7c02e" margin-left="0px" margin-right="10px" ] 12 Main Street Pt. London
    					[gdlr_core_space height="-6px"]
    					[gdlr_core_icon icon="fa fa-phone" size="20px" color="#f7c02e" margin-left="" margin-right="10px" ] +44 3656 4567
    					[gdlr_core_space height="-6px"]
    					[gdlr_core_icon icon="fa fa-envelope-o" size="20px" color="#f7c02e" margin-left="0px" margin-right="10px" ] contact@realfactoryWP.com

### Icon List

There're two icon types we included within our theme that's font awesome icons and elegant icons. You can see the icon class which you needed fill in shortcode or the "icon class" area here.

###### Font Awesome Icons

http://support.goodlayers.com/document/icon-font-awesomes/

###### Elegant Icons

http://support.goodlayers.com/document/icon-elegant-icons/

### Social Network API

###### Obtaining Twitter Authentication Info

http://support.goodlayers.com/document/obtain-twitter-authentication-info/

###### Register Your Site to Obtain Twitter Share Count

http://opensharecount.com/
Since twitter deprecate the function to retrieve the share count number, you need to register your site with "http://opensharecount.com/" in order to retrieve the twitter share count number in social network item.

###### Obtaining Instagram Access Token

http://support.goodlayers.com/document/obtain-instagram-access-token/

###### Obtaining Facebook ID & Access Token

http://support.goodlayers.com/document/obtaining-facebook-id-access-token/