"CleanWay" WordPress Theme” Documentation by “Anps” v1.1.1


“"CleanWay" WordPress Theme”

Created: 08/04/2013
By: Anps team
Email: Anps

Hello! First of all I would like to thank you for purchasing our theme! :)
If you have any questions that are beyond the scope of this help file, please feel free to send your question on support@anpsthemes.com.

This file will teach you how to set up and use the “"CleanWay"” WordPress Theme.

This file is really extensive so you might think the theme is hard to use,
actually its not, you probably just might jump to the options page and explore everything yourself, this file is more of a reference work if you do not know what to do, or if you are not familiar to WordPress.

Have fun!
Anps team


Table of Contents

  1. Folder Structure
  2. Installation
    1. Setting up the CleanWay Options
    2. Theme style
    3. Theme options
    4. Contact form
    5. Dummy content
    6. Menu
  3. WooCommerce
  4. Adding a sidebar to pages
  5. Sliders
  6. Adding Blog items
  7. Adding Portfolio items
  8. Widgets
  9. Footer
  10. Shortcodes
  11. Child theme
  12. Updating the theme
  13. Translating the theme
  14. HTML Structure
  15. CSS Files and Structure
  16. JavaScript
  17. PSD Files
  18. Image Sizes
  19. Sources and Credits

Folder Structure - top

The Theme is built with WordPress best practices in mind, therefore it makes heavy use of the WordPress template engine. What exactly does that mean?

Whenever you see a php function call like this within your php files (get_template_part(), get_header(), get_footer() or get_sidebar() ) the theme retrieves a reusable code snippet, most of the time a chunk of code that is used in many different files.

Apart from the php structure the theme uses a lot of modern CSS3 features, most notably the power of media queries to serve different layouts for different viewport sizes. If you use a modern browser (IE9 +, Chrome, Safari, Firefox) and resize your browser window you will realize that the theme adapts its size to the viewport. The site works also IE older browsers like IE8, but lacks some animations and usage of CSS3.

Folder structure:

 


Installation - top


You can either choose to upload the theme to your server via ftp (only upload the unzipped folder "CleanWay" into the folder wp-content/themes/ ) or via WordPress upload function. to use the upload function of the WordPress admin panel make sure to ONLY upload the "CleanWay" folder and not the whole archive file that you received from themeforest.

Notice: if you are new to WordPress and have problems installing it you might want to check out this link: Solving broken theme issues
After that is done activate the theme as you would activate any other theme at Appearance→Themes.

If you are new to WordPress and have problems with setting up the theme you might want to import the dummy content file that comes with the theme. You can import this file by clicking the "Insert dummy content" Button in the Appearance → Theme options → Dummy content. The theme will then import some dummy posts and pages from the live preview. However you will still need to set some options on your own, like which page should serve as front page or how menus should be displayed.


Setting up the CleanWay Options - top

The main theme options can be found under the Appearance tab → Theme options and are arranged in submenus:

All of the above submenus are described separately in more detail below.

Theme style - top

Our template CleanWay is design with customisation in mind! That means you can create a very unique website, with just setting our theme options.

You can change 14 colors separately, but you can also choose one of our ten predefined color schemes, to either just use as your theme scheme or as a basis from which you can set colors as you wish.


Font family

Here you can choose two font types:

Our theme supports 500+ google fonts, so you have the freedom to choose whatever font you would like, but be aware that our theme uses certain font weights that may not work good with certain font families.


Heading sizes

Here you can change the sizes of all headings that we used in our template - H1, H2, H3, H4 and H5.


Predefined color schemes

Here you can choose from 10 predefined colors schemes. When you choose a color scheme, it will only fill in the options below, so you can still change any color, without editing the predefined colors.


Setting the colors

You can put in the HEX values for what color you would like, or you can click on the colored box, which will open our colorpicker.

Colors are devided into many different sections, but you can choose 14 colors.


Theme options - top

Under tab Theme options you will find social accounts, contact information, favicon and logo, page setup.

Responsive
Here you can turn on/off responsive option for template. That means if responsive option is turned off template won't adjust to other devices (mobile, tablets etc.). Responsive option is turn on by default.

Responsive on demand
Responsive on demand is an options that allows users to turn off responsive mode. The button to turn it off will show in the theme footer.




Page layout settings
Here you can set the header background image. You can choose from 9 patterns or a background image, which you can set to streched or tilled (tilled is best used for adding your own patterns).






Email
Enter your email address here. All contact form messages will be sent on this email address.








