Troubleshooting our Theme

Contents

1. I can't activate a plugin. Where is the license key ? Is it included with your theme ?

2. When installing the theme it says "Are you sure you want to do this ? / the link you followed has expired"

3. There are codes showing up on my page ? My site is broken! What's wrong ?

4. Facebook display an unwanted preview of my image and text.

5. How to optimize and speed up your website

6. My audio tracks don't play but I can see the sticky footer player. What's wrong?

7. Maximum execution time of 29 seconds exceeded in class-wp-image-editor-imagick.php

8. I'm using JetPack plugin. What should I know?

9. The Music slider style has changed since I have updated Slider Revolution to v6.x

10. How to prevent a specific page to load with AJAX

1. I can't activate a plugin. Where is the license key ? Is it included with your theme ?

Sometimes, plugins will ask you to enter a Licence Key or API Key. Well, you don't need a licence key or API key to activate it. The plugin will still work even if you don't have that licence key.


The licence key or API key is only used for automatic updates offered by the plugin authors and is available if you purchase the plugin for yourself at codecanyon.net


Since we include the plugin directly (for free) into our theme, we made sure the plugin is 100% compatible with the theme. If you decide to purchase the plugin license for yourself and update the plugin, the theme might break. 


We (Sonaar) are responsible to update the pre-packaged plugins that come with our theme. We release plugin updates on a regular basis after testing them and make sure they are 100% compatible with our theme. It's the way it works for every theme that offers third-party plugins packaged into the theme.

2. When installing the theme it says "Are you sure you want to do this ? / the link you followed has expired"

There are 2 different causes for this issue.

If you are installing your theme from the WordPress theme dashboard, but get a message that says “Are you sure you want to do this OR the link you followed has expired ?”, most likely your web server is configured with PHP settings that are too low to allow the theme ZIP file to upload. Specifically, PHP is configured to a maximum file upload size limit at 8 megabytes or less. The theme ZIP is currently about 34 MB. Thus, the web server is rejecting the upload. WordPress is giving you a rather ambiguous message in response.

This is not a theme fault or bug.

SOLUTION 1)

You can either increase your PHP limits. Since every server is configured differently, there are 3 ways to do this. You can try to do it yourself but if you don't have the skill, just ask your web host and they usually will do it for you.

To raise the PHP limits, try one of the 3 solutions below:

a) Add this in the .htaccess file of your server php_value memory_limit 128M php_value post_max_size 128M php_value upload_max_filesize 128M php_value max_execution_time 1800

b) Add this to wp-config.php

define(‘WP_MEMORY_LIMIT’, ’64M’); c) Create a text file and name it php.ini then upload php.ini file in your root folder by FTP. In the php.ini file, add: upload_max_filesize = 64M post_max_size = 64M

--- 

If it still doesn't work, you can ask your web host to raise the upload and memory limit (Just tell them you are trying to upload a WordPress theme file that is around 35MB) OR jump to SOLUTION 2 below:

SOLUTION 2)

You can upload your theme via an FTP client. Please read this article for more info: 

 http://codex.wordpress.org/Using_Themes#Adding_New_Themes_Manually_.28FTP.29

----- 

Recommended PHP configuration limits are as follows:

max_execution_time 600

memory_limit 256M

post_max_size 64M

upload_max_filesize 64M

You can verify your PHP configuration limits by installing a simple plugin called WordPress phpinfo().


ADDITIONAL INFO:

Sometimes, you might be trying to upload the whole theme package zip file (which contain the PSD, Licence, Theme, etc..), instead of only the theme zip file.

If that's the case, make sure you unzip the theme package zip file on your computer, then look into the /Theme/ folder. Make sure you are uploading sonaar.zip that is located in that theme folder.

3. There are codes showing up on my page ? My site is broken! What's wrong ?

Make sure that all the plugins are activated, in particular: WPBakery Page Builder (Formerly known as Visual Composer).

4. Facebook display an unwanted preview of my image and text.

The easy way to manage the site preview that shows up on Facebook is the free plugin Yoast SEO. With this plugin, you will be able to display what you want onto the preview and it will help you to improve your site’s SEO. 

  1.  Download the Yoast SEO plugin.
  2. Install and activate it on your WordPress site.
  3. Edit your homepage backend and look for the Yoast SEO setting.
  4. Click on the social icon


  1. And fill the title and description fields. You can also select a new preview image


See the full Yoast SEO Documentation here

5. How to optimize and speed up your website

Here's an article about optimizing your website and make it faster. If you experience slow issue, this article is for you:


Use the "Dynamic CSS into Static Stylesheet's" theme option.

Our theme options and individual page options are loaded every time a page is loaded. This mean there are calls to your DB whenever a page loads and this can slow your site, especially if you use PHP 5.x. (PHP 5.x is twice slower than PHP 7 by the way). So make sure to activate the option "Move Dynamic/Custom CSS Into External Stylesheet?" by going to WP-Admin > Theme Options > General Settings. See screenshot: https://d.pr/i/yIpFnj

Wait! There is one downside with this option: Since your options will become a standard CSS file, it will be saved in your browser's cache. When you will change one of your theme options or page options, you will have to clear your browser's cache to see the change.

