Introduction

BeTop – Coaching & Speaker WordPress Theme Documentation

A short guide and general information to help you get to know your new theme.

Above all, We would like to thank you for purchasing this theme, your contribution is very much appreciated.


This document covers the installation and use of this theme and reveals answers to common problems and issues - We encourage you to read this document thoroughly if you are experiencing any difficulties. If you have any questions that are beyond the scope of this document, feel free to pose them in the dedicated support forum.

Getting Started

Installation of the theme

Installation of the theme

To install this theme you must have a working version of WordPress already installed. For information regarding the installing of the WordPress platform, please see the WordPress Codex - http://codex.wordpress.org/Installing_WordPress

Installation

When you are ready to install a theme, you must first upload the theme files and then activate the theme itself. The theme files can be uploaded in two ways:
FTP Upload - Using your FTP client, upload the non-zipped theme folder into the /wp-content/themes/ folder on your server
WordPress Upload - Navigate to Appearance -> Add New Themes -> Upload. Go to browse, and select the zipped theme folder. Hit “Install Now” and the theme will be uploaded and installed.
Some webservers have a limitation for the maximum allowed size of files being uploaded to them and that value may be exceeded by the theme file. If that is the case you can receive an error that states: The uploaded file exceeds the upload_max_filesize directive in php.ini. or Are you sure you want to do this? Please try again. If you get any of these errors please increase the values of upload_max_filesize and post_max_size directives in your php.ini file to 20M or follow the Installation via FTP section described above.
Once the theme is uploaded, you need to activate it. Go to Appearance -> Themes and activate your chosen theme.
After that you need to activate the pre-installed plugins:
1. Elementor
2. Woocommerce
3. WooCommerce Wishlist Plugin
4. AddToAny Share Buttons
5. Contact Form 7
6. MailChimp for WordPress
7. Header Footer Elementor
8. STM Widgets
9. STMT Theme Options
10. GDPR Compliance & Cookie Consent
All the plugins which are not free come under our Extended License, so you don’t need to pay for their license to use them. Some of them might have messages requiring activation, but they are already activated on our side. No purchase code needed. When using them under our license you will need to wait for the plugin updates in our regular theme updates. If you want to be able to auto update them from wp-admin, you will need to buy your own personal license for that.
Also you can update included plugins via upgrading the theme. We include latest versions of plugins in every update of the theme.

What to do if the theme installation fails

What to do if the theme installation fails?

PHP Configurations

If the installation stalls and fails to respond after a few minutes, or if WordPress gives you an error message, you are suffering from PHP configuration limits that are set too low to complete the process. You should contact your hosting provider and ask them to increase those limits to a minimum as follows:
  • max_execution_time 600
  • memory_limit 256M
  • post_max_size 32M
  • upload_max_filesize 32M
Besides this, theme requires at least PHP 5.6. Also, here you can see WordPress Requirements and recommendations: https://wordpress.org/about/requirements/.
You can verify your PHP configuration limits by installing a simple plugin found here: https://wordpress.org/plugins/debug-info/. And you can also check your PHP error logs to see the exact error being returned.
Besides this, you can upload the theme using your FTP client, upload the non-zipped theme folder into the /wp-content/themes/ folder on your server

Importing the demo content

Importing the demo content

