Configuring SMTP plugin

There are many WordPress plugins that help you to integrate an SMTP service into your WordPress website. Some of them are listed below, and for this article, we’ll explain about the WP Mail SMTP plugin.

Installing the WP Mail SMTP plugin

To install the plugin, there is the same process as for any 3rd-party plugin.
Refer to this article regarding the plugins installation.

Configuring the plugin

To add the SMTP details into the plugin:

1. From the left WordPress menu, go to Settings > Email.

2. Fill in the form with the necessary information.

From Email – Email address you want to send emails from – email@yourdomain.com, for example.
From Name – Name that your emails will be received from.
Mailer – Choose whether you want to use the default mail function or the SMTP.
Return Path – Check if you want to match the return path for your emails to the sending email.
SMTP Host – Hostname for your SMTP server.
SMTP Port – Port your server works on.
Encryption – If you have SSL/TLS encryption available for that hostname, select it here.
Authentication – Check if your SMTP server requires authentication.
Username – Username for your SMTP server.
Password – Password for your SMTP server.

3. Click on the Save Changes button.

Testing the Plugin

If you want to test your settings, you can go to the Send a Test Email section and enter an email address that you want to send to, then click the Send Test button.

Now WordPress is configured to work with your SMTP server.


Registering for an SMTP service

After choosing an SMTP service, you need to register for it.

Let’s set one of the free SMTP services. In our case, Gmail.

Google’s GMail SMTP server is a free service for anyone who has a GMail account. If you don’t have a Gmail account, you can create one at the Gmail account creation page.

When you’ve created the account, you’ll need to configure your mail client to use Gmail for the outgoing mail server. As an example we’ll describe the configuration of the Thunderbird mail client.

1. Download Mozilla Thunderbird and install it on your computer.

2. Open it and go to Tools > Account Settings.

3. Under the Account Actions dropdown at the bottom left side, select Add Mail Account.

4. Enter your name in the given box. Write your email address and password in the required fields and click on the Continue button.

5. Thunderbird will try to configure your settings automatically.  We suggest to fill in the settings manually, so click on the Stop button on the right.

6. Then click on Manual Setup button to fill in the settings manually.

7. Click on Outgoing Server (SMTP) on the left pane. Select smtp.gmail.com (Default) from the list and click on the Edit button.

8. A small SMTP Server window will appear. Now enter the settings given below:

Outgoing Mail (SMTP) Serversmtp.gmail.com

Use AuthenticationYes

Use Secure ConnectionYes (this can be TLS or SSL depending on your mail client)

Usernameyour GMail account, e.g. user@gmail.com

Passwordyour GMail password

Port465 or 587

If you use Google Apps with your domain name, you should write that email account with the Username: field, e.g. user@yourdomain.com

9. On the left, click on the first option, i.e. the name of your email (user@yourdomain.com). On the right side, fill in your email address in the Account Name field. In the Outgoing Server (SMTP) dropdown, select the server setting you configured in step 8. Click OK.

To configure SMTP plugin, please refer to this article.

Choosing an SMTP service

SMTP stands for Simple Mail Transfer Protocol, and sending through an SMTP server means that you have set up a real email address on your system and you are allowing the web based script (wp_mail) to connect to the server with the appropriate account credentials.

By default, WordPress uses the PHP Mail function to send emails. However, it is not the best method and may decrease email deliverability. Emails may often arrive in the spam/junk folder. As an alternative, you can use SMTP to send emails.

There is a wide range of free SMTP servers that can be set up on a mail client to deliver your emails.

A public outgoing server is a good choice for daily communication. You can select among different free SMTP services. The most popular are:

When it comes to email marketing though – when you need to send a bulk message like a newsletter – things get much trickier.

In fact, a common SMTP server like Gmail is not designed to support such kind of mass emailing, because it relies on shared IPs and sets strict limits to the volume of messages and recipients that you can handle per day.

So in this case it’s better to use a premium SMTP service that can guarantee full deliverability of your emails.

Some examples of the paid services include:

How to register for an SMTP service, please refer to this article and this one to find how to configure SMTP plugin (WP Mail SMTP in example).

I don’t receive any email, what should I do?

By default, WordPress uses the PHP Mail function to send emails. However, it is not the best method and may decrease email deliverability. Emails may often arrive in the spam/junk folder. As an alternative, you can use SMTP to send emails.

In order to send emails via SMTP follow the steps below:

Choose an SMTP server

