=== eCommerce shopping cart ===
Contributors: webdorado
Donate link: https://web-dorado.com/products/wordpress-ecommerce.html
Tags:  cart, checkout, e-commerce, ecommerce, paypal, sales, sell, shop, store, shipping,product catalog,  online store, shopping cart
Requires at least: 3.4.0
Tested up to: 4.6
Stable tag: 1.0.15
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Ecommerce WD is a highly-functional, user friendly WordPress Ecommerce plugin, which is perfect for developing online stores for any level of complexity. 

== Description ==


[WordPress Ecommerce WD](https://web-dorado.com/products/wordpress-ecommerce.html)      
[Demo](http://wpdemo.web-dorado.com/ecommerce/)  
[User Guide](https://web-dorado.com/wordpress-ecommerce/installing.html)       
[Support Forum](https://web-dorado.com/forum/ecommerce.html)     
       
= Ecommerce WD Add-ons: =
[Filters Add-on](https://web-dorado.com/products/wordpress-ecommerce/add-ons/filters.html )    
[Mini Cart Add-on](https://web-dorado.com/products/wordpress-ecommerce/add-ons/mini-cart.html )    
	   
Ecommerce WD is a highly-functional, user friendly WordPress Ecommerce plugin, which is perfect for developing online stores for any level of complexity. 

The Ecommerce plugin for WordPress includes advanced filtering, sorting and comparing functionality which makes user experience in the store straightforward and smooth. The advanced search in addition gives possibility to find any needed info in seconds. 

The plugin allows creating different shipping methods and tax types and apply them to  a group or a single product. To highlight products for any purpose you can use labels- small image overlays. 
You can define different parameters for products, assign values for each product and change prices depending on parameter value. 

Product manufacturer and category pages can be created separately to provide all of the necessary information. You can display the products in 5 different stunning views.You can choose to use the pre-built templates of the plugin for all the pages or customize the templates to better fit you website design.

This ecommerce plugin supports three types of payment processing - without online payment , PayPal Standard and PayPal Express (available with Pro version). 

Payment and order details can be sent both to user and administrator using default email templates. Email templates can be customized based on your preference. You can monitor store’s performance using orders section and advanced reports. 

The plugin supports popular social network integration, Facebook comments, reviews and rates. 
Users can get the most essential info about the product using Quick view and comparing it with similar items. 

Pro version includes 5 built-in themes, and you can also create new themes or edit existing ones.

The products can be displayed in 5 views- Thumbnail and List (Free version) and Masonry, Chess and Blog Style (Pro version).


###IMPORTANT:    
If you think you found a bug in Ecommerce WD or have any problem/question concerning this plugin, please check out [Support Forum](https://web-dorado.com/forum/ecommerce.html)  in our website. If you do not find a solution here, do not hesitate to [click here to contact us](https://web-dorado.com/support/contact-us.html).

= Main Features of Ecommerce WD: =

*   Fully Responsive design    
*   Unlimited number of products/categories    
*   Currency and Country set up    
*   PayPal Payment gateway Integration    
*   Shipping methods and taxes    
*   Discounts for individual and grouped products   
*   Product label display    
*   Product parameters with price setup    
*   Detailed Manufacturer's Page    
*   Guest Checkout    
*   Product, Category and Manufacturer template customization    
*   Orders section and advanced Reports    
*   Social network integration    
*   Facebook comments    
*   Ratings and reviews   

Upgrade to [Ecommerce WD Pro](https://web-dorado.com/products/wordpress-ecommerce.html) to get access to

*   5 built in themes    
*   Possibility to add/edit new themes    
*   PayPal Express Checkout   
*   Product Masonry view    
*   Product Blog Style view  
*   Product Chess view   

== Changelog ==

= 1.0.15 =
* Added: Mini cart add-on.     

= 1.0.14 =
* Added: Hook to add menu to Ecommerce-WD menu.   
* Added: Hook to add tab to Ecommerce-WD Options page tab and subtab.   
* Fixed: Remove parameters box from products edit page sidebar.   
* Fixed: Item checkout with filters widget.   

= 1.0.13 =
* Added: Filters add-on   

= 1.0.12 =
* Fixed: Quick view.     
* Added: Shopping cart link on add to cart.     

= 1.0.11 =
* Added: Translations.   

= 1.0.10 =
* Fixed: Add to cart, Remove from shopping cart, Rate in some reasons.      
* Fixed: Paypal SSL Version.       
* Changed: Product parameters info in email and order details in backend.    

= 1.0.9 =
* Fixed: Checkout without billing/shipping country.   

= 1.0.8 =
* Changed: Translations source texts       

= 1.0.7 =
* Added: Admin notices.    
* Changed: Help topics links.   

= 1.0.6 =
* Fixed: Line breaks in description and short description.     
* Fixed: Category shortcode bug.     
  
= 1.0.5 =
* Fixed: Product price bug.   

= 1.0.4 =
* Fixed: Conflict with Yoast SEO plugin.    

= 1.0.3 =
* Fixed: Payments additional parameters save in some case.     
* Fixed: Save template bug if external folder and/or theme php in internal folder can't be created.     

= 1.0.2 =
* Fixed: Multiple shortcodes error.    
* Fixed: Truncating description with html.   
* Fixed: Conflict with All In One SEO Pack plugin.   
* Fixed: Masonry view bug.   

= 1.0.1 =
* Fixed: Minor bug    

= 1.0.0 =
* Initial version

== Screenshots ==
1.  Ecommerce WD  - Products View       
2.  Ecommerce WD  - Single Product View         
3.  Ecommerce WD  - Manufacture         
4.  Ecommerce WD  - Category     
5.  Ecommerce WD  - Edit Product     
6.  Ecommerce WD  - Edit Options      


== Installation ==

#### Thank you for your interest in Ecommerce WD.  

### Minimum requirements.  
*   Wordpress 3.4+  
*   PHP 5.x  
*   MySQL 5.x  

### Perform a new installation  

After downloading the ZIP file of the plugin,  

1. Log in to the administrator panel.   
2. Go to Plugins Add > New > Upload.     
3. Click "Choose file" ("Browse") and select the downloaded zip file of the plugin.     
4. Click "Install Now" button.     
5. Click "Activate Plugin" button for activating Ecommerce WD.    
6. If the installation does not succeed, please contact us at [support@web-dorado.com](mailto:support@web-dorado.com).

==  Ecommerce WD User Manual  == 


Installation

Login to your WordPress Admin panel. Navigate to Plugins.
Press Add New > Upload Plugin > Choose File > click Install Now. Then activate Ecommerce WD.

Alternatively you can proceed with FTP Upload. Unzip the downloaded package go to wp-content\plugins\ folder and upload the package. Return to WordPress Admin panel and activate the plugin.

Set up

After installation of the plugin  you will have an option to run Installation Wizard. If you skip this step, but want to use this option afterwards go to Options> Global>General>Setup Wizard.

As a result of installation three menu sections will be added to your WordPress Dashboard Ecommerce WD, Products and Ecommerce Pages. 


Options 

Options menu is the first step while creating an online store: here you set up general and payment options. Options contain Global, Products, Checkout, Additional charges and discounts, Users, Email options, Standard pages tabs.


Global options

Global Options allow changing date format of the online store, enabling decimals and changing the lists for countries, currencies, order status types and running the setup wizard again. You can enable/disable search, filtering and sorting bases. 

By default Ecommerce WD uses its own template for product, manufacturer and category pages, but you can make necessary changes in Manage Templates. General Templates button uses website active theme and generates the pages using design of the theme. This works for most of the themes written strictly in WordPress standard. Otherwise you can manually add the php code to the template using Import from Theme template option instead. To reset the changes press Custom Template. which is the ecommerce default design. 

Products

In Products data you can change weight and dimensions units, as well as enable/disable SKU, UPC, EAN, JAN, ISBN, MPN.  In Feedback tab enable/disable product rating and review possibility. In Social Media tab you can enable social media sharing buttons and enable Facebook comments instead of standard comments and choose color scheme for the Facebook comments box (light or dark depending on your preference).

Checkout

Here you can enable checkout, allow guest checkout (for non- registered users), redirect to cart after adding an item and enable/disable payment gateways and configure the options using Payment systems button for the all list or click on a payment gateways for a single one. 

Without online payment. This option allows check out the product and receive money afterward.

PayPal Standard. In case of PayPal standard you are required to enter only the PayPal address which receives the payment and choose the checkout mode- sandbox (for testing) or production (for actual payment).

PayPal Express.  For PayPal Express you need to choose the checkout mode- sandbox (for testing) or production (for actual payment). Then you need to create API signature:

Login to your PayPal (www.paypal.com) account. Make sure that the account is business one. Hit the profile icon on upper right corner, choose Profile and Settings from Business Profile menu. 
On the right-hand menu hit My Selling Tools and in Selling Online click on Update hyperlink for API access.
Go to Option 2 and Request API Credentials on the API Access.
Request API signature and click Agree and Submit to generate the API signature.

You should be able to get a similar result:

Copy the generated username, password and signature and fill them in corresponding input fields.

Additional Charges and Discounts

Here you can choose whether to include discounts and taxes in the final price of the product or not and set shipping calculation- per group (in case of identical shipping methods the bundle will be considered as a single unit, whereas in case of different methods for included items the shipping will be calculated for each product separately) of per unit (each unit will have its own shipping charge).  

Users

Here you can enable/disable details necessary for the checkout. You can set the input fields to required as well.

Email Options

First specify the general email settings- Administrator email, Email from (to user) and From Name (Administrator username) and choose mailing type- php or smtp depending on your preference.

Email to Administrator tab defines the condition when to send an email, email subject, email mode and email body using custom HTML and placeholders.

Email to User tab defines the condition when to send an email, email subject, email mode and email body using custom HTML and placeholders.

Customer note tab defines whether to send email, email subject, mode and and email body using custom HTML and placeholders. Note that this email is sent  when administrator changes the status of the order.

In Failed, Pending, Completed and Refunded tabs choose whether to send email to Administrator and User, define subject, mode and email body using custom HTML and placeholders for each case.

Customer invoice is email manually sent to customers containing their order information and seller information. Define its subject, mode and email body using custom HTML and placeholders.


Standard Pages

Here you can specify permalink structures  as well as path component for action page, e.g. Compare or List of license pages.

Adding product

Go to Products>Add New.  Product is a custom page, where you can add the name and description of the product as post title and content. You can add short description of the product in Short description content area (visible with some of the views) and proceed to Product data box:
Data tab is designed for specifications of the product. Here you can add product model, price, choose discount, tax, set final and market prices, define amount in stock (for unlimited option tick the checkbox) and finally fill in values for SKU (Stock Keeping Unit), UPC (Universal Product Code), EAN (European Article Number), JAN (Japanese Article Number), ISBN (International Standard Book Number) and MPN (Manufacturer Part Number) if applicable.
In Links tab you can add label (e.g. overlays for New, Sales and etc.) to the product and license pages (for terms of product purchase and usage).
For adding parameters or inherit them from category parameters use Parameters tab.
In Shipping tab you can enable shipping for the product and fill in shipping details such as weight and product dimensions. Units for both can be changed in Options menu. 
In Media tab you can add various images for the product, as well as include a video.
To make the product page SEO-friendly you can add its own metadata in Meta tags:  meta title, meta description and meta keywords.

On the right hand you can choose Product Category, add tags, fill in or choose parameter values and select manufacturer.

Adding categories

Go to Products >Categories. Here fill in name, slug, parent category, description and meta data, image, choose parameters and tags for the category. Then if applicable enable information and products for this specific category page, subcategory display and category hierarchy. Set the number of visible products and number of columns. To finalize the changes press Add new category button.

Adding Tags

Go to Products >Tag. Here fill in name, slug and description of the tag and press Add tag button.

Adding Parameters

Go to Products>Parameters. Here fill in name, slug and description of the parameter. Then choose the type of it:
Single value. Allows adding a single option, which cannot be adjusted or changed, e.g. Color: White.
Input. Allows the users to type in parameter option they do prefer.
Select. Allows the user to select the prefered option among the listed ones.
Radio. Allows the user to check the prefered single option.
Checkbox. Allows the user to check multiple options for the product parameter.

Choose whether to have it as a required parameter or not and press Add parameter button.


Adding Labels

Go to Products>Labels. Labels are overlay images which are added to differentiate products, e.g. New, 30% off and etc. Here add name, slug, description, upload the overlay image and finally choose the position of it over the image from 4 available positions. Press Add label button.

Adding Manufacturers

Go to Products>Manufacturer. Manufacturer is a custom post, where you can fill in the Title and description of the manufacturer as a post title and content, then add the website of the page. Then you need to enable/disable added details display and product display referring to this manufacturer, define their number. As a final step you should fill in metadata and set a featured image and press Publish button.

Choosing and Adding Themes
To choose or add new themes for the plugin go to Ecommerce>Themes. Here you can set one of the themes to be default by pressing on star icon next to it. To add new theme press Add new button. Initially the theme will have settings of the theme which is set to default.  First you need to add title to the theme and choose whether to have rounded corners for the ecommerce containers. 
In Elements tab define styles and colors for header, input fields, buttons and dividers, In Components tab define navigation bar options, user data and product panel, ratings, tabs, alerts, modal header and pagination. In Single Item and Multiple Items tabs you can define styles and colors for single product or multiple product views, enable certain product parameters and characteristics for views.

Managing Ratings

You can view all ratings in Rating menu. Product ratings can be deleted. To do so go to Ecommerce>Ratings, select the product, choose the user IP or rating, tick the checkbox and press Delete button.

Adding Discount

To create discounts for grouped or single items go to Ecommerce>Discounts. Fill in its title, slug, add description, rate in percentage, start and finish dates. Then press Add new discount button.

Adding Taxes

To create taxes for grouped or single items go to Ecommerce>Taxes. Fill in its title, slug, description and tax rate. Then press Add new tax button.

Adding Shipping Method

Go to Ecommerce>Discounts. Fill in the title, slug, description, select the countries, tax, shipping price (with possibility to have free shipping for certain price and higher purchases) and shipping type- per bundle (in case of identical shipping methods the bundle will be considered as a single unit, whereas in case of different methods for included items the shipping will be calculated for each product separately) of per unit (each unit will have its own shipping charge).  Press Add new shipping method button.

Tracking Orders

Orders include: ID (sequential number of purchase), User IP, Product,  Total Price, Date, Payment method, Order Status, Payment Status. You can sort order by any of this parameters.  

Using Actions tab you can delete any order, change the status of it or resend additional information, such as purchase details to a buyer. In this case you will need to check the ID of the user and change the status of it.

From-To. Filter and sort your data with the little calendar icons. Clicking them select the time period to check the history of your online store. 

Tracking Reports

View your store’s performance reports by month, year, week or specific date range. You can track sales in selected period, averages, bestseller items and more. To enable/disable properties just tick the checkbox next to graph.

Publishing Ecommerce WD shortcode to Pages/Posts

In editor of a page/post find Ecommerce WD icon (shaped as a shopping cart), click on it. Set up the options and press Insert button. Shortcode uses  three tabs for creating product list, categories or manufacturers pages.

Creating category page: Filter the category/categories to display, define the ordering (ascending, descending) and choose whether to display category information alongside the category product display.

Creating Manufacturer page: Define the ordering for the manufacturer list and choose whether to display manufacturer information alongside its listing.

Creating Products page: Here you need to choose the arrangement for the product display:
Thumbnails. Displays product identical thumbnails with short description.
Masonry. Displays product thumbnails based on added image proportions and its content length.
List. Displays products one after another as a list with short description.
Blog Style. Displays products one after another with its full description similar to blog posts.
Chess. Displays set of four products, where the content components of products next to each other are inverse.
Then set up the filters for the product display choosing category, manufacturer, maximum and minimum prices, adding date, rating and tags. As a final step define the ordering.
