like.themes.wp@gmail.com www.like-themes.com Portfolio

Kaffa - Like Themes WordPress Theme Documentation 1.0

Before continue, please check online documentation, it can be updated.

1. Theme Support and Licence

Thank you for purchasing Kaffa WordPress Theme. If you need support you can contact us by email (like.themes.wp@gmail.com). You must provide purchase code, we'll answer you in 1-2 business days (if you wait for answer too long, please check spam folder). According to item support policy it doesn't include theme customization, third party plugins integration and hosting problems.

With ThemeForest Regular License you allowed:

You are not allowed:

For more information about license please read https://themeforest.net/licenses/faq.


2. Theme installation

To install this theme you must have a working version of WordPress already installed. Make sure you have clean WordPress setup.
This installation guide will help you to install the WordPress. If you area new in WordPress we recommend you to read WordPress Codex, FAQ and Lessons.


Requirements

You need web hosting with at least PHP7.x, MySQL 5 or higher and WordPress 5.x installed. Please check WordPress official minimal requirements https://wordpress.org/about/requirements/
If you have troubles with theme installation or one click demo install, make sure your server configuration limits are:

You can check the server settings using the left menu Like Themes.

To change these values edit your .htaccess file (at root of your FTP) and adding these lines:

php_value upload_max_filesize 32M
php_value post_max_size 32M
php_value memory_limit 128M
php_value max_execution_time 600

 
  
If it still not helps - contact your hosting provider, they must help you with server configuration.


Installation

Please watch full video tutorial. It was recorded for our Gomoto theme, but can be used for any theme of our development.



Notice: we recommend installing our theme on a clean WordPress to avoid problems.

The theme files can be uploaded in two ways: Through FTP or through WordPress dashboard.
  1. FTP
    Upload the non-zipped theme folder into the /wp-content/themes/ folder on your server. You must upload upload the file kaffa-child.zip in addition with the folder /kaffa/ from archive kaffa.zip.
  2. WordPress
    Navigate to "Appearance" > "Add New Themes" -> "Upload Theme" -> "Choose file" (choose kaffa.zip) > Install


   


Activate it after install.


Basic configuration

  1. Install all required plugins by clicking on Begin installing plugins
  2. Activate them after that
  3. Update permalinks for custom pages in Settings -> Permalink -> Save

Attention! Unyson, LTE-Ext and Elementor plugins are necessary plugins for theme work. They are required to install!
Notice: if you want to use a child-theme, you can also upload the file kaffa-child.zip in addition with the main Kaffa Theme. Child Theme allows you to add/modify CSS Stylesheet and functions without modifying main theme files. And you'll not lose your modifications after main theme update.


Like Themes left menu.

This menu consists of two items: Like Themes and Theme Settings. The Theme Settings menu item is described in more detail in paragraph 4 of the left menu. The Like Themes menu item helps you check if your server configuration matches the theme requirements. This menu item also contains links to the main theme settings menus, a link to documentation, technical support contacts and links to technical support rules.

Screenshot from the Like Themes menu:


Demo Content Install


We recommend you to install demo content. Go to the Tools -> Demo Content Install. Be aware - installing of demo content will delete all your current content.
Click Install, wait till it'll be downloaded. Your WordPress Kaffa theme now must be identical to live preview. If you have troubles with installation, please check minimal PHP hosting requirements from Theme installation section.




Notice: If Tools -> Demo Content Install not Available - make sure Unyson Plugin is installed and activated. Also Backup & Demo Content Extension must be active:




If demo installation interrupts with warning "Curl SSL" , contact your hosting support and ask them to check, that Curl SSL support is enabled on your site.

If backup or import interrupts with "Abort" link and you have this notice in dashboard “Unyson: Your website is hosted using the LiteSpeed web server. Please consult this article if you have problems backing up.” please read this article: http://manual.unyson.io/en/latest/extension/backups/index.html#litespeed-webserver.
Or you can use the solution that our developers found.

3. Troubleshooting guide

Theme is missing the style.css stylesheet error


If you have error "Theme is missing the style.css stylesheet error" - make sure you uploading inner WordPress .zip file with theme, not the whole archive downloaded from ThemeForest. Unzip the archive and download only the attached *.zip file with the theme.

More information on https://help.market.envato.com/hc/en-us/articles/202821510-Theme-is-missing-the-style-css-stylesheet-error.


LiteSpeed web server

If backup or import interrupts with "Abort" link and you have this notice in dashboard “Unyson: Your website is hosted using the LiteSpeed web server. Please consult this article if you have problems backing up.”


You can use the tips from this article: http://manual.unyson.io/en/latest/extension/backups/index.html#litespeed-webserver.

