SHINEY - Magento 2 Theme | Documentation

SHINEY - Getting Started

  • Created On: 14th October, 2016
  • Last Updated On: 14th October, 2016
  • By: Solwin Team
  • Email: info@solwininfotech.com

Introduction

Thank you for downloading Magento theme. This documentation consists of several parts and covers the entire process of installing and setting up Magento 2 theme starting from scratch.


SHINEY Theme files structure

The theme package you have downloaded consists of several folders. Let's see what each folder contains:

  • documentation
    contains documentation files.
    • index.html
      a main documentation file you are reading at the moment.
  • sources
    contains the theme source files.
    • demo
      contains shiney-demo-data.sql file and theme files.
      Quickstart
      contains full magento 2 set up and demo data .sql file
      demo-pages.zip
      contains all the demo cms pages .txt files
      demo-blocks.zip
      contains all the demo static blocks .txt files
  • theme-files
    contains shiney theme files data
    • shiney-theme.zip
      contains shiney theme files
    • shiney-theme-magento-2.1.x-patch.zip
      contains shiney theme patch files for magento 2.1.x.
  • shiney-demo.url
    redirect to shiney theme demo.

Prerequisite

Before you install Magento, you must check all of the following:

Apache

  • You must run Apache version 2.2 or 2.4.
  • In addition, the apache mod_rewrite module must be enabled. mod_rewrite enables the server to perform URL rewriting.

PHP

  • 5.6.x
  • 5.5.x, where x is 22 or greater
  • 7.0.2 up to 7.1.0, except for 7.0.5

Required PHP extensions:

  • PDO/MySQL
  • mbstring
  • mcrypt
  • mhash
  • SimpleXML
  • curl
  • xsl
  • gd, ImageMagick 6.3.7 (or later) or both
  • soap
  • intl
  • bc-math (Enterprice Edition Only)
  • openssl

MySQL

  • You must run MySQL version 5.6 or later

File Permission

The web server user must have write access to the following files and directories:

  • var
  • app/etc
  • pub

We recommend setting the permissions as follows:

  • All directories have 770 permissions.
  • 770 permissions give full control (that is, read/write/execute) to the owner and to the group and no permissions to anyone else.
  • All files have 660 permissions.
  • 660 permissions mean the owner and the group can read and write but other users have no permissions.

Quick Start Installation

In order to do quick start installation follow the steps.

  • Create a new empty database.

  • Open the theme package(shiney-multipurpose-responsive-magento-theme.zip) and go to the Theme Files folder.

  • Find shiney-demo-data.sql inside the theme package under sources/QuickStart/ folder and import it into your newly created database (using your database management tool such as phpMyAdmin or whatever you use).

    Note: This file must be imported before running the Magento Setup Wizard.

  • Upload Magento_2_1_1_quickstart.zip from Sources/QuickStart to the root directory of your domain using your favourite FTP client and unzip it.

  • Set correct file permissions for uploaded folders. File permissions depend on server settings. If you have any doubts about file permissions, please sent request to your hosting provider.

  • Navigate to your website (to the folder where you extracted Magento_2_1_0_quickstart.zip) in your favorite browser. If you followed all steps coorectly you will see the Magento Setup Wizard

  • Follow the installation instructions step by step just like in case of a standard Magento installation process. After all that you will get absolutely the same copy of the demo store

Demo Store Installation

In theme package we included sample data with settings of demo version.

In order to install exactly the same store as on demo version, follow the steps.

Note: In case you're installing theme on existing magento store please omit first 3 stpes and refer step 4

  • Step 1 Before magento installation create empty database using phpMyAdmin or similar tools

  • Step 2 Import sources/Demo/shiney-demo-data.sql into database that was created in previous step

  • Step 3 Install magento:

    • Go to magento download page choose the latest stable full release of the Magento Community Edition 2 and download it

    • Upload and unzip downloaded file with magento to the folder on your server where magento should be installed

    • Upload demo images to the root of your magento. Demo images your will find under sources/Demo/pub folder of your theme package

    • Open browser and proceed to the folder where magento was unzipped and load default Magento setup wizard

    • Follow the wizard's instructions and finish magento installation

  • Step 4 Navigate to theme-files in theme package and upload app folder on the magento root directory. And run below commands

    Set correct file permissions for uploaded folders. File permissions depend on server settings. If you have any doubts about file permissions, please sent request to your hosting provider.

    • For Linux:

      bin/magento setup:upgrade

      bin/magento indexer:reindex

      bin/magento setup:static-content:deploy

    • For Windows:

      php bin/magento setup:upgrade

      php bin/magento indexer:reindex

      php bin/magento setup:static-content:deploy

    • For more details click here

  • Step 5 Activate the theme: You don't need activate the theme in cases you've installed the shiney-demo-data.sql.

    To activate theme Click Here