There is a wide range of free SMTP servers that can be set up on a mail client to deliver your emails. For further information about SMTP servers please refer to this article.

Register for the SMTP server

After choosing an SMTP service, you need to register for it. To learn more about registering for an SMTP service please refer to this article.

Integrate the SMTP service with your WordPress website

There are many WordPress plugins that help you to integrate an SMTP service into your WordPress website. We suggest you to read this article to learn more about configuring an SMTP plugin.

Use Gromwatik to send highly personalized emails to your users with no need to third-party tools or email delivery services (Free for up to 10,000 emails per month).

Lost Tracking

How to fix if analytics tool is not tracking after theme migration.

If you use some sort of analytics tool, whether it is Google Analytics or another service, and you added the tracking code to the footer.php file instead of to a plugin, you will lose the code once you migrate to the Jupiter X theme. 

So, you’ll need to make sure that you copy and paste your tracking code into your new theme. This is one of the things that is very commonly overlooked by users.

Use Growmatik to measure the performance of your Jupiter X website and get actionable insights to promote growth.

Content in Sidebar Is Lost

How to get the content into sidebar back after theme migration.

If your old theme had some custom areas in Appearance > Widgets, you may lose them when switching to the Jupiter X theme. The reason is that Jupiter X is designed differently and has its own widget areas.
To get the content in your sidebars back, you’ll need to add the widgets again to the new Widget Areas.

Note: To learn more about adding widgets to widget areas, check out this article.

“Coordinates of this location not found” error for JetElements Advanced Map widget

How to fix “Coordinate not found” error for Advanced Map element in JetElements plugin?

If you decided to use JetElements Advanced Map element in your page and added Google API key in the JetElements settings, you may see the error in Elementor page builder once you selected Advanced Map widget from JetElements – Coordinates of this location not found.

This error is related to the API settings you made in your project.
Since you’ve placed a referrer restriction on your API key, it will be limited to executing on the browser with the web service APIs, including the Geocoding API. The issue is that since the API call is server side, the HTTP referrer address is different than the domain name and the issue will be resolved if:

  • The HTTP Restriction disabled in the API settings.
  • The HTTP Referrer is provided correctly (web server address or IP, not the domain name)

See this section in the Maps APIs FAQ on switching key type to a server restricted key: https://developers.google.com/maps/faq#switch-key-type

Also, you should make sure your API project has these features enabled on your API Console

  • Geocoding API
  • Maps JavaScript API

Template can’t be installed

Jupiter X Templates are actually zip files containing the WordPress data, Widgets and Menu settings and Customizer settings. These are packed into one zip file for each template. The template installer uses this procedure to install the template:

  1. Creating a backup of the previous data.
  2. Downloading the package from Artbees servers.
  3. Installing the required plugins.
  4. Importing the contents.

While installing the templates, you may encounter different issues at each step. In this article, we will give an overview of what can cause template installation failure and suggest workarounds to fix them.

File and Folder permission issue

On all of the steps that require any file import or file creation, wrong permission on folders and files, or even different ownerships can cause template import issues. If you check the Jupiter X -> Control Panel -> System Status and realized any of the folders listed on top are not writable, you may need to reset the folder permissions as below:

[WordPress Root Directory]                                           755
[WordPress Root Directory]/wp-content/                               755
[WordPress Root Directory]/wp-content/uploads/                       755
[WordPress Root Directory]/wp-content/plugins/                       755
[WordPress Root Directory]/wp-content/themes/                        755
[WordPress Root Directory]/wp-content/uploads/jupiterx/              755
[WordPress Root Directory]/wp-content/uploads/jupiterx_backups/      755
[WordPress Root Directory]/wp-content/uploads/jupiterx_templates/    755

If you are a system admin and can use chmod command to reset the folder permissions, that would be easier by executing the following command:

cd "path to your WordPress Directory" 
find . -type d -exec chmod 0755 {} \;
find . -type f -exec chmod 0644 {} \; 

An alternative would be to use FS_METHOD direct. In order to use it, just add the following codes in the wp-config.php file and modify each six FTP details based on your own details.

define('FS_METHOD', 'direct');

In case after adding the line above, a form showed up on your page and asked for FTP credentials, please also add these codes:

 
define( 'FS_CHMOD_DIR', ( 0755 & ~ umask() ) );
define( 'FS_CHMOD_FILE', ( 0644 & ~ umask() ) );
define('FTP_BASE', __DIR__);
define('FTP_CONTENT_DIR', __DIR__ .'/wp-content/');
define('FTP_PLUGIN_DIR', __DIR__ .'/wp-content/plugins/');
define('FTP_HOST', 'hostname');
define('FTP_USER', 'username');
define('FTP_PASS', 'password'); 


