Home 2. Getting Started

SECTION 01Server Recommended Settings / Requirements

In order to successfully run NewStar on your website your server environment will have to meet certain PHP and WordPress minimal version requirements.

PHP 5.4.X or higher

Theme requires php 5.4.X or higher installed on your server.

In order to check your php version we recommend one of two methods:

If neither of these options work for you, please consult your hosting provider regarding the php version you are running on your server.

MEMORY LIMIT 64M or higher (Recommended 96M)

You can have a closer look at how to increase the PHP memory by referring to the following article: Fix WordPress memory exhausted error increase php memory.

MAX UPLOAD SIZE 35M or higher

You can have a closer look at how to increase the PHP memory by referring to the following article: Fix WordPress memory exhausted error increase php memory.

Optional settings for PHP.INI file:

post.max_vars = 5000
request.max_vars = 5000
max_execution_time = 300

WordPress version

Although the theme will run on older versions of WordPress we highly recommend WordPress 4.4.X or later.

In order to check which version you are running, please click on the WordPress icon in the upper left corner of your wp-admin console.

http://documentation.bold-themes.com/newstar/wp-content/uploads/sites/32/2017/11/server-settings.jpg

SECTION 02Installing WordPress

If you’ve recently purchased a hosting plan and a domain name, the next step is to install WordPress CMS on your server.

The best option is to start with fresh WordPress installation.

If you’ve recently purchased a hosting plan and a domain name, the next step is to install WordPress CMS on your server. Here are a few links to help you start your website’s back-end and get your site ready for installing the theme:

A step by step guide: How to install WordPress.

If you plan on using our theme on a local WordPress development and migrating your site live later on, this is a useful link that shows how to create a local WordPress development environment: Installing WordPress on a Local Server Environment.

If you’re switching to a new domain please refer to the following link to make sure that all the necessary steps are taken: How to Properly Move WordPress to a New Domain Without Losing SEO.

Related links:

SECTION 03Installing NewStar Theme

After you have installed WordPress and purchased the theme, you should go to a download tab on ThemeForest:
http://documentation.bold-themes.com/newstar/wp-content/uploads/sites/32/2017/11/theme-forest-download.jpg

You have 2 options for downloading your theme:

  • All files and documentation (Complete Zip archive)
  • Installable WordPress file only.
http://documentation.bold-themes.com/newstar/wp-content/uploads/sites/32/2017/11/theme-forest-download-options.jpg

Please download both archives. All files and documentation package contains all files provided with the theme, including this document.

Installable WordPress file only should be used in the process of Theme installation.

There are two methods of installing a theme onto your WordPress site. You can use the WordPress Admin panel to upload and install the theme, or you can use FTP software instead.

WordPress Theme Installation

To install the theme directly from the WordPress admin panel, please first log-in to your wp-admin console

  1. Navigate to Appearance > Themes
  2. Click Add New
  3. Click Upload Theme
  4. Click Choose File
  5. Find the package you have downloaded from ThemeForest as Installable WordPress file only on your local computer
  6. Click Install Now and the installation will begin. You can monitor the installation process in the lower left corner of your browser
  7. Once the installation is complete you will see the following screen:
http://documentation.bold-themes.com/newstar/wp-content/uploads/sites/32/2017/11/install-theme.jpg

8. Click Activate

9. You should see the list of themes installed in your WordPress instance with the NewStar activated.

Congratulations! You’ve successfully installed and activated NewStar WordPress Theme on your website. Proceed to install plugins and either add your own content or import the demo content to get your site up and running in no time.

FTP Installation

To install the theme using FTP software, log in to the server where your WordPress website is hosted.
First extract the “newstar” folder from Installable WordPress file only package that you received in your installation pack. Now connect to your server via FTP and navigate to the /wp-content/themes/ directory under your WordPress website’s root location. Upload ‘newstar’ folder to the themes folder on your remote server.

Once the theme is uploaded, you need to activate it. Go to ‘Appearance > Themes’, find NewStar and click ‘Activate’ button.

