Lukani DocumentationThank you for purchasing my theme. If you have any questions that are beyond the scope of this help file, please feel free to email via my user page contact form here. Thanks so much!
| Author: | RoadThemes |
| Contact: | roadthemez@gmail.com |
| Item: | View Demos |
| Current Version: | 1.0.0 |
| Documentation Version | 1.0.0 |
| Created: | 2019-07-22 |
To install this theme you must have a working version of WordPress already installed. You should ALWAYS be running the latest version of WordPress anyway; otherwise you put your whole site at risk for potential threats in case using an outdated version of WordPress.
If you need help installing WordPress, follow the instructions in WordPress Codex.
Once you've downloaded the installation file on ThemeForest, extract it and locate a file called lukani.zip. You can install the theme by using one of two installation methods:
Once installation is complete, your Theme theme will be ready to use. You should now see "lukani" appears in the WordPress themes manager panel.
Note: If you don't want to lose changes after a theme update, we recommend that you install and activate a child theme.
The installation of plugins will be required once after the theme activation.
***Install and Activate them. In case if automatic plugin installation fails (as a rule it is because of your server settings), you can install them manually via your Dashboard: Plugins > Add New > Upload Plugin > Browse plugins archives. Or via FTP, by uploading and extracting the plugin zip files into wp-content/plugins folder.
- You can find the zip files for plugin installation in the theme folder lukani/plugins.
Watch the guide above to see in details.
***Automatic plugin installation
***Manual plugin installation
We can import content for pages, posts, menu, projects, contact form, testimonials... like our demo. To import our demo content follow the steps below:
Install and activate required and recommended plugins before you proceed.
Click Import Roadthemes => Click on IMPORT DEMO => Wait some minutes => See The data have imported succesfully => Next, click Import Roadthemes => See the demo with ACTIVATED => Successful
To install other demo, please click Import Roadthemes -> IMPORT DEMO at the demo you want. => See The data have imported succesfully -> Successful
To install demo which you have imported but now not "ACTIVATED", please click Import Roadthemes -> ACTIVATE at that demo.
After importing demo data, slider doesn't show. You need to create/import. We have some sample slider in the slider-sample folder in the package.
- Login to your WordPress dashboard, navigate to Slider Revolution - Modules - Manual Import
- You can drag and drop sample slider or choose Click to Choose to choose sample slider in the slider-sample folder in the package
- You can see sample slider you've imported at:
- After importing demo content, if Shop page doesn't show sidebar, please import widgets.
- To create widgets for this theme quickly, we use a tool to import all widgets from exported files in "sample-data/exported_files" folder.
- Login to your WordPress dashboard, navigate to Tools - Widget Importer & Exporter
- Click on "Browse..." or "Choose File" button then select "widgets.wie", click on "Import Widgets" to finish.
- After importing widgets, if you need change widgets, go to Apperances - Widgets
You can update your theme manually by performing the following steps:
***Important note: Please note that all changes made directly within theme files (additional PHP coding and theme modifications) will be lost upon theme update. That is why we recommend using a child theme when making changes in theme files, in order to avoid losing these changes or having to re-do them each time you update your theme.
Go to Dashboard> Settings > General
If the url is not correct, Go to Dashboard > Settings > Permalink and Click Save
To change site title, tagline, site icon, you need to do like steps below:
- Go to Dashboard - Appearance - Customize - Site Identity: Change title, tagline, icon of the site.
To set a page as home page and posts page (blogs):
****Example: To set Home1 to be your homepage:
Login Dashboard > Settings > Reading :
After that, you must go to Dashboard> Pages > All Pages > Home page (you have set above, Example: Home shop 1, Home shop 2 ...) and set Template as Front Page Template:
***Important note: Please note that Template Demo (2, 3, ...) are only for our demo. If you choose Template Demo, you cannot change Theme Options and Header, Footer layouts.
Login Dashboard > WooCommerce > Settings :
- Tab Products: setting Shop page.
- Tab Advanced: setting other pages.
- Setting Wishlist page: Go to Dashboard > YITH > Wishlist > Settings :
*** Note: You have to set home page as Front Page Template , see Setting Homepage and Posts Page
You can access Theme Options from the WordPress admin panel. The settings found here are applied globally and will affect all pages of the site.
This section allows you to set up general settings for your site. We can change body background, content background and show/hide the back to top button.
This is where you can change colors for your website. We can change the primary color, sale label color, link color, text selected color and background.
Note: The menu ID may changed, so you need to update menu in Pages, Header, Footer (WPBakery Page Builder editor).
This section allows you to set up the header area. The first choice to change the header layout, header layout in mobile. Change the header text color and link color.
We can turn on or off the sticky header. Change background for the sticky header, it supports transparent background color. You can change header sticky layout.
In this area, we can change text color and link color for top bar.
We can change mobile menu label. The sub menu background in desktop view.
We can change categories menu label. The sub categories menu background, number of items are applied for the categories menu (categories menu) in desktop view.
Note: The menu ID may changed, so you need to update menu in Pages, Header, Footer (WPBakery Page Builder editor).
This area allow you to change the footer layout, footer background, footer text color, footer link color.
In this area, we can change font for text, heading, menu, price... There are some options to select for each font like font family, back up font family, font weight and style, font size, line height, color. We use Google Fonts. You can use default options or change any font like you want.
If we want to use default options, click on "Reset Section" button.
In this tab, we can select page layout is full width or box, select theme preset and turn off the style switcher.
Preset: There are many presets to select, if we select a presets (example: preset 2) the theme uses pre-defined fonts and colors in that preset. If we select "Use Options" then the theme uses fonts and colors from "Colors" and "Fonts" tab.
This section allows you to upload brands logo and configure the options for the brands slider. Click on Add Slide to add more logos.
This section allows you to upload category logos and links. Click on Add Slide to add more images.
This section allows you to change position of sidebars to left or right side in inner Pages (Default Page Templates). Products and Blogs sidebars are in other sections. Go to edit page/post to select custom sidebar.
This section allows you to change the layout for the shop page and change position of sidebar in shop page. We can change how the products appear in grid view or list view. We have products per page, product columns and secondary image.
This area allows you to change options for the product page in product page.
This area allows you to change the text link on the quick view window.
This section allows you to change the text on header of blog page "Blog", select blog layout, change read more text, change position of sidebar in blog page.
This area allows you to change options for the latest posts carousel on home page.
This area allows you to change options for the testimonials carousel on home page.
This section allows you to upload image, background for the error 404 page.
This section allows you to turn on/off the less compiler. In the theme, we used .less files in the "less" folder to generate .css files. Turn off the compiler after you finished your website.
- Go to Theme Options - Header - Header Layout to select your header layout.
- Go to Theme Options - Header - Header Mobile Layout to select your header layout on Mobile.
- Go to WPBakery Page Builder > Templates > Header 1 (Header 2/ Header 3/ Header 4)(The header you are using) -> Edit:
***Change mobile header : In WPBakery Page Builder=>Templates=>Header Mobile -> Edit
***Change Logo: Now let's add a logo. In WPBakery Page Builder > Templates > Header 1 (Header 2/ Header 3/ Header 4) (the header you are using) : you click to Logo shortcode to edit, then select image from library or upload new logo. Remember to save. You should now have a visible logo in your header area.
***Change Sticky Logo: In WPBakery Page Builder > Templates > Header 1 (Header 2/ Header 3/ Header 4) (the header you are using) -> you click to Main Menu shortcode to edit, then select image from library or upload new logo. Remember to save. You should now have a sticky logo in your header area when scrolling page.
***Change Logo in mobile: In WPBakery Page Builder > Templates > Header Mobile -> you click to Logo shortcode to edit, then select image from library or upload new logo. Remember to save. You should now have a logo in your header area in mobile.
- Go to Theme Options - Header - Header Mobile Layout to select your header mobile layout.
- Change your logo and content of header on mobile : Go to WPBakery Page Builder > Templates > Header Mobile (The mobile header you are using) -> Edit. Remember to save when finish changing.
After installing theme, to show My Account on Header, you need to config and save menus:
Go to Dashboard > WPBakery Page Builder > Templates > Header 1(Header 2/ Header 3/ Header 4) (the header you are using)
At WP Custom Menu -> Edit -> At Menu:
To like our demo set:
- With (1): Select Currency 2 menu
- With (2): Select Language 2 menu
- With (3): Select Top Menu menu
- Go to Theme Options - Footer - Footer Layout to select your footer layout.
***Change Logo: In WPBakery Page Builder > Templates > Footer 1 (the footer you are using) : you click to Single Image of Logo to edit, then select image from library or upload new logo. Remember to save. You should now have a visible logo in your footer area.
*** Footer contains Logo, copyrights, menus.
- To edit Footer: Go to WPBakery Page Builde > Templates > Footer 1 to edit.
After installing theme, to show links above on Footer, you need to config and save menu:
Go to Dashboard > WPBakery Page Builder > Templates > Footer 1 (the footer you are using)
At WP Custom Menu of titles -> Edit -> At Menu: Select menu you want to show -> Save
To like our demo set:
- With (1): Select Information menu
- With (2): Select Extras menu
- With (3): Select My Account menu
- With (4): Select Customer Service menu
Following these steps to create a menu.
Go to Dashboard > Appearance > Menus
Click on Create a new menu -> Enter a name for your menu, and then click on Create Menu
Select items from the left meta boxes and click Add to Menu
On the right, feel free to drag and drop menu items to organize them
When you’re done moving menu items, check a menu location at the bottom of the page
Click Save Menu
- To config locations of menus like demo, please follow these steps:
Go to Appearance > Menus > Manage Locations and choose location for each menu:
Go to Dashboard > Appearance > Menus
Select Edit Menus : At Select a menu to edit : Choose Horizontal Menu (Primary Menu, Sticky Menu, Sidebar Menu by Mega Main) -> Select
Select item you want to set columns. Ex, here is Shop : At Menu Structure : Set Multicolumn Submenu and Submenu Columns (Not For Standard Drops) : choose number of columns
To change links of items on menus:
Appearance > Menus
Select Edit Menus : At Select a menu to edit : Choose Horizontal Menu (Primary Menu, Sticky Menu, Sidebar Menu by Mega Main) -> Select
At Menu Structure -> Select item need change url -> At URL: Enter url of that item.
You can go to https://wpbakery.com/video-tutorials/ to read more about WPBakery Page Builder
Theme comes with WooCommerce integration, which allows you to build an online shop. For more information on installing and configuring WooCommerce, please visit this page:
http://docs.woothemes.com/documentation/plugins/woocommerce/getting-started/
In order to setup WooCommerce with our theme, please perform the following steps:
Main image width: Single product width (unit: px)
Thumbnail width: The largest width of products (in shop and homepage layouts, not the thumbnail) (unit: px)
Important Note: After changing product sizes, you need to regenerate thumbnails. Read more: http://wordpress.org/plugins/regenerate-thumbnails/
When editing a product, we can upload a featured image and thumbnail images.
Note: You need active plugin YITH WooCommerce Zoom Magnifier.
Read more: https://docs.yithemes.com/yith-woocommerce-zoom-magnifier/.
Go to YIT Plugins=>Zoom magnifier to select options for the zoom feature on the product page.
Note: You need active plugin YITH WooCommerce Wishlist.
Read more: https://docs.yithemes.com/yith-woocommerce-compare/.
Go to YIT Plugins=>Wishlist to change settings for the wishlist, we don't require any settings there but we recommend to change text, select social networks.
Note: You need active plugin YITH WooCommerce Compare.
Read more: https://docs.yithemes.com/yith-woocommerce-compare.
Go to YITH Plugins=>Compare then select settings like this
You can go to https://www.themepunch.com/revslider-doc/slider-revolution-documentation/ to read more about Revolution Slider.
You can import sample sliders, please view Import Revolution Slider .
To create a new blog post, go to Posts - Add New from the admin panel.
Let's go over Post Format :
You can insert shortcode carousel such as Carousel, Gallery ...
You can insert shortcode video such as Youtube, Vimeo ...
You can insert shortcode carousel such as Audio ...
Now that you've set up your blog post, let's go over the custom fields.
Note that most of them are the same custom fields you'll find when creating standard pages.
Go to Instagram Feed to config, set ID instagram, can custom number of photos, columns will be shown.
You can find our shortcodes in tab Theme
Note: read more about Woocommerce Products: https://docs.woocommerce.com/documentation/plugins/woocommerce/getting-started/setup-products/
Some Settings for Example:
Brand Logos can be added in Dashboard - Theme Options - Brand Logos
Categories carousel can be added in Dashboard - Theme Options - Categories Carousel
Note: You need active plugin Mailchimp For Wordpress.
Read more: https://wordpress.org/plugins/mailchimp-for-wp/
Go to Dashboard - Mailchimp for WP - Mailchimp and enter your API.
- Then go to Mailchimp for WP - Form to edit Mailchimp Form and get the Form ID.
- Go to Dashboard - Pages - All Pages - Choose home page & paste shortcode of Mailchimp
Note: You need active plugin Instagram Feed.
Read more: https://wordpress.org/plugins/instagram-feed/
Go to Dashboard - Instagram Feed to configure.
To use this shortcode, you can add text (shortcode Text Block) like:
[instagram-feed]
You can go to https://wordpress.org/plugins/instagram-feed/#installation for more settings.
- Create pages: you can read more: https://wpbakery.com/video-academy/start-building-page-scratch-blank-page-templates/
- When creating a new page, one of the first things you might want to do is to assign an appropriate template for it. To do this, go inside the page backend and locate the section on the right called Page Attributes. Theme comes with a variety of templates to choose from:
We will guide 2 ways to translate theme: Using Loco translate and PoEdit. We only guide translate text strings of our theme.
Important: Before, you need check you can switch language
Dashboard -> Settings -> General. Changing this will set a new default language for all site visitors. Example, we're going to set the language to French at Available : Choose Français
If you don't see your language in the dropdown list you may have to install the core language packs manually.
You can set your site back to English now if you like. We'll be switching to French later on to check our custom translations are working, but the language setting isn't required while we add them.
Go to Dashboard > Plugins > Add New
Enter Loco Translate at search field
Locate Loco Translate in the search results and click on Install Now
Once installation is complete, click on Activate
=> You can read this guide to translate theme with Loco translate : https://localise.biz/wordpress/plugin/beginners
You need install Poedit software on your computer. Poedit is available on OS X and Windows and can be downloaded from here.
Before using Poedit to translate,
Open Poedit and select Create new translation
A new window will pop up, select WordPress theme you want to translate. A Theme’s default translation template is located in wp-content\themes\your_theme\languages\lukani.pot
Next, from a dropdown menu select a language you want to translate your theme to:
Highlight any string you want to translate. Or you can press Ctrl+F to find string you want to translate.
In the Translation section enter a desired translation of the source string
Once you have translated your theme, save the file with format : language-code_country-code.po("fr_FR.po" in this example) in wp-content\themes\your_theme\languages
- Explanation: fr_FR - with "fr": language-code and "FR": country-code
- You can find language code and country code at Get language codes , Get country codes
The easiest way to translate the plugin is by using the Loco Translate WordPress plugin. To use loco translate plugin, please see the steps below.
Go to Dashboard > Plugins > Add New
Enter Loco Translate at search field
Locate Loco Translate in the search results and click on Install Now
Once installation is complete, click on Activate
Go to Loco Translate > Plugins and click a plugin theme. Example: Slider Revolution
Click New Language
- If after you click New Language, you see Template missing the warning. You only click Skip template
Choose your language and choose a location is in languages/plugins/, then click Start Translating
Click Source Text and enter the text you want to translate in French translation
Click Save button
Note: To update your language file when you updated the theme, you only click Sync button.
If you change the image size settings, you must resize all images that you have uploaded. You can use plugin Regenerate Thumbnails, read more: https://wordpress.org/plugins/regenerate-thumbnails/.
Read more: https://getbootstrap.com/docs/4.2/getting-started/introduction/
If you modify a theme directly and it is updated, then your modifications may be lost. By using a child theme you will ensure that your modifications are preserved.
Read more: https://codex.wordpress.org/Child_Themes.
Please note that Theme comes with font icon pack: Font Awesome 4.7.0, Pe icon 7 stroke, Ionicons, Linearicons Free, Material Design Iconic Font, ... See which icon fonts are used by go to folder: wp-content\themes\[theme-name]\css. You can see an overview of all the available icons in this icon packs at the following link:
We hope this manual was useful for you and helped you to install, to edit the template and to resolve your issues.
In this theme, it uses the less compiler function to generate css files from .less file. If your server has small PHP memory, it may show the error. Please try to increase the PHP memory like this:
1. Edit your wp-config.php file and enter something like:
ROADTHEMESdefine('WP_MEMORY_LIMIT', '256M');
http://codex.wordpress.org/Editing_wp-config.php#Increasing_memory_allocated_to_PHP
2. If you have access to your PHP.ini file, change the line in PHP.ini
If your line shows 32M try 256M:
memory_limit = 256M ; Maximum amount of memory a script may consume (256MB)
3. If you don’t have access to PHP.ini try adding this to an .htaccess file:
php_value memory_limit 256M
4. If none of the above works then talk to your host.
Cause of this problem is small value of the "max_input_vars" option in the configuration of your server (host). You must increase value of the "max_input_vars". You must to set a value that is twice as large of the current value.
php_value max_input_vars 3000
php_value suhosin.post.max_vars 3000
php_value suhosin.request.max_vars 3000
max_input_vars = 3000
In some cases, you uses large images on your page, server run slowly because it's a VPS. Try these methods:
- Reduce images size
- Install cache plugin like W3 Total Cache
- Turn off less compiler in Theme Options=>Less compiler after finished changing colors & fonts.
- Test website with GTMetrix and see its suggestions https://gtmetrix.com/
If you get a white screen or some other error when trying to import our demo content, this probably happens because of the maximum execution time limit. You need to increase the maximum execution time (upload time) setting of your web server. The default maximum execution time on web servers is 30 seconds. Please increase it to 300 seconds. Possible ways of achieving this are:
Ask your hosting provider to take care of this for you.
In this theme, we use Shortcodes Ultimate plugin to make shortcodes. You can go to this page http://gndev.info/kb/ and read the documentation to create your own shortcodes.
I have included these sources with this theme:
jQuery: http://jquery.com/
FlexSlider: http://flexslider.woothemes.com/
Slick: http://plugins.jquery.com/slick/
jQuery Gmap: http://labs.mario.ec/jquery-gmap/
FancyBox: http://fancyapps.com/fancybox/
jQuery Parallax:http://www.ianlunn.co.uk/plugins/jquery-parallax/
jQuery Shuffle: http://vestride.github.io/Shuffle/
Font Awesome: http://fortawesome.github.io/Font-Awesome/
lessphp: http://leafo.net/lessphp
Once again, thank you so much for purchasing this theme. As I said at the beginning, I'd be glad to help you if you have any questions relating to this theme. No guarantees, but I'll do my best to assist. If you have a more general question relating to the themes on ThemeForest, you might consider visiting the forums and asking your question in the "Item Discussion" section.