Google Analytics Tracking Code
Enter your Google analytics tracking Code here. It will automatically be added to the themes header so google can track your visitors behaviour.

Make sure you only put in you unique code (no html, js code), like shown in the picture.






Social accounts
Here you can add all of your social accounts (Facebook, Twitter, LinkedIn, Vimeo, YouTube and Flickr), which are then going to be shown in the widget we designed to be used in the footer.






Favicon
You can choose to upload your own favicon. You will also see preview image. Favicon dimesions have to be 16 x 16px. Image type can be .gif, .png or .ico.









Logo
Next you can choose to upload your own logo.










Front page and 404 page
First of all you have to choose which content your front page should contain. You can either choose to display a page of your choice, or if you dont select a page the posts will be displayed. Also select a page that will show for your 404 errors.













Blog settings

First select the page on which you want your post to appear, then choose a blog layout style:






Portfolio page
Here you can choose which content your portfolio page should contain. Portfolio page has several options (pagination type, limit items and portfolio heading), which we will discuss now one by one.

 

Filter
Check this option if you would like to include a filter for you portflio posts. Be sure to set categories for you portfolio posts.

 

 

Limit items per page
Enter a number for the maximum number of items to shows on each portfolio page.






Contact form - top

From this tab you can easily create any kind of contact form you like. For each box you have 5 set of settings:

You can add or delete fields by either clicking on the plus or the minus sign on the right side of each field. The new field will be added behind the field you clicked on.




Dummy content - top

If you are new to WordPress or have problems creating posts or pages that look like the theme preview you can import dummy posts and pages here that will definitely help to understand how those tasks are done.

Important: Please make sure you have set your links to pretty link, so you won't receive any errors, check also menu description below.