Note: 
Please replace “hostname”, “username”, and “password” with your real FTP credentials.

Backup Creation fails

Sometimes the template fails to install at the first step (Creating the backup). It can be either related to the folder permission or database permission. Also, sometimes a corrupted record in the database prevents the backup from being created. So, before everything, make sure the permissions are set correctly like above and if the issue persists, reset the WordPress database using a WordPress reset plugin. Please note that it will remove all of your data, so use this as the last workaround if you don’t know how to fix the database issues. In general, it is recommended to install the templates on fresh WordPress installations to avoid such problems.

Downloading the package or plugin fails

In case you encountered an issue on step 2 and 3, it means that:

  • Your web server can not connect to the Artbees servers and download the files it needs.
  • You don’t have proper permission on the server (check above solution)
  • Your WebHost exceeded the quota

So, the first thing would be to make sure your connection to Artbees Servers can be established. Simply check the Artbees connectivity status on Jupiter X -> Control Panel -> System Status and make sure your web server can access Artbees servers. If it wasn’t possible to connect to Artbees Servers, you should contact your web host support and ask to trace the routs and see what is preventing a secure connection to Artbees. We do not have any limit or blacklist to the connections to our API endpoints so you would need to check it with your web host provider.

In case you couldn’t connect to Artbees Servers, uploading this file to your WordPress rout and executing it may give you additional details on what could be wrong:

<?php 

    $url = 'https://themes.artbees.net/wp-json/templates/v1/list';
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_NOBODY, true);
    curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
    curl_exec($ch);
    $retcode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);
    if (200==$retcode) {
        echo 'access to artbees servers is OK';
    } else {
        echo 'access to artbees servers is NOT OK Error Code: ' . $retcode . ' <br/> '; 
        $curlHandler = curl_init();

        curl_setopt_array($curlHandler, [
            CURLOPT_URL => $url,
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_VERBOSE => true,
        ]);




        $verbose = fopen('php://temp', 'w+');
        $result = curl_setopt($curlHandler, CURLOPT_STDERR, $verbose);


        $result = curl_exec($curlHandler);


        rewind($verbose);
        $verboseLog = stream_get_contents($verbose);

        echo "Verbose information:\n<pre>", htmlspecialchars($verboseLog), "</pre>\n";

        curl_close($curlHandler);
    }

?>

Migrating page content to Jupiter X

How to migrate old content to Jupiter X

Jupiter X uses Elementor as it’s main page builder, so most likely you will have to recreate the pages from scratch. Unfortunately to convert the page from your old content to the Elementor is impossible, it has to be done manually by recreating the whole page.

To learn how to properly upgrade to Jupiter X, check out this article.

We provide Jupiter 6 to Jupiter X migration service under Content Management service in WPDone.


Note: But don’t worry, you can still use the WPBakery Page Builder to maintain your website, but it is highly recommended to convert everything to Elementor because of it’s features and performance.

How to Troubleshoot a Jupiter X Issue

The basic troubleshooting steps that can be taken when something goes wrong with your Jupiter X theme.

First thing you should do is to create a complete backup of your WordPress site. Backups allow you to restore your WordPress site easily when something goes wrong. They are your first and most important defence against data loss.


Note:
 To completely backup your WordPress site, you may use the All-in-One WP Migration plugin.

Check Server Resources


Having the correct server requirements is one of the key factors for the Jupiter X theme to work properly. It is highly recommended to use a server which supports the recommended requirements.

Update the Theme and Plugins


The issue on your website may have been already reported and fixed by our development team, so it is very important to keep the theme and plugins up to date. Jupiter X theme and it’s plugins are under active development therefore this is one of the most important steps to resolving your issue. Before updating, check the release notes.


Note: 
To learn how to update the theme, check out this article. To learn how to update the plugins, check out this article.

3rd Party Plugins Conflict

Jupiter X theme follows the standard coding practices so it is compatible with most of the plugins. Most of the times errors are caused by a plugin conflicting with each other, the theme, or the WordPress core. Deactivating all WordPress plugins on your site will most likely solve the problem. You can then find out which plugin was causing the issue by activating plugins one by one on your site.

Child Theme Issues

