Hello.
Thanks for purchasing Kuist!
1. Introduction
Thank you for purchasing Kuist. This document includes the necessary information about using it.

Please do share any thoughts or comments with us. We'd like to hear from you!

If you need help, please do not hesitate to ask us. We'll be ready to reply you on our ThemeForest comments page.

Follow us on ThemeForest, Facebook or Dribbble to keep in touch!
2. Installation
Extract the zipped package that you downloaded from ThemeForest. You'll find a file named "kuist.zip" in "Theme" folder. Now there are 2 ways to start using it:

1) On WordPress admin panel, go to "Appearance > Themes" and click the "Add New" button at the top of the page. Then click "Upload Theme" button. Pick "kuist.zip" file and click "Install Now" button.

2) Extract the "kuist.zip" file and upload the extracted folder to the ".../wp-content/themes/" folder on your server.

After uploading the theme, you need to activate it. Go to "Appearence > Themes" page and click Kuist's "Activate" button. And you're done.

If you face any problem, please visit ThemeForest Knowledgebase to learn how to install a WordPress theme.
3. Demo Content
You can find the demo content file in "Demo Content" folder inside the zip file you've downloaded from ThemeForest.
4. FAQ
If you can't find your question below or in entire documentation, please don't hesitate to ask for help. We'd be glad to help you.

Importing Demo Content
Follow the steps below to import the demo content:

a) Navigate to "Tools > Import".

b) Click "WordPress > Run Importer".

c) Click "Choose File" and point the xml file you've got.

d) Click "Upload file and import" and wait.

e) When the page refreshes, check "Download and import file attachments" and click "Submit". You're done when the process is finished.

After importing the demo content, don't forget to set the "Works" page as your homepage from "Settings > Reading" section


Back to Top


Theme is missing the style.css stylesheet error
A common issue that can occur when installing a WordPress themes is "The package could not be installed. The theme is missing the style.css stylesheet." error message being displayed when uploading or activating the theme.

This is because you're trying to upload the wrong file. While downloading your theme, you see the options below:


You can get the theme file that you must upload by clicking the "Installable WordPress file only".

"All files & documentation" option includes some other files like the help file that you're reading right now. If you download this package, you should upload the .zip file inside it after you extract the package.

Back to Top


How to Update Your Theme
The most common way to update your theme is to download it from themeforest.net and re-install. Basically:
  1. Switch your theme to one of the default themes of WP.
  2. Remove the theme. Your data & settings will not be deleted but it's always suggested to do a back-up.

  3. IMPORTANT NOTE: If you've done any changes in theme files (edited the codes manually), those changes will be lost when you removed the theme. Therefore, it's always recommended to use a child theme.

  4. Download the new version of your theme and install it like you're doing it for the first time.
  5. Activate your theme and you're done.

Back to Top


Adding Your Portfolio
Please see the Portfolio Plugin section.

Back to Top


How can I upload my own logo?
Go to "Appearance > Customize > Header > Logo Settings" and select your logo from the media library.

Back to Top


How can I change the colors?
Go to "Appearance > Customize > Colors" and set your colors.

Back to Top


How can I change the site font?
Go to "Appearance > Customize > Font Settings" and pick your font. You can also set the font sizes here.


Back to Top


How can I change the portfolio thumbnail sizes?
Go to "Appearance > Customize >Portfolio Settings" and set "Thumbnail Width" & "Thumbnail Height" fields as you wish.

Back to Top


How can I set the number of portfolio items per page?
Go to "Appearance > Customize >Portfolio Settings" and see "Portfolio Items Per Page" section. You can also set a different number for category (archive) pages.

If you wish, you can set this number via the shortcode too. Just add the "count" parameter to the shortcode like that:
[kuistportfolio count=5]

Back to Top


How can I change the lightbox image size?
You have 3 options for lightbox image size: Large, Full and Custom Size. Go to "Appearance > Customize >Portfolio Settings" and see "Lightbox Image Size" section.

Keep in mind that you'll see your images smaller than the browser height, even if your image size is larger.

Back to Top


Where can I find the blog homepage layout options?
Kuist has 2 blog homepage layout options: 2 columns and 3 columns. Go to "Appearance > Customize > Blog & Page Settings" to set it as you wish.

Back to Top


How can I add a contact form to the "Contact Pane"?
Kuist supports the Contact Form 7 plugin and firstly you must ensure that this plugin has been installed and activated.

Just go to "Contact > Add New", edit the pre-builded form if you need, and click "Save". Then, on "Contact > Contact Forms" screen, you'll see the added form and its shortcode like that:


Now copy that shortcode and paste it into the field on your customizer: "Appearance > Customize > Contact Pane > Contact Form Shortcode". That's all.

The contact form code we used on our demo site is like that:

<label>[text* your-name placeholder "Your Name"]</label>

<label>[email* your-email placeholder "Your E-mail"]</label>

<label>[textarea your-message placeholder "Your Message"]</label>

