Documentation - Classima WordPress Theme

# Classima WordPress Theme Documentation

For any support please don't hesitate to contact us at support@radiustheme.com. We provide 15 hours real-time support for our customers.
Last Updated on: December 11, 2019 / v1.3.1

## 1| Requirements

You need at least WordPress version 4.5+ installed for this theme to work properly. It is strongly recommended that you always use the latest stable version of Wordpress to ensure all known bugs and security issues are fixed. Other requirements:

- PHP version 5.6 or greater. But for maximum speed gain we recommend you to use PHP version 7.3+.
- MySQL version 5.6 or greater OR MariaDB version 10.0 or greater.
- WordPress memory limit of 128 MB or greater.

Server Requirements: https://make.wordpress.org/hosting/handbook/handbook/server-environment

## 2| Theme 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/ directory on your server.
- WordPress Upload: Navigate to Appearance -> Themes -> Add New -> Upload. Go to browse, and select the zipped theme folder. Hit "Install Now" and the theme will be uploaded and installed.

Once the theme is uploaded, you need to activate it. Go to Appearance -> Themes and activate your chosen theme.

After that you need to install and activate the following pre-packaged plugins:

1. Classima Core: Required and must install plugin.
2. RT Framework: Required and must install plugin.
3. Redux Framework: Required and must install plugin.
4. Classified Listing Pro: Required and must install plugin.
5. Classified Listing Store: Optional. Install if you want store functionality.
6. RT Demo Importer: Required if you want to import demo contents. You can deactivate it after demo is imported.
7. Elementor Page Builder: Recommended. Page builder plugin.
8. Contact Form 7: Optional. Install if you want to use contact form.

N.B: All plugins must be installed and activated if you want your site to look exactly like demo.

To install these plugins, navigate to Appearance -> Install Plugins and start installation.

After installation process completed you have to activate these plugins.

## 3| Importing Demo contents

We are providing you two methods for importing demo contents: Automatic and Alternative. You can follow either one of these methods.

1. Automatic (Recommended): This method will remove all your existing data, so use this method only in fresh website. This procedure will be faster because you just have to do one click and then everything will happen automatically. If you want an exact clone of demo website without doing any manual configuration after importing data then this method is appropiate for you.
2. Alternative: Use this method only if:
   - Automatic demo import method fails ( Only few of our customers like 5% have experienced this issue due to their hosting limits, in that case we also provide free demo importing service if you contact with us).
   - You already have a working website with existing contents(eg. posts, pages etc).

## 3.1| Automatic Import

Want to build your site like the demo? You can do it by only one click!

** Note: Before proceeding, please remember that when you are done with the demo import, all existing settings and contents will be removed and replaced by the demo contents. So it is highly recommended that you should only do this in fresh site. **

First please make sure that Classima Parent Theme is activated on your site.

From Admin menu, navigate to Tools -> Demo Content Install. Or alternatively, navigate to Plugins -> RT Demo Importer -> Install Demo Contents.

In this page, Click on the Install button for installing the demo.

It will take some time for importing the demo contents.

After importing demo data, please update your permalink. To update permalink, navigate to Settings -> Permalink and then click on Save Settings button.

If you face any issue in demo installation process please check the Troubleshooting Section(15.1) from here

## 3.2| Alternative Import

Here's the steps:

1. First install and activate plugin One Click Demo Import. Here's the plugin link: https://wordpress.org/plugins/one-click-demo-import/
2. From Admin menu, navigate to Appearance -> Import Demo Data.
3. On this page, click on the "Import" button for installing any demo. It will take some time for importing the demo contents.

4. After importing demo data, please update your permalink. To update permalink, navigate to Settings -> Permalink and then click on Save Settings button.

If you face any issue in demo installation process please check the Troubleshooting Section(15.1) from here

## 4| Listing Setup

We are using plugin Classified Listing Pro here for Listing functionalities, so you can check the plugin documentations and tutorials from the plugin website.