The issue can also be caused by a customization made in your child theme. To check, simply activate the Jupiter X parent theme in Appearance > Themes.

Switch to a Default WordPress Theme

You can check whether it’s the Jupiter X theme causing the issue on your website or not by switching to the default theme.

From the WordPress left menu, go to Appearance > Themes page and then click on the Activate button next to a default theme (Twenty Seventeen, for example).


Note:
 By switching the theme, you will not lose any content on your website.

Cache Issues

Both server cache and browser cache can cause some problems viewing your website correctly. It is highly recommended to purge all the server caches and remove browser cache after changing any content or configurations.


Note:
 To learn how to clear the cache so you can see the most recent version of your website, check out this article.

WPBakery Page Builder Issues

WPBakery Page Builder is a page builder which helps you manage your content in WordPress and makes your life easier.

More information regarding this plugin can be found in the article What Is WPBakery Page Builder.

Sometimes you may face some issues when using WPBakery Page Builder. In this article we’ll cover possible problems and their solutions.


WPBakery Page Builder Editor Is Available for Pages Only

When you edit pages, you can use the WPBakery Page Builder editor by default, but when you move to posts, the VC isn’t present and you have to use the standard WordPress editor.

There is a quick and easy fix for this:

1From the WordPress left dashboard, go to WPBakery Page Builder > Role Manager > Post Types.

2Select Custom Post Type from the drop-down menu.

3Check the post types where you want to use the VC editor.

4Click the Save button.

After that, you’ll be able to create content in the VC editor on the post types you have selected.


Strange video Background on All Pages

This issue may occur if you use the original version of the WPBakery Page Builder plugin.

As you know, the modified version of the WPBakery Page Builder plugin is bundled in with the Jupiter theme and only this version is compatible with Jupiter.

So if you’re using the original version of the VC plugin, you’ll need to switch to the modified version following these steps:

1Go to WP Dashboard > Plugins.

2Deactivate and uninstall the WPBakery Page Builder plugin.

3Go to Jupiter > Control Panel > Required Plugins.

4Install the WPBakery Page Builder plugin.

Once it’s activated, the strange video will disappear and your site will work as usual.


Not Displaying All Shortcodes

Sometimes WPBakery Page Builder does not display all of the shortcodes available to you by default. To solve this problem, you’ll need do the following:

1From the WordPress left menu, go to WPBakery Page Builder > Role Manager.

2Select Administrator under User Groups Access Rules

3Click the Select All link at the bottom to enable all shortcodes for administrators

4Finally, click the Save Changes button at the bottom of the screen to ensure that your changes are kept.


Cannot Close Windows or Some Controls Become Unresponsive

This situation is typically related to the Visual Editor being disabled for your user profile. To fix this, follow the steps below:

1Go to Users > Your Profile in the WordPress admin panel and look for the Visual Editor setting.

2There is a checkbox labeled Disable The Visual Editor When Writing. Make sure that the checkbox is unchecked.

WPBakery Page Builder elements are not responsive

If you see on mobile that the elements you added via WPBakery Page Builder are not responsive and are shown like on your desktop view, you can fix it following the steps below:

1From the WordPress left menu, go to WPBakery Page Builder > General Settings.

2Find the option “Disable responsive content elements” and uncheck it if it’s ticked.

After that the content will be responsive on mobile.


WPBakery Page Builder is unavailable after WordPress update to 5 version

If you update WordPress to 5 version and noticed that WPBakery editor isn’t shown on your pages, in this case you need install the plugin Classic Editor and activate it. It will disable the Gutenberg editor (which has caused the issue) and WPBakery builder will be available again.


Menu Issues

Such an easy process as creating menus may cause issues in some cases. Therefore it’s recommended to first read the article How to Set up Menus in Jupiter. In this article we’ll describe possible menu issues and their solutions.


In some cases you may encounter a limitation regarding the number of menu items you can have on your WordPress installation. This happens due to a limitation in PHP settings on some servers and can be fixed by increasing those values.

To do that you’ll need to access your php.ini file if you have a dedicated server, or ask your hosting provider if you use shared hosting. You just need to set the options below to the proper values:

max_input_vars = 1000;


You can also set this value in the .htaccess file by adding the line below:

php_value max_input_vars 4000


4000 is the recommended value for Artbees themes in this case.
Please note that one of main symptoms of this problem is menu items NOT saving after they’ve been added. This can be fixed with the suggestion above.


