Mill v2.0
WordPress Theme Documentation

Mill is a premium e-commerce WordPress theme, powered by WooCommerce. Beautifully designed and multi-purpose with 9 unique skins demonstrating the flexibility of Mill.

This documentation covers everything you need to get up and running, from WordPress installation to theme configuration. If you still have questions after reading this, do join us at our support forum where we'll be happy to help.

Getting Started

The .ZIP you have downloaded from either Eski or ThemeForest contains everything you need (plus more) to get started with the theme. Most importantly the .ZIP contains the theme itself (Zipped and Unzipped), but it also includes other goodies such as the original PSD created during the design process, this documentation, the licence file and some sample dummy data to get the ball rolling.

.ZIP Contents & Folder Structure

In the .ZIP you will see the following folders:

Theme Requirements

As this theme runs on WordPress, all of this themes requirements are defined by WordPress themselves. We have added nothing to the mix, if your server can run WordPress, then it can also run this theme.

WordPress requires a web server that supports PHP and MySQL. There are many different versions of PHP and MySQL, and there are also many versions of WordPress too, each with their own unique requirements. For that reason we always recommend using the very latest version of WordPress. Doing so will give you a much smoother experience. WordPress is constantly evolving and improving, using an old version just doesn't make sense.

Installation & Setup

Installing WordPress

Before you can install the Mill theme you need to set WordPress up on your web server and do some basic configuration. Mill theme then sits within WordPress to add the extra functionality and style. Installing and setting up WordPress is beyond the scope of this documentation, but you can find an in-depth guide here.

Installing Mill

If you have managed to get WordPress up and running, you will do fine with this next section as some of the steps you did to get WordPress installed will help you here too.

There are three main methods to get a WordPress theme installed:

Method 1 — Envato Automatic Installation

Possibly the easiest method for downloading, installing and updating the Mill theme is with the Envato marketplace Toolkit Plugin.

This handy plugin developed by the team at Envato (ThemeForest) interfaces with your Envato marketplace account, and displays a list of supported products you have purchased that can be installed directly from within WordPress. Furthermore it also supports updates and backups. Whenever a theme is updated you will be informed (similar to the way WordPress informs you of plugin updates), you can then choose to update at a time that suits you.

We have included the plugin within Mill as one of our suggested plugins.

  1. From within the WordPress Admin, click on Appearance and then Install Plugins
  2. Find and hover over 'Envato Toolkit' in the list, then click Install
  3. The plugin will then be installed. You can then click Return to Required Plugins Installer to activate the plugin.
  4. On the left hand menu, you should now see an Envato Toolkit item. Click on this to continue.
  5. To establish an Envato marketplace API connection navigate to the 'Envato Toolkit' page and insert your marketplace username and secret API key in the designated input fields. To obtain your API Key, visit your 'Settings' page on any of the Envato marketplaces.
  6. Once the API connection has been established you will see a list of themes within your account that can be auto installed.
  7. Find the theme you wish to install (hopefully this one) and the on screen instructions will guide you through the rest.

Method 2 — Upload Tool

WordPress comes with a built in tool to help you install themes and plugins. You simply upload a .ZIP file to WordPress, and the rest is taken care of.

  1. Login to your WordPress admin environment.
  2. Click on Themes under the Appearance menu.
  3. In the tabs at the top of the page, click Install Themes.
  4. Just under the tabs there is a row of links, click on Upload.
  5. Using the file selection box, navigate to the folder where you extracted the contents of the .ZIP you downloaded from ThemeForest. Within this folder, click into /Theme/ and select mill.zip, then click Install Now.
  6. WordPress will now upload mill.zip, extract it and add it to the correct folder.

The theme is now installed, all that needs to be done now is to make it active. Within the WordPress admin, browse through to the Themes page under Appearance and activate Mill.

This upload method can behave differently depending on the server environment and the security protocols being enforced on the web server. If you encounter problems with Method 2, move onto Method 3

Method 3 — FTP Upload

Method 3 requires the use of an FTP client to connect directly to the Web Server and upload the theme files manually. You will need to acquire the FTP details from your Web Host provider.