Here's the documentation link: https://www.radiustheme.com/setup-configure-classified-listing-pro-wordpress/

And here's a video tutorial:

## 5.1| Sitewide Colors

From Admin menu, navigate to Appearance -> Theme Options. Then go to Colors tab.

Choose your preferred primary and secondary color from the color palette. Also from here you can change colors for various parts of the site.

After changing the settings, Click on Save Changes button.

## 5.2| Logo

From Admin menu, navigate to Appearance -> Theme Options. Then go to General tab.

From here you can upload your main logo and light logo. Light logo will be used when "Transparent header" is enabled.

After changing the settings, Click on Save Changes button.

## 5.3| Favicon

Favicon is the little icon which you see at the address bar of your browser.

To set this, from Admin menu navigate to Appearance -> Customize link.

Then navigate to Site Identity

From there you can upload the "Site Icon" which will be used as favicon

For more details, here's the WordPress official instruction link for setting up favicon: https://codex.wordpress.org/Creating_a_Favicon

## 5.4| Preloader

From Admin menu, navigate to Appearance -> Theme Options. Then go to General tab

Here you can find the option for enabling/disabling "Preloader" option. Also you can upload your custom preloader image. When uploading image, make sure it's a transparent GIF image.

After changing the settings, Click on Save Changes button.

## 5.5| Back to Top Arrow

From Admin menu, navigate to Appearance -> Theme Options. Then go to General tab

Here you can find the option for enabling/disabling "Back to Top Arrow" option. Choose your preferred option

After changing the settings, Click on Save Changes button.

## 5.6| Header

To change the Header related settings, please go to Appearance -> Theme Options. Then go to Header tab. Following features are available:

- There are several Header Layouts. You can choose your preferred layout from here.
- You have options to enable/disable TopBar.
- You have options to enable/disable Sticky Header.
- You have options to enable/disable Transparent Header.
- You have options to enable/disable Header icons.
- You can also define the minimum width from which mobile menu will be activated.
- You have options to change the Banner related settings globally, you can override this settings from "Layout Defaults" Option(Section-6) and individual pages(Section-7) as well.

After changing the settings, Click on Save Changes button.

## 4.7| Socials

From Admin menu, navigate to Appearance -> Theme Options. Then go to Contact & Socials tab. These information will show up on top bar.

After changing the settings please click on Save Changes button.

## 5.8| Menu

You can create menus from Appearance -> Menus Page. This is standard WordPress functionality. To display any menu on site header, please select the menu location as "Primary Menu".

After changing the settings, Click on Save Menu button.

## 5.9| Multi Column Menu

Multi column menu looks like this:

To make any menu item multi column, you have to add some specific classes in the parent menu item. Here's an example:

Here I used css class mega-menu which turns the submenu items into multi column. Also i used another class hide-header which hides the title "Column 1" and "Column 2" inside menu.

NB: If you can't see the field "CSS Classes", you have to enable it first. To do this, go to the top and follow this screenshot below:

## 5.10| Footer

To change the footer settings, navigate to Appearance -> Theme Options. Then go to Footer tab. It looks like this:

After changing the settings, Click on Save Changes button.

To set up footer widgets, navigate to Appearance -> Widgets. Here you can find available footer widget areas.

## 5.11| Typography

You can change the typography of Body and Headers. To do this, go to Appearance -> Theme Options. Then go to Typography tab.

After changing the Typography settings, Click on Save Changes button.

## 5.12| Custom Sidebar

You can create as many as Custom Sidebar as you want. Also you can replace the Default Sidebar with your Custom Sidebar easily in any page. To create a new custom sidebar, navigate to Appearance -> Widgets. Here you'll see the option for creating new sidebar.

After your custom sidebar has been created, you can place this sidebar in any individual page. To do that, you have to choose this custom sidebar in Layout Settings option. This part is explained in Section-6 and Section-7 below.

## 6| Layout Settings

