Kose - WordPress Theme

Contents

1. The Google Maps element do not load and show up. What do I do?

2. How to hide the full screen slider and make the content area displayed right under the menu on mobile views?

3. [v1.5.0 Note] Changes in theme's custom code for Visual Composer

4. I cannot open portfolio single page. I only see "404 Page Not Found". What to do?

5. How to hide the slider's caption on mobile devices?

6. How to remove Related Works section out of the portfolio single page?

7. The menu items overlap with social icons and copyright text on small screen. How to fix that?

8. How to enable Visual Composer mode for portfolio item?

9. How to adjust the side margins of the side panel to make more room for the logo?

10. How to customize the width of the scrollbar of the content area?

11. How to reduce the top and bottom margins of the side panel?

12. Where to find the code of portfolio meta info (Date, Client, Categories and Website) so I can customize it?

13. General troubleshooting steps

14. Creating a child theme

15. Setting up automatic updates

16. Some bundled plugins cannot be updated. They tell me to register with their own license first. What to do?

17. I couldn't update the bundled plugins with the theme purchase code. Why?

18. How to adjust CSS for different screen sizes?

19. I want to have all the content like the demo site. How do I do that?

20. OptionTree could not be downloaded and installed. What to do?

1. The Google Maps element do not load and show up. What do I do?

Please first update the theme to the latest version. After that, go to "Theme Options > Google Maps" to enter your API key and save. Clear all cache and check it again. The maps should load properly now.

2. How to hide the full screen slider and make the content area displayed right under the menu on mobile views?

You can use this custom CSS to adjust it:

@media only screen and (max-width: 1160px) {
    #full-scrn-slider-container {
        display: none;
    }
    #content-container {
        top: 0;
        position: relative;
    }
}

You can find where to place the code by going to "Style Customizer > Others > Custom CSS".


3. [v1.5.0 Note] Changes in theme's custom code for Visual Composer

Since the theme v1.5.0, most custom code for overriding Visual Composer's elements are deprecated. A little drawback is that it might affect some of previous elements that you are using in your theme. But it will be greater in a long run for supporting plugin's stability and its powerful features.

Some affected elements are:

4. I cannot open portfolio single page. I only see "404 Page Not Found". What to do?

Please go to "Settings > Permalinks" and click to save once. This should solve the issue.

5. How to hide the slider's caption on mobile devices?

1. Go to "Style Customizer > Others > Custom CSS"

2. Enter this custom CSS into the box:

@media only screen and (max-width: 767px) {
    .slide-caption-wrapper {
        display: none;
    }
}

This code will force to hide both caption title and text on mobile devices (resolution width lower than 767px).

6. How to remove Related Works section out of the portfolio single page?

Please go to "Settings > UXbarn Portfolio Options" and there you will see the option to remove the Related Works section.

7. The menu items overlap with social icons and copyright text on small screen. How to fix that?

Please go to "Style Customizer > Others > Custom CSS" and try using this CSS:

@media only screen and (max-width: 1200px) {
    
    #side-container {
        padding: 20px 50px
    }
    
    #logo-wrapper {
        margin-bottom: 20px;
    }
    
    #menu-wrapper > ul > li {
        font-size: 12px
    }
    
    #side-footer-wrapper {
        bottom: 20px;
    }
    
    #copyright {
        margin-bottom: 10px;
    }
    
}

This code will reduce the overall spacing of the side panel for the resolution lower than 1200px (set by media query as you can see). But if you have so many menu items, the issue might still occur. If this is the case, I would recommend to either reduce the number of menu items or set the "font-size" value in the code above to be lesser.

In case you would like to use custom CSS for other elements, I would recommend "Developer Tools" on Chrome or "Firebug" on Firefox to inspect the elements on the page. Then you can know which CSS selector to adjust.

8. How to enable Visual Composer mode for portfolio item?

Please go to "Settings > Visual Composer" and tick the "uxbarn_portfolio" item in the Content Types list. Then the Visual Composer button will show up in the portfolio edit screen.

9. How to adjust the side margins of the side panel to make more room for the logo?

Please go to "Style Customizer > Others > Custom CSS" and use this custom CSS:

#side-container {
    padding-left: 10px;
    padding-right: 10px;
}