Once the theme is installed, you will find a new BeTop menu in the WordPress dashboard. You can use this menu to access the different theme-related pages.
Don’t know where to start on building up your site? We have created an option for you to recreate our theme demo site with just one click.
Tip: Before importing the demo content, you can check out the various demos at https://betop.stylemixthemes.com/. You can see the different demos and decide on which one suits your firm the best.
Click on BeTop > Demo Import in the WordPress menu.
Tip: You can use the demo content as a starting point for your website and modify the content to suit your needs. In that case, select the demo layout that is most appropriate for your website.
Please note: All demo site images replaced with placeholders due to licensing policy.
Each demo layout requires a number of plugins to function properly. Fortunately, StyleMix Themes has made it easy for you to install the plugins and they will be installed automatically during demo setup proceed. In order to start the import proceed, click on the Setup layout button.
Note: Depending on the speed of your Internet connection, it may take some time to install all the plugins and import the demo content.
All the plugins which are not free come under our Extended License, so you don’t need to pay for their license to use them. Some of them might have messages requiring activation, but they are already activated on our side. No purchase code needed. When using them under our license you will need to wait for the plugin updates in our regular theme updates. If you want to be able to auto update them from wp-admin, you will need to buy your own personal license for that. However, we always include the latest versions of the plugins in every update of the theme.
Setup Layout feature installs all required plugins, imports the chosen demo layout and widgets. After finishing the proceed you can visit your site front page in order to see all ready features.
Tip: If you want to start from scratch after viewing the demo content,you can remove the demo content using the Reset WP plugin (https://wordpress.org/plugins/reset-wp/). This plugin resets the WordPress database back to its defaults. It will delete all customizations and content, but it does not modify files; it only resets the database. Please see the above link for more details.

What if the Import fails or stalls?

If the import stalls and fails to respond after a few minutes You are suffering from PHP configuration limits that are set too low to complete the process. You should contact your hosting provider and ask them to increase those limits to a minimum as follows:
  • max_execution_time 600
  • memory_limit 128M
  • post_max_size 32M
  • upload_max_filesize 32M
You can verify your PHP configuration limits by installing a simple plugin found here: https://wordpress.org/plugins/debug-info/. And you can also check your PHP error logs to see the exact error being returned.

Install Plugins

Install Plugins

Once the theme is installed, you have to install all required plugins via Appearance > Install Plugins menu. Select All plugins and Install them via bulk Apply:
After installation of all plugins, Activate them:
Now all plugins installed and activated correctly:

Update the theme

Update the theme

We will periodically provide updates of your theme. These updates are essential if you want to have a bug-free website as we give new features and improvements to the theme over time. Some of these updates might be needed in order to make the theme compatible with newer versions of WordPress.
Note: There is no risk of losing your settings and pages when you update the theme. However, any modifications you have made to the core theme files will be lost, so you should back up those files before you update the theme.
Tip: After upgrading the theme, you can update extra plugins via Appearance > Install Plugins.
There are three ways of updating our WordPress themes to newer versions:
  • Updating via the WordPress Admin Panel (using Dashboard > Updates)
  • Update via the WordPress Admin Panel (using an extra plugin)
  • Updating via FTP

Updating via the WordPress Admin Panel (using Dashboard > Updates)

The easiest way of updating the theme is via Dashboard > Updates. When an update is available for your theme, you will get a notification in your WordPress Dashboard and you can update your theme by clicking on Dashboard > Updates and updating the theme (just as you would update any other installed theme).
Note: You will need the Token key you had generated when you had originally installed the theme. You will find this under the Settings > API Keys section of your profile on Themeforest.

Updating via the WordPress Admin Panel (using an Extra Plugin)

For this method you should first install Theme Upgrades Tool (http://wordpress.org/plugins/easy-theme-and-plugin-upgrades/). This plugin will update your theme when you upload the BeTop.zip file.
Once you have installed the Easy Theme and Plugin Upgrades plugin:
  • Download the theme file update from ThemeForest.
  • Extract the BeTop.zip file from the downloaded theme file.
  • In the WordPress dashboard, click on Appearance > Themes > Add New > Upload Theme > Browse...
  • Select the BeTop.zip file that you extracted in step 2 and click on Install Now.

Updating via FTP

Another way of updating your theme is via FTP. Extract the contents of the BeTop.zip file (which you will find inside the theme update file you have downloaded from Themeforest). The contents will be extracted to a folder called BeTop\ and to subfolders within the BeTop folder.
Tip: Make sure your unzipping software does not create any extra directory with the same name nested within the BeTop\ folder.
Using an FTP program, upload the BeTop\ folder (and its subfolders) to /wp-content/themes/ on your web server.
Note: The FTP program will give a warning that the BeTop\ folder already exists. Choose Replace All.
Final Tip: Whichever method you use to update your theme, clear your browser cache after each update if you notice anything off. Old theme files can sometimes persist in your local cache and make you think something’s wrong.

Theme Features

Theme Options

Theme Options

WordPress Customize allows you to setup the general styling of the website visually. In WordPress menu go to Dashboard > Theme Options . Here, you can set up the following:
  • Main site settings such as default visualization options; Preloader options and others.
  • Colors scheme.
  • Typography settings.
  • Buttons settings.
  • News Archive and Single page options.
  • Shop page settings.
  • Custom post types settings.
  • Google Maps API settings.
Main Theme Options:
  • site body background;
  • 404-page background;
  • Title box settngs;
  • Preloader settings;
Colors : Change the main color settings of the theme.
Blog: Choose archive pages layout, sidebar and its position.
Shop Pages: Here you can select Sidebar and its type/position and number of displaying products on Shop page.
Buttons : Here you can set up fonts, font weight and font size of buttons.
Google : Set up Google Maps API key.
Post Types : Rename custom post types.
Typography: Set up the fonts out of free google fonts. Besides this you can setup font weight, font size and line height also.

Setting Up the Header and Footer

Setting Up the Header and Footer

You can customize the look-and-feel of the header and Footer. You can also control what items appear in the header& footer areas of your pages.
To set up or customize them of your web pages:
Click on Appearance > Header Footer Builder in the WordPress menu.
Click on Edit with Elementor in order to modify the Header or Footer template.
Now you can easily modify included elements or add new elements via drag and drop.
Header:
Footer:
Each element has Content and Advanced options panel for modifications and settings:

Menus

Menus

The BeTop Theme supports up to four menus. You can have a menu at the top of your website pages and up to three menus in the sidebars. In addition to the above locations, you can also add one of the four menus to any page you want using the Elementor Navigation Menu widget.
As mentioned above, your theme allows you to have a menu at the top of your website pages and up to three menus in the sidebars.
This is standard Wordpress functionality, you can choose from the pages, post categories, or custom links.
To set up the Standard Menus:
  • Click on Appearance > Menus in the WordPress menu to open the Menus page.
  • You can now set up the menus as you would do for any other WordPress theme.

Localization

Localization

You can change your site main language via Settings -> General -> Site Language.
Before adding translations for static strings it needs to rename language files correctly according your site languages. Theme language files are located in a ../BeTop/languages/ folder. You can find a list of language codes at WordPress in your Language. As an example, the language code for English is en_EN, so you would save the translated files as en_EN.po first, then en_EN.mo.
There are several ways to fill up translations. One of them if using PoEdit platform. You can add translation via editing your .po file and at the end PoEdit generates .mo file for you. Then you needs to upload ready translation files to primordial folder (../BeTop/languages/).
Another way is to use a localization plugin like: Loco Translate

Content

Setting up Content Pages and Posts

Setting up Content Pages and Posts

You can add regular content to your website as normal pages and posts using Elementor page builder. Elementor is a visual page builder plugin for WordPress enabling the creation of web pages in a live, visual way.
This step-by-step guide walks you through how to create a website using Elementor.
If you are an Elementor newbie, this article will help you understand the essentials of successful page-building. You will learn about:
Tip: Here you can see the full Documentation of the Elementor - https://docs.elementor.com/article/226-getting-started.

Blog page

Blog page

TThe Blog page is a usual blog, formed from the posts which belong to categories created by you, which have tags and featured images that show in the post listings on the blog page. You can set a page as a Blog posts archive page via Appearance -> Customize -> Homepage Settings.
The blog page can have the sidebar on the left, right or no sidebar, and the contents of the sidebar, as described above, are set under the Appearance -> Widgets. Other settings of this archive page you can setup via Theme Options -> Blog:
Blogs can be posted by someone who has the access to the backend of the site with admin or author role. Anyway that person will be able to log into the WordPress panel and have a user profile.
Default blog layout is grid layout and once you set up an empty page in the theme setting where it is said blog, it will show posts in grid layout.

WooCommerce Products

WooCommerce Products

WooCommerce is the most popular e-commerce plugin for WordPress. Now you can have a shop with all e-commerce features on WordPress.
Before you start adding products, please go through the WooCommerce plugin settings and specify everything you need for your shop:
Adding the products: You can easily add new products via Products > Add New
You can read more about Woocommerce here also - WooCommerce Documentation

Training Classes

Training Classes

Trainings in the BeTop theme are grouped products of the WooCommerce plugin. Also, there is special custom settings for making the product as a training class.
You can read more about the WooCommerce grouped product type here - https://woocommerce.com/videos/woocommerce-grouped-product-overview/
In order to create a training class, you need to go to Products -> Add New:
After adding a class name, you need to go to the Grouped Membership Limit section and enable the Is repeatable training option. Then you will be able to select a number of members and duration of the training.
Booking Deadline section for selecting the active period for booking a training class.
Finally, you need to set a regular price of this training class in the Product Data section and publish your training class (product).
Note: As training classes aren’t simple products, they need to be invisible on the archive shop page. Thus you should select the Hidden option for Catalog Visibility setting.

Training Page

Now, you need to create new product and set up it as the main training page which will hold your training classes.
Firstly, you need to build a training page content by using elements of the Elementor plugin.
Lastly, should go to Product Data section and select a Grouped Product option. After, you need to add your training classes in the Linked Products section.
Note: Training products shouldn’t be visible on the archive shop page as well. Therefore, you should select the Hidden option for Catalog Visibility setting.
Customers will be able to select the appropriate training class and period on the main training pages.