Once you have your FTP details you will need an FTP client to help you connect to the web server and transfer the files. FileZilla is a free FTP tool and has been my personal choice for many years. Once you have both your FTP details and an FTP client, continue with the instructions below.

  1. Connect to you Web Server using the FTP details your host provided you with.
  2. Browse to the WordPress installation you wish to install this theme into.
  3. Within /wp-content/ click through to /themes/
  4. Unzip mill.zip to an easy to access destination on your computer (The desktop is usually a good location)
  5. Upload the whole /mill/ folder into the /themes/ folder using the FTP client.

The theme is now installed, all that needs to be done now is to make it active. Within the WordPress admin, browse through to the Themes page under Appearance and activate Mill.

File & Folder Permissions

Upon installation of Mill, there is one final step you will need to complete in order to get the most power out of Mill. In order for Mill to work properly, it needs access to certain files so that it can perform certain tasks. When customizing the colors of Mill, specifically when saving your config, it creates/updates a file which is then included within your site. In order for Mill to update this file, it needs the correct permissions. You will need to log in via FTP to do this.

Once logged in to your website's FTP, you will need to locate your WordPress install. From there, navigate to the following folder path: /wp-content/themes/mill/assets/wp-customizer/. This is the folder we need to update. Right clicking this folder should present an option allowing you to change its permissions. You need to change the permissions to 775, then click OK.

What the file permissions window could look like

Multisite Setup

If you are using a WordPress multisite configuration, Mill will make a unique stylesheet for each site within the network. These exported follow a naming convention: override-<theme_name>-<blog_id>.css.

Child Theme

Mill comes packaged with a child theme so you can develop on top of Mill as a base whilst retaining the ability to update the parent theme without fear of having your changes overwritten. Even if you don't plan on making any development changes to Mill, we still recommend you activate the child theme instead of the parent.

As standard, the child theme will look and function no differently than if you had the parent theme active.

To use the child theme, it's really easy. All you need to do is upload both themes, the main/parent theme (Mill) and the child theme (Mill-child) and activate Mill-child, not Mill. The child theme then inherits all styles and functionality from its parent.

WordPress stores certain themes settings in a safe way so they don't conflict with settings from other themes, old or new. As a child theme is technically a new theme, these certain settings won't be transfered over if you switch between parent and child themes. This is another reason why we suggest using the child theme from the start, as changing down the line could cause unnecessary problems and require you to reconfigure certain settings.

For a more in-depth read into child themes, WordPress has a much more substantial write up on the topic that explains how they work and some best practices when developing within them.

Configuring Theme Options

Suggested Plugins

Within Mill we have included a selection of suggested plugins. None of these are required for the theme to function, but they all add an extra level of functionality that you might wish to make use of. Two of these plugins are premium plugins, which would cost $30 to buy, but we have included them for you to use absolutely free of charge.

To see and install the suggested plugins:

Global Settings

Once the Mill theme is activated, a new item will appear under the Appearance menu labelled Theme Options. Click this to access some of the configurable options. Simply browse around the sections and familiarise yourself with the options, tweaking them to your preferences.

Pay particular attention to Page for Search, Page for 404 and Page for Projects. These three options need to be configured, they each require a unique page being made and assigned. These pages will then allow you to control the content and page layout for the search results, 404 and project archive pages, just like you would any other page.

Colors & Styling

The theme customizer is probably the most powerful feature of mill and really enables you to add your own creative flare to your website. To change the colors, you need to browse through to the Themes page under Appearance within the WordPress admin area.

Once there, and providing that the Mill parent or child theme is active, within the Current Theme section you will see a Customize link. Clicking this will take you to a new page with a sidebar on the left and a preview of the site on the right. Within the sidebar are many sections, each one dedicated to controlling a section of the site.

Browse through the sections, you should see several color pickers and drop downs. Changing these values with update the preview on the right in real time. We suggest you jump in and start tinkering with things, it's really quite fun!

Skins

Mill comes packaged with 9 skins that work in tandem with the theme customizer. Esentially what the skins do is update the customizers default values to those within the selected skin. The skin is changed via the admin page. Simply select a new skin, click save, and then reload your site to see the skin in action. The skins can be used as is, or be used as a starting point which you can then build on top of.

In the process of changing skins all the new skin settings will override any settings already made within the customizer. Any custom CSS added within the Theme Options page will not be overwritten.

Example .XML Data