Or you can use the solution that our developers found. You need to make changes to the file .htaccess and wp-config.php which are located in the root folder on your FTP server:

1) .htaccess:

RewriteRule .* - [E=noabort:1]


2) wp-config.php: 

define('DISABLE_WP_CRON', true);
define('ALTERNATE_WP_CRON', true);

Menu assignment

If after installation you have problems with menu and it displayed without drop down levels like on screenshot:




Make sure that Main Menu is assigned in Appearance > Menu > Menu Settings > Display Location:


Image regeneration

If during the installation of demo content you had this error:

Or after installation you notice that some images are missing, here is a guide to fix this problem:
Install the Regenerate Thumbnails plugin:
https://wordpress.org/plugins/regenerate-thumbnails/

In the Tools menu, the entry "image regeneration" will appear.


Click on the button marked in the screenshot:


At the end of the image regeneration process, thumbnails for all images will be restored.


Requests made through the contact form do not come to the email.

The WordPress Themes doesn’t control WordPress/WooCommerce sendmail function. It is external plugin. You can enable default WordPress theme and check sendmail again.

If you have problem with smtp, it could be mail server configuration error. You can install this plugin and run Connectivity Test, it will check if the SMTP service is available on your hosting:
https://wordpress.org/plugins/post-smtp/

If you have problems with SMTP service you need to contact hosting support and ask them for help. You can also use this plugin in order to configure external SMTP service (Gmail, for example):
https://wordpress.org/plugins/wp-mail-smtp/

4. Theme Configuration

The basic settings of the theme can be done in the menu Like Themes > Theme Settings.

General Configuration

Menu Like Themes > Theme Settings > General > General Settings
Page Loader - styled for particular theme page loader can be deactivated or replaced with a custom image.
Google API Key - you must enter your Google API Key if you need Google Maps services.




Menu Like Themes > Theme Settings > General > Logo and Media
In this menu you can load your logo and set its height with which it will be displayed.



Header Configuration

Menu Like Themes > Theme Settings > Header > Navbar

    



Navbar Default - allows you to define the style of navbar by default. In the theme there are few options:



Navbar Default Override - overrides navbar on all pages.



Navbar Sticked - determines the position of the navbar on the page. Two options are available: sticky and static


Navbar Mobile Breakpoint, px - You can specify the point at which the navbar will switch to the mobile display.
Important!  The value must be specified in pixels.



Menu Like Themes > Theme Settings > Header > Topbar

The topbar is usually called the contacts section, which is located above the navigation menu:



Important! In this menu you can change only the visibility of the navbar and define it.



 You can create or edit the topbar in the menu Sections.


Menu Like Themes > Theme Settings > Header > Icons and Elements





Phone number can be changed in Navbar Additional Icons:




In this menu you can assign different types of icons for display in the Navbar. For example: shopping cart, user profile, search, social icons (phone icons). You can also determine the display of icons on your mobile phone.



All icons created in this menu can be displayed everywhere by adding a shortcode [lte-navbar-icons] to into a text widget or text block in the page editor.



Menu Like Themes > Theme Settings > Header > Page Header H1
In this menu you can customize the background, effect of parallax in header, Display of social network icons (which are configured in the menu Like Themes > Theme Settings > Social)



Featured Images as Background

If you need to use a different background in the header for different pages, activate this function in this menu:




After activation, the background image in the header will be replaced by the Featured image assigned in this page. If such an image is not assigned, then the image assigned in the Theme Settings menu will be displayed in the header.
Notice: we recommend using images with a resolution of 1900 * 600px for the background in the header.



"Page Header H1" responsible for the section of the site between the Navbar and the rest of the site content. See the screenshot below:



Footer Configuration

Menu Like Themes > Theme Settings > Footer > Widgets
In this menu, you can customize the display of content in the footer.



In the "Footer Default Style" drop-down list, you can choose few options for displaying the footer:



Default - displays footer with settings made in this menu.
Copyright Only - hide all footer content and display only block Copyrights.


Also in this menu you can change Footer Background and enable Footer Parallax effect.


Widgets visibility.
In this part of the settings, you can configure the space to display content in the footer. The space of the footer on the screen is divided into equal parts depending on the active sections. For example: If you have all 4 footers turned on to display, then each of them will occupy a quarter of the screen. You can also hide the content of the footer for display on different devices by activating or turning off the footer with the desired number.
You can change the content in the footer in the menu Appearance > Widgets.


Important! In this menu, you can only configure the way content is displayed in the footer. You can read about how to configure the content at the link: Widgets


Menu Like Themes > Theme Settings > Footer > Go Top