Congratulations! You’ve successfully installed and activated NewStar WordPress Theme on your website. Proceed to install plugins and either add your own content or import the demo content to get your site up and running in no time.

WordPress Theme Installation and Plugin Activation Tutorial

SECTION 04Installing Required Plugins

Once you have WordPress and the theme installed, you’re required to install the necessary plugins to successfully run our theme on your website (Bold Builder, theme’s plugin and the rest).

Upon installing and activating theme in Appearance > Themes panel you will get a notice at the top of your admin panel saying that the theme requires certain plugins. Click on Begin installing plugins.

http://documentation.bold-themes.com/newstar/wp-content/uploads/sites/32/2017/11/required-plugins.jpg

WordPress redirects you to the Install Required Plugins page. Select all plugins, choose Install and click Apply.

http://documentation.bold-themes.com/newstar/wp-content/uploads/sites/32/2017/11/install-required-plugins.jpg

Once the installation is complete the following screen will appear. Click Return to the Dashboard at the bottom of the screen.

http://documentation.bold-themes.com/newstar/wp-content/uploads/sites/32/2017/11/installation-required-plugins.jpg

Congratulations! You have successfully installed the plugins required to run the theme on your site. If you click on Plugins in wp-admin menu, you should see the following list:

http://documentation.bold-themes.com/newstar/wp-content/uploads/sites/32/2017/11/installed-required-plugins.jpg

Note: WooCommerce is recommended plugin. We strongly encourage you to install it even if you do not intend to use it since demo with WooCommerce assets can be imported only if this plugins is installed and activated. Once you import the demo, you can deactivate and uninstall it.

The best way to start is to install demo content. If you want to install demo content please go to the next section.

SECTION 05Installing Demo Content

The best practice is to start with fresh WordPress installation or use WordPress Database Reset plugin to clear your WordPress instance of previously existing content.

Note: Please keep in mind the following:
Import of demo content will delete all existing posts, pages and menus.

The best practice is to start with fresh WordPress installation or use WordPress Database Reset plugin to clear your WordPress instance of previously existing content.

Note: Since demo contains WooCommerce demo data, please make sure to install and activate it prior to activating the import or the import will fail. If you do not intend to use WooCommerce, feel free to deactivate them and uninstall it later on, but it has to be activated prior to import.

The procedure is as follows:

  1. Login to the wp-admin panel
  2. Go to Tools > BT Import
http://documentation.bold-themes.com/newstar/wp-content/uploads/sites/32/2017/11/BT-import.jpg

3.  Select one of the demo XML files and click on it (warning: existing posts, pages and menu items will be deleted).

http://documentation.bold-themes.com/newstar/wp-content/uploads/sites/32/2017/11/choose-xml.jpg

4.  Once the installation starts, you will be able to see how much time is left until the demo imports.

http://documentation.bold-themes.com/newstar/wp-content/uploads/sites/32/2017/11/demo-import-percent.jpg

5.  Please wait until you get the message that import is finished.

http://documentation.bold-themes.com/newstar/wp-content/uploads/sites/32/2017/11/finished-bt-import.jpg

6.  If you imported demo with WooCommerce content, go to WooCommerce > Settings > Products > Display and select Shop as Shop Page; open Checkout tab and select Cart as Cart Page and Checkout as Checkout Page; open Accounts tab and select My Account as My Account Page.

Congratulations! You have successfully imported the demo. If you click on visit Site in wp-admin header, you should see your site with demo content imported.

ARTICLE 06Common Issues And Troubleshooting with theme install

In this section we will describe the most common errors that can occur when installing the theme, and provide solutions for each one.
Broken Theme And/Or Stylesheet Missing

An error message while installing or activating a WordPress theme usually means that the incorrect file(s) were uploaded.