Preventing Menu Items from Opening in New Windows

To prevent menu items from opening in new browser Windows/Tabs, you’ll need to take the steps below:

1From WordPress left menu, go to Appearance > Menus.

2On top right of the menus page, there is an option called Screen Options.

menu issues

3Open the panel and check the Link Target option. 

menu issues

4The new option will be available on the menu items. Uncheck that option.

menu issues


Menu Disappears After Installing a Child Theme

When installing and activating a child theme in WordPress, it’s basically almost the same as installing a new theme. That means some basic configuration is required after activation. If your custom menu (which you had previously created) is not the default menu anymore, you can navigate to Appearance > Menus in your WordPress dashboard and assign your custom menu again to the preferred menu slot in your WordPress theme.


Other Issues

If you have any other issues with the menu, please create a ticket.

Template Issues

In this article we cover some of the common issues which you may face during or after template installation.


FS_METHOD (Ownership of wp-directory)

This issue occurs when WordPress does not have permission to modify the file systems correctly. To solve this issue on 99% of web hosts, add following codes in the wp-config.php file and modify all three FTP details based on your own details.

define('FS_METHOD', 'direct');

In case after adding line above, a form showed up on your page and asked for FTP credentials, please also add these codes:

define( 'FS_CHMOD_DIR', ( 0755 & ~ umask() ) );
define( 'FS_CHMOD_FILE', ( 0644 & ~ umask() ) );
define('FTP_BASE', __DIR__);
define('FTP_CONTENT_DIR', __DIR__ .'/wp-content/');
define('FTP_PLUGIN_DIR', __DIR__ .'/wp-content/plugins/');
define('FTP_HOST', 'hostname');
define('FTP_USER', 'username');
define('FTP_PASS', 'password');


Error 504 (Gateway Time-out)

This issue occurs mostly when the PHP maximum execution time is less than the Jupiter requirements. Read the Jupiter server requirements article and increase your server’s maximum execution time to the recommended value.


Template slider Is Not Displayed

If a template slider is missing on the front-end of your website, follow the steps below to import the slider manually:

1Install the Layer Slider by following this article.

2Depending on which template slider you are missing, download the file below:

3From the WordPress left menu, go to LayerSlider WP.

template issues

4Click on the Import button and import the downloaded file.


Recommended Hosting Solutions

The following hosting services offer maximum compatibility with Jupiter and provide exclusive discounts to Artbees Themes users:

InMotion > Up to 50% Discount
WPEngine > 20% Discount
DigitalOcean > $10 Discount
MediaTemple > 2 Months free on Annual Plan


Other Issues

If you face any other issues (Error 500, etc), open a ticket in our help desk.

Custom Image Sizes Issues

There is a section in the Jupiter Control Panel for adding custom image sizes for different parts of your website. You can add as many sizes as you like and then use them in different shortcodes. Some issues may occur when loading images with custom sizes.

In this article we’ll describe these image sizes issues and how to fix them.


Image Sizes Are Not Generating

If you set custom sizes in the Jupiter Control Panel, but they are not applying to your images, the first thing you need check is whether the GD library is installed and activated on your server. It’s required in order to be able to generate the images. You can read about it in this article.


Images Do Not Load with the Lazy Load Plugin

If you’re using the Lazy Load plugin for images but can’t see them loading, the reason may be that the Jupiter theme already has a lazy load function. You can try these solutions to resolve the issue:

1Reduce the image sizes to smaller values to reduce the loading time.

2Disable the preloader on the page. It will let the users see the page while the images are loading. 

3Use a CDN such as CloudFlare. In this case, it will make your website super fast because it cuts out the wasted time from DNS responses. 


Only Dummy Images Display

Sometimes you can see only dummy images on the site even though you uploaded your own and set proper sizes for them. To fix this issue, you’ll need follow these steps:

1Check permissions for the wp-content/uploads folder.


2Set the execute permission for the BFI_thumb.php file.

You can find it in the directory wp-content/themes/jupiter/framework/includes/.


Recommended Hosting Solutions

The following hosting services offer maximum compatibility with Jupiter and provide exclusive discounts to Artbees Themes users:

InMotion > Up to 50% Discount
WPEngine > 20% Discount
DigitalOcean > $10 Discount
MediaTemple > 2 Months free on Annual Plan


Other Issues

If you face any other issues with custom image sizes, open a ticket in our help desk.

Cache Issues

