Candor Documentation

# Candor

By Inspiry Themes

View All

## Introduction

This documentation is last updated on 10th August 2017.

Thanks for purchasing Candor theme. If you have any question that is beyond the scope of this documentation, Feel free to ask that on our support website. You can visit this knowledge base article to learn about how to get item purchase code from themeforest.net to sign-up on our support site.

### Important Note

It is highly recommended to use child theme, So that you can easily update parent theme whenever a new update becomes available. A pre-built ready to use child theme is included in the main theme pack that you might have downloaded from themeforest.

### How to Update Theme

If you want to update your theme then you can consult this knowledge base article for automatic update OR you can consult this knowledge base article for manual update.

### Support Policy

Support Includes

- Answering technical questions about theme features.
- Assistance with reported bugs and issues.
- Help with included 3rd party assets.

Support Does Not Includes

- Theme customization services.
- Theme installation services.

## Install Theme

To start you must have a working version of WordPress. Almost all major web hosts provides one click WordPress install and you can consult your host's help site for more information in this regard. For manual install you can consult WordPress Codex Installing WordPress.

Once you have a working version of WordPress, You need to download "All Files and Documentation" from themeforest download page and extract the downloaded zip to get various files including inspiry-candor.zip.

### Install Theme Via WordPress Dashboard ( Recommended Way )

1. Go to 'Appearance > Themes' section
2. Click 'Add New' and select the 'Upload Theme' option
3. Click 'Upload Theme'
4. Choose the inspiry-candor.zip file and press 'Install Now'
5. Once the theme is uploaded you need to activate it.
6. After activation go to "Appearance > Customize" to play with theme's settings.

if you face any problem during upload through dashboard, please upload the theme using FTP as guided below.

### Install Theme Via FTP ( Alternative Way )

1. Access your hosting server using an ftp client like FileZilla
2. Go to the 'wp-content/themes' folder of your WordPress installation
3. Extract the inspiry-candor.zip file and put the inspiry-candor folder in 'wp-content/themes/' folder
4. Go to 'WordPress Dashboard > Appearance > Themes' section to activate the theme
5. After activation go to "Appearance > Customize" to play with theme's settings.

### Install Child Theme ( Highly Recommended )

It is highly recommended to use child theme, So that you can easily update parent theme whenever a new update becomes available. A pre-built ready to use child theme is included in the main theme pack that you have downloaded from themeforest.

To install child theme, You need to upload the inspiry-candor-child.zip and activate it in the same way as you have uploaded and activated parent theme's inspiry-candor.zip.

Next Step is to Import Demo Contents

## Import Demo Contents

You can follow one of these approaches.

1. One Click Demo Import ( Automatic & Recommended )
2. Import XML Contents and Configure Settings Manually

### 1. One Click Demo Import ( Automatic & Recommended )

1. Go to Dashboard → Appearance and click on Import Demo Data in the sub menu items.

   Click on Import Demo Data button. Wait for few minutes as the demo images are being fetched from the remote server and this process can take a couple of minutes.

   Once the import process is complete, You will receive a notice like the one displayed in the screen shot below.

   Visit your site and you will find your site working like the theme demo.

2. Go to Settings → Permalinks and choose Post name from Common Settings and save the changes, As displayed in screen shot below.

### 2. Import XML Contents and Configure Settings Manually

1. Go to WordPress Admin > Tools > Import and click WordPress as displayed in image below.

   At 1st time you need to install WordPress importer plugin

   Once installed you need to activate the plugin and run the importer.

2. Look for Import XML folder in unzipped package downloaded from themeforest and use the XML file within it.

   After importing XML file.

   1. Assign posts to an existing author.
   2. Mark the checkbox to download and import file attachments
   3. Click 'Submit' button

   Import process can take few minutes. So wait for it and try to keep the focus on current tab in your browser.

   After that is done, you will have bunch of posts, pages and other contents as on the theme demo.

3. To configure permalinks settings visit WordPress Admin > Settings > Permalinks and configure then save it as displayed in image below.

## Configure Header

Navigate to Appearance > Customize and look into Site Identity and Header section to explore further settings.

#### Site Identity

You can upload your site's logo, title, description tag and site icon from this section.

#### Header

You can customize almost everything in header from related settings in header section. As pointed in screenshot below.

## Blog Page Settings

Navigate to Appearance > Customize and look into Blog section to explore further settings as displayed below.

#### Variation One

#### Variation Two

#### Variation Three

#### Variation Four

## Footer Settings