The exact error message may vary, however it will typically include the words, ‘Broken Theme’ or ‘Stylesheet Missing’. A similar message will appear if you’re using a plugin that has minified all the CSS files, including the theme’s or child theme’s default style.css file, which should be left intact according to WordPress regulations.

The solution is to review which file you were uploading – please refer to section Installing NewStar Theme for instructions which files to use in the process.

Also, you can find more about this error and how to fix it.

Blank Dashboard – White Page

This issue is most commonly related to either php version (required php version is 5.4.X or higher) on your server or WordPress memory limit and its value being too low on your server.

Please read this article and increase the WP memory limit: Fix: WordPress Memory Exhausted Error – Increase PHP Memory.

If the issue persists upon adjusting the WordPress memory limit, we recommend enabling WordPress debug mode to track down the cause of this error and resolve it. To enable debug mode, please go to the WordPress installation folder on your server using FTP software and open the wp-config.php file in a text editor. Find this line of code:

define('WP_DEBUG', false);

Adjust the code so that WP_DEBUG is set to true:

define('WP_DEBUG', true);

Save the file, re-upload it back to your server and check for issues.

Please read the article about WP_DEBUG mode.

Parse error: Syntax error, unexpected T_STRING

If you get the error similar to this:

Parse error: syntax error, unexpected T_STRING in /wp-content/themes/eventim/php/BTCrushFunctions.php on line 7.

Keep in mind that this issue is most commonly related to php version (required php version is 5.4.X or higher).
You need to update your php version to the required one.

Parse error: Syntax error, unexpected T_FUNCTION

If you get the error similar to this:

Parse error: syntax error, unexpected T_FUNCTION in /wp-content/themes/medicare/functions.php on line 39.

Keep in mind that this issue is most commonly related to php version (required php version is 5.4.X or higher).
You need to update your php version to the required one.

ARTICLE 07Common Issues And Troubleshooting with Demo content

In this section we will describe the most common errors that can occur when importing the demo, and provide solutions for each one.
Error. This demo contains WooCommerce data. Please install and activate WooCommerce.

As it was mentioned in 2.5 Installing Demo Content section, some of the demo contains WooCommerce demo data, which is why WooCommerce should be installed and activated. Navigate to Plugins > Add New and in Search plugins field type WooCommerce (author WooThemes). Install it, activate it and then continue importing demo content.

I got the red colored Internal Server Error Message. What should I do?

On some hosting environments (HostGator, GoDaddy) there is an issue with the resources dedicated to a single instance of Shared Hosting. While trying to prevent a single instance to compromise others in Shared Hosting environment, they set the limits too low. Especially limits related to memory and processing power.

As a first step, please try to set Server Recommended Settings and try the import again.

If that does not work, most probably the hosting limit prevents creation of thumbnails for images larger than 60-70k.

The consequence is that you will not be able to see the thumbnails in your Media Library although the images are there (thumbnail was not created) and you will not get optimized images for different elements on the site. You will get the original ones which are usually not optimized for the placeholder they have been put in.

In order to import the demo in such environment, you need to repeat it over and over again. The import is incremental process and eventually it will finish (it usually takes 30 or more retries since it will crash on the import of each image larger than 60kb). You can check the progress by refreshing Media Library window – each retry should add one or more images (the ones with 60kb and more will be grey while the smaller ones will have a proper thumbnail).

Once the import finishes you will have a functioning demo, but we strongly recommend to resolve the resources issue with the hosting or change it since it will almost certainly create other problems in the future.

I get Error 404 (Page not found) for all pages except the home page of the site. What should I do?

Try to recreate permalink structure by going to Settings > Permalinks, changing it to Post name for example, saving the settings, then changing it back to Day and name and saving it again.

Images on my demo site are low quality. Why is that?

Demo imports come with low quality images for two reasons – one is the speed of import and the second is that images are not licensed for third party use, just for demo presentation purposes.

Distributing production quality images with our demos would be a violation of the license terms on our part.

If you would like to use the same images as on our demo for your final site, please let us know and we will provide you all the information of used images on ShutterStock.