Thank you for purchasing our theme. If you have any questions that are beyond the scope of this help file, please open a ticket http://codespotsupport.com/others/. Please also take a minute to check our Knowledgebase before opening a ticket. Thanks so much!
We hope you will enjoy working with our themes.
Yours sincerely, WPDance.
In this user guide you will find all required information to get your site up and running: starting from theme installation and setup, to usage of different post types, page templates and shortcodes
Attention!!! Kindly note, that we cannot provide the support until you specify your Item Purchase Code. Here's how you can get it: http://themeforest.net/forums/thread/item-purchase-code/96457.
Also note that this is combined manual for our multipurpose themes that shares similar back- and front-end features. Therefore some screenshots, interfaces and features may slightly vary from actual theme that you’ve purchased.
Please note that this theme is not harder to use than any other premium theme with advanced functions. Moreover, we believe that it’s even much easier! And there’s a good reason for that: amount of time that we invested in designing its interfaces, page templates and theme options is simply immense…
Nevertheless, please note that this User Guide does NOT cover basic WordPress usage. Therefore if you are not a confident WordPress user, please get accustomed with it BEFORE proceeding to this manual and theme!
Here are some links that will help you to become more confident with WordPress:
Seriously!!! If you do not want to spoil your experience with any Premium Theme, get accustomed with WordPress basics first!
Our themes are compatible with the WordPress versions 3.9 or higher ( PHP 5.2.4 or higher, and mysql 5 or higher).
Most JavaScript enabled Browsers will make them work with no issues. They are designed and optimized for desktops, tablets and smartphones.
Currently we are testing themes in:
IMPORTANT!!!
Download and Install WordPress 3.9 or later.
If you've downloaded whole theme package (see fig. 1), unzip it. There you will find the theme installation file (called like "theme_name_v.zip"), user manual, dummy content folder, license folder, folder with PSD files, etc.
Fig. 1-1. Theme Package.
Alternatively you can simply download the installable WordPress file (see fig. 1-2).
Fig. 1-2. Installable file.
You have 2 ways to upload theme:
In "Appearance > Themes > Manage Themes > Available Themes" activate the Theme by hitting the correspondent "Activate" link.
Attention!!! To assure your permalinks are being rendered correctly (the web-site does not return "404 Not Found" error) after switching the theme, follow "Dashboard > Settings > Permalinks" and click "Save Changes".
After activating the Theme, you will notice Theme Options and Required Plugins (WooCommerce, WD Shortcode, WD Portfolio, WD Slide, Features, Testimonials, etc.) in your WordPress admin panel.
Using FTP client, go to "your_site/wp-content/themes/wp_oswad_market" CHMOD to 777 this folder : cache_theme. You also change CHMOD to 777 for Uploads folder.
Follow the steps below to install via WordPress
Fig. 2. Uploading theme in .zip format.
Please note that some hostings have a restriction on a size of a file that you are uploading. If any warnings appear, most probably, your hosting has file size limit. And the theme .zip file is too large to be uploaded via WordPress Panel.
To solve this problem you should either increase your maximum upload size (to 10mb) on your hosting admin panel or try contacting your hosting provider to do it for you if you do not have the privilege to alter your server php settings. This is a very common request and they should be able to help you out. Once the limit is increased you can re-try the install and you’ll be all good to go.
Also, you can install the theme via FTP.
Otherwise you can install theme via FTP. Simply unzip the installable file and upload the theme folder via FTP into "your_site/wp-content/themes/".
Attention!!! Theme will work fine on the vast majority of correctly installed and configured WordPress sites without any additional settings. However on some (very rear) hosting configurations you can notice that images on your site are not displaying. If you are experiencing this issue, please follow these steps to fix it:
If above steps did not yield any results, please don’t hesitate to address this issue directly to your hosting company. Since this is most likely a server-related problem, we will not be able to help you!
In order to import demo content file, follow "WP-admin >Tools > Import > WordPress" (fig. 5):
Fig. 5. Upload .xml file.
Click on "Browse" button and select the demo XML file ( "sample-data.xml" ) beside your theme package, then click "Upload file and import" button.
The next screen in "Import author" you are able to select a new author for imported content or select the existing one. In "Import Attachments" section you need to choose whether you want to upload demo media or not. Finally, click "Submit" (fig. 6):
Fig. 6. Media.
After imported the demo content, your site will like our sample site. But it can't import the widget and revolution slider contents. You also set the primary menu and static page again for your site.
If you want to setup the site like our demo, you must install the full demo package. Please send your request and purchase code to support@wpdance.com, our support team will send it to you.
Since v1.0.8, we supply One Click Import Demo functionality. In admin panel, you navigate to Appearance > Theme Options > Import Demo tab. You click on "Click To Import" button to import the demo content.
Please note that it won't import all images from demo site. It will be very slow to load all images. So it only import placeholder images. You need also to configure Mega Menu in Menu editor.
You can update your theme via FTP or via WordPress. See the information below for each method. However the first thing you need to do is download the new theme files from Themeforest.
Whenever you update the theme, its always a good idea to backup your current theme folder. Log into your server and make a copy of the OswadMarket theme folder located at wp-content > themes. If you are using the Revolution Slider and have added custom css, please make a backup of the styles because those will be removed when you update. You can also backup your theme options on the backup tab in Appearance > Theme Options.
We notice you should use this environment to test. If there have no problems, you can tranfer to live site
The easiest and safest way is to always update through the Envato Toolkit plugin that comes packed with the theme.
In your WordPress admin dashboard you should see a section called Envato Toolkit. You need to connect your ThemeForest account to it and once you have done so, you’ll see here all available updates, always at one click away.
To connect your ThemeForest account, you'll need to input your account username and a secret API key. An API Key can be generated in your ThemeForest account, under My Settings > API Keys.
This tool also gives you the option to create a backup while updating, which we totally recommend.
Download the latest version of the Envato Toolkit Plugin.
OswadMarket is constantly being updated with new features and adjustments. You can always view the most recent update information in the change log in the changelog.txt file inside the theme zip file.
OswadMarket has an advanced Theme Options panel that is loaded with options. We have the options organized into logical tabbed sections, and each option has a description of what it will do on the front end. There are too many options to go over in these docs but please take some time and navigate through each tab to see what we offer. Go to Appearance > Theme Options in your WordPress admin to access the theme options panel. You can also backup your theme options by clicking on the backup tab. That is a great way to move your custom options from site to site. See below for screenshots of our theme options panel. Please note: we are always adding new options so these screenshots may not reflect the most up to date options.
OswadMarket includes many widget areas. You can use them for diffrent pages. The below image presents all widgets that are used for the sidebars
Drag the text widget into top content widget area, copy code and paste into the text widget. You need to add new feature and change id attribute in the feature shortcode. See shortcode feature
Drag the text widget into banner top content widget area, copy code and paste into the text widget. We use the banner shortcode in this content. See shortcode banner
The header is probably one of the first things you will want to setup. The header consists of pretty much everything above and including the menu. There are many different elements to the header and many ways to customize it including images, colors, content, design and more. All of this is done via our Admin Panel. The following sections will cover several different sections of the header that are listed below
In OswadMarket we have thought an alternative way of having single logo image which is retina compatible as well. OswadMarket will not give these paddings using CSS.
The favicon options are also on the logo tab in theme options. Favicon's are an icon associated with a URL that is variously displayed, as in a browser's address bar or next to the site name in a bookmark list. To add it, simply click the upload button next to the appropriate field and select the favicon file you would like to use
OswadMarket has a built-in mega menu that can be enabled in the main menu. It can have 1-5 columns, be full width, take any widget and have icons/images next to menu items. Please see below for information on how to set this up. If you need information on how to create a regular menu, please see the appropriate section of our documentation.
All Mega menu widget area use the Text Widget. You need to drag the Text widget into mega menu widget area, copy the below codes and paste into the text widget
The above codes use shortcode from WD Shortcode plugin. You must ensure that WD Shortcode plugin is installed
Footer Widget Area.
Mapping Front-End.
The demo codes for the Text widgets on Footer Widget Areas
First Footer Widget Area
Second Footer Widget Area
Third Footer Widget Area
Fifth Footer Widget Area 2
OswadMarket includes a highly advanced theme options panel organized into sections that allows users to customize many different aspects of the theme. There is a Footer section of theme options that allows you to customize different areas of the footer. The Footer tab is organized into 3 sections: Show/Hide Footer Widget Area option, Footer Copyright option and Payment Icon option. See the information below for a description and screenshot of each section
You can create any number of pages with content. OswadMarket includes several page templates to choose from, and you will need to choose the page template that suits your needs. For example, if you want a "Full Width" page, then you need to select "Full Width" for the page template. All of this is done in the pages section of your WordPress Admin.
Fig. 1. Make page a homepage.
The sample code for the contact page. Use the Text editor to add it
Good News for those of you who is familiar with great plugin Contact form 7 : We have covered all styling required to build your forms without worrying about its appearance. You dont need to do anything in extra just intall Contact Form 7 and OswadMarket will take over the rest. we will dequeue its styling and add our own customised version to make it work seamlessly with OswadMarket.
Please be informed that we do not give support to any third party plugin's questions and issues. We can only afford to answer simple usage questions or issues related to incompatibility with the theme. This exception is for only our supported Plugins (Revolution slider, Contact form 7, bbPress and Woocommerce)
Each page you create has a full set of options to choose from allowing you to customize each individual page. Each page you open in your WordPress admin will have a "Page Configuration" Box that contains all the different settings. Some settings will only work if you use a specific template. Below are screenshots of the Page Configuration box.
In there:
These options are not available on the shop page. You can configure the shop layout and other options in Theme Options > Product Category tab
You can quickly build a home page using one of the pre-defined layouts you can see in the theme demo.
To ensure flexibility, all pages are built using one of the available page templates and a combination of shortcodes, which is available on this page, for each home page version. Take the following steps for creating a new home page
In Page Configuration section, set Page Layout to Left Sidebar, select the widget area for Left Sidebar.
The content for Text widget
We use shortcode banner in this content
In Page Configuration section, set Page Slider to Revolution Slider, select the Revolution Slider below. You have to change id attribute in the shortcode feature and the shortcode team_member
The content of the Text widget in Fourth Footer Widget Area
The content of the Text widget in Fifth Footer Widget Area 2
In Page Configuration section, set Page Layout to Right Sidebar, select the widget area for Right Sidebar.
The content for the first Text widget
The content for the second Text widget
The content of the Text widget in Fourth Footer Widget Area
The content of the Text widget in Fifth Footer Widget Area 2
In Page Configuration section, set Page Slider to Revolution Slider, select the Revolution Slider below.
Onepage Configuration
Take the following steps for creating a new one page
Content Animation
To add animation, you click "Edit Row" or "Edit Column" button. Then, you add animation through CSS classes. In there, "has-animation" class is required. Some classes that you can use:
In Page Configuration section:
Add the content below into the Text widget #1
Add the content below into the Text widget #2
Add the content below into the Text widget #3
Add the content below into the Text widget
You need to hide other Footer Widget Areas in Theme Options > Footer tab
You don't need to add any content to this page. Just select Blog Personal Template as shown in the screenshot
Below is the sidebar that we configured. You need to create an account in about.me and instagram.com to use About Me and Instagram widgets
Add the content below into the Text widget
Also, you will show Banner Top Content Widget Area on this page. You add a Text widget into this widget area and use the content below
You need to configure the page template and page configuration as the screenshots below
With each template, we have different default options in Theme Options (color, font, ...). In documents folder, we include some files that set default options. You navigate to documents folder(oswad-userguide) > options-default > open the folder that relates to your template. Then, you copy 2 files in there:
- Copy function.options.php file to theme_folder > admin > functions folder
- Copy custom_style.php file to theme_folder > framework > functions folder
Finally, go to admin panel > Appearance > Theme Options > click Options Reset button.
There are too many shortcodes to go over this document. Please take some times and navigate to each menu item. We only present some popular shortcodes
Use these shortcodes to show your products with grid layout or carousel slider. Ex, I use Feature Product and Feature Product Slider shortcodes
If you want to add an icon before the title instead of image, you will follow the screenshot below
Shortcode options:
Shortcode options:
Shortcode options:
This shortcode displays the best selling products. If you don't have any best selling product, it will display nothing.
Shortcode options:
Use these shortcodes to display your content elements
Shortcode options:
Shortcode options
Descciption options
big and small labels 
onsale, featured and new styles
Banner width ~ Banner height : normal
Banner width ~ Banner height x 2 : much_width 
Other : max_much_width
Shortcode options
Shortcode options
In admin panel, navigate to Slide on the left menu to add/edit brand slider
In admin panel, navigate to Team Members on the left menu to add/edit member
Please note that you don't need to create a sticky post to use this shortcode
Horizontal layout
Vertical layout
Shortcode options
You have to add video url and featured image for these posts
Shortcode options
OswadMarket is loaded with options for the blog. It offers many different options for you to present your blog posts, along with several different blog layouts. In addition there are numerous theme options and shortcode options that allow you to customize how posts are displayed. There are 2 ways to display your blog posts. The following sections will cover each method to display your blog post.
First, you need to know how to add new blog post. See the section below
No matter which method or methods you use to display your blog posts, the first thing you need to do is create the blog posts. See below for information on how to create blog posts
The first blog method we will cover is the standard WordPress method, setting up an assigned blog or "post" page. It's as simple as making a new page, and then telling WordPress to use that page as the post page
The second method we will cover is our template. It's as simple as making a new page, select a page template from a list of templates
For the blog posts page and the single post page. We offer many options in Theme Options
Let's face it, everyone loves sliders. They are the perfect way to catch your viewers attention by displaying your important content. OswadMarket includes the Revolution Slider. We also include other slider types for pages/posts and carousels. Each slider can be used on any page or post. When you install the theme, you need to intall the Revolution Slider plugin and you and will be able to be access in the sidebar of your wordpress admin. The Revolution Slider is one standalone plugin activated via TGM plugin activation, please install and activate it. Each slider is different and offers various features. The following sections will cover several different sections of the slider that are listed below
Once you have created your sliders, you need to assign them to a page, or use a shortcode if the slider offers one. There are two methods to assigning a slider to a page. First you can assign a slider via our page configuration box. Doing it this way will always put the slider directly under the navigation. The second method is to insert the slider shortcode in the post content field. Read below for information on both methods
Our Document includes the sample sliders from the Revolution Slider. It also includes our demo sliders(demo-revolution-sliders folder). Please read each section carefully. Each slider has its own method of importing, see below for each method
The Revolution Slider allows you to easily export/import your slides. It's always a good idea to backup your slides so you can easily import them again if you ever need to. Making animated slides takes a lot of time, make sure you export the data so you don't ever lose the time you’ve spent on them. The Revolution Slider requires you to export each slider individually. Export each slide you have made and it will give you an individual zip file that contains all the necessary files
How To Export Revolution Sliders – Open the slider settings page and find the import/export section below the main settings. Click the "Export" button and you will receive a zip file with all the needed files inside.
How To Import Revolution Sliders – First you must create a new slider. Next find the import/export section below the main slider settings. Click "Choose File" button and select your zip file then click "Import".
OswadMarket includes the popular Revolution Slider Created By ThemePunch. This slider is a beautifully animated slider that is 100% responsive and has some amazing options. We cannot cover everything here but we outline how to setup a slider and how to add slides to it. If you download our main files from Themeforest, you will get the original documentation created by ThemePunch, which is located in the slider-revolution-documentation folder.
Page Composer is a visual shortcode generator that you can build your layout painlessly without wasting your time with writing shortcodes. We built Page Composer based on Famous plugin called Visual Composer by wpbakery. There's one concept/design pattern you should know. In the Page Composer editor mode you'll have "Add element" button, which you should click or drag to the working canvas, to add content block or row to your page. Clicking the "Add element" button will show the content element selection menu. Content blocks are divided into categories so you can filter. Alternatively you can type the shortcode name to filter down the items instead of search them visually.
It has very simple and intuitive interface, but before getting started with building layouts, you may find it useful to get accustomed with Visual Composer documentation: http://kb.wpbakery.com/index.php?title=Visual_Composer.
You can control page composer global settings such as disable/enable in a post type and user roles that can use a shortcode. You can find these settings from WordPress "WP-admin > Settings > Visual Composer".
Content types: This option allows you to choose which post type should have the page composer feature. Please note that only post types will have this feature that they have WP editor feature. So for example clients will not have page composer even if you check mark its post type.
Rules for users groups: This option will give you the ability to select which shortcode should be appeared in the specific user role. this is useful when you give subscribers the ability to post, so you can disable some shortcodes for them.
Display reponsive content elements: Check this checkbox to prevent content elements from "stacking" one on top other (on small media screens, eg. mobile).
Google font subsets: Choose which subsets you want to load for your Custom Heading Element. Take into account that each subset will have impact on page loading.
This Options allows you to apply custom visual appearance to Visual Composer content elements and also control responsive width. By default content elements "stack" one on top other when screen size is smaller than 768px.
If you want to add some custom CSS code to the plugin and don't want to modify any files, then it's a good place to enter your code at this field.
This options allow you to make update the plugin automatically
This tab allow you to map your shortcode. Your shortcode will be shown on the list of Visual Composer elements menu
To start creating new layout click "BACKEND EDITOR" button on the top left of WYSIWYG (text editor):
Fig. 1. Enable Visual Composer.
WYSIWYG editor change to Visual Composer canvas (see fig. 2.). You can work with it as you do with regular Visual Composer
Fig. 2. Visual Composer canvas.
If you have a notice of Visual Composer about the license, you will do nothing. Because we bought this plugin and included it in the theme package. Also you can't enable automatic updates functionality of this plugin. But you can use it normal. If it has new version, we will update it for you.
Row element allows you to add your content. To add row, you click "Add new element" button, then select Row element from list
Fig. 1. Add Row.
Visual Composer allows you to setting up the row with many options.
Fig. 2. Edit Row.
Row editing interface will be displayed (see fig. 2). Additionally you can configure stripe with custom background, paddings, margins, etc.
Fig. 3. Row settings panel.
Rows are used to divide your page into the logic blocks with columns, columns later will hold your content blocks. To divide columns, you hover on Column button and select layout you want to show. Then, click Add New Element button in column section to add new element for column
OswadMarket is fully compatible with latest version of Woocommerce Plugin. We added required stylings to fit the design, Checkout section in header toolbar, and all required config codes to make it seamless with OswadMarket. If you dont need Woocommerce simply dont install it and all the features, codes and anything required for woocommerce will not be loaded and interfered. Vice versa, if you need to set up woocommerce just install woocommerce like you do for other plugins and thats all about it. you dont need to do anything else.
Please be informed that we do not give support to any third party plugin's questions and issues. We can only afford to answer simple usage questions or issues related to incompatibility with the theme. this exception is for only our supported Plugins (Revolution slider, Contact form 7 and Woocommerce)
Upon installation WooCommerce creates the following new pages:
Prior to the WC 2.1 release there were additional pages for account/checkout (such as lost password, order received, edit address, etc.) which now have been removed in favor of endpoints. Endpoints are nested into the pages listed above, for example, if you go to your My Account page you will see the links for the ‘my account’ endpoints. More information on endpoints can be found here.
Once you have activated YITH WooCommerce Wishlist plugin, you navigate to WooCommerce > Settings > Wishlist tab. You change its configuration
Once you have activated YITH WooCommerce Compare plugin, you navigate to WooCommerce > Settings > Products Compare tab. You change its configuration
OswadMarket is compatible with bbPress plugin
bbPress don't included in theme package. You should install bbPress plugin via Plugin page
If you want to show your forum with a list of categories, you can add some forum categories
OswadMarket theme is ready to translate. You can use PO file to do it. There are 2 methods to do:
After translating, you need to config wordpress language.
We have tested and ensured that OswadMarket is WPML compatible. If you need a multi-language site, then we recommend using the WPML Plugin. You would need to buy a license for the plugin, then install it and set it up. All the information you need to get started and use it is on the WPML.org page. Below are all the resource links you will need.
OswadMarket is, in their words, incredibly responsive, with a refreshingly clean design. And it has some awesome features, premium sliders, unlimited colors, advanced theme options and much more! If you have chosen OswadMarket as your site’s theme, we’ll teach you in this tutorial how to turn it multilingual with WPML.
Tutorial recommended by wpml team for translating widgets http://wpml.org/2011/03/howto-display-different-widgets-per-language/