P.S. In case you would like to use custom CSS for other elements, I would recommend "Developer Tools" on Chrome or "Firebug" on Firefox to inspect the elements on the page. Then you can know which CSS selector to adjust.

10. How to customize the width of the scrollbar of the content area?

You would need to manually edit the JS code for that. Please open "/js/kose.js" file and find this code:

$('#inner-content-container').niceScroll({
	cursorcolor : ThemeOptions.content_scrollbar_color,//'#fcda1c',
	cursorwidth : 3,
	cursorborder : 0,
	touchbehavior : false,
	autohidemode : true,
	hidecursordelay : 1000,
	scrollspeed : 100,
	//bouncescroll : true,
});

Just increase the value of "cursorwidth" here to make the scrollbar bigger. Then clear all the the cache and see the result.

Note that the theme uses "nicescroll JS" for the scrollbar. You can find more info about its API here: http://areaaperta.com/nicescroll/

11. How to reduce the top and bottom margins of the side panel?

Please go to "Style Customizer > Others > Custom CSS" and use this custom CSS:

#side-container {
    padding-top: 20px;
}

#side-footer-wrapper {
    bottom: 20px;
}

You can adjust the px value here.

P.S. In case you would like to use custom CSS for other elements, I would recommend "Developer Tools" on Chrome or "Firebug" on Firefox to inspect the elements on the page. Then you can know which CSS selector to adjust.

12. Where to find the code of portfolio meta info (Date, Client, Categories and Website) so I can customize it?

*Note: Since the theme v1.5.0, a new feature for creating your own meta info for portfolio has been introduced. You can manage the custom meta info by going to "Settings > UXbarn Portfolio Options" and they will appear on the portfolio's edit screen. There is no need to use the below instruction.


There are two major sections involved which are:

1. For the front end, open "/uxb_templates/single-portfolio.php" file and there you will see the code for the meta info to display on your website.

2. For the back end, open "/includes/plugin-codes/custom-uxbarn-portfolio.php" file and search for the function of "uxbarn_custom_port_create_meta_info()".

13. General troubleshooting steps

When there's something wrong happened with your WordPress site, don't panic. In many cases, the cause of issues can be found and solved easily. Please try the following troubleshooting steps:

  1. First, make sure that everything is up-to-date on your site (WordPress, themes, and plugins).
  2. If you still have issues, try to switch the theme to the default WordPress' Twenty [xxx] theme (for example, Twenty Seventeen) to make sure that the issues you are having are related to the UXBARN theme you are using. If the issues are still there after switching themes, it means the issues are not from the theme, but they might be from any of the plugins you are using.
  3. Now you can try to disable the plugins one by one to see if any of them are the cause. If you find ones, please contact the plugin developers.
  4. If the problem occurred after you had customized the theme, try to revert everything back to the default state. This should solve the problem in most of the cases. After that, double check your custom code again before adding it back piece by piece.

The above steps are probably enough for troubleshooting the issues by yourself.

But if you see an error message like "500 Internal Server Error", it means there's something wrong on your server. Please contact your system admin to help you check the server's error log and to solve the issue.

14. Creating a child theme


This article is offered for informational purposes. Please note that while we're happy to provide this guide, we can't offer support for custom code modifications. For details on what our support covers, please review our Item Support Policy.

Before you proceed, it's crucial to understand the steps outlined in this article.



Firstly, ensure your theme is updated to the latest version.

If you're planning to make more than just CSS changes to the theme, we highly recommend using a child theme. A child theme allows you to modify the parent theme's functions, templates, and styles without losing those changes when you update.

For these tasks, you can use an FTP client like FileZilla to connect to the server hosting your WordPress site.

Ready to create a child theme? Follow the steps below:

1. Create a New Folder: Start by creating a new folder for your child theme within the "themes" directory of your WordPress site. The directory path should look something like this:

[root]/wp-content/themes/

For this example, we'll name the child theme's folder "child-theme," making the complete path look like:

[root]/wp-content/themes/child-theme/

2. Add Required Files: Inside the "child-theme" folder, create two essential files: "style.css" and "functions.php."

3. Edit 'style.css': Open the "style.css" file in your child theme and insert the following code at the top:

/*
 Theme Name:   Child Theme
 Theme URI:    https://uxbarn.com
 Description:  My Child Theme
 Author:       UXBARN
 Author URI:   https://uxbarn.com
 Template:     [parent-theme-folder-name]
 Version:      1.0.0
 License:      GPL
 License URI:  http://codex.wordpress.org/GPL
 Tags:         light, right-sidebar, responsive-layout, accessibility-ready
 Text Domain:  uxbarn
*/

The crucial part here is the "Template" line. This must match the folder name of the parent theme. For instance, if you're using our Kathy theme as the parent, the "Template" line should read "kathy," like so:

/*
 ...
 Template:     kathy
 ...
*/

Note: If you're using a different theme, adjust this line accordingly.

4. Edit 'functions.php': Now, open the "functions.php" file in your child theme and add the following code at the top:

<?php
function child_theme_enqueue_styles() {
    wp_enqueue_style( 'child-style', get_stylesheet_directory_uri() . '/style.css' );
}
add_action( 'wp_enqueue_scripts', 'child_theme_enqueue_styles', 99 );

This action and function instruct WordPress to load the "style.css" file of the child theme, appending it to the parent theme's list of styles on the front end.

5. Activate the Child Theme: Finally, navigate to your WordPress admin panel and go to "Appearance > Themes." You should see your child theme listed among the available themes. Click to activate it.

  

----------

Overriding Parent Theme's Template Files

If you wish to modify theme template files like "header.php" or "index.php," simply copy the desired file from the parent theme into your child theme folder. You can then make your edits there.

----------

Overriding Parent Theme's Functions

To modify functions from the parent theme—say, the "uxbarn_register_theme_image_sizes()" function—copy only the specific function into the "functions.php" file of your child theme.

* Note: Be sure to copy only the "function() {...}" portion, excluding the "function_exists()" wrapper.

----------

Overriding Parent Theme's CSS

You can do this by either using the "Additional CSS" field in the theme customizer or adding your custom CSS code into the "style.css" file of your child theme.

----------

Important Reminder!

After updating the parent theme to a newer version, always review the code in your child theme. Update it as needed to align with any changes in the parent theme. This practice ensures that your child theme remains up-to-date and avoids potential conflicts.

----------

That should be all the necessary information to help you get started with a child theme!

15. Setting up automatic updates

You can set up the automatic updates in our UXBARN themes using the Envato Market plugin. After installing the theme, you should see a notification at the top telling you to install the Envato Market plugin; just install and activate it first.

The idea of this plugin is that, you create and save a token and the plugin will list the items you purchased on the Envato Market (ThemeForest, CodeCanyon, for examples). You can then update the items easily via WordPress Updates.

Please follow the steps below to set up the plugin:

1. After activating the plugin, you will need to configure it by going to the "Envato Market" menu on your WP admin panel. You should see this screen:


2. There are 2 options to choose:

2.1) For Global OAuth Personal Token, it is suitable if this is your own website so once the token is saved, the plugin will list all the purchased items. To start creating the token, click the "generate a personal token" link on the page.

You might then see the login page. Just log in with your account that you used when purchasing the theme. Now you will see the screen like this for creating a new token: 


Select the permissions as shown above and click "Create Token". You will finally see a screen showing the information of the created token. Copy that token and put it into the "Token" field on the Envato Market plugin page.

After saving, you will see all of the purchased items of the account that is used to create the token.

2.2) For Single Use OAuth Personal Token, it is suitable if you create this website for your client so you can specify which items you want them to display. The plugin will show only the added items. The overall concept is similar to the global token instructed above. Once you click the "Add Item" button, you will see this popup window:


Use the same steps as the above global token to create a new token. Or if you already have one, put it into the "Token" field here.

To find the item ID, just go to the item page on ThemeForest then look at the browser's URL field. You will see a number like this "11354296" right after the item name in the. Copy and put it into the "Item ID" field then click "Save".

That's it! If the plugin is properly configured, next time when there is a newer version of the theme available, you will see an update notification on your WP admin.

16. Some bundled plugins cannot be updated. They tell me to register with their own license first. What to do?

There are two different cases here:

Case 1: The bundled plugins cannot be updated right after finished updating the theme

You find that the newer versions of the bundled plugins already come with the latest version of the theme. You normally can update them via WP but this time the plugins prevent you from the update.

