=== Product Advisor for Ecwid === Contributors: Qualiteam Software Limited Tags: shopping cart, store, shop, ecwid, tools, random products, bestsellers, best sellers, on sale, discounted products, latest products, new arrivals Requires at least: 3.2 Tested up to: 4.0 Stable tag: 0.8 beta9 This module allows to show Random Products, Bestsellers, On Sale & Latest Products from Ecwid store. == Description == Product Advisor for Ecwid is a plugin for Wordpress that allows to show Random Products, Bestsellers, On Sale & Latest Products from Ecwid store. It allows to show products as widget or it can be used as shortcode, so products will be inserted into entry's body. Product Advisor for Ecwid must be used side by side with Ecwid Shopping Cart plugin (http://wordpress.org/extend/plugins/ecwid-shopping-cart/) and cannot work without it. Also, Product Advisor for Ecwid uses some settings of Ecwid Shopping Cart plugin such as Ecwid Store ID, so basically Product Advisor for Ecwid extends the functionality of the core Ecwid Shopping cart plugin. == Installation == 1. Log into your Wordpress back-end 2. Go to Plugins > Add New section 3. Search for "Product Advisor for Ecwid" keywords 4. Install the suggested module == Configuration == After installation, Product Advisor for Ecwid is generally ready to work without any configuration. However, if you do not have paid Ecwid account, you may experience problems with currency display. In this case, you may want to define currency settings manually. For that you should: 1. Go to the "Settings > Product Advisor for Ecwid" section in your Wordpress back-end and tick the "Use manually-defined currency settings" checkbox. 2. After that define currency prefix or/and suffix. 3. Save changes. For example: - if you define prefix as '£' your prices will look like £7.56 - if you difine suffix as '€' your prices will look like 7.56€ == Frequently Asked Questions == = Product Advisor for Ecwid's widgets = Available widgets: - Ecwid Random Products - Ecwid Bestsellers - Ecwid On Sale Products - Ecwid Latest Products In order to use Product Advisor for Ecwid's widgets, you need to: 1. Go to "Appearance > Widgets" area in your Wordpress. 2. Select any Product Advisor for Ecwid's widget and drag it to desired Sidebar or Area. 3. After your drop the selected Product Advisor for Ecwid's widget you will be able to define its settings. 3.1. "Title" field defines the title of widget. 3.2. "Number of products to display" field defines how many products will be displayed in this widget. 3.3. "Display product title?", "Display product price?" and "Display product SKU?" check-boxes define whether or not to display product name, price and SKU correspondingly. 3.4. "Category ID to select products from" defines any category ID from which products will be displayed. = Shortcode = Shortcode in Wordpress is a sort of macros that allows to use different features within the body of Wordpress entries such as Pages, Posts etc. There are followig shortcodes available for Product Advisor for Ecwid plugin: - [ecwid_random_products] - [ecwid_bestsellers] - [ecwid_on_sale_products] - [ecwid_latest_products] 1) [ecwid_random_products] Description: Display random products from Ecwid store. Parameters: number - how many items will be shown, ex. count=3 show_price - whether or not to show the price, ex. show_price=true show_sku - whether or not to show the price, ex. show_sku=true show_title - whether or not to show the product name, ex. show_title=true product_width - defines width of one product in px, ex. product_width=100 per_row - how many products need to be shown in a row, ex. per_row=3. Rule per_row=1 defines to show products in column. category - defines ID of category to select products from, ex. category=100. Works for paid accounts only. Example: [ecwid_random_products number=6 per_row=3 show_price=true category=2000] This shortcode will display 6 random products from category with ID 2000 in 2 rows (3 products in a row). It will show price for these products. 2) [ecwid_bestsellers] Description: Display Ecwid store's bestsellers. It works for paid Ecwid accounts only. It requires you to specify the Order API Secret Key in settings of Ecwid Product Advisor plugin. Parameters: number - how many items will be shown, ex. count=3 show_price - whether or not to show the price, ex. show_price=true show_sku - whether or not to show the price, ex. show_sku=true show_title - whether or not to show the product name, ex. show_title=true product_width - defines width of one product in px, ex. product_width=100 per_row - how many products need to be shown in a row, ex. per_row=3. Rule per_row=1 defines to show products in column. from_date - by default plugin uses all orders to build a bestsellers list (if this option is not specified). If for that purpose you want to use orders placed after certain date, then specify this parameter. Ex. from_date=2012-03-20 - to use orders after 20th March of 2012. 3) [ecwid_latest_products] Description: Display Ecwid store's latest products - products that were added to your catalog recently. It works for paid Ecwid accounts only. Parameters: number - how many items will be shown, ex. count=3 show_price - whether or not to show the price, ex. show_price=true show_sku - whether or not to show the price, ex. show_sku=true show_title - whether or not to show the product name, ex. show_title=true product_width - defines width of one product in px, ex. product_width=100 per_row - how many products need to be shown in a row, ex. per_row=3. Rule per_row=1 defines to show products in column. 4) [ecwid_on_sale_products] Description: Display Ecwid store's on sale (discounted) products. It works for paid Ecwid accounts only. Parameters: discount_type - required - possible values flat or percent - defines what type of discount will be used to filter your on sale products. Ex. discount_type=percent discount_value - required - defines the value of discount. If a product has discount greater than specified value, then this product will be in a list. Ex. discount_value=10 number - how many items will be shown, ex. count=3 show_price - whether or not to show the price, ex. show_price=true show_sku - whether or not to show the price, ex. show_sku=true show_title - whether or not to show the product name, ex. show_title=true product_width - defines width of one product in px, ex. product_width=100 per_row - how many products need to be shown in a row, ex. per_row=3. Rule per_row=1 defines to show products in column. Examples: [ecwid_on_sale_products number=5 discount_type=flat discount_value=10] This shortcode will display 5 products with discount more than $10 (considering your currency is $) [ecwid_on_sale_products number=6 discount_type=percent discount_value=50] This shortcode will display 6 products with discount more than 50%. == Changelog == = 0.8 beta9 = - [!] Product URL was generated incorrectly. Fixed. = 0.8 beta8 = - [*] Plugin renamed to "Product Advisor for Ecwid". - [!] Save % was incorrectly calculated. Fixed. - [!] Thumbnail images did not use required "alt" attribute. Fixed. - [!] Parameter 'from_date' was processed incorrectly for 'ecwid_bestsellers' short code. Fixed. - [!] Parameter 'from_date' was processed incorrectly for 'Ecwid Bestsellers' widget. Fixed. = 0.8 beta7 = - [!] PHP fatal error: Call to undefined function get_ecwid_protocol() in /wp-content/plugins/ecwid-useful-tools/classes/Product.php on line 23. Fixed. = 0.8 beta6 = - [!] PHP fatal error: Call to undefined method EcwidRandomProducts_Config::get_currency_prefix() in /wp-content/plugins/ecwid-useful-tools/functions.php on line 211. Fixed. = 0.8 beta5 = - [!] PHP fatal error: Call to undefined function get_ecwid_store_id() in wp-content/plugins/ecwid-useful-tools/functions.php on line 74. Fixed. - [!] Minor mistype on Ecwid Product Advisor Settings page. Fixed. = 0.8 beta4 = - [!] PHP fatal error: Declaration of EcwidRandomProducts_Bestsellers: :__construct() must be compatible with that of EcwidRandomProducts_IProducts: :__construct() in wp-content/plugins/ecwid-useful-tools/classes/Bestsellers.php on line 3. Fixed. - [!] Plugin settings did not save, "All Settings" page showed when clicking "Save Changes" button. Fixed. = 0.8 beta3 = - [!] Plugin renamed from Ecwid: Random products to Ecwid Product Advisor - [+] New features added: Bestsellers, On Sale & Latest Products = 0.7.4 = - [!] Appearance bug related to `mfunc` tags has been fixed. = 0.7.3 = - [+] Now plugin works with cache plugins like WP Super Cache that supports `mfunc` tags. Make sure that the cache plugin supports 'late init' and enable this option. - [+] CSS classes for price and title spans were added back. - [!] Fixed bug that WP went down if /cache folder could not be created. - [!] Fixed bug that product links were incorrect sometimes. = 0.7.2 = - [!] Many bugs related to free Ecwid accounts were fixed. - [!] However, pulling products from certain category works for paid Ecwid accounts only. - [!] Widget name was changed. All widgets must be reconfigured after this update. Shortcodes will keep working. = 0.7.1 = - [!] Activation bug was hot-fixed. = 0.7 = - [+] Added cache. - [+] Added possibility to show products from certain category only. Works only for paid Ecwid Accounts. = 0.6 = - [+] Huge refactoring was done. - [+] Wordpress version requirement was changed. Now it requires at least 3.2. We did really need to switch to PHP 5.x. - [!] Fixes to correlation between core plugin and Random Products were added. - [!] Plugin now shows tips if Ecwid's page does not exist and it causes widget to fail. = 0.5.1 = - [!] Widget's bug is hot-fixed. = 0.5 = - [+] Added deinstallation hook, so settings will be erased after uninstalling. - [+] Added correlations between this plugin and Ecwid Shopping cart. http://wordpress.org/extend/plugins/ecwid-shopping-cart/ to settings page. - [!] Bug that currency prefix could not be updated has been fixed. - [!] Bugs regarding blank spaces in widget area are fixed. = 0.4 = - [+] Added possibility to display products in row using shortcode. Check features.txt file for instruction on how to do that. - [!] Bug with incorrect price display has been fixed. - [!] Bug with incorrect bradcrumbs has been fixed. = 0.3 = - [+] Settings page was added. Now it is possible to define currency settings there. - [!] Module has been renamed from `Ecwid: useful tools` to `Ecwid: Random Products`. - [!] Bug with Inline SEO Catalog has been fixed. - [!] Small changes in widget settings. - [!] Small refactoring of the whole module's code. = 0.2 = - [+] Now it is possible to show price and/or title for random products. - [!] Some typos were fixed. - [!] Problem with HTTPS was fixed. = 0.1 = - [+] Initial version.