Complete installation

The complete installation method can be used if you want to set up a Magento store using a sample content. We assume that you have completed all the preparation steps.

The installation process consists of 3 stages:

1. Creating a database.

2. Uploading all the required files to the server.

3. Installing a Magento Commerce engine together with the template you have purchased.

Let's get started!

Creating a database

First, you need to prepare a new database for your Magento store. You can create the new database using the database management tool from your hosting control panel (usually PhpMyAdmin).

The following data will be received while creating a database: database name, database username, password and your server name. You need to save this data as you will need it for further Magento installation.

With the phpMyAdmin tool you will be able to create a new database in 3 simple steps(check the screen shots below):

1. Open the "Database" tab, you will see the list of databases.

create database - image1


2. Input your database name. Click "Create" button.

create database - image2


3. Your database has appeared in the list. In order to enter the database, click on its name in the list.

create database - image3


If you have any issues with creating a database, please contact your hosting provider for help and assistance.

Magento Installation

When you are done with uploading files, you can start Magento engine installation process. Open your browser and in the address bar type your 'domain name/path to your Magento directory'. You should see the welcome screen. Please follow the instructions below to install Magento.

Step 1: Installation Assistant

Please read the license agreement and click the "Agree and Setup Magento" checkbox if you agree with the terms.

how to install - image1


Server Readiness Check

Click the "Start Readiness Check" button to check your server settings compatibility with the Magento 2 engine requirements.

how to install - image2


Step 2: Database connection

Here you need to input the database details and some initial settings. Add a Database – input your host name, database name, database user and password. Contact your hosting provider, if you don't have the necessary details.

Make sure you have a database created for the Magento installation. And also make sure it is clear, without any tables.

how to install - image4


Step 3: Web Configuration

Here you can change Magento admin panel URL and the main store address. Other settings you can leave unchanged.

Make a point of the admin panel path. Note it or insert your specific admin panel URL to remember the admin panel access.

how to install - image5

When the checking procedure is complete, click 'Next'. button.


Step 4: Localization

Select the required time zone, default currency and store language. In the Advanced Modules Configurations section you can also select default modules that should/shouldn't be installed. We recommend that you do not perform changes in this section.

how to install - image6

When the checking procedure is complete, click 'Next'. button.


Step 5: Create Admin Account

Here you need to input personal details for the store owner and administrator.

how to install - image7


Step 6: Install

The store configuration is done. Press the Install Now button to start the store installation process.

how to install - image8


Step 7: Success

This is the final installation step. Copy the generated encryption key and keep it safe.

how to install - image9

SHINEY theme installation

This theme is not compatible with Magento 1.x engine. It will work with the Magento 2.x engine only.

First of all, please make sure your Magento installation version meets the template requirements. If you are using an outdated Magento engine version, you need to upgrade it. Don't forget to make a backup of your store files and database. The detailed Magento update guide you will find on the site Magento Wiki.

If your Magento engine meets the template requirements, you can start the template installation.

1. Open the theme package(shiney-multipurpose-responsive-magento-theme.zip) and go to the Theme Files folder.

2. Extract "shiney-theme.zip" file and Upload the app & pub folder to the root Magento installation directory on your server. This folder includes the template files, that will not effect your existing files. If you are using Magento 2.1.x version then add the patch files.

3. Once done with uploading "app & pub" folder, you need to execute below command at magento root directory using command line

For Linux: bin/magento setup:upgrade

For Windows: php bin/magento setup:upgrade

For more details click here

Template configuration

We are going to review template configuration options based on the example. We will configure it the same way as our Live Demo template, without affecting products data.

Activate the new theme

1. (For 2.0.x) Open Magento admin panel and navigate to Stores > Configuration menu.

Theme set - image1


(For 2.1.x) Open Magento admin panel and navigate to Content > Design > Configuration menu.

Theme set - image1-1


2. (For 2.0.x) In the General menu select Design tab. Click Design Theme tab and in the Design Theme drop-down list select the required theme, then click Save Config button.

Theme set - image2


(For 2.1.x) Go to Edit.

Theme set - image2


(For 2.1.x) Select the template from dropdown. And click on 'Save Configuration'

Theme set - image2


Reindex data

1. To reindex data, Open System > Index Management

Theme set - image3


2. In the first column open the drop-down list and choose the "Select All" option.

Theme set - image4


3. In the top "Actions" selector choose "Update on save" option. It will allow automatically reindex the specified data after saving any settings in the admin panel.

Theme set - image5

Click "Submit" button.

Please be patient, this may take a while.



Reindex data using command line

In order to reindex data using command line, please execute below command at magento root directory

bin/magento indexer:reindex

For more details click here


Disable cache

In order to make the changes appear on your website with no delay, you need to disable cache. It prevents additional cache clearing actions after every change you make. You can enable it when you are done with store editing.

1. Open Magento admin panel and navigate to System > Cache Management menu.

Theme set - image6


2. In the first column open the drop-down list and choose the "Select All" option.

Theme set - image7


3. In the top "Refresh" field select "Disable" option.

Theme set - image8

4. Click "Submit" button.

Navigate to Theme Cpanel > Theme Settings

Save configuration once to save the default settings.

Import Static Blocks button import all the static blocks that comes with shiney theme. If you want to overwrite existing blocks than select Overwrite Existing Blocks to Yes and Save Config. Then after Click on Import Static Blocks button. Do same for import cms pages.

After import static blocks & pages, Click on Import Demo Data to import all demo data of extension that comes with shiney theme.

After import demo data, Import demo that you want to display on front side.

import block & pages

After Successfully import your demo, save Theme Settings and Design Settings and clear the Cache.

Logo configuration

For 2.0.x

Please follow these steps when setting up logo image included into the theme package (you can view it on the Live Demo page).

1. Open the Magento admin panel and select Stores > Configuration in the side menu.

Theme set - image9


2. Select the "General" tab.

Theme set - image10

3. In the "General" section, select the Design tab. Choose Header, and upload your logo.

4. Click "Save Config" button.

For 2.1.x

Open Magento admin panel and navigate to Content > Design > Configuration menu.

Theme set - image9-1


2. Expand the "header" tab.

Theme set - image10-1

3. In the "Header" section, click on 'Upload' button to upload your logo.

4. Click "Save Configuration" button.

Pages configuration

From the top menu select Content > Pages. Here you can find all the store pages. Home page, About Us and Privacy and Cookie Policy should already be available, so you don't need to add them. You only need to update the pages HTML and XML content. Open any of them in order to get the access to the content.

page settings - image2


To add Widget, Navigate to Content field click on Insert Widget.. button. It will open popup , from there select widget that you want to display on home page with widget options and click on Insert Widget button

add widget

Static blocks configuration

In the top menu navigate to Content > Blocks.

In the top right corner click the "Add New block" button to add a new static block.

static block - image1

Add Block title, identifier, select store view & add HTML code into the content area.

static block - image2

Click on Save Block button from upper right corner to save static block.

Design Settings

Open Magento admin panel and navigate to Theme Cpanel.

theme cpanel


Click on Theme Cpanel > Design Settings. Store owner can set different colors for different stores.

theme color


From Body Font Color, Store owner can set body text color.

font color


From Body Font Size, Store owner can set body font size.

font size


Set Main Wrapper & Content Background Color , Background image & style from Page Wrapper and Main Content Settings

page wrapper


Set Header Top, Header Search Block, Header Top Navigation Menu, Minicart block colors

header design


Set Footer Top, Footer Newsletter block, Footer Social Block, Footer Middle block, Footer Bottom Block(Copyright) etc

footer design


Add custom css for footer

footer custom css

Theme Settings

Set Theme layout: Full-width Layout, Box Layout and Maximum Width: 1170, 1280 (Default)

theme layout


Set Header type from 5 different header layout. show sharing addons, set home navigation link & text.

header type


Set static block home page content, Slider width(full or boxed), Set main title image, Sidebar static blocks etc.

homepage content blocks


Set Footer top, footer middle 1, footer middle 2 & footer bottom settings.

footer settings


Set Product list page settings like, show new & sale label, product block(3-block, 4-block) in a row, image width, show ratings, show add to compare & wishlist link etc

list page


Set Product view page settings like, show sharing addons, show related, upsell & cross sell products etc

view page


Set Contact page settings like, show google map, set store name, address, contact no., email etc

contact page


Show loader on home page or all pages with uploaded loader image

website loader


Import Static Blocks, Pages & Demo data that comes with a shiney theme

import block & pages

Homepage Configuration

How to change newsletter popup settings?


newsletter popup

Go to Theme Cpanel > Newsletter > Configuration

From that you can change newsletter settings like,

General Settings: Show/hide Newsletter Popup

Content Display Settings: Show/hide/change main title, change main title font color, text size etc, set custom message, show newsletter popup checkbox, show background image etc

Popup Box Settings: Popup box height & width, open & close effect, set delay time for popup appear, set cookie expiration time etc

Social Options: Show social icons with url like facebook, google plus, twitter, youtube, flicker, vimeo, pinterest, instagram, foursquare, tumblr, rss, email etc



How to edit homepage slider?

To edit homepage slider content, please go to Admin Theme Cpanel > Banner Slider > Manage Bannerslider and you can add/edit bannerslider as per your requirement.

You can also change bannerslider configuration from Theme Cpanel > Banner Slider > Configuration

home page banner


How to add advertising blocks on homepage?

To add advertisement static block on home page, Go to Content > Blocks. Edit Shiney Home Page Content static block.

advertisement insert widget

Go to Content field. Click on Insert Widget... button. Now select CMS Static Block from Widget Type*. Now click on Select Block... button and select your advertisement static block. Click on Insert Widget button.

It will add advertisement static block on home page like,

advertise block 1


How to add Latest Products widget on homepage?

Go to Content > Blocks. Edit Shiney Home Page Content static block.

Go to Content field. Click on Insert Widget... button. Now select Catalog Product List from Widget Type*. Set Title, Display Page Control, Number of Products to Display, Template, Cache Lifetime(seconds). Click on Insert Widget button.

latest products widget

It will add Latest Products widget on home page like,

latest products


How to add Featured Products widget on homepage?

Go to Content > Blocks. Edit Shiney Home Page Content static block.

Go to Content field. Click on Insert Widget... button. Now select Catalog Product List from Widget Type*. Set Title, Display Page Control, Number of Products to Display, Template, Cache Lifetime(seconds) & Conditions(Is Featured? to Yes). Click on Insert Widget button.

featured products widget

It will add Featured Products widget on home page like,

featured products


How to add Latest Blogs block on homepage?

To add Latest Blogs block on home page, Go to Content > Blocks. Edit Shiney Home Page Content static block.

our blog widget

Go to Content field. Click on Insert Widget... button. Now select CMS Static Block from Widget Type*. Now click on Select Block... button and select 'Shiney Home Blogs' static block. Click on Insert Widget button.

It will add latest post block on home page like,

latest post block


How to add Brands block on homepage?

To add brands block on home page, Go to Content > Blocks. Edit Shiney Home Page Content static block.

Go to Content field. Click on Insert Widget... button. Now select CMS Static Block from Widget Type*. Now click on Select Block... button and select 'Shiney Home Brands' static block. Click on Insert Widget button. (same as latest blogs block)

It will add brands in slider on home page like,

brands block


How to change/edit footer block settings


footer block

Go to Theme Cpanel > Theme Settings > Footer. There are four main section

Footer Top: Set newsletter block & social icons

Footer Links: Show About us link in footer

Footer - Middle 1: Set footer contact block, information block, instagram block & theme features block

Footer - Middle 2: Show footer services block like 100% Satisfaction, Free Shipping, 24x7 Helpline, Money Back Guarantee

Footer - Bottom: Show copyright text and payment logos from static block

Conclusion

Shiney is a fully responsive, creative, clean, beautiful and multipurpose Magento 2 theme with latest web design trends. It is multi-purpose professional theme for any ecommerce business like electronics, fashion, jewelery, furniture etc… with readymade layouts and color options.

The following resources will help you to become a true Magento professional:

Useful resources

Help and Support

Frequently Asked Questions

What can cause the problem:

  • - Magento cache (or external cache) was not flushed after installation of the theme.
  • - Compilation mode was not disabled before installation.
  • - Some of the theme files were not uploaded.
  • - You edited theme files and accidentally removed or changed something in the files.
  • - You have customized the theme by creating custom sub-theme and your modifications change/break the default behavior of the theme.
  • - Sometimes you have installed other theme and some elements are currently affecting the current theme.
Yes. You can easily change your theme color from Theme Cpanel > Design settings
This may be file permissions issue, or your Magento does not have access to images because of incorrect file permissions on your server. First, make sure that images were uploaded and if correct paths to those files are specified. You need to set correct file permissions for all images and folders (in most cases images are stored in pub/media directory).
Flush Magento cache in System > Cache Management, clear web browser cache/cookies for your store domain and refresh the page in your web browser.
Generally all extensions can work with all themes but sometimes they have to be integrated manually. That is because sometimes the extension and the theme override the same Magento template file so there can be a conflict.
You can completely disabled extensions from Store > Configuration > Advanced > Advanced

Massive Updates are Coming!

It's not the end. Here are some upcoming features of Shiney

  • - Improved Layered Navigation
  • - One Step Checkout
  • - More Config Option
  • - More Theme layout

Thanks for using Shiney Theme!

We would like to thank you for using our Shiney Magento 2 Theme! We are very pleased you have chosen Shiney for your next Magento store. If you have any difficulties with Shiney theme or need any additional service, do not hesitate to contact us. We provide 24/7 Support!

Regarding customization service based on our themes or other magento related, please contact us to support@solwininfotech.com. We have an amazing team to provide customization service who have done bunch of customization projects so far, will provide you reasonable quote before start.

customization

We are very happy to assist you!