Symptoms

This is the case that after you finished updating the theme, you see a notification to update the bundled plugins on your WP like this:

You then click "Begin updating plugin" and try to update the plugin in the next screen but you get the message like this:

Note that in this case, the bundled plugin is only Visual Composer. There can be any other bundled plugins that give the similar message, for example, Revolution Slider, LayerSlider, etc. and you cannot then update them via the theme.

Solution

On your WP panel, go to the "Plugins" menu and disable the plugins in question first. Then try to update them once again using the same method. This should let the update pass the registering/activating process of the plugin. Finally you should see a complete message like this:

Now just reactivate the plugin after the update.



Case 2: You just see a notification from the bundled plugins to register/activate them to receive auto update

In this case, you can just ignore the notification as you get the plugins with the theme (bundled ones). So you do not have the purchase code of the plugins to register or activate them. Normally the bundled plugins will be updated periodically with the new version of the theme.

Or, you may consider purchasing the plugins separately to get their own purchase code so you can use the auto update of the plugins without waiting the next version of the theme. But we cannot guarantee the plugin support as we only test with the version that comes with the theme.

17. I couldn't update the bundled plugins with the theme purchase code. Why?

Since they are "bundled" with the theme, the plugins will only be updated with the newer version of the theme. This is normal for any bundled items. You won't be able to use the theme purchase code to register or update them directly.

If you wanted to directly update the bundled plugins, you would need to purchase them separately to get their own purchase code.

18. How to adjust CSS for different screen sizes?

There are times when you wanted to use CSS code for different screen sizes. For example, you want to display the tagline normally on PC, but you want it to be hidden when viewing on a mobile.

1. Use https://designmodo.com/responsive-test/ or http://responsivepx.com/ for simulating the device viewport. You can also use the Chrome's Developer Tools for the job.

2. Use the Chrome's Developer Tools or Firebug on Firefox to inspect the elements you want to adjust.

3. Use CSS media queries to create the CSS for a particular screen size. For example:

@media only screen and (max-width: 768px) {
    .tagline {
        display: none;
    }
}

The code above will hide the tagline on any 768px screens and below.

For more information about CSS media queries, please see: https://developer.mozilla.org/en-US/docs/Web/CSS/Media_Queries/Using_media_queries

4. You can enter any custom CSS code into the "Additional CSS" section that is in the theme customizer.

19. I want to have all the content like the demo site. How do I do that?

You can do that by importing the demo data from the provided XML file which is included in the full purchased package.

For a full guide of how to install the theme (and import the demo data), we would suggest reading through the theme documentation. There are also some useful tutorials provided in the doc to help you get started with the theme.

Note that the documentation is also included right in the purchased package. Just go to the 'Documentation' folder and open the 'index.html' file with your browser.

20. OptionTree could not be downloaded and installed. What to do?

On November 6, 2018, the OptionTree plugin seemed to be somehow disabled on the plugin repository of WordPress.org so you would not be able to download and install it. When you are trying to install the plugin, you might get an error message like this:

Something went wrong with the plugin API.

The issue should be temporary, and it should be online again in a few days.

However, if you are still experiencing the issue, you can manually install the plugin by following these steps:

1. Download the OptionTree plugin\'s ZIP package from here: https://cl.ly/32a1a9b26df4

2. On your WP admin panel, go to \"Plugins > Add New > Upload Plugin\" then browse to the plugin\'s ZIP file you downloaded in step 1 and click the Install Now button.

3. After it is installed, click the Activate Plugin button you see on screen.


* The themes that are affected by this situation are: Kathy, Darren, Alvar, Enso, Viceversa, Nakamura, Finnik, Lowel, Schon, Calmer, Thine, Kose, Fineliner, and Archtek.



Latest Update about OptionTree (April 3, 2019)

The author of OptionTree has already updated the plugin to v2.7.0, but it is currently in a develop branch on their github repo (reference: https://github.com/valendesigns/option-tree/issues/696#issuecomment-476055302 ). Once everything is settled, we will update and include the latest version of OptionTree in the following themes:

Note that for the other themes (Kathy, Darren, Alvar, Enso, Viceversa, Nakamura, and Finnik), the OptionTree plugin has been replaced with Advanced Custom Fields.