Using caching on your website is possibly the most effective way to decrease the loading times of your web pages and bring content to your visitors quickly. In this article we’ll describe common cache issues and their solutions.


Content Is Not Updating on the Site

There are three common causes for this issue. The first one is your browser cache. Sometimes your browser will show you a cached copy of your website instead of showing the new one. Each browser has a different process to follow when clearing the cache. Detailed information on each browser is mentioned below:

  1. Google Chrome
  2. Mozilla Firefox
  3. Apple Safari
  4. Internet Explorer
  5. Opera
  6. Android
  7. IOS
  8. Windows Phone

The second and most likely cause of this issue is a poorly configured WordPress caching plugin. To see if a caching plugin is causing this problem, you’ll need to see if you’re using a caching plugin on your site. Clearing the cache is different depending on the plugin you use. You’ll need to check the plugin documentation on how to clear the cache, but we also list some popular cases here:

1WP Super Cache.
  1. Go to WordPress Admin Menu > Settings > WP Super Cache.
  2. Click on the Delete Cache button under the Delete Cached Pages section.
2W3 Total Cache.
  1. Locate the Performance link in the top section of the WordPress admin page.
  2. Click on the “Empty All Caches” link

The third cause may be the server cache.

In some cases, hosting service providers apply internal caching to improve the performance of the server. This happens especially in WordPress-managed hosting service providers. You will need to contact your hosting service provider, or check their documentation to clear the server cache. Here is a list of popular servers that use this cache system. Click on the link to know how to clear the server cache in those cases:

  1. WP Engine
  2. Blue Host
  3. GoDaddy
  4. Kinsta

Jupiter Version 5 has a feature to cache some assets in order to increase the performance of the theme. You will need to clear the cache after you make changes to the admin section as well as to different options of the theme. To clear the cache you simply need to click on the Clear Theme Cache link in the top left section of your WordPress admin page.


Theme Options Are Not Applied After Page Refresh

In this case you need check the file/folder permissions for the wp-content/mk_assets folder. You can read about permissions in WordPress Codex.

Also it’s recommended to check the htaccess rules to make sure the requests are not redirecting to a cache folder. In some rare cases adding an htaccess password to the website causes problems for dynamically generated files of the theme. It’ better to disable the HTACCESS Password and check the front-end of the website to see if it fixes the problems.

Don’t forget to check the wp-config.php file and make sure there is no cache value inserted.

The cache conflicts happen in some cases where third-party Content Delivery Networks or cache systems are used. For example, MaxCDN, CloudFlare or Varnish Cache can be considered popular choices. Clearing those functionalities or disabling them temporarily is good practice for troubleshooting.


Other Issues

If you faced any other cache issues, open a ticket in our help desk.

Theme Registration Issues

We already showed you how to register the Jupiter theme in the article How to register theme, but sometimes you may encounter some errors. Don’t worry, they can be fixed.

In this article we’ll describe what errors may occur during registration and how to fix them


Connection Error

Since introducing the Register product feature to our themes, there have been a few very rare cases (8 failures out of over 700 successful registrations). This bug is not directly related to WordPress or the theme itself. If you’re wondering what goes wrong read the steps below:

  • The theme does not connect to our site by itself. It asks WordPress to do it by calling the standard WordPress function wp_remote_post().
  • WordPress also does not connect to our API site by itself when asked. It asks the PHP to do it by calling the standard php curl_exec() function.
  • The PHP also does not connect to our site by itself when asked. It asks the system binary library that is installed on the server, called “cURL”, to do it.
  • That library is the one that connects to our site. It generates the “Connection timed out after 5000 milliseconds” error and passes it to the PHP, which passes it to WordPress, which passes it to the theme.
  • Only your hosting provider can answer why the library generates the error and in turn resolve the problem.

Please contact your hosting service provider regarding the connection error and ask them to install modules with the proper settings listed below:

  • artbees.net is not blocked (IP : 157.230.149.127)
  • allow_url_fopen is on
  • cURL support is enabled
  • OpenSSL support is enabled


Other Issues

If you face any other issues while registering Jupiter, open a ticket in our help desk.

Contact Form Issues

If you have set up the contact form shortcode or widget, make sure that you have used the correct email address (where you want to receive WordPress emails). If you still do not receive any emails, then read on for some tips that may help.


WordPress wp_mail Function Is Not Working Properly

