Pearl - Gettings Started

Pearl WP - Installation, Activation, and Demo Import tutorial.

Installation

System Requirements

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

You can install the theme just as you would install any other WordPress Theme.

To install the theme:

1. In the WordPress Dashboard, click on Appearance > Themes to open the Themes screen.

2. Click on the Add New button to open the Add Themes screen.

3. Click on the Upload Theme button and upload the zipped theme file you have received from ThemeForest.

4. Once the file is uploaded click on the Install Now button to install the theme.

Here you can see video tutorial of Installation 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

You can verify your PHP configuration limits by installing a simple plugin found here: http://wordpress.org/extend/plugins/wordpress-php-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.

Viewing System Status

You can also view some of your WordPress system settings by going to the Pearl Theme System Status page. (Click on Pearl > System Status in the WordPress menu.) This page will provide information about your WordPress environment and your server environment.

Any items that require your attention will be highlighted in yellow.

Theme Activation

After completing the installation of the theme, you need to activate your product under Dashboard -> Pealr following these instructions:

  1. Click on this Generate A Personal Token link. IMPORTANT: You must be logged into the same Themeforest account that purchased this theme. If you are logged in already, look in the top menu bar to ensure it is the right account. If you are not logged in, you will be directed to log in then directed back to the Create A Token Page.
  2. Enter a name for your token, then check the boxes for View Your Envato Account Username, Download Your Purchased Items, Verify Purchases You've Made and List Purchases You've Made from the permissions needed section. Check the box to agree to the terms and conditions, then click the Create Token button.
  3. A new page will load with a token number in a box. Copy the token number then come back to this registration page and paste it into the field below and click the Submit button.
  4. You will see a green check mark for success, or a failure message if something went wrong. If it failed, please make sure you followed the steps above correctly.


Paste the token in the provided box and click on the Submit button.


If activation is successful, you will see a green check mark.

You can follow this manual if activation fails. 

Importing the demo content

Once the theme is installed, you will find a new Pearl 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 http://pearl.stylemixthemes.com/landing/. You can see the different demos and decide on which one suits your firm the best.

Click on Pearl > Install Demos 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.

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: http://wordpress.org/extend/plugins/wordpress-php-info. And you can also check your PHP error logs to see the exact error being returned.

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 Pealr > 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 pearl.zip file.

Once you have installed the Easy Theme and Plugin Upgrades plugin:

  1. Download the theme file update from ThemeForest.
  2. Extract the pearl.zip file from the downloaded theme file.
  3. In the WordPress dashboard, click on Appearance > Themes > Add New > Upload Theme > Browse...
  4. Select the pearl.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 pearl.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 pearl\ and to subfolders within the pearl folder.

Tip: Make sure your unzipping software does not create any extra directory with the same name nested within the pearl\ folder.

Using an FTP program, upload the pearl\ folder (and its subfolders) to /wp-content/themes/ on your web server.

Note: The FTP program will give a warning that the pearl\ 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. 

5

Was this article helpful?

Yes No

Thanks so much for your feedback!

Thanks so much for your suggestion!