In this menu we define the appearance and behavior of the "Go Top" button.




This button can be found in the lower right corner of the site:



Menu Like Themes > Theme Settings > Footer > Copyrights

In this menu you can register your copyright.
Important! If you just leave the text input field empty, it will not remove our copyright from your site. You need to replace them with your own.




Posts Types

In the menu Like Themes > Theme Settings > Posts Types you can customize the display of content on pages with blogs, services and in the gallery. For example: enable or disable the sidebar in blogs or on the blog pages, change the number of items in one row per page, change the number of columns in the gallery... Excerpt Blog - automatically cuts text on these pages.





In the Services tab, you can configure the look of the template for services. Important: in this menu you are able to change slug for services.




WooCommerce Custom Settings

Menu Like Themes > Theme Settings > WooCommerce contains a lot of settings that affect the display of products in your online store:









Fonts

In this menu you can control the fonts used in the theme:





Social

In this menu you can add the icons of social networks or instant messengers that you need and add to each link.




Notice: you can use these icons anywhere on the site with a [lte-social] shortcode.


On the Share Buttons tab you can specify what exactly share buttons will persist on your site:




Color Schemes

Our themes provide the ability to use different color schemes in one site. The basic color scheme can be configured in the menu Appearance > Customize > Kaffa Colors. Also, you can create your own color scheme in the menu Like Themes > Theme Settings > Color Schemes:





After creating new color scheme you can assign it to the any page in the Page settings in the bottom of the page editing menu.




Favicon

Next, in Appearance  -> Customize you can set Site Title, add Favicon




Color Customization

Appearance  -> Customize -> Kaffa Colors allows you to change all main colors of the theme
(section can be named is theme you are using, for example Kaffa Colors)



CSS Customization

For minor changes you can use Appearance -> Customization -> Additional CSS. Basic information about of CSS:

Also you'll need in-browser tool for CSS Tweaks (watch firebug video tutorial):


WordPress settings

You can find more information in WordPress documentation, but we'll describe main options:




  1. Settings -> General. You can set here your email, timezone, date format
  2. Settings -> Reading. Frontpage must be set to "Homepage", but you can use any page of site as welcome page. Also you can change number of posts per page. 6, 8 or 10 will be optimal
  3. Settings -> Discussion. You can enable/disabled premoderation of comments here.

5. Menu and Widgets

Menu

Use Appearance  -> Menus to set you header menu and footer menu.
If you downloaded demo content, we set optimal pages, you can change order and level. Add new pages or remove them here. You can use different menus for header block (with multilevel menus).

   


Widgets

Widgets are blocks visible in blogs, shop pages and footer of site. You can configure blog sidebar position in pages control (or disable it at all).
You can change them in Appearance -> Widgets.
You can use any of standard WordPress widgets. Also you can install and any new widget in Plugins menu, but we can't guarantee full
support for them.



You can add the required widget to the footer using the drag and drop method. Or you can click on the widget and select where to add it in the drop-down list.



After adding the widget its contents can be edited as you need.



Important! Sidebar Default can be displayed on different pages of the site except WooCommerce pages. On WooCommerce pages only Sidebar WooCommerce is displayed. Footer 1, Footer 2, Footer 3 and Footer 4 are displayed only in the footer.


6. Posts

Blogs posts

It's standard WordPress posts module. You can write articles here, create categories, set tags.





If you want to create additional Blog Page, create empty page, them set Template -> Blog




Also set Blog Layout you want (at footer of Pages)




Gallery

Among standard gallery, you can use our posts type. Main Photo with header and description will be shown in list and other photos with full-page zoom inside of gallery.



As blogs, you can change layout and create additional pages:





Testimonials

You can post clients feedback here, it will be available on /testimonials/ page. Also you can post preview of feedbacks on any page with shortcode.



Sections and Topbar

Allows to edit common used on all pages blocks.



In the Section menu, you can create an additional section that can be displayed on each page above the footer or above the navigation menu. After creating a section, do not forget to assign its position.






7. Pages

Among posts, pages are main module where you'll create your site content. You can use Elementor for visually change blocks and using shortcodes. You'll find information about all Kaffa shortcodes in next section, here we'll describe main editor functions.


Layout

You can add new elements be clicking on plus button.

You can read all about Elementor Shortcodes in official documentation.

Layout Configuraton

For every page you can configure:




Additional Page Settings

In the bottom of any page editing menu you cam find additional Page Settings menu. In this menu you are able to hide or displays different parts of content, choose Navbar type, custom Color Schemes, hide or display Header etc.





8. Shortcodes

Here we describe our shortcodes:




Gallery Shortcode

The shortcode displays on the photo page from the specified gallery.







Like Slider shortcode

Shortcode displays previously created sliders from the specified category.







This shortcode displays sliders from a specific category. You can add sliders and assign a category to them in the Sliders menu.






Services shortcode

Shortcode displays previously created services.
In the shortcode settings you can specify the category of services to display, and the total number of services to display.




You can also choose another way to display services in the shortcode settings:



Header shortcode

Designed to display two sections of text: Header and Subheader. Provides a wide range of settings for each section individually.




Block with Icons shortcode

Create different information block with icons:








Button Shortcode

Shortcode displays a button on the page. In the settings, you can change the text of the label, add a target link and make small appearance settings: select default color state, hover color state, different text color.
Position allows you to set several button in one row.




Partners Shortcode

Shortcode displays the photo and the name of the partner. You can also add a link to a partners website.




Google Map Styled Shortcode

The shortcode displays a Google map on the page and marks the coordinates specified in the settings.

The result of this shortcode is visible on Frontend only:


Contact Form 7 Customized Shortcode

More detailed information about using Contact Form 7 you can find in section Forms. This shortcode allows you to create customizable
form with different button color or background:



Important: Contact Form 7 plugin is a third-party plugin. Detailed documentation on how to configure this plugin here:
https://contactform7.com/setting-up-mail/


Blog Shortcode

Insert block with last Blog Posts from archive

You can inset certain Blog Posts by ID's, or latest posts from Category. Also you can set needed text size.



Default Layout:




Featured Row Section layout:





CountUp Shortcode

CountUp Block is simple, but effective way to show some important information to you client.




Add several blocks, insert you information and that's all - animated block is ready.


Products Shortcode

Show latest product from WooCommerce plugin with filter and slider and can display products:
 





  Also, you can change the quantity of the products per row for different screen resolution:



Product Categories Shortcode

This shortcode displays previews of product categories. In the settings you can specify which categories will be displayed.






Instagram Shortcode

With this shortcode you can display the latest posts from your Instagram on your site:




Menu Shortcode

Shortcode allows you to display a menu from the selected category on any page with this shortcode. You can create your own menu in the left menu Menus.




Video PopUp Shortcode

Allows you to add image with video link:





Testimonials Shortcode

This shortcode allows you to display customer feedback and avatars.








9. Forms

You have the opportunity to create your own forms for users with the necessary fields.
For instance:


To add forms on your pages, first create them in required plugin. Then go to Contact > Contact Forms



To insert form into page use CF7 Shortcode or CF7 Customized for more options. You can read more about working with this plugin here: https://contactform7.com/setting-up-mail/


10. Additional Plugins


WooCommerce

E-commerce plugin with huge amount of add-ons.
https://wordpress.org/plugins/woocommerce/


Breadcrumb NavXT

Used for showing breadcrumbs in header of site
https://wordpress.org/plugins/breadcrumb-navxt/


Post Views Counter

Show number of views in gallery and blog posts. If you disable it icon will be hidden.
https://wordpress.org/plugins/post-views-counter/


MailChimp

Plugin for emails subscribe lists
https://mailchimp.com/


11. Third Party Plugins

Custom Fonts plugin

You can use additional plugin to upload fonts:
https://wordpress.org/plugins/custom-fonts/

Notice: You need to add It in all formats it requires (not only TTF).

Contact Form 7 plugin

Detailed documentation on how to configure this plugin here:
https://contactform7.com/setting-up-mail/

12. Tips and FAQs.

Loading custom icons

You can use this additional plugin to upload your own icons:

https://wordpress.org/plugins/custom-icons-for-elementor/



Loading custom fonts

You can use additional plugin to upload your fonts:

https://wordpress.org/plugins/custom-fonts/

Notice: You need to add It in all formats it requires (not only TTF).



Navbar Mobile Breakpoint

You can control breakpoint of hamburger menu in Appearance -> Theme Settings -> Navbar -> Navbar Mobile Breakpoint (please make sure you are using the latest version of our theme).

   

By default hamburger is enabled for 1200px and less, but you can set 4000px, for example, in order to enable it in any resolution.



Featured Images as Background

The theme has a built-in function. It replaces the image in the header with the main image of a separate page.

You can enable it in the menu Appearance > Theme Settings > Header > Page header H1 in the drop down list "Featured Images as Background" set the value "Enabled".



After it all the featured images will be used as header background. You can assign a featured image for each page separately.




Notice: We recommend using images with a resolution of 1900 * 600px for the background in the header.


13. Backup

You can backup your site in Tools -> Archives menu. Also you can enable Backup Schedule for automatic backup.