Navigate to Appearance > Customize and look for Footer panel.

## Blog Post Settings

Navigate to Appearance > Customize and look into Blog Post panel to explore settings related to blog post.

## Add Blog Post

Go to WordPress Admin > Posts > Add New

1. Provide the post title
2. Provide the post contents
3. Add or select the related category
4. Add or select the related tags
5. Provide the featured image. The recommended minimum width for featured image is 1140px and height is flexible. The bigger size images will be cropped automatically.
6. Publish the post once it is ready.

## Add Full Width Page

Go to WordPress Admin > Pages > Add New

1. Provide the page title
2. Provide the page contents
3. Select the Full Width Template from page attributes.
4. Publish the page once it is ready.
5. After publishing you need to add the newly created page in menu from WordPress Admin > Appearance > Menus

## Add Contact Us Page

You can use any of the following plugins to add Contact Form to your page(s)

1. Jetpack
2. Ninja Forms
3. Contact Form 7

Go to WordPress Admin > Pages > Add New

1. Provide the page title

2. There are three ways to add contact form in the page

   #### Contact form Using Jetpack Plugin

   Once you have installed and activated the jectpack plugin, click add contact form button to insert contact form on the page.

   #### Contact form Using Ninja Forms Plugin

   Once you have installed and activated the Ninja Forms plugin, click add contact form button to insert contact form on the page.

   #### Contact form Using Contact Form 7 Plugin

   Once you have installed and activated the Contact Form 7 plugin, click add contact form button to insert contact form on the page.

3. Publish the page once it is ready.
4. After publishing you need to add the newly created page in menu from WordPress Admin > Appearance > Menus

## Author Profile Widget

1. Go to Appearance > Widgets and look for Candor - Author Profile widget.
2. Use that widget in a sidebar. Select the author from the list.
3. Now check out the front end of your site and you will have the Author Profile widget working for your site.
4. Information related to a user can be modified from his user profile page as displayed in screenshot below.

## Recent Posts Widget

1. Go to Appearance > Widgets and look for Candor - Recent Posts widget.
2. Use that widget in a sidebar. Provide its title and number of posts to display.
3. Now check out the front end of your site and you will have the Recent Posts widget working for your site.

## Top Posts Widget

1. Go to Appearance > Widgets and look for Candor - Top Posts widget.
2. Use that widget in a sidebar. Provide its title and number of posts to display.
3. Now check out the front end of your site and you will have the Top Posts widget working for your site.

## How to set up Twitter Widget

1. Install the Quick and Easy Tweets plugin.
2. Now, you need the twitter App's consumer key, consumer secret, access token and access token secret for twitter authentication.
   To get all these keys, You need to register a new twitter app from following url
   After registering app and generating access token you will have api keys and access token as displayed below
3. Now go to Appearance > Widgets and look for Quick and Easy Tweets widget.
4. Provide title, twitter username, number of tweets, keys and save the widget settings.
5. Now check out the front end of your site and you will have a twitter widget working for your site.

## How to set up Instagram Widget

1. Install the Wp Instagram Widget plugin.
2. Go to Appearance > Widgets and look for Instagram widget.
3. Add the widget to Instgaram Feed widget area as this will display instagram images in footer.
   Once added, Provide Title, Username, Number of photos, Photo size, Open link in, Link text ( leave it blank ) and save the widget settings.
4. Now check out the front end of your site and you will have a working Instagram widget in the footer of your website.

## Short Codes

To use shortcodes, Make sure to install & activate Candor Shortcodes plugin that is included with in the theme pack.

#### Buttons

    [inspiry_button link="#"]Default[/inspiry_button]

    [inspiry_button type="info" link="#"]Information[/inspiry_button]

    [inspiry_button type="success" link="#"]Success[/inspiry_button]

    [inspiry_button type="warning" link="#"]Warning[/inspiry_button]

    [inspiry_button type="danger" link="#"]Danger[/inspiry_button]

    [inspiry_button link="#" target="_blank"]To Open New Tab[/inspiry_button]

#### Alerts

    [inspiry_alert]This message is displayed in default alert box.[/inspiry_alert]

    [inspiry_alert type="success"]This message is displayed in a success alert box.[/inspiry_alert]

    [inspiry_alert type="warning"]This message is displayed in a warning alert box.[/inspiry_alert]

    [inspiry_alert type="danger"]This message is displayed in a danger alert box.[/inspiry_alert]