Important: If you are having trouble inserting dummy content and are receiving server errors, you will probably need to set your file permissions on folder wp-content/uploads ( if you don't have the folder, create it manually and set the permissions only on this folder ).

If you don't want to set, can't or don't know how to set file permissions, you can download this .zip file and place it into wp-content folder.

Manual instalation ( with WordPress Importer ):

Installing the WordPress Importer:

In our theme files you will find a .xml file (under cleanway/admin-functions/importer/dummy.xml). Use that file in the next step where it says: "Choose a WXR (.xml) file to upload, then click Upload file and import." and click on Upload file and import. In the next step you need to assign all the posts/page to a existing user or create a new user. In this step also be sure to have the Download and import file attachments checked, then click on the Submit button and you are done!


Menu - top

When creating your menu you should keep in mind that our theme supports space for only a number of fields, so be careful. The theme support only up to three level menu structure.

Also when you add dummy content don't forget to choose which main menu should be selected. To choose your main main go to Appearance → Menus and then select a menu for your Primary navigation.


Sidebar generator

Before you can start adding widgets you need to create a new sidebar, but you can add widgets to the already added ones, but you can create how many new sidebars you like. You can find the sidebar generator under AppearanceSidebars,



Adding a sidebar to a page/post

You can add a sidebar to all pages, except the portfolio page and single item portfolio page. You can add a sidebar to a page/post by selecting the desired by going to the desired item in WordPress (under Pages/Posts) and under the content editor you will see a box called Sidebars. You can select eiter only one of the sidebars, either both of them.

Important: Be carefull when adding two sidebars, because some elements aren't designed to be used with two sidebars ( two or more column sidebars ).


Sliders - top

We have included one slider with our theme: Revolution slider. You will be promted by WordPress to install them (yellow box on top).

You also have the possibility to set up a default slider (Apperance - Theme options - Theme options - Default slider). The default slider will appear on pages that do not have a slider selected.

Revolution slider

Watch this video for a quick tutorial on how to use this awesome slider:

WooSlider

WooSlider is the one we used on our demo site. We added support for it, but unfortunately it is not included with the theme (you will need to purchase it separately from WooThemes). You can position it both in the header or in the content.

You can find a great tutorial on this page.




Adding Blog items - top

To add a post to your blog click on Posts → Add New, then add post heading, post content, add Featured image and select the blog category. All of those settings are standard for WordPress, but you need to do one more thing before you can submit your post.

You also need to add Insert More Tag to separate your post summary and the full content of your post. Text above the More line will appear on the Blog page, while the rest of the text will appear only on your article page.

Adding a video to your Blog posts

You can also add videos inside of you Blog posts, via our shortcodes (YouTube or Vimeo), but you can also display a video on the first page as well.

All you need to do is to add a video within your content (if you have more than one video, it will show the first one), but don't select any Featured image because image override videos.

Adding a gallery of images to Blog posts

Adding a gallery is the same as adding the Featured image, but don't just select one image. You can add as many images as you like.


Adding Portfolio items - top

Adding portofolio items is the same as adding Blog post, you just need to select Portfolio insteed of Posts.

Adding videos to Portfolio items

To add videos to Portfolio items you just simply add a video shortcode in the content of your Portfolio item. You will also need to add the featured="true" attribute, so that the video will only show on the top of the page (in the slider).

Vimeo:

[vimeo featured="true"]46106724[/vimeo]

YouTube:

[youtube featured="true"]IG0wyXUcqZI[/youtube]


Widgets - top

We included 5 custom widgets: Images (good for adding an image to your footer), Quotes, Flickr, Twitter and Recent/Popular/Comment box. We also styled the default ones to some extent, like Arhives and Custom menu.

You can add widget in Appearance → Widgets by drag and dropping in the Sidebar box.

Once you have added a widget to the Sidebar box the widget will open and extra fields will appear.


We included the footer styler in the same part as Widgets, Appearance → Widgets. The only difference is you don't drag and drop in the Sidebar box, but you add them in 4 different columns. In each column you can add what you like, but we recommend to text, link, search and contact info shortcode.

Adding links to footer

First thing you will need to do is go to Menus where you need to create new menus with all of the links.

Now you are ready to start showing the added links in your footer, just find the Custom Menu widget and add it to the desired Footer Column.

When the widgets open you will be able to set the title and select a menu which should be displayed.


Shortcodes - top

Shortcodes are small text snippets that get converted by WordPress. As an example:

Using shortcodes is very easy. To use one, create a new post (or edit an existing one), and in the the editor type a shortcode in brackets, such as:

[quote] This is a pull-quote. [/quote]

The theme comes with quite a few shortcodes that are easily accessible thanks to a visual self-explanatory user interface that is accessible by clicking the Shortcodes button when you write a post or a page. Most shortcodes require you to enter additional information and then get generated by the theme on its own. You can also choose to nest various shortcodes.

Attention: Please make sure to always start new shortcodes on new lines. Most of the time you wont encounter any errors if you don't do that but unfortunately WordPress does mess up the HTML sometimes.

Check shortcodes in action

List of shortcodes:


Child theme - top

A WordPress child theme is a theme that inherits the functionality of another theme, called the parent theme, and allows you to modify, or add to, the functionality of that parent theme. The whole idea of a child theme is that you can modify, and add to the functionality of that parent theme without modifying it directly. The parent remains intact, everything is built within the child theme.

Reasons to use child theme:

To start using our child theme, then just activate the

Read more here


Updating the theme - top

Before you update:

How to update: To update our theme, go to ThemeForest and download the newest version of our theme (you can check all of your purchased items under the Downloads tab). Unzip the .zip files until you get the cleanway folder, then go to your server and place the files under wp-content/themes/cleanway.

Please note: our theme cannot be updated via WordPress, so if you are promted to update the theme, please do not click on the update, as you may lose your files.


Translating the theme - top

Our theme comes localisation ready out of the box – all that’s needed is your translation.

There are several methods to create a translation, most of which are outlined in the codex (http://codex.wordpress.org/Translating_WordPress), however, we find the easiest method is to use a plugin called codestyling localisation.


HTML Structure - top

The Theme uses valid HTML 5 and comes with predefined classes for common elements needed in web design.
All templates share basic elements like header, footer, main, and entry so be carefull when editing those or adding/changing the CSS.


CSS Files and Structure - top

The CSS for the theme is split into various files: theme main CSS file ( style.css ), which includes almost all classes, CSS file for responsive design ( media-queries.css ) and some css files that are used by plugins. Last but not least we got an empty custom.css file which should be used by you to add your own modifications. Since we never touch the custom.css file when making updates you can easily update to later theme versions without beeing in danger of loosing stylesheet modifications.


JavaScript - top

The theme uses advanced jQuery functions. You do not need to know how to use jQuery to activate them, almost everything is controlled by WordPress. Many of our functions can be found in js/functions.js file and also you can find all of the other used plugins in the same folder.

Lightbox v2

We used Lightbox only on the portfolio page, but if you want to apply the lightbox to a link you can add the rel='lightbox' attribute to the <a> tag.


PSD Files - top

Among with the theme come all psd files needed to edit the different skins. With these psds you can even create your own unique "CleanWay" skin.


Image Sizes- top

This are all the image size that have been set or updated in functions.php to tell wordpress which image sizes to use.


Sources and Credits - top


Go To Table of Contents