WordPress sends emails using wp_mail, a function which for all practical purposes operates like PHP mail. It is a way for your site to send email via a PHP script, rather than using other methods such as SMTP. In order to determine what your problems might be, it is important to understand the potential email configuration requirements. Some issues could be server-based, while others could be due to not understanding the restrictions set by your host.

In some cases the mail() function is disabled by default, and you should enable it from the php.ini file.


Valid Email Headers

Some hosts require the server-side email script to send with a “from” address that is an actual email address. WordPress by default sends email from a generic “wordpress@yourdomain.com” address. If your host requires that you send from a valid email address but you don’t have the email address wordpress@yourdomain.com configured, then your site can’t send emails. For example, the address wordpress@artbees.net should be configured in your mail server in order to pass through this policy.


Shared Server

On shared hosting, the email process is also shared. If another user on your host has a script that is tying up the email server, it will affect your site (and therefore your email script). For those running WordPress on shared hosts, the issue is most often that the email is delayed.

It is important to communicate with your host if this is something you are likely to be affected by.


Recommended Hosting Solutions

The following hosting services offer maximum compatibility with Jupiter and provide exclusive discounts to Artbees Themes users:

InMotion > Up to 50% Discount
WPEngine > 20% Discount
DigitalOcean > $10 Discount
MediaTemple > 2 Months free on Annual Plan


Spam Filters

Sometimes the issue is that certain messages are blocked simply because of an addressing issue. Emails coming from one of the major email provider domains (Hotmail, AOL, Gmail, Yahoo) can get flagged for a number of reasons, possibly due to spam filters. If an email from wp_mail is not getting delivered, you may need to determine whether it is not getting through to anyone or it is only limited to certain domains. Getting blocked or blacklisted by a specific host could be the issue.


Other Issues

If you face any other issues with the contact form, open a ticket in our help desk.

Translation Issues

When translating the Jupiter theme to your language, you may encounter some issues like words that can’t be translated or the translation not working after the theme update. In this article we’ll describe some translation issues and how to fix them.


Translation Stopped Working After Theme Update

If you are using the Loco Translate plugin and you noticed some translations are not working as expected, click on the Sync button on the translation edit screen. This option will sync the old translations with the new translations.

Also after theme update new strings may be added to default mk_framework.pot file, but you can’t find them in your translation .po file.

To fix it, you need synchronize your file with the default one. To update your .po file, navigate to Catalog, choose Update from POT file, and then choose the mk_framework.pot file from which you will get the updated contents. After that, translate the project as you normally do and save all changes.


Translation Is Not Loading/Working

Usually this means that you forgot to save the translated file, or that it’s in the wrong path. Usually plugins and themes search for translations in the folder /languages or /i18n inside their root, but this may change. To locate Jupiter translation files correctly, read the article How to translate theme.


Some Strings Are Translated, But They Are Not Loading

When translating the Jupiter theme to your language, you may encounter some issues like words can’t be translated or the translation is not working after the theme update.

Be sure that they are not Fuzzy. A Fuzzy string means that it needs to be checked. The translator was probably not sure of it’s translation, so it marked the word(s) as Fuzzy to let others confirm that the translation is correct before using it or the original text was changed in the theme update.

To fix it, you need uncheck Fuzzy selection. On PoEdit for Mac, disable Needs Work option:

On Windows/Linux, click this Fuzzy icon:

Click on it for each string which is marked as Fuzzy and save the changes.


Other Issues

If none of the above steps helped, please open a ticket in our help desk.

Theme Migration Issues

Migrating from one theme to the Jupiter theme is a technical process and sometimes there may be some problems you have to deal with.

In this article we’ll describe what issues may occur during theme migration and how to fix them.


Content in Sidebar Is Lost

If your old theme had some custom areas in Appearance > Widgets, you may lose them when switching to the Jupiter theme. The reason is that Jupiter is designed differently and has its own widget areas.
To get the content in your sidebars back, you’ll need to add the widgets again to the new Widget Areas.


Lost Tracking

If you use some sort of analytics tool, whether it be Google Analytics or another service, and you added the tracking code to the footer.php file instead of to a plugin, you will lose the code once you migrate to the Jupiter theme. So, you’ll need to make sure that you copy and paste your tracking code into your new theme. This is one of the things that is very commonly overlooked by users.


Fix Thumbnail Sizes