<button class='wpcf7-form-control wpcf7-submit'>SEND</button>

Back to Top


How can I add a copyright text to the footer?
Just add your text like you're adding a regular menu item. Then follow the steps below:

First, on "Appearance > Menus" screen, click the "Screen Options" button at the top right of the screen. Check the "CSS Classes" box over there.

After doing this, you'll see a field named "CSS Classes (optional)" in your menu items.

If you write menu-item-passive into that field, the menu item will be passive and look like the copyright text on our demo site.

5. Menu
Kuist has 2 locations for a menu: Primary Menu and Footer Menu.

For menu setup, go to "Appearance > Menus" page. Choose your items you want to show in menu from the left side. Don't forget to check "Primary Menu" or "Footer Menu" box to see your menu in correct place. And finally click "Save Menu" button to get it done.


To read more about WordPress Menus: WordPress Menu User Guide
6. Portfolio Plugin
Kuist has its own portfolio plugin. Follow the steps below to start using it!

Firstly, you need to install the Kuist Portfolio plugin. You'll already realize the "This theme recommends the following plugin: Kuist Portfolio." notice when you activate Kuist theme.
  1. Click "Begin installing plugin".
  2. Click "Install" under the "Kuist Portfolio" title.
    The "Install" button will appear when you rollover the title.
  3. When you see the "Return to Required Plugins Installer" link appeared, it means you're done! But don't forget to activate the plugin.

    You'll realize that a button named "Kuist Portfolio" is placed on your admin panel menu now. If you can't see it, just click to "Dashboard" or somewhere else to refresh the view.
After installing & activating the portfolio plugin, you're ready to add your portfolio. You'll see that it's very easy to use the Kuist Portfolio plugin! Adding your images, re-ordering them, adding work credits like client name, retoucher name etc. All of these are possible.


Now, let's add our first portfolio item:
  1. Click "Kuist Portfolio > Add New Portfolio".
  2. Write the portfolio title and then click "Add Image(s)" button.
  3. Select the images you wish and click "Add Image(s)" button. You can now arrange them by drag&drop feature and also Remove/Change the ones you wish.
  4. Now click "Publish" and you're done!
  5. If you wish, you can choose a category and add some information like client, retoucher etc. from the panels at the right hand side.
You can repeat the steps above to create all the portfolio items you want. Now it's time to show your portfolio on the site:
  1. Click "Pages > Add New".
  2. Write the title of the page. Something like "Portfolio" or "Works" would be fine.
  3. Add the portfolio shortcode into the page:
    [kuistportfolio]
  4. Click "Publish" and that's all!
  5. If you set this page as your "Homepage" from "Settings > Reading" section, your visitors see your works directly when they enter your site.
Some additional usages:
  • If you want to create a page and show your portfolio items in a specific category, you can add the "category" parameter to the shortcode. Like below:
    [kuistportfolio category=your_category_slug_here]
  • To create a special page from your selected items, you can use the "Portfolio Shortcode Tags" field. Don't forget that you should use the same tag name for the portfolio items you want to see in the same page. (It's the same procedure with tagging a blog post.)

    You can use the portfolio shortcode by adding the "tag" parameter. Like that:
    [kuistportfolio tag=your_tag_slug_here]
  • If you want to control the number of portfolio items to show per page, you can add the "count" parameter:
    [kuistportfolio count=5]
  • You can combine the "count" parameter with the "category" OR the "tag" parameter:
    [kuistportfolio category=fashion count=3]
7. Theme Customizer
Kuist has a very well organized customizer which almost is a user guide itself. It uses the native customizer of WordPress. So navigate to "Appearance > Customize" and start to personalize your theme!

Here is a full list of setting sections:
  1. Header
    1. Logo Settings
    2. Menu Settings
  2. Portfolio Settings
    1. Thumbnail Width
    2. Thumbnail Height
    3. Portfolio Items Per Page
    4. Archive Portfolio Items Per Page
    5. Lightbox Image Size
    6. Lightbox Image Custom Width
    7. Lightbox Image Custom Height
  3. Colors
  4. Font Settings
    1. Site Font
    2. Font Sizes
  5. Contact Pane
    1. Contact Text
    2. Contact Form Shortcode
  6. Blog & Page Settings
    1. Layout
    2. Thumbnail Width
    3. Thumbnail Height
    4. Max Container Width
    5. Content Width
  7. Social Accounts
  8. Translation
    1. Site Language
    2. Portfolio
    3. Blog & Page
    4. Post Comments
8. Translation
Translation is extremely easy with Kuist. Just go to "Appearance > Customize > Translation" and start to translate!
9. Sources & Copyrights
All the images/photographs used in our demo site and all the rights of them belong to their creators/owners.
We hope you'll love Kuist and its features. Again, don't hesitate to share any thoughts, ideas, comments or requests with us. We're here to help you and to make your Kuist experience better.

Talk to you soon!

Burnhambox