From here you can set default layouts for pages, blog, posts etc. You can find this settings on Appearance -> Theme Options and then Layout Defaults tab.

## 7| Layout Settings for Individual Post Types

You can override the above settings for individual Posts and Pages as well. When you go to Add New or Edit post/page, you can find similar settings like above under the "Layout Settings" box. If you change any settings from here, this will take priority. If you choose default, settings from the Theme Options -> Layout Defaults (described above) will be used.

## 8| Blog Settings

Navigate to Appearance -> Theme Options. Then go to Blog Settings tab. From here you can change Blog/Archive related settings.

## 9| Post Settings

Navigate to Appearance -> Theme Options. Then go to Post Settings tab. From here you can change settings for single post .

After changing the settings, Click on Save Changes button.

## 10| Error Page Settings

Navigate to Appearance -> Theme Options. Then go to Error Page Settings tab. From here you can change settings for error page.

## 11| Advertisement Settings

This theme comes with Advertisement feature, means you can place 3rd party advertisements easily in any pages. We've created several advertisement areas listed below:

- Header
- Before Sidebar
- After Sidebar
- Footer
- Before Listing Items
- After Listing Items
- Before Post/Page Contents
- After Post/Page Contents
- And many more...

To setup this feature, Navigate to Appearance -> Advertisement Options. Here you'll see all Advertisement areas. All you have to do is ativate the advertisements in your preferred available areas.

After that you'll see options like this - you can either put an image with link as advertisement:

Or you can use custom code/shortcodes:

If you want more dynamic advertisement features you can also use any 3rd party advertisement plugins( eg. Advanced Ads ) with this theme. Using those plugins you can create your own advertisement shortcodes and then apply those shortcodes in the image above.

## 12| Elementor Widgets

Elementor Page Builder has a lot of built-in widgets by default. But for your convenience we've created several custom Elementor Widgets that you can use in your website and extend website functionality. You can find them under RADIUSTHEME ELEMENTS section on Elementor edit mode.

## 13| Built-in CSS Classes (Advanced)

You can use the following built-in css classes if needed:

- primary-color: set primary color
- secondery-color: set secondery color
- primary-bgcolor: set primary background color
- secondery-bgcolor: set secondery background color

## 14.1| Setting up Contact Form

We are using plugin "Contact Form 7" for contact functionality. You can see their documentation for better understanding.

If you don't want to go through all the troubles to check their documentation and just want to use the default contact form we provided with this theme, please at least set up the default emails in contact form settings. To do that, please follow the steps below:

Step 1: Navigate to Contact Menu, then click on any contact form and go to Mail tab. Here you should set your own email address where you want to receive user submitted forms. Then click on save button.

Step 2: Please submit some dummy forms from Contact page to make sure that it's working properly.

## 14.2| Setting up Social Login

This theme supports Social Login feature. To use it, first install any 3rd party Social Login plugin of your choice. After that use that plugin's shortcode in the settings page(Settings > Account and Policy) of Classified Listing Plugin. Here's an example using "Nextend Social Login and Register" plugin:

- Install and setup the plugin.
- This plugin offers shortcode [nextend_social_login] to display social login. Use that shortcode in Classified Listing plugin's settings page.
- The end result will be like this in login page.

## 14.3| Translating Theme

You can translate this theme to another language easily. You have to translate several things for your website to work properly:

- Theme: Classima
- Plugin: Classima Core
- Plugin: Classified Listing Pro
- Plugin: Classified Listing Store

There are many tools available for translation. But the easiest way is to use plugin "Loco Translate". Using this plugin, you can literally translate any WordPress themes or plugins if it supports translation.

--- Here's a step by step tutorial about translating any themes and plugins using "Loco Translate":

Step 1: Install and activate plugin "Loco Translate".

Step 2: Select the Theme or Plugin you want to translate from "Loco Translate" menu.

Step 3: Click on New language link.