It may happen that all of the new images that are uploaded after activating the new theme look good, but the old thumbnails appear ugly and distorted.
When you upload an image to WordPress, it creates duplicate images of the original in different sizes and saves them in the uploads folder. WordPress gets the thumbnail image size information from your theme. Your theme defines the thumbnail sizes, which are really useful in order to load the best image size when needed. These new image sizes are only applied to the images that you upload after activating the new theme.
To solve this problem you’ll need to generate new sizes for all the previously uploaded images. This process is often referred to as regenerating thumbnails and there is a plugin to help – Regenerate Thumbnails.


Recommended Hosting Solutions

The following hosting services offer maximum compatibility with Jupiter and provide exclusive discounts to Artbees Themes users:

InMotion > Up to 50% Discount
WPEngine > 20% Discount
DigitalOcean > $10 Discount
MediaTemple > 2 Months free on Annual Plan

Theme Update Issues

Updating your website’s theme to the latest version is highly recommended, because it ensures that you have all the latest features.

In this article we’ll describe the issues that may occur during a Jupiter theme update.


Recommended Hosting Solutions

The following hosting services offer maximum compatibility with Jupiter and provide exclusive discounts to Artbees Themes users:

InMotion > Up to 50% Discount
WPEngine > 20% Discount
DigitalOcean > $10 Discount
MediaTemple > 2 Months free on Annual Plan


Destination Folder Already Exists Error

If you go to Appearance > Themes > Add New and try to upload a new version of the theme that is already in your site’s themes directory, it may fail and you’ll get an error message telling you that the destination folder already exists.

The reason for this error is that you can’t have two folders in your themes directory with identical names – jupiter.

There are a couple of simple solutions:

1Log into your site via FTP or cPanel, delete the old theme and then upload the new version.

Make sure you make a backup of the old version of your theme just in case something goes wrong.

2Another option is to rename the old version of the theme.

This will allow you to successfully upload the new version of the theme.

  • Log in to your site via FTP or cPanel and navigate to wp-content/themes/ and find your old theme.
  • Rename your old theme something like “jupiter-old”.
  • Upload your new theme.

The old and new versions of the theme will both appear in the themes interface, but you will be able to distinguish them by their folder names and version numbers.


Losing Customization After Theme Update

When you want to customize your Jupiter theme, you can simply edit the code directly in your theme files. This becomes a problem when a new update is released and it wipes out all customization.

That’s why it is always best practice to use a child theme for all your customizations. Here is an article on how to create a Jupiter child theme.

Using a child theme makes it easier for you to update the parent theme. Your changes will be saved during the update, and you will not have to re-do all actions again.


Other Issues

If you face any other issues while updating Jupiter, open a ticket in our help desk.

Theme Installation Issues

When installing a theme, you may encounter some problems and it is important to troubleshoot the cause. It could be caused by your environment, a possible third-party plugin conflict, or your server might not meet the requirements.

In this article we’ll describe the most common issues you may have while installing the Jupiter theme via the WordPress dashboard.


The theme Is Missing the style.css Stylesheet. Error

A common issue that can occur while installing a Jupiter theme is “The package could not be installed. The theme is missing the style.css stylesheet.” This error message is displayed when uploading or activating the theme.

The reason may be that you tried uploading the full zip file that includes sample data, documentation, etc.

Please make sure you are uploading only the installable theme called Jupiter.zip. When you download the theme from your ThemeForest downloads it will give you two choices: one is to download the full zip file which you will then need to extract in order to locate the theme and the other one is just the installable theme. Please pay close attention to this.


Are You Sure You Want to Do This? Error

This error can happen for several reasons listed below:

  • Your server’s memory limit to PHP is too low (most common).
  • You are trying to upload the full zip file and not just the installable theme (please refer to the guide on installing your theme).
  • The upload limit on your server isn’t large enough and you must update your PHP.INI file to increase the upload_max_filesize value or contact your webhost to fix it.


White Screen Of Death or PHP Error Notice

A “white screen of death” happens when there is a PHP error on the site but WP_Debug isn’t enabled on the server. So the first thing to do would be to enable WP_Debug so you can read what the actual error is and fix the problem.


Parse Error: Syntax Error, Unexpected T_FUNCTION Error

This error may occur if you have an old PHP version, like PHP 5.2 version. The Jupiter theme uses some OOP techniques and standards that are not present in PHP legacy versions (e.g. v5.2.X, v5.3.X). The minimum required version is PHP V5.6+. So if you’re getting this error, you’ll need contact your hosting provider support and ask them to update the PHP version to get the Jupiter theme working.


Other Issues

If you face any other issues while installing Jupiter, open a ticket in our help desk.