Use a Cache plugin

This is essential! Any great and fast website use a caching system and this might speed up your website 5X faster. Caching plugins allow you to publish static HTML files instead of dynamic files. This greatly reduces the time a page takes to load as there are no PHP or MySQL commands to execute.

Additional caching features include minification, caching of feeds, Gzipping, Content Delivery Network (CDN) support, and much more, but lets keep it simple for now.

Caching your pages is one of the most effective ways of improving your page loading times, with many plugins promising an improvement of at least ten times. We recommend using WP Rocket. It's a paid plugin but so much effective! There are other free caching plugins but WP Rocket is the way to go.

If you are using WP Rocket, (or any cache plugins), make sure that:
1- Page HTML Cache is activated
2- Disable Minify CSS and Minify JS (Our files are already minified thus, it will create conflicts)
3- Disable Combine CSS and disable Combine JS

Check your plugins

Make sure Iron Demo importer plugin is deactivated once you have imported your first theme demo. You don't need this plugin except for importing a new theme demo so it's better to leave it deactivated.

Before you install any third party plugin on your website, ask yourself “Is this plugin necessary?”.

Third Party Plugins are one of the biggest causes of  slow WordPress site. The more plugins you install without research, the more likely you will face performance issues; however the sheer number of plugins you have installed is not the reason a WordPress website can slow down.

Certain plugins are known for causing websites to be slow. There are many reasons for this including bad coding, calls to external servers and persistent calls and updating of your WordPress database. Pay close attention to how much CPU plugins use too. Many plugins can bottleneck your CPU due to persistent processes. If this happens, your whole server could go down.

One plugin I highly recommend you use is P3 Profiler. Developed by GoDaddy, the plugin will show you exactly how much load time your plugins are adding. A breakdown is given which displays exactly how much load each plugin adds. It is the most effective way of seeing what plugins are slowing down your website.

If you are using Essential Grids:

Make sure that the grid items use an appropriate image format. By default, the items displayed in your grid is set to load the large or full image. By example: If your grid contains 50 items and each items loads a 1mb image, the user will have to download 50mb of images in order to display the page! Its too much. You should load medium image for desktop and thumnails for mobile. See screenshot: https://d.pr/i/nigBv6

For more Essential Grid optimization, see official documentation here: https://www.themepunch.com/essgrid-doc/optimization/

Optimize your image

Images can help break up long pieces of text and can help your articles be shared more frequently on social media services; however they also take up a lot of storage. Therefore, pages that contain many images can take a long time to load.

It is therefore in your best interests to optimise your images for the internet before you upload them to your website. Most photo editing applications, such as Photoshop, allow you to do this via the “Save for Web” option.

A good plugin to optimize images that have already been uploaded is WP Smush.it. It utitlizes the Smush.it API to optimize JPEG images, strip meta data from JPEGs and convert GIF images to PNG. You should however be aware that the plugin uses up a lot of resources when it is converting images, therefore your website may be slow whilst it is running.

6. My audio tracks don't play but I can see the sticky footer player. What's wrong?

The issue seems mostly related if you use a CDN (Content Delivery Network) or GoDaddy Shared Hosting (GoDaddy enable a CDN by default)

The player shows up at bottom but it won't play any audio. This happens because you have CDN (Content Delivery Networks) enabled in your GoDaddy control panel. If you check your console log (with Chrome), you will see a CORS Policy error such as this one: https://d.pr/i/Be7qSM

It's because your player is hosted on yourdomain.com but the player tries to play a file that is hosted on a different domain name thus it gives a permission error. (CORS). Since our player use javascript to request the audio file, the source server (aka requested server) must "accept" incoming request from the server (aka origin server) where the player is embed.

There are 3 different options to resolve this issue:

1) You disable your CDN on GoDaddy (check in your Godaddy panel)

2) You turn off real-time spectrum analyzer in wp-admin > theme options > general settings (this disable the javascript request at the same time)

3) You check with your CDN to add yourdomain.com to its CORS header.

7. Maximum execution time of 29 seconds exceeded in class-wp-image-editor-imagick.php

Problem: If you get this error message when importing a theme demo:

Maximum execution time of 29 seconds exceeded in /xxxxxx/wp-includes/class-wp-image-editor-imagick.php on line 366

Solution: Add this piece of code in your child theme's function.php:

add_filter( 'wp_image_editors', 'change_graphic_lib' );
function change_graphic_lib($array) {
return array( 'WP_Image_Editor_GD', 'WP_Image_Editor_Imagick' );
}



8. I'm using JetPack plugin. What should I know?

We don't recommend that you use JetPack plugin. Read this article to know why.

If you insist to use JetPack, it will cause an issue with the Ajax page loading. To fix the issue, see screenshot: https://d.pr/i/8wVCZY

9. The Music slider style has changed since I have updated Slider Revolution to v6.x

When we update Slider Revolution from version 5 to version 6, the music slider provided by our demo content will be a bit altered. The perspective effect will be removed. 

How to reset the Perspective effect:

The plugin update will also enable the carousel "auto rotate slideshow" option by default. Here how to disable this option.