Mill comes packaged with several .XML files that contain example data for various sections of your site. These are designed to give you a quick boost of content when setting your site up. The content will also help those who learn by doing instead of reading.

To import the data, login to the WordPress admin and navigation to Tools > Import. From here you will be given a list of content types to import. Select the bottom in the list, labelled 'WordPress'. This will install the "WordPress Importer" plugin. Click Activate Plugin & Run Importer to get started.

On the next screen, click Choose File and select one of the .XML files that was contained within the Mill .ZIP. Then click Upload file and import. WordPress will then give you some basic options on how you want to setup the data, once done press Submit and the data will be imported.

Simply repeat this process for the other files if you wish. All data is optional, if you only want to see how the pages work, then you only need to import page.xml

Tools > Import

Basic Configuration

One of the first things you might want to do after setting up WordPress is to configure what page is your home page. By default WordPress displays your blog posts on the home page. If you want to have a static home page and choose to display your blogs elsewhere, enter the WordPress admin and click on Settings then Reading

Once on this page, at the very top is the controls to pick your home page. As mentioned above, by default "Your latest posts" will be selected. Changing to "A static page" will then enable you to pick a new home page.

If you imported the sample .XML page data, then these lists should already be populated with page titles. Select whichever page you would like to be your home page, and because we no longer have a defined section to show our blog posts, we should set up a page for this too.

Settings > Reading

Navigation & Menus

Mill offers two menu locations:

To make use of these theme locations, you first need to create a menu and add some links to it using the on screen interface. You can then assign your new menu to one of these theme locations. Upon first installation of Mill you should setup a minimum of two menus, one for each location and assign them. You can create additional menus for use elsewhere around the site such as in sidebar widgets.

TIP - It's a good idea if you plan on making any significant changes to an already active menu, or are making changes that will only be in place temporarily, to make a brand new menu, set it up as needed, then simply switch the menu location to that of the new menu. Then, if you need to revert back it can be done instantly by switching back to the old menu.

Configuring Page Options

Each page can have its options independently configured enabling you to have complete control over how each and every page looks and feels. This gives you the power to break out of the traditional template structure other themes can use, where you have a small number of strict templates.

Breadcrumbs

Whilst the breadcrumbs are a very useful tool for navigating around a website, the majority of the time you would want these enabled. You can however turn them off on certain pages if you wish. Within the "Breadcrumbs" panel is a select box enabling you to disable them. By default they are enabled.

Sidebar

In the "Sidebar" panel are several select boxes enabling you if the sidebar is enabled, which one you would like to load and on which side (right or left).

Title Bar

By default the Title bar is disabled. You can enable it within the "Titlebar" panel. There are two titlebar templates to choose from. The default which contains a primary and secondary page title, or the slider template which allows you to insert a full width slider at the top of a page. If you pick the slider template, then you can use the text box below to insert the shortcode of the slider you want to display. If you pick the default template then you can choose to enable the secondary title, define what the secondary title is and how you want the text to be aligned (right, left or center).

Output Scripts

You can output page specific scripts into either the head or footer of your site. Certain pages might require very specific functionality, such as tracking codes. Simply paste the whole script (including the opening and closing <script> tags) into the applicable textarea and they will be output only on that specific page.

Configuring Post Options

Posts are what make up your blog. You can organise and categories each post into sections and give each post post format to further enhance the content for the visitor.

Post Formats

When adding or editing a post, you can choose its post format from the 'Format' panel (usually found in the right column near the top). There are several formats to choose from. By picking the most relevant post format to the content you are posting, you can tailor the way the content gets displayed on the front end. For example, selecting the 'Video' post format will tell Mill to show the video content you are posting about more prominently.

Selecting certain post format will cause additional option panels to display. These additional panels contain input boxes specific to the current post format selected.

Configuring Portfolio Options

Before you jump in and start using the portfolio, first make sure that you have correctly configured the Page for Projects option within the Theme Options. This page is then used to control the layout options for the portfolio archive page, just like you can do on any other page.

The portfolio inherits some functionality from the page configuration options mentioned above, these inherited sections are: Breadcrumbs, Sidebar and Title Bar. For instructions on these options, please consult the section above.

The Portfolio does have some extra tricks up it's sleeve, you can find details on these below.