Step 4: Select your preferred language, and also select your location as "System". Then click on "Start Translating" button.

Step 4: Click on the "Sync" button for the first time. Then start translating strings like the image below.

Here's a quick video tutorial about how to use Loco Translate:

## 14.4| Updating Theme

Occationally we provide updates which includes new features and bugfixes. Updating WordPress theme is standard WordPress functionality.

Before Updating Theme:

** Before updating please make sure to keep a backup of your installed theme and plugins (eg. Classima Core, Classified Listing, Classified Listing Store) to be on safe side.

You can use this plugin to keep the backup: https://wordpress.org/plugins/wp-theme-plugin-download/

There are few ways to update WordPress theme. You can follow any of the methods described below:

Method 1: Automatic Update by Using Envato Market Plugin

1. Install and activate the "Envato Market" plugin manually. Here's the plugin zip file: http://envato.github.io/wp-envato-market/dist/envato-market.zip
2. From WordPress Admin Panel, navigate to "Envato Market" menu.
3. In this page, you'll find a field for insering Envato Token. Insert your Envato Token Code from there. You can generate this code from this link: https://build.envato.com/create-token/?purchase:download=t&purchase:verify=t&purchase:list=t.Remember, while generating the token you have to login with the same envato id which you've used to purchase theme.
4. After completed the above steps successfully, Navigate to Appearance -> Themes. Here you'll see an "Update now" link beside your theme. Click on that link and your theme will be updated automatically.

Here's a quick video tutorial explaining this method:

Method 2: By Uploading zip File

1. From WordPress Admin Panel, Navigate to Appearance -> Themes.
2. Activate any other theme (eg. Twenty Seventeen) than the current one.
3. Delete Classima Theme.
4. Now you have to upload the updated theme zip file. To do this, Navigate to Appearance -> Themes -> Add New -> Upload. Go to browse, and select the zipped theme folder. Hit "Install Now" and the theme will be uploaded and installed.

Method 3: By FTP

1. Using your FTP client, navigate to "/wp-content/themes/" folder on your server and delete the "classima" folder from there.
2. Now upload the latest non-zipped theme folder into that "/wp-content/themes/" folder .

After Updating Theme:

** After updating the theme please update all plugins which come with the theme.

## 14.5| Optimize Website Loading Speed

If you want to make your website fast like the demo, here's some tricks:

- Upgrading PHP version: If your current PHP version is less than 7.2, upgrade it to version 7.2+. If you don't know how to do it, ask your hosting provider to do it for you.
- Use HTTPS/SSL: HTTPS has certain advantage regarding loading speed, besides Google recommends it for better SEO. Activate HTTPS in your website. If you don't know how to do it, get help from your hosting provider.
- Optimize Images: Optimizing images means reducing the image size without losing quality. There are many online tools (For example: https://tinypng.com/) from where you can optimize images very easily. Please optimize images using these tools before uploading it into website.
- Page Caching Plugin: Use a better page caching plugin. In our demo website, we are using "Autoptimize" and "Cache Enabler" plugin together. If you are going to use "Autoptimize", make sure to turn on the HTML, CSS and JavaScript optimization option.
- Speed Testing Tool: Finally to measure the loading speed you can use the pingdom website here: https://tools.pingdom.com. Keep in mind that loading speed varies depending on which location you set in that website. To get the accurate result always choose the location same/nearby as your website server location.

## 15.1| Demo Content installation failed

This is a hosting issue. In most hostings demo installation will work fine. But some hostings block certain permissions which may cause this issue. If this happens to you, you can contact your hosting provider or alternatively send a support request to support@radiustheme.com and we will help you to fix this.

## 15.2| 404 Error in all pages

If you face this type of issue, please update your permalink. To update permalink, navigate to Settings -> Permalink and then click on Save Settings button.

## 16| Contact

If you face any issue please contact us at support@radiustheme.com. We provide 15 hours real-time support for our customers.

Thank you for purchasing our theme.