Gem- Installation Guide

Last Updated: Dec 01, 2015

Theme Introduction

Gem is a versatile responsive Magento theme for eCommerce sites. Supporting all the latest versions of Magento CE including Magento 1.9, this eCommerce Magento theme ships with responsive web design, off-canvas menu and offers 5 bonus theme skins. You can read more about Gem features here.

Supported Magento Extensions

UberTheme develops complementary Magento extensions for our themes exclusively. Once purchased Gem, you can download the following complementary extensions, namely:

Layout and Block Positions

The layout of Gem Homepage can be illustrated as follows.

Accordingly, Gem comes up with these following static blocks:

Note:

To create new static blocks, read on here.

System requirement

To install Gem, you have to install the Magento base in advance. You can get it done quickly by following the Magento Installation Guide.

Download packages

Once downloaded, extract Gem download package to get these folders:

mage_ext: contains all built-in extensions of the theme.
mage_tpl: contains the theme files only.
quickstart: a full Magento version with Gem already integrated to match the demo.
source: contains all source files of the theme.

There are two ways to install a UberTheme Magento theme:

Manual Installation: Applicable if your store is full with content that you don’t want to overwrite.
QuickStart Installation: Applicable if you want to get a whole new fresh site as per Demo.

Provided that you have installed the Magento base already, decide which way to install and follow steps as below.

1. Manual Installation

Step 1: BaseTheme Installation

Kindly install Magento extension BaseTheme in advance of any other installations to avoid unexpected conficts that may occur.

To install, copy the BaseTheme folder in the extracted folder mage_ext to your site root folder.

For more about BaseTheme, visit its detailed documentation.

Step 2: Theme Installation

1. Copy the folders skin and app to your site root folder. The overwritten folders should have a directory layout like this:

        {docroot} /magento/app/
        index.php
        js/
        lib/
        LICENSE.txt
        media/
        pear/
        skin/
        var/

2. Log in to your Admin Panel e.g. //www.yourdomain.com/admin. Log out and log in back.

3. Navigate to System >> Cache Management, Sellect All the cache types, take Action as Refresh and Submit.

4. Navigate to System >> Configuration >> Design.

5. In Themes tab, input Default field with the actual theme name e.g. “gem” instead of “purity”.

Magento Guide: Packages and Themes Settings

6. You can also change the settings for Gem Header.

7. Click Save Config button to finish.

Step 3: Extension Installation

1. Copy all the folders of each extension folder in mage_ext to the your site root folder.

2. In your Admin Panel, navigate to System >> Configuration.

3. To enable any extension, enter this one’s tab and set Enable to “Yes”.

Magento Guide: Extension Enable Settings

4. Click Save Config button to finish.

2. QuickStart Installation

Quickstart package is to minimize time and effort in installing the theme as per Demo site. Kindly note that, with Quickstart, all your existing data will be overwritten. Thus, we recommend using Quickstart for your first installation or just in case you want to refresh your site to the very beginning.

1. Upload the folder quickstart to your server. In Quickstart folder you will see the extracted folder that includes all sample data.

2. Create a database for your Magento store using phpMyAdmin.

3. To install, open a browser and navigate to your URL (where the Quickstart package uploaded) to load the default Magento installer. Kindly follow each step of the Installer so that the installation process can be set.

4. In the Configuration step, input the required fields as below.

Do not use “localhost” in URL, otherwise you could not log in to your Admin area (you should use your local IP in case of installing on your computer).
Leave Tables prefix field blank.

Take a full backup

Always make a back-up before proceeding to any of the upgrade process. In case there are any problem, you can always restore from the back-up files.

Upgrade Magento core

In case you need to upgrade Magento core for your eCommerce site e.g. upgrading Magento 1.7 to Magento 1.9, head over our detailed guide about this here.

This section will guide you to configure your pages just as the Demo of Gem.

I. Homepage

Detailed layout of Gem Homepage:

To configure this page, in the Admin Panel, navigate to CMS >> Pages.

Create a new page named {Homepage} in Page Management section.

Page Information Tab: click to see the Back-end Settings.
Content Tab: click to see the Back-end Settings.

Copy and paste the following code into the Content field.