To setup the slider that appears on a single project page, simply follow these instructions:

If you add more than one [gallery] to a page, all the images accross all galleries will be merged together to create the slider.

Testimonial

Each portfolio project can have a unique testimonial attached to it. From the "Testimonial" panel you can first choose to enable or disable this. You can also fill out the Author and Role of the testimonial author along with the main copy of the testimonial, what the author actually said.

Project Details

The "Project Details" panel allows you to add various extra details to a project. Data such as a URL for the project, the clients name and a URL for the client. There is also the option to enable or disable the project details section all together.

Other Projects

The "Other Projects" panel allows you to display an area dedicated to other portfolio pieces, allows your visitors a convenient way to browse around your site. You can choose the order in which these projects appear, how many and in how many columns to arrange them.

Shortcodes

Mill has very few shortcodes directly within it. The vast majority of shortcodes that we use throughout our demo are stored with the entirely optional eski-Shortcodes plugin (included within the theme). This plugin contains a lot of shortcodes that are useful for all wordpress theme, not just eski produced themes. There are however some shortcodes that are very specific to eski and our products. These shortcodes are stored direct within the theme instead.

Band

The [band] shortcode can only be used with the "Page with bands" page template. This specific template is unable to have a sidebar attached to it as this directly conflicts with the nature of bands. The [band] shortcode is used to split a page into multiple sections allowing you to create a very popular style of page in modern web design. Each band can have a unique background colour or image, useful for creating feature sections or to draw attention to certain areas.

[band background_image="#" parallax="yes"]
[blog]
[/band]
id
string
class
string
parallax
yes, no
background_image
URL to image resource
background_color
Valid CSS colour reference (#F2F2F2)
padding_top
Valid CSS measurement (1px)
padding_bottom
Valid CSS measurement (1px)

WooCommerce

Mill comes with support for WooCommerce. WooCommerce is entirely optional, the theme functions perfectly well with or without it.

WooCommerce is a massively powerfull plugin, and as such is beyond the scope of this documentation. Fortunately WooCommerce has an extensive documentation website, which can be found here.

Slider Plugins

Within the Mill theme, there are two included premium slider plugins, LayerSlider and Slider Revolution. Both of these plugins are fantastically powerful and great at what they do.

For instructions on how to install and activate these two plugins, read the Suggested Plugins section

The documentation for both of these plugins is far beyond the scope for this documentation. However we have included links to the developers own documentation pages below.

LayerSlider

Taken from the LayerSlider codecanyon page:

This is the WordPress plugin of LayerSlider! You can create as many layers and sublayers as you want. You can use unlimited images with links. The script is very user-friendly, you can add global settings or local (per slide) settings to each layer or sublayer. You can change delay times, easing types, durations and much more.

You can view the LayerSlider documentation here

Slider Revolution

Taken from the Slider Revolution codecanyon page:

Create a responsive (mobile friendly) or full width slider with must-see-effects and meanwhile keep or build your SEO optimisation (all content always readable for search engines). See the heaps of custom transitions/animations for each object on the page! Customize this slider with our convenient drag&drop backend to your very needs.

This plugin features tons of unique transition effects, an image preloader, video embedding, autoplay that stops on user interaction and lots of easy to set options to create your own effects.

You can view the Slider Revolution documentation here

Updating Mill

The best way to update your theme is via the Envato WordPress Toolkit. We covered the envato toolkit in section 2.2.1.

By using the Envato WordPress Toolkit, the process of updating a theme is handled for you. The toolkit periodically checks to see if a new version is available, and informs you of any updates. Then it's just the simple task of clicking "Update" and the rest is done for you.

If you have the technical experience, you could update via FTP. This will require knowledge of your web servers FTP details, an FTP client along with knowledge of how to use it, and experience and knowledge in the best practices and processes of updating in order to protect yourself from technical or user error should something go wrong.

Updating live files via FTP has its risks. Things can go wrong so make sure you take proper precations when working via FTP by making backups and checking site functionality as you go to ensure everything is still working.

Sources & Credits

Documentation Info

Documentation Version
v2.0
Documentation Updated
25th November 2014
Created By
eski
Theme Demo
www.eski.io/demo/mill
Support Forum
www.eski.io/support/forum/mill