#### Progress Bars

    [inspiry_progress_bar value="40"]

    [inspiry_progress_bar value="60" color="green"]

    [inspiry_progress_bar value="80" color="orange"]

    [inspiry_progress_bar value="50" color="red"]

#### Tabs

        [inspiry_tabs titles="Rise Early,Do Less,Slow Down"]

        [inspiry_tab_pane]Your Content [/inspiry_tab_pane]

        [inspiry_tab_pane]Your Content [/inspiry_tab_pane]

        [inspiry_tab_pane]Your Content [/inspiry_tab_pane]

        [/inspiry_tabs]

#### Accordion

        [inspiry_accordion]

        [inspiry_accordion_block title="Your Title"]Your Content[/inspiry_accordion_block]

        [inspiry_accordion_block title="Your Title"]Your Content[/inspiry_accordion_block]

        [inspiry_accordion_block title="Your Title"]Your Content[/inspiry_accordion_block]

        [/inspiry_accordion]

#### Toggles

    [inspiry_toggles]

    [inspiry_toggle_block title="Your Title"]Your Content[/inspiry_toggle_block]

    [inspiry_toggle_block title="Your Title"]Your Content[/inspiry_toggle_block]

    [inspiry_toggle_block title="Your Title"]Your Content[/inspiry_toggle_block]

    [/inspiry_toggles]

#### Contrast Content

    [inspiry_contrast_content]Your Content[/inspiry_contrast_content]

#### Wide Content For Images Only

    [inspiry_wide_content]Wide Content[/inspiry_wide_content]

#### Full Width Content For Images Only

    [inspiry_full_width_content]Full Width Content[/inspiry_full_width_content]

#### Columns

##### 1 Column Short Code Example

    [inspiry_columns]

    [inspiry_single_column]1/1[/inspiry_single_column]

    [/inspiry_columns]

##### 2 Columns Short Code Example

    [inspiry_columns]

    [inspiry_two_column]1/2[/inspiry_two_column]

    [inspiry_two_column]1/2[/inspiry_two_column]

    [/inspiry_columns]

##### 3 Columns Short Code Example

    [inspiry_columns]

    [inspiry_one_third]1/3[/inspiry_one_third]

    [inspiry_one_third]1/3[/inspiry_one_third]

    [inspiry_one_third]1/3[/inspiry_one_third]

    [/inspiry_columns]

##### 4 Columns Short Code Example

    [inspiry_columns]

    [inspiry_one_fourth]1/4[inspiry_one_fourth]

    [inspiry_one_fourth]1/4[inspiry_one_fourth]

    [inspiry_one_fourth]1/4[inspiry_one_fourth]

    [inspiry_one_fourth]1/4[inspiry_one_fourth]

    [/inspiry_columns]

##### Mix Columns Short Code Example

    [inspiry_columns]

    [inspiry_one_sixth]1/6[/inspiry_one_sixth]

    [inspiry_two_third]2/3[/inspiry_two_third]

    [inspiry_one_sixth]1/6[/inspiry_one_sixth]

    [/inspiry_columns]

##### Mix Columns Short Code Example

    [inspiry_columns]

    [inspiry_three_fourth]3/4[/inspiry_three_fourth]

    [inspiry_one_fourth]1/4[inspiry_one_fourth]

    [/inspiry_columns]

## Fonts

Navigate to Appearance > Customize and look into Typography panel to explore settings related to fonts.

## Translating The Theme

This theme is translation ready and translate it in your language you can consult This Knowledge Base Article

## How to Modify Styles

There are various options available to modify styles in this theme.

1. Basic Styles - Go to Appearance > Customize and navigate to Styles to change basic styles.

2. Additional CSS - Go to Appearance > Customize and navigate to Additional CSS to add your styles.

3. Custom CSS in Child Theme - 'child-custom.css' file is provided in child theme to add major css changes.

   Note: It is highly recommended to use child theme for any changes that you want to make as this way you can update parent theme whenever an update becomes available. Simply copy a template file that you want to change to child theme after creating same directory structure and then modify it. For more info http://codex.wordpress.org/Child_Themes.

4. Custom CSS in Parent Theme - if you are not using child theme then 'css/custom.css' file is provided in parent theme to add major css changes.

### Use Child Theme for Customization ( Highly Recommended )

It is highly recommended to use child theme for any customization that you want to make, So that you can easily update parent theme whenever a new update becomes available. A pre-built ready to use child theme is included in the main theme pack that you have downloaded from themeforest.

## Hire Customization Services

If you need some additional features or want modification in existing theme features then you can contact us for theme customization service.