<div class="home.products.deal">{{block type="joomlart_jmproductsdeal/list" name="home.jmproductsdeal.list" template="joomlart/jmproductsdeal/home-deals.phtml" }}</div>

Design Tab: click to see the Back-end Settings.

Copy and paste the following code into the Design field.

<reference name="tops1">
                <block type="cms/block" name="jmslideshow">
                  <action method="setBlockId"><block_id>jmslideshow</block_id></action>
                </block>
              </reference>
              <reference name="tops2">
                <block type="joomlart_jmtabs/core" name="jmtabs">
                    <action method="addTabs_staticblock">
                      <title>Trending</title>
                      <identifier>trending</identifier>
                    </action>
                    <action method="addTabs_staticblock">
                        <title>best seller</title>
                        <identifier>best-seller</identifier>
                    </action>
                    <action method="addTabs_staticblock">
                        <title>New arrival</title>
                        <identifier>new-arrival</identifier>
                    </action>
                </block>
              </reference>
              <reference name="tops3">
                <block type="cms/block" name="collections">
                  <action method="setBlockId"><block_id>collections</block_id></action>
                </block>
              </reference>
              <reference name="mass-bottom">
                <block type="cms/block" name="gift">
                  <action method="setBlockId"><block_id>gift</block_id></action>
                </block>
              </reference>
              <reference name="bots1">
                <block type="cms/block" name="advantage">
                  <action method="setBlockId"><block_id>advantage</block_id></action>
                </block>
                <block type="cms/block" name="testimonials">
                  <action method="setBlockId"><block_id>testimonials</block_id></action>
                </block>
              </reference>

II. 404 Page

To configure this page, in the Admin Panel, navigate to CMS >> Pages, select 404 Not Found 1 page to edit the following settings.

Page Information Tab: click to see the Back-end Settings.
Content Tab: click to see the Back-end Settings.

Copy and paste the following code into the Content field.

<div class="no-route">
<p><img alt="" src="{{media url="wysiwyg/page-not-found.jpg"}}" /></p>
<div class="page-title">
<h1>page not found</h1>
</div>
<dl><dt>The page you requested was not found, and we have a fine guess why.</dt><dd>
<ul class="disc">
<li>If you typed the URL directly, please make sure the spelling is correct.</li>
<li>If you clicked on a link to get here, the link is outdated.</li>
</ul>
</dd></dl><dl><dd>
<ul class="disc">
<li><a onclick="history.go(-1); return false;" href="#">Go back</a> to the previous page.</li>
<li>Use the search bar at the top of the page to search for your products.</li>
<li><br /><br /><span>Follow these links to get you back on track!</span><br /><a href="{{store url=""}}">Store Home</a> <span class="separator">|</span> <a href="{{store url="customer/account"}}">My Account</a></li>
</ul>
</dd></dl></div>

Front-end Appearance:

Introduction

Theme Introduction

Supported Magento Extensions

Layout and Block Positions

Note:

Download Instruction

System requirement

Download packages

Installation Instruction

1. Manual Installation

Step 1: BaseTheme Installation

Step 2: Theme Installation

Step 3: Extension Installation

2. QuickStart Installation

Upgrade Instruction

Take a full backup

Upgrade Magento core

Page Configuration

I. Homepage

II. 404 Page

Static Block Configuration

1. jmslideshow: Slideshow

2. trending: Trending

3. best-seller: Best Seller

4. new-arrival: New Arrival

5. collections: Collections

6. gift: Collection of gift

7. testimonials: Testimonials

8. advantage: Advantage

9. brands: Brands

11. about-us: About Us

12. support: Support

13. useful: Useful

14. colors: Colors

15. mega-banner: Mega Banner

16. mega-products: Mega Products

17. mega-one-product: Mega one product

18. contact-masshead-info: Contact Page -- Masshead

19. get-in-touch: Get in touch

Extension Configuration

1. Masshead

2. BaseTheme

2.1. BaseTheme Configuration

2.2. Label Configuration

3. Mega Menu

4. Products

5. Products Deal

6. Slideshow

7. Quickview

8. Products Slider

9. Tabs

Mega Menu Configuration

Men Menu

Note:

Responsive Layout Configuration

Where to customize?

Note: