Awwwards

Minelight is the first gem we have discovered in the MineThemes mine. It is the embodiment of a fresh, clean, minimalist Portfolio theme which can also be used as a multipurpose theme. You can use it for selling your products via the amazing WooCommerce, or for clean, simple, fashion-related, personal, or travel blogs. Minelight theme is packed with a bundle of powerful features and you can use it to present your portfolio in the most glorious way.

Server Requirements

Server requirements are of extreme importance in order to provide an undisturbed theme upload and import the demo data. It is very important to choose a good hosting provider if you want your website to be fast, safe and undisturbed. Below are configuration parameters which you should check prior to WordPress theme installation:

  • max_execution_time = 300 (900 if you are using GoDaddy)
  • max_input_time = 120
  • memory_limit = 128M
  • post_max_size = 15M
  • upload_max_filesize = 15M

There is a simple way to check these parameters:

  1. The php.ini file on your server contains this information, which is where you check first. If need be, you can edit this file. If you do not know how to do this, ask your hosting server provider to perform the configuration of these files instead of you.
  2. You can install and activate a plugin called Host PHP Info. After you activate it, you can find the PHP Info in Tools > PHP Info. After that, contact your server hosting provider to configure/modify this if need be.

WordPress Installation

WordPress is very simple to install and it will take you only a few minutes. You can install it via your hosting provider which provides you with simple installation tools.
We advise you dearly to do it by yourself, and here you can find a simple WordPress installation guide http://codex.WordPress.org/Installing_WordPress

Theme Installation

There are two ways of installing the theme:

  • Installation via WordPress
  • Installation via FTP client (traditional)

Installing the theme via WordPress:

Step 1 – Download the theme package (all files and documentation) from ThemeForest and extract it.
Step 2 – Log into your WordPress admin panel
Step 3 – Go to Appearances >Themes
Step 4 – Click Upload Theme
Step 5 – Upload the theme file called minelight.zip. The Theme package that you downloaded from ThemeForest is the Master file which includes the Theme File, Child Theme file, Documentation, and Sample Content. You have to extract them and upload only the file called minelight.zip.
Step 6 – Install and activate the theme

Common Issues while uploading the theme

  1. Broken theme and/or style sheets missing

While uploading the theme via WordPress, if an error that reads Broken theme and/or stylesheets missing appears, it does not mean that the theme you have purchased is broken. It simply means that it was uploaded incorrectly. Please make sure that you upload the right file which is called ‘minelight.zip’. This article from Envato explains how to fix this common issue.

  1. Are you sure you want to do this? – ERROR

While uploading the theme via WordPress, if the upload is unsuccessful and the error message reads ‘Are you sure you want to do this? Try Again’ – probably the file upload limit is lower than the theme’s file size. In order to solve this issue, please increase your file upload limit to around 10 MB, or upload the theme via FTP and install it.

How to install the theme via FTP:

Step 1 – Log into your Hosting server using FTP service like Filezilla
Step 2 – Unzip the file called minelight.zip in your theme’s buyer’s package
Step 3 – Upload only the Extracted folder called ‘minelight’ to the folder wp-content/themes
Step 4 – Go to your WordPress Dashboard to activate the theme in Appearances >Themes
Step 5 – Click the ‘Activate’ button under the theme’s name

Installing the Required Plugins

After you install and activate our theme, you are going to have to install the required and recommended plugins.

Just click the link to start installing the plugins.

Next, check the boxes to select all the plugins you wish to install, select the install bulk action from the dropdown box and then click the Apply button.

Select the plugins you have installed, and then apply the bulk action to activate them.

Finally, a confirmation notification will appear and inform you that your plugins are activated.

Mandatory plugins:

Minelight Custom Post Types

In order for your theme to work without obstructions, you are going to have to install the plugin called Minelight Custom Post Types. It will enable you to use the full potential of this wonderful portfolio theme.

Additional plugins:

Minelight Shortcodes

If you want to use the shortcodes we have created for you, you are going to have to install the Minelight Shortcodes plugin.

Please proceed to the forthcoming special instruction on how to install WooCommerce and the Revolution slider:

Importing Demo Data

There are two roads to go when you have installed the Minelight theme. First is to start building your site from scratch, and second is to import one of our demo sites which can serve as a starting point for your site. Of course, you can simply modify the Demo according to your liking.

We will now explain how to import Minelight Demo data.

Minelight comes with a one-click import module. You need to do the following so as to import one of our demo sites:

  1. Log into WordPress admin
  2. Go to admin panel > Select Options > Select Import
  3. Choose the demo site that you would like to import from the “Demo Site” dropdown menu
  4. Choose what type of content you wish to import from the “Import Type” dropdown menu on the right:

All – here you import the pages, their content, widgets, and settings. We recommend this to users who want to import a demo site exactly as it appears on our live demo.

Content – this option imports only the pages and their content. We recommend this to users who want to see how we have created our page layouts, but who also want to retain their own settings in Select Options.

Widgets – imports only widgets. We recommend this to users who want to supply the theme’s widget areas with the widgets from their chosen demo only. Nothing else will be imported (no other content).

Options – this imports settings in Select Options only. We recommend this to users who want to get the same look and feel of their preferred demo site, but do not want to import any other content.

Customizer settings – you need to import identical Customizer settings in order to get the same appearance as in the Demo.

Slider RevolutionIf you want to import the Revolution Slider / demo slider, you are going to have to locate the ‘xml export’ folder in the previously downloaded package from ThemeForest. Inside the folder, you will find the RevolutionSliderr_Export.zip file. After you have found it, go to the Revolution Slider from the WordPress admin panel and upload this file in the Import section.

If you want to import media files as well (images, videos, sounds), you need to check the “Import attachments” checkbox.

Mind you that the images we have used are copyrighted, and if you want to publish them on your site as well, you are going to have to buy them separately. We have bought the majority of them on ShutterStock.

  1. Click the “Import” button and wait for the import process to end.

If you want to import media files as well (images, videos, sounds), you need to check the “Import attachments” checkbox.

Mind you that the images we have used are copyrighted, and if you want to publish them on your site as well, you are going to have to buy them separately. We have bought the majority of them on ShutterStock.

  1. Click the “Import” button and wait for the import process to end.

First Steps upon Theme Activation

Minelight theme uses the latest post reading settings. Naturally, you can set the theme to display the desired static page instead of posts, but you are also going to have to create the posts page.

Setting the theme’s reading settings – Latest Posts landing page

Log into WordPress admin panel, and go to Settings > Reading. Set the Front page display option to your latest posts. Click the Save Changes button to apply the changes.

Setting the theme’s reading settings – Static Page landing page

Log into WordPress admin panel and go to Pages > Add New. Create a new page – enter title (e.g. Home). Click the Publish button to create the page. Now create another new page (e.g. Blog), with the Default page template in the same way.
After that, go to Settings > Reading and set the theme to display a static page. Then, select the previously created pages – select your desired page (e.g. Home) as your front page, and select your page with the Default page template (e.g. Blog) as your Posts page. The latter page will display all blog posts.

Click the Save changes button and apply the changes.

Another important thing to do is to set your permalinks. We strongly suggest to use nice-looking permalinks (with the title of the post, rather than generic). In order to do this, go to Settings > Permalinks and select Post name.

Customizer

Working in the Customizer is great because you can see the changes applied while making them.

Ever since the WordPress 3.4 version appeared, developers can use the Customizer to make changes and add controls in the Appearance > Customize admin screen. The Theme Customizer allow you to change the theme’s settings, such as color scheme, widgets, etc. and preview them in real time.

Minelight Customizer has two important settings: General Customizer settings and Minelight Settings for fine tuning of your theme.

 

GENERAL SETTINGS

1. Minelight Settings for fine tuning of your theme.

1-customizer-minelight-settings

1.1 Logo

  1. Upload Logo: Here you can upload your site logo from your computer.
  2. Upload Sticky Logo: You can upload a small logo image for the sticky header.

1.2 Home Page Slider

  1. Display Revolution Slider on Home Page? – Tick this box if you want Revolution Slider on Home Page
  2. Choose Revolution Slider on display: Select which revolution slider to display
  3. Display Revolution Slider in fullwidth? – Tick this box if you want Revolution Slider in full width
  4. Display Menu Nav on top of slider? – Tick this box if you want Navigation menu on top of the slider

1.3 Portfolio Layout

  1. Choose Portfolio Layout: Select Masonry or Grid type
  2. Columns: Choose number of columns (Two or Three)
  3. Spacing between columns: Tick this box if you want spacing between columns
  4. Post Per Page: Tyle the number of posts you want to be visible on the page.

1.4 Portfolio Settings

  1. Choose Paging Type: Select if you want an infinite load or pagination
  2. Choose Hover Type: Select type of the hover for the portfolio items
  3. Display paging on Portfolio single page: Tick this box if you want to show paging on the Portfolio Single page
  4. Display sharing icons on Portfolio single page: Tick this box if you want to sharing icons on Portfolio single page
  5. Upload Header Image: Select or upload Header image
  6. Custom header image height: Enter the height of custom Header image
  7. Enable parallax effect on header image: Tick this box if you want parallax effect on header image
  8. Header image behind the title: Tick this box if you want header image behind the title
  9. Upload footer image: Upload or select Footer image
  10. Custom footer image height: Enter the height of custom Footer image
  11. Enable parallax effect on footer image: Tick this box if you want parallax effect on Footer image

1.5 Social Links

  1. Paste links to your social network Facebook page
  2. Paste links to your social network Twitter page
  3. Paste links to your social network Instagram page
  4. Paste links to your social network Vimeo page
  5. Paste links to your social network Pinterest page
  6. Paste links to your social network LinkedIn page

1.6 Theme Colors

  1. Body Bg color: Changes color of background on the content area.
  2. Navigation Bar (Sticky menu) color: Background color of navigation bar (sticky menu)
  3. Navigation links color: Color for menu items text
  4. p, body text color: Body and paragraph text color
  5. Headings color: Text color of headings
  6. Links color: Text color of links
  7. Buttons color
  8. Categories filter / Mega menu color: Background color of categories filter and mega menu
  9. Mega menu links Color: Text color of links in mega menu
  10. Social icons Color:  Color of icons in social navigation
  11. Mini cart Color: Color of mini car icon

1.7 Navigation settings

  1. Display sticky navigation: Tick this box if you want navigation to be visible when you scroll down the page
  2. Display mega menu navigation: Tick this box if you want mega menu navigation

1.8 Contact Settings

  1. Contact Email address: Enter Email address where you want to receive messages from form on the Contact page
  2. Map X coordinate: Enter X coordinate
  3. Map Y coordinate: Enter Y coordinate
  4. Map zoom factor: Choose Zoom level of the map
  5. Map marker title: Enter text which you want to be shown with marker on the map
  6. Upload Marker Icon: Select or upload Marker icon for map (115x60px recommended)
  7. Map Color: Pick the overlay color of the map

1.9 Fonts

  1. Choose headings font: Select font for headings
  2. Choose paragraph font: Select font for paragraphs
  3. Choose subtitle font: Select font for subtitles

1.10 Blog Settings

  1. Display post date on single post: Tick this box if you want to show date on single post page
  2. Upload header image: Select or upload header image for blog
  3. Custom header image height: Enter custom header image height for blog
  4. Enable Parallax effect on header image: Tick this box for parallax effect on blog header
  5. Header image behind the title: Tick this box if you want header image behind the title on blog
  6. Upload footer image: Select or upload footer image for blog
  7. Custom footer image height: Enter custom footer image height for blog
  8. Enable Parallax effect on footer image: Tick this box for parallax effect on blog footer
  9. Display related posts on single post: Tick this box if you want related posts to be shown on single blog post page

1.11 Google Analytics

  1. Enter Google Analytics Code: Paste here your Tracking ID. Here is instructions how to obtain tracking ID

1.12 Sidebar Settings

  1. Display Archives sidebar: Tick this box if you want Archives sidebar
  2. Display Page sidebar: Tick this box if you want page sidebar
  3. Display Posts sidebar: Tick this box if you want Posts sidebar
  4. Display Shop sidebar: Tick this box if you want Shop sidebar
  5. Choose Shop Sidebar: Select if you want sidebar on shop page to be positioned left or right

1.13 WooCommerce settings

  1. Display cart at the header bar: Tick this box if you want cart icon at the header bar
  2. Number of product to display on Shop page: Enter the number of the products to display on shop page
  3. Shop subtitle: Type in subtitle of the shop
  4. Choose shop layout: Select two or three columns
  5. Upload header image: Select or upload header image for the shop page
  6. Custom header image height: Enter custom header image height for shop page
  7. Enable Parallax effect on header image: Tick this box for parallax effect on shop header
  8. Header image behind the title: Tick this box if you want header image behind the title on shop page
  9. Upload footer image: Select or upload footer image for shop
  10. Custom footer image height: Enter custom footer image height for shop page
  11. Enable Parallax effect on footer image: Tick this box for parallax effect at the shop footer
  12. Display Related Products on single product page: Tick this box if you want related products to be shown on single product page

1.14 Animate settings

  1. Do you want to enable animation: Tick this box if you want to enable animations
  2. Choose Portfolio Layout: Select the effect of portfolio
  3. Duration: Enter the duration of the effect
  4. Delay: Enter the delay of the effect (0 for no delay)

1.15 Preloader settings

  1. Do you want to enable preloader: Tick this box if you want to enable preloader while page is loading
  2. Show preloader on all pages: Tick this box if you want to enable preloader on all pages

1.16 Footer settings

  1. Enable Footer Social Icons: Tick this box if you want Social icons to be shown in footer
  2. Copyright text: Type in copyright text

1.17 Custom CSS

  1. CSS code: Here you can write your custom CSS code

1.18 Custom JS

  1. JS Code: Here you can write your custom JS code

1.19 Light gallery

  1. Do you want to enable light gallery: Tick this box if you want to enable light gallery

2. Site identity

  1. Site Title: Write the title of your site
  2. TagLine: Place for you punchline
  3. Site icon: Upload your favicon

3. Menus

  1. Menu Locations: Select which menu you would like to use.
  2. Menu 1: Edit selected menu
  3. Add a Menu: Create a new menu

4. Widgets

There are no widget areas currently rendered in the preview. 

5. Static Front Page

  1. Front page displays: Choose if you want Front page to be dynamic with your latest posts or you want a static page
  2. Front page: Select which page you want to be Front page
  3. Posts Page: Select which page is your Blog page

WooCommerce

Minelight is integrated with WooCommerce, which means that you can easily create an online shop. For more information about installing and configuring WooCommerce, please visit this page:

http://docs.woothemes.com/documentation/plugins/woocommerce/getting-started/

In order to setup WooCommerce with the Minelight theme, please follow these steps:

  1. Go to Plugins > Add New in the admin panel.
  1. Type “WooCommerce” in the search field.
  2. After “WooCommerce – excelling eCommerce” appears in the search results, click “Install Now”.
  1. After the installation is done, click “Activate Plugin”.
  2. You will now see a notification saying “Welcome to WooCommerce – You’re almost ready to start selling :)”. If you plan to import demo content, click “Skip Setup”. Otherwise, click “Install Pages”.
  3. If you plan to import demo content, you should set the product image sizes first in order to achieve the same look as on our demo sites. Go to WooCommerce > Settings and click the “Products” tab. In the section “Product Image Sizes”, enter the same values as ours:

Note: If you want to modify these sizes later, you may need to regenerate thumbnails in order for it to take effect. You can do this with the following plugin: http://wordpress.org/plugins/regenerate-thumbnails/

Slider Revolution

How to import the Slider Revolution:

In order to import the Revolution Slider, go to Revolution Slider > Import Slider and then select the slider’s demo files in the folder Example_Data:

How to use Slider Revolution?

This theme comes with a Revolution Slider premium license. In order to understand how the slider works and how to work with it, you should read its documentation http://revolution.themepunch.com/documentation/

Widgets

Widgets serve the purpose of adding content and features to the sidebar and footer. Default WordPress widgets and custom widgets are combined with the theme. You can add/remove them easily. First, log into your WordPress admin panel and go to Appearance > Widgets.

  1. Choose the preferred widget and drag it into the sidebar on the right. After you refresh the page, your widgets will be active.
  2. Widget is an area in which you can place the preferred widgets.
  3. Widgets in widget areas can be added, removed or customized by clicking on the arrow icon in the top right corner of the widget box to expand it. Drag the widgets up and down to change their order of appearance.

Custom widget

Minelight – Instagram Feed

This widget enables you to show your Instagram profile in a simple way.

Posts

There are five different post formats in the Minelight theme: Standard, Image, Video, Quote and Link (see image below).

  1. Post title: This field serves to type the name of your post which is displayed in the front end.
  2. Post content: This is where you write/paste the content of your post – text, images, shortcodes, etc.
  3. Publish: This option implies assigning a status to your post – draft, in review or published – with the additional option of customizing its date and time of publication. Visibility is also an option – your post can be visible only to you (private) until you decide to publish it.
  4. Sidebar: You can choose left or right sidebar option or without sidebar.
  5. Post formats: Different post formats will display content in a different way. There are five formats you can choose for your post:
  • Standard
  • Image
  • Video
  • Quote
  • Link

Post formats:

Standard post format

This is the usual post format (most commonly used). Featured image will be displayed above the title and post content in this post format.

Video post format

This post format enables you to add video content into your post. When you select Video format, Additional Video options will appear in the editor area – so you can paste the URL of your video (e.g. YouTube, Vimeo, DailyMotion) and your video will be shown above the post title and content.

videolink

Quote post format

As the name suggests, this post format allows you to display someone’s words as quotations. When you select the Quote post format, two fields will appear in the editor: one for the quoted text, and the other for the author of the quotation. After you publish the post (in the front end), featured image of the post will be shown above the quoted text and its author, on a black background so that the quotation and image look like a poster.

Link post format

Your posts can display links to other places on the Internet – in a cool way. When you select the Link post format, two fields will appear in the editor part: link text and URL. When you publish the linked post, featured image will be shown above the post title and the linked text on a white background.

  1. Category: WordPress posts need to be categorized. Assigning categories means better navigation and grouping with other posts that fall under the same or similar content category.
  2. Tags: Tags are words that allow you to organize posts by similarity of their content.
  3. Set featured image: The image you set as featured will be displayed as a cover image in the front end of the page/post.
  4. Excerpts: Excerpt is a summary of your content. It can be auto-generated or created by you. Learn more about summaries here http://www.wpbeginner.com/glossary/excerpt/
  5. Discussions: Your posts will probably drive engagement, i.e. people are going to post comments on them, which you can disable or enable by navigating to Settings > Discussions, and this setting will override with the global setting on the site.
  6. Comments: There is also the option of adding comments to the post which you can assign to different authors as well.

Pages

Site Pages are different from Posts. Page content is more stable and is not chronological as in Posts.

By Pages we mean pages such as About Me or Contact.

How to create a new page:

Step 1: Go to Pages > Add new and enter your page information

You can add your page content to the WYSIWYG editor

Step 2: Choose template

When creating a new page, you need to choose an appropriate template for it. To do this, visit your page from the back end (or create a new page in Pages > Add new), and find the “Page Attributes” section on the right. Minelight offers a lot of page templates:

  • Default Template – Select the Default template if you want to create a standard page with your content inside the grid.
  • Blog
  • Contact
  • Full Width Template
  • Portfolio

Once you choose a template, we can now head to custom fields for pages, which are the following:

  1. Post title: This is the name of your post which is displayed in the front end.
  2. Post content: This is the content of your post, be it text, image, shortcodes etc.
  3. Publish: This option allows you to bring your content to the front, i.e. publish it and let it go live. This option implies assigning a status to your post – draft, in review or published – with the additional option of customizing its date and time of publication.
  4. Sidebar: You can choose left or right sidebar option or without sidebar.
  5. Page attributes: In this section, you choose the parent page and a preferred template.
  6. Subtitle: This section holds the Title which is shown on the top of the page.
  7. Header Image: If you want to decorate your Header with an image, you can upload it in this section.
  8. You can select Custom height of your Header image.
  9. Choose whether or not you want it with a parallax effect.
  10. Choose the position of the image (e.g. image behind the Title)
  11. Footer Image: If you want to decorate your Footer with an image, you can upload it in this section.
  12. You can select Custom height of your Footer image.
  13. Choose whether or not you want it with a parallax effect.
  14. Choose the position of the image (e.g. image behind the Title)
  15. Page Share: Choose whether or not you want to display your social media icons.

Search Engine Optimization (SEO)

Even though all our themes are optimized for search engines (SEO) by having H1, H2, H3, H4, H5 tags, clean code, and are in HTML5, you are still going to need improve your website with a few SEO plugins and Google Pagespeed Service:

  • Yoast SEO plugin
  • Google Pagespeed Service
  • Smush.it (image optimization)

Translation/Localization

Minelight theme can be translated into your preferred or native language (this is also called localization).

It contains a language file ending with .pot (in theme-name/languages/theme-name.pot ), and here you can translate the theme to your preferred language. This file basically enlists all the text lines in the theme in the English language.

Here is how you can translate your theme easily:

Via Poedit

One of the most commonly used programs for translation/localization of themes is Poedit. You can download it for free via http://poedit.net/ .

After you have installed it, start the program and select File > New Catalog from POT file. Next, go to /includes/lang/ or /languages/ folder in your theme and select the .pot file you want to translate.

Make sure that you translate each line of the code into your preferred language, and save the catalog with your language code (e.g. ed_ES.po). Poedit usually creates the .mo file automatically and saves it, too.

And finally, upload the translated files into your theme’s language folder via FTP.

Tell WordPress which language file to use

If you did not use a language other than English (default) in WordPress so far, you are going to have to inform WordPress about activating the theme translation and using it in a different language.

How? By editing the wp-config.php file (located in the main directory of your WordPress files) and defining the WPLANG constant. Now set your language code, e.g. es_ES for Spanish translation. You can do this by adding a line below wp-config.php or (if existing) edit it into:

define (‘WPLANG’, ‘es_ES’);

How to Update the Theme

Method 1:

Having Minelight in any other version higher than 1.0 means that your update is just a few clicks away.

Step 1: Go to ThemeForest, click on the Downloads tab in your account and download the purchase code.

Step 2: When in Dashboard, go to Appearance > Themes and click on the Minelight thumbnail to update the theme.

wp-update

Method 2:

If you have a version of MineLight which is lower than 1.0, one click update will not be available for you. You are going to have to update the theme manually, by following these two simple steps:

Step 1: Log into your ThemeForest account, go to Downloads section and download the newest version of the theme.

Step 2: Unzip the “minelight.zip” file and extract the theme package. After that, connect with your server via FTP and go to the wp-content/themes in the WordPress installation, and replace the existing folder called “Minelight” with the unzipped folder.

Piece of cake!

Image dimensions

All images in your freshly bought Minelight theme need to have the following dimensions:
Blog – 800px by 800px,
Author thumb –  100px by 100px;
Portfolio-grid Thumbnail – 900px by 675px;
Portfolio-slide Thumbnail – 595px by 335px;
Single Portfolio – 826px wide;
Product image – 680px by 680px.
Shop – On your Dashboard, navigate to WooCommerce > Settings > Products > Product Image Sizes and set up the size for thumbnail and Single Product Images. Note that after you alter the Image sizes, be sure to Regenerate the thumbnails (using Plugin) so that the images get re-cropped to the right dimension.

MineThemes Clouds