just.themes.wp@gmail.com www.just-theme.com Portfolio

Vibratex - Just 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 the Vibratex WordPress Theme. If you need support you can contact us by email (just.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 Just 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


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 vibratex-child.zip in addition with the folder /vibratex/ from archive vibratex.zip.
  2. WordPress
    Navigate to "Appearance" > "Add New Themes" -> "Upload Theme" -> "Choose file" (choose vibratex.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 vibratex-child.zip in addition with the main Vibratex 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.

System Check (Just Themes menu).

This menu consists of two items: Just Themes and Theme Settings. The Theme Settings menu item is described in more detail in paragraph 4 of the left menu. The Just 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 Just 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 Vibratex 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://just-theme.com/litespeed.html

Theme updating

We always update our themes to avoid incompatibilities between our products and latest versions of WordPress and necessary for theme plugins. If your theme need to be updated you can use tips from this article:
http://just-theme.com/update.html
 

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://just-theme.com/litespeed.html

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 the demo content installation was interrupted during the image regeneration phase or during the installation of demo content you had this error:

Or after installation you notice that some images are missing, you do not need to reinstall the demo-content after this error. 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/

The Classic Widgets.

If you are using WordPress 5.8 or higher you can encountered with some kind of errors or with the Block editor in the menu Appearance > Widgets. To avoid this kind of issues you can enable classic menu view for widgets by installing this plugin:
https://wordpress.org/plugins/classic-widgets/


4. Theme Configuration

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

General Configuration

Menu Just 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.
Enable Block Widgets - switcher that allows you to switch between modern block editor for widgets and classic widget editor.
Footer with widgets appearance can be controlled in the menu Just Themes > Theme Settings > Footer > Widgets and footer content can be edited in the menu Appearance > Widgets




Menu Just 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.

Important note:
we strongly recommend you to upload your logo in two different resolutions: default and x2. The x2 Logo used for retina displays and must be twice larger than x1 Logo. In case you do not have x2 logo please skip this field and do not assign incorrect x1 Logo here, otherwise bug with Safari/Chrome retina displays could occur.

It is also important, that theme has two different homepages and different color schemes and one of the pages is configured in Color Schemes menu.


Header Configuration

Menu Just 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
- if enabled will display the default navbar on the whole site (disable if you want to use different nav-bars on your site).


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 Just 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 left menu Sections.



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


In this menu you can assign different types of icons for display in the Navbar. For example: shopping cart, user profile, search, social network. 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.

The navbar button can be edited in the menu Just Themes > Theme Settings > Header > Icons and Elements > Navbar Additional Icon section:




Menu
Just 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 Just Themes > Theme Settings > Social)



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



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.


Furthermore, you can specify in what type of posts this feature will work:



Footer Configuration


The footer is edited in Dashboard -> Sections menu:



It is a simple Elementor layout section and it can be fully edited with the Elementor plugin.

After configuration you may need to assign the footer in Just Themes > Theme Settings > Footer:




Menu Just Themes > Theme Settings > Footer > Footer Block

In this menu you can define which element created in the left menu Sections will be displayed as Footer.




Menu Just Themes > Theme Settings > Footer > Before Footer

In this menu we define the Before Footer section.


Please note that Subscribe section can be edited in the left menu Sections.


Menu Just Themes > Theme Settings > Footer > Subscribe

In this menu we define the Subscribe section.


Please note that Subscribe section can be edited in the left menu Sections.

Menu Just 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 Just 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.



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.


Posts Types

In the menu Just 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 Just 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.



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 > Vibratex Colors. Also, you can create your own color scheme in the menu Just 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 -> Vibratex Colors allows you to change all main colors of the theme
(section can be named is theme you are using, for example Vibratex 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 and shop pages 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.

Important note: in WordPress version 5.8 or higher you can encountered with the Block editor in the menu Appearance > Widgets. You can read more about enabling the classic menu by the link.

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.


7. Sections menu


In our theme we have few reusable sections that can be created here and edited with Elementor plugin. You can create a Topbar section (it will be display at very top of the page), Before Footer section and Footer Section.



After creating a section, do not forget to assign its position (at the bottom of the section editing menu) and enable it in the Theme settings menu.




Please note that each section can be hidden on any page separately at the bottom of the page editing menu:




8. 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 Сalmes 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


Gallery Shortcode

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








Just Slider shortcode

Shortcode displays previously created sliders from the specified category.




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




Please note that each slider can be edited in the left menu Sliders or you can pass to the slider editing menu from the wp-admin bar:



Important: the slider background image can be changed in the single slider editing menu.





Links Widget

Display styled list of the text strings with hover effect. A URL could be added to each list item.







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.





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.




Price Widget

Allows you to create styled list of services with header, description and price:




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:



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.










Video PopUp

Display styled button that has onclick event that activate a popup with video.







History

Create visual chain of important events. Can be used for display the chronological information





Progress Bar Shortcode

This shortcode was created to visualize the completion of a task, the number of percentages of some value, etc.






Tariff Widget
For displaying some ready-for-sell service. Contain header, description, price and different styling effects.
Screenshot from settings:




Team Widget
Created for representing your team on the site homepage. Displays items previously created in the left menu Team.




Testimonials Widget

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/


Slider Revolution plugin

Very powerful editor for creating sliders for every taste. Can replace the standard slider.
https://revolution.themepunch.com/

Link to documentation on settings and methods for working with the plugin:
https://www.themepunch.com/support-center/#sliderrevolution-documentation


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://just-theme.com