We strongly recommend you to do manual backups regularly, especially when you making updates or major changes on your pages.



14. Site Translation

If you make the site not in English, then after setting up, filling with content, adding new sliders, you will need to translate some lines that are embedded in the theme. For example: the inscription "search" in the navigation bar, the inscriptions on the buttons, some headings, etc. 

To translate such strings we recommend using the Loco Translate plugin.

Install and activate the Loco Traslate plugin

You can download the plugin directly on the page. Here is the link:

https://wordpress.org/plugins/loco-translate/

And then add it through the menu: Plugins > Add new > Upload Plugin.






Or in this same menu, use the search bar and enter Loco Translate:




Basic configuration of the plugin.
The plugin does not require basic configuration. It automatically determines the language used in the theme and the language used by default on the site.


String Translation.

IMPORTANT! When translating our themes, it is important to know that the lines that are displayed on the site are taken directly from the theme files, LT-Ext plugin and WooCommerce plugin (for those who have the functionality of an online store).
The translation of the theme and the plug-ins are absolutely identical, therefore we will consider the translation only on the example of the theme. In the menu Loco Translate > Themes click on the topic we need. As a result, we will see this window:



Clarification: all our themes were designed exclusively as English-language, so by default, only this language will be displayed in this window. But, for example, the WooCommerce plugin has many author translations. Therefore, it will automatically pull up all the translations for the languages installed on your system. You just need to choose the right and make changes.
Now we need to add the language we need to translate. Clicking on "New Language" will open the following dialog box:




First point: In the drop-down list of language choices, select the one we need.
Second point: choose the location of the file with the translation. You can choose any option.
After clicking on the "Start Translation" button, you will see the following menu:



To search for the string you need, use the Filtering Translations input field. As you enter characters in the field, the lines will be automatically filtered. Select the desired line and make a translation here:



After making changes, the Save button is activated. The lines that you have not yet translated will be displayed in bold, the translated and saved lines will be displayed in normal font and the translated and not saved lines will be marked with an asterisk. The example in the picture above.
After completing the work, click the Save button.

Important! If you have updated a theme or plugin, it is possible that during this time some lines have been changed or added, in order to update the list of lines, press the Sync button.

Change strings in English-language sites.

Very often there is a need to change the lines even on English-language sites. In such cases, Loco Translate will also help. About installation, configuration and use, see paragraphs 2.1, 2.2, 2.3.
Attention! You can directly edit the first language pattern. But we do not recommend doing this, because in the future, when updating a topic, the file with strings can be overwritten. In order not to lose your translation, copy the language template and make the translation directly in it.
To create a copy of the template, hover the mouse in the English language, and click on the “Copy” link. You will be redirected to this menu:



First point: In the drop-down list of language choices, select English Language.
Second point: choose the location of the file with the translation. You can choose any option.
The third point: put a dot in front of "just copy the English lines".


15. WordPress Optimization

Very often there is a need to increase the speed of the site. The easiest way is to use optimizing plugins. Our team recommends using Autoptimize and WP Super Cache plugins.
You can check pagespeed of your site here: https://gtmetrix.com/
Also you can check this article about Wordpress optimization: https://gtmetrix.com/wordpress-optimization-guide.html

Autoptimize Plugin.

Link to the official page of the plugin: https://wordpress.org/plugins/autoptimize/

We use such plugin settings:




WP Super Cache plugin.

Link to the official page of the plugin: https://wordpress.org/plugins/wp-super-cache/
We use such plugin settings:




16. Site migration

As a rule, during development, no one wants outsiders to see his site, so development is carried out on a local server, or on a test domain, or a stub is put on the site. In the first two cases, after the project is completed, it will need to be transferred to another hosting and another domain. In this article, we will consider a simple way to transfer a site from one hosting to another.

Important: hosting must meet the minimum requirements of Wordpress and the Domain must be configured.
The requirements of the WordPress engine can be checked at the link below:
https://wordpress.org/about/requirements/

For site migration we use the Duplicator plugin. Below is a link to it:
https://wordpress.org/plugins/duplicator/

After installing the plugin, you will have access but this menu:


In the "packages" menu, you can create a new package for migration or view old versions of packages. Let's create a new package.


The first step of the plugin:


Second phase:


The third stage: download the archive with content and the installer.


Copy the archive with the content and the installer to the root folder on your new hosting. To start the installation, enter this text string in the address bar: YourDomainName/installer.php, аnd follow the instructions.

First step:


Second phase. Database connection.:


Third stage:


At the fourth stage, you will be prompted to enter the site and automatically remove the transfer packets.




http://like-themes.com