Croma Help Guide | IronTemplates

# Croma

> Important: You can find out all the latest knowledge base on our help desk right here.

Set-up & general guide to help you get the most out of your new WordPress theme.

# Getting Started Back to Top

## Support & Live chat

This document covers the installation, set up, and use of this theme, and provides answers and solutions to common problems. We encourage you to first read this document thoroughly if you are experiencing any difficulties before contacting our support team.

If you are still having trouble after reading this guide, contact our help team by having a live chat with us.

Croma has many more customization options including typographic selectors, stylistic color pickers and other add-ons. And in addition to these fantastic features, you'll also receive access to world-class theme support by our team of in-house professional WordPress developers.

> Please note that support is only offered for user who bought Croma from ThemeForest. To access the support, you will need your purchase code that is available by login your ThemeForest account > Downloads tab
> If you have any questions that are beyond the scope of this document, feel free to ask us via our dedicated help center.

## Theme Installation via the WordPress Dashboard

To upload through your WordPress Dashboard, go to wp-admin > appearance > themes > add new > upload theme. Once the theme is fully uploaded and installed, click “Activate” to activate the WordPress theme.

> The theme files will be stored on your server in the `wp-content/themes` location.

When uploading your theme with the installer, please ensure you are uploading the theme .zip file, not the entire package you downloaded. In this case, you will be uploading croma.zip.

> If you have a message error that says: Are you sure you want to do this ? Don't worry. we got you covered. There is 2 different causes for this issue. Most likely your web server is configured with PHP Upload Max file size setting that are too low to allow the theme ZIP file to upload. By default, your web server is configured to a maximum file upload size limit at 8 megabytes or less. The theme ZIP is currently about 35MB. 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 servers are configured differently, there is 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`

## Theme Installation via FTP Upload

To manually upload your new WordPress theme, login with your credentials to your website and locate the wp-content folder in your WordPress install files. Upload the un-zipped Croma folder into the: wp-content/themes folder.

Once uploaded, activate the theme by heading to the “Themes” menu in the WordPress Dashboard. Locate the Croma theme and hit “Activate”.

# Import the Demo Back to Top

The best way to get started with our theme is to import the demo. Install the theme and its required plugins, then go to WP-Admin > Tools > Demo Content Install and you will see there all the demos available. Choose your favorite. Then you will only have to change the images, texts and color by your own assets.

​

> Take note that when you import the demo, this completely swipe your actual content by the demo's one but it's often the best way to get started with your new design.

Go to WP-Admin > Appearance > Install Plugins. Install all the required plugins, including "Iron Demo Importer" and make sure to activate them all by going to WP-Admin > Plugins.

Once activated, go to WP-Admin > Tools > Demo Content Install. Choose your favorite demo and install it. It should takes 3 to 10 minutes.

> ### Here's some issue you can face on when importing the demo:

## Important: You need to activate zip extension.

This message might shows up when you go to Tools > Demo Content Install. If it's your case, it means that Zip extension library is not enable on your server. To enable it, Go to your CPANEL > Select PHP Version and check ZIP. See Screenshot
If you don't have access to your cpanel, please contact your webhost so he can enable Zip Extension.

## Timed Out

If you have a Timed Out message when you are importing the demo it means that your `max_execution_time` is set only to 30 second or so. Our demo's data is big and the import process while takes more than 30 seconds. It's why you see a timed out message. To raise the time a script is allowed to run, go to your CPANEL > Select PHP Version > Switch to PHP Option (See Screenshot)

Then check for `max_execution_time` and change the setting for 30 then click Apply and Save (See Screenshot)

If you don't have access to your cpanel or you still receive a timed out message, please contact your webhost so he can set your `max_execution_time` to 600.

## If you don't see the demo importer tools in WP-Admin > Tools > Demo Content Cnstall

It's probably related to a server permission. Please install the plugin maually. You can download it here

## Manual Upload

If you cannot use the demo content install plugin, try the manual upload:

1. Download the demo package on your computer:

Lowtempo
Capital
The Moons
Phoenix
KPop
Light
Dark
The Grid
Nika

2. Upload demo.zip file to your web server in the folder `/WP-CONTENT/UPLOADS/FW-BACKUP/`

3. Go to WP-Admin > Tools > Backup

4. Select the archive you want to import then click restore Backup.See Screenshot

You can always open a support ticket at http://support.irontemplates.com if you have any issues. We are here to help.

Find out more on installing and activating plugins.

# Navigation Back to Top

It is rather important to set your theme menu in the WordPress Dashboard. To do this, locate the Menu options by selecting the “Appearance” tab from the dashboard sidebar and then “Menus”.

Once you’re viewing the Menus, create a new menu and save it. After you’ve saved the menu, you can add it to a menu via the Menu Settings, below the Menu Structure area. Add your pages and links to the menu you just created in the Menu Structure area.

# Plugins Back to Top

Croma requires some plugins to be installed and activated. To install the required plugins, go to WP-Admin > Appearance > Install Plugins.

## Required Plugins

- Croma Music - required plugin
- Visual Composer Page Builder - required plugin. The best place to get started with Visual Composer is to read the how's to provided here.
- Essential Grid - required plugin
- Revolution Slider - required plugin

## Plugin ask for a licence key to be activated. What's wrong ?

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 (IronTemplates) are responsible to update the pre-packaged plugins that comes with our theme. We release plugin updates on regular basis after testing them and make sure they are 100% compatible within our theme. It's the way it works for every themes that offer third party plugins packaged into the theme.

# Updates Back to Top

## Check for Updates

To check your theme version, go to WP-Admin > Appearance > Themes and click the Croma theme.

To check what is the latest version available and to see what changes are,view the official Croma theme changelog →

If you are in need of the update please follow the instructions here.

# Croma Child Theme Back to Top

A child theme is a theme that inherits the functionality and styling of another theme, called the parent theme. Child themes are the recommended way of modifying an existing theme.

## Why use a Child Theme?

There are one main reason why you would want to use a child theme: If you modify a theme directly and it is updated, then your modifications WILL be lost. By using a child theme you will ensure that your modifications are preserved.

## Installing the Child theme

Log in to your site's administration panel, and go to WP-Admin > Appearance > Themes. Click "Add New" and follow the directions to upload the croma-child.zip file, located in the croma-package/theme/ folder.

Next simply click "Activate" and both the Croma theme and Croma child theme will be active on your WordPress site. Now you're ready to customize away.

> Note that this is the same exact method we referred to in the Getting Started section of this guide. You should see your child theme listed and ready for activation.

## Customizing Template Files

If you want to change more than just the stylesheet, your child theme can override any file in the parent theme: simply include a file of the same name in the child theme directory, and it will override the equivalent file in the parent theme directory when your site loads.

For instance, if you want to change the PHP code for the site header, you can include a header.php in your child theme's directory, and that file will be used instead of the parent theme's header.php.

## Child Theme Functions.php

Unlike style.css, the functions.php of a child theme does not override its counterpart from the parent. Instead, it is loaded in addition to the parent’s functions.php. (Specifically, it is loaded right before the parent’s file.)

In that way, the functions.php of a child theme provides a smart, trouble-free method of modifying the functionality of a parent theme.

## Adding PHP Functions

Say that you want to add a PHP function to your theme. The fastest way would be to open the croma/functions.php file and put the function there... But that’s not smart: The next time Croma is updated, your function will disappear (as the entire contents of the /croma/ folder are replaced upon an update.

However, there is an alternative way which is the smart way: you can create a child theme, add a functions.php file in it, and add your function to that file. The function will do the exact same job from there too, with the advantage that it will not be affected by future updates of the parent theme.

> DO NOT copy the full content of functions.php of the parent theme into functions.php in the child theme. It's not a good practice by any means.