woocommerce/readme.txt

634 lines
42 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

=== WooCommerce - excelling eCommerce ===
Contributors: woothemes, mikejolley, jameskoster, CoenJacobs
Tags: ecommerce, e-commerce, commerce, woothemes, wordpress ecommerce, affiliate, store, sales, sell, shop, shopping, cart, checkout, configurable, variable, widgets, reports, download, downloadable, digital, inventory, stock, reports, shipping, tax
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_xclick&business=paypal@woothemes.com&item_name=Donation+for+WooCommerce
Requires at least: 3.8
Tested up to: 3.8
Stable tag: 2.0.13
License: GPLv3
License URI: http://www.gnu.org/licenses/gpl-3.0.html
WooCommerce is a powerful, extendable eCommerce plugin that helps you sell anything. Beautifully.
== Description ==
Transform your WordPress website into a thorough-bred eCommerce store. Delivering enterprise-level quality and features whilst backed by a name you can trust. Say "hello" to the WooCommerce eCommerce plugin.
WooCommerce is built by the experienced folk at WooThemes who also offer premium [eCommerce themes](http://www.woothemes.com/product-category/themes/woocommerce/ "eCommerce themes from WooThemes") and [extensions](http://www.woothemes.com/product-category/woocommerce-extensions/ "eCommerce extensions for WooCommerce from WooThemes") to further enhance your shopfront.
[vimeo http://vimeo.com/60440851]
= STRENGTH & FLEXIBILITY =
WooCommerce is built using WordPress best practises both on the front and the back end. This results in an efficient, robust and intuitive plugin.
= SMART DASHBOARD WIDGETS & REPORTS =
Keep a birds-eye view of incoming sales and reviews, stock levels and general store performance and statistics all from the WordPress dashboard or go to the reports section to view stats in more detail.
= CUSTOMIZABLE =
Your business is unique, your online store should be too. Choose one of our [eCommerce themes](http://www.woothemes.com/product-category/themes/woocommerce/ "eCommerce themes from WooThemes") or build your own and give it a personal touch using the built in shortcodes and widgets.
WooCommerce works with any theme, including the default WordPress themes Twenty Ten, Twenty Eleven and Twenty Twelve. If you need help getting your theme working nicely with WooCommerce please read our [theming docs](http://docs.woothemes.com/document/third-party-custom-theme-compatibility/) to discover your options.
If you're looking for a tailored WordPress eCommerce theme designed specifically to be used with WooCommerce be sure to browse the official [WooCommerce Themes](http://www.woothemes.com/product-category/themes/woocommerce/). Also check out our free themes, [Mystile](http://www.woothemes.com/products/mystile/), [Artificer](http://www.woothemes.com/products/artificer/) and [Wootique](http://www.woothemes.com/products/wootique/).
= FEATURES =
Whether you're operating a superstore selling thousands of products, or a just a sole trader selling hand made arts and crafts WooCommerce has you covered. You can read all about WooCommerce' features on the [WooCommerce website](http://www.woothemes.com/woocommerce/ "WooCommerce: An open-source eCommerce plugin for WordPress").
Payment Gateways, Shipping Methods and Integrations are important to any store - WooCommerce comes bundled with the following:
* __PayPal Standard Gateway__ - Accept credit cards and PayPal payments
* __Mijireh Checkout__ - Accept credit cards via Stripe, Authorize.net, PayPal, eWay, SagePay, Braintree, PayLeap, and more.
* __BACS__, __Cheque__ and __Cash on Delivery__ - Simple offline gateways
* __Flat rate shipping__ - Ship your items using a flat cost
* __Free shipping__ - Ship for free, or require a coupon to enable
* __International delivery__, __Local delivery and local Pickup__
* __Google Analytics__ - Powerful analytics, including eCommerce tracking
* __Sharedaddy__ and __ShareThis__ - Let your customers share your products with their friends
* __ShareYourCart__ - Encourage your customers to share their purchases in return for a coupon
Need a specific payment gateway? Perhaps additional shipping methods? WooCommerce has a plethora of eCommerce extensions available to provide just that.
* [View Payment Gateways](http://www.woothemes.com/product-category/woocommerce-extensions/?prod_cat%5B%5D=1023&s=&post_type=product&min_price=0&max_price=129&prod_country=0 "Payment gateways for WooCommerce from WooThemes").
* [View Shipping Methods](http://www.woothemes.com/product-category/woocommerce-extensions/?prod_cat%5B%5D=1026&s=&post_type=product&min_price=0&max_price=129&post_type=product&prod_country=0 "Shipping methods for WooCommerce from WooThemes").
* [View all extensions](http://www.woothemes.com/product-category/woocommerce-extensions/ "View all WooCommerce extensions").
= GET INVOLVED =
Developers can checkout and contribute to the source code on the [WooCommerce GitHub Repository](https://github.com/woothemes/woocommerce/blob/master/CONTRIBUTING.md).
== Installation ==
= Minimum Requirements =
* WordPress 3.5 or greater
* PHP version 5.2.4 or greater
* MySQL version 5.0 or greater
* Some payment gateways require fsockopen support (for IPN access)
= Automatic installation =
Automatic installation is the easiest option as WordPress handles the file transfers itself and you dont even need to leave your web browser. To do an automatic install of WooCommerce, log in to your WordPress admin panel, navigate to the Plugins menu and click Add New.
In the search field type “WooCommerce” and click Search Plugins. Once youve found our eCommerce plugin you can view details about it such as the the point release, rating and description. Most importantly of course, you can install it by simply clicking Install Now. After clicking that link you will be asked if youre sure you want to install the plugin. Click yes and WordPress will automatically complete the installation.
= Manual installation =
The manual installation method involves downloading our eCommerce plugin and uploading it to your webserver via your favourite FTP application.
1. Download the plugin file to your computer and unzip it
2. Using an FTP program, or your hosting control panel, upload the unzipped plugin folder to your WordPress installations wp-content/plugins/ directory.
3. Activate the plugin from the Plugins menu within the WordPress admin.
= Upgrading =
Automatic updates should work like a charm; as always though, ensure you backup your site just in case.
If on the off-chance you do encounter issues with the shop/category pages after an update you simply need to flush the permalinks by going to WordPress > Settings > Permalinks and hitting 'save'. That should return things to normal.
= Dummy data =
WooCommerce comes with some dummy data you can use to see how products look; either import dummy_data.xml via the [WordPress importer](http://wordpress.org/extend/plugins/wordpress-importer/) or use our [CSV Import Suite plugin](http://www.woothemes.com/products/product-csv-import-suite/) to import dummy_data.csv and dummy_data_variations.csv.
= Premium Extensions =
[Click here to view our extensions](http://www.woothemes.com/extensions/woocommerce-extensions/ "eCommerce extensions for WooCommerce from WooThemes"). Some of our more popular plugins are listed below.
* __Functionality__
* [Dynamic Pricing](http://www.woothemes.com/extension/dynamic-pricing/) - Bulk discounts, role based pricing and more.
* [Product Addons](http://www.woothemes.com/extension/product-addons/) - Create personalised products.
* [Gravity Forms Addons](http://www.woothemes.com/extension/gravityforms-product-addons/) - Create personalised products using gravity forms.
* [Currency Converter Widget](http://www.woothemes.com/extension/currency-converter-widget/) - Dynamically switch the currency of displayed prices.
* [Product Enquiry Form](http://www.woothemes.com/extension/product-enquiry-form/) - Allow visitors to email you enquiries about a product.
* [Facebook Tab](http://www.woothemes.com/extension/facebook-tab/) - Sell your products via your Facebook page.
* [Google Product Feed](http://www.woothemes.com/extension/google-product-feed/) - Add your products to Google Product Search.
* [Newsletter Subscription](http://www.woothemes.com/extension/newsletter-subscription/) - Allow customers to subscribe to your MailChimp or CampaignMonitor mailing list.
* __Shipping__
* [Shipment Tracking](http://www.woothemes.com/extension/shipment-tracking/) - Add tracking info to orders
* [Table rate shipping](http://www.woothemes.com/extension/table-rate-shipping/) - Create rules based on country/postcode, weight, cart items, and price.
* [UPS Shipping Method](http://www.woothemes.com/products/ups-shipping-method/) - Get calculated shipping rates from UPS
* [USPS Shipping Method](http://www.woothemes.com/products/usps-shipping-method/) - Get calculated shipping rates from USPS.
* [FedEx Shipping Method](http://www.woothemes.com/products/fedex-shipping-module/) - Get calculated shipping rates from FedEx.
* __Payment__
* [PayPal Pro](http://www.woothemes.com/extension/paypal-pro/) - Direct gateway
* [PayPal Express](http://www.woothemes.com/extension/paypal-express/) - Skip the WooCommerce checkout in favour of PayPal
* [Authorize.net DPM](http://www.woothemes.com/extension/authorize-net-dpm/) - Form based gateway
* __Import/Export__
* [Product CSV Import Suite](http://www.woothemes.com/extension/product-csv-import-suite/) - Import and Export variations and products via a CSV
* [Order/Customer CSV Export](http://www.woothemes.com/extension/order-customer-csv-export/) - Export your orders and customer records to a CSV
= Free Extensions =
WordPress.org is home to some cool free extensions too ([search WordPress.org for more](http://wordpress.org/extend/plugins/search.php?q=woocommerce&sort=popular)).
* [WooCommerce Admin Bar Addition](http://wordpress.org/extend/plugins/woocommerce-admin-bar-addition/) - Adds useful admin links and resources for the WooCommerce eCommerce Plugin to the WordPress Toolbar / Admin Bar.
* [WooCommerce Delivery Notes](http://wordpress.org/extend/plugins/woocommerce-delivery-notes/) - Print delivery Notes for orders.
* [Affiliates WooCommerce Integration Light](http://wordpress.org/extend/plugins/affiliates-woocommerce-light/) - Integrates Affiliates with WooCommerce.
* [WooCommerce Multilingual](http://wordpress.org/extend/plugins/woocommerce-multilingual/) - Allows running multilingual e-commerce sites using WooCommerce and WPML.
* [WooCommerce Grid / List Toggle](http://wordpress.org/extend/plugins/woocommerce-grid-list-toggle/) - Display products in grid or list format.
* [WooCommerce Customizer](http://wordpress.org/extend/plugins/woocommerce-customizer/) - Customise button text, labels and more from the dashboard.
* [WooCommerce Custom Product Tabs Lite](http://wordpress.org/extend/plugins/woocommerce-custom-product-tabs-lite/) - Easily create custom tabs for your WooCommerce products.
== Frequently Asked Questions ==
= Where can I find WooCommerce documentation and user guides =
For help setting up and configuring WooCommerce please refer to our [user guide](http://docs.woothemes.com/document/woocommerce/)
For extending or theming WooCommerce, see our [codex](http://docs.woothemes.com/documentation/plugins/woocommerce/woocommerce-codex/).
If you get stuck and you're not a WooThemes customer, you can ask for help on the [Community Forums](http://wordpress.org/support/plugin/woocommerce).
= Will WooCommerce work with my theme? =
Yes; WooCommerce will work with any theme, but may require some styling to make it match nicely. Please see our [codex](http://docs.woothemes.com/documentation/plugins/woocommerce/woocommerce-codex/) for help.
= Where can I request new features, eCommerce themes and extensions? =
You can vote on and request new features and extensions in our [WooIdeas board](http://ideas.woothemes.com/forums/133476-woocommerce)
= Where can I report bugs or contribute to the project? =
Bugs can be reported either in our support forum or preferably on the [WooCommerce GitHub repository](https://github.com/woothemes/woocommerce/issues).
= WooCommerce is awesome! Can I contribute? =
Yes you can! Join in on our [GitHub repository](http://github.com/woothemes/woocommerce/) :)
== Screenshots ==
1. The slick WooCommerce settings panel.
2. WooCommerce products admin.
3. Product data panel.
4. WooCommerce sales reports.
5. A single product page.
6. A product archive (grid).
== Changelog ==
= 2.1 - x =
* Feature - Define whether prices should be shown incl. or excl. of tax, and add an optional suffix.
* Feature - Show grouped or itemized taxes during checkout.
* Feature - Split frontend styles into separate appearance/layout stylesheets and removed the enable/disable option.
* Feature - Added woocommerce-smallscreen.css to optimise default layout on handheld devices.
* Feature - Bulk edit increase / decrease variation prices by fixed or percentage values
* Feature - Admin action to link past orders of the same email address to a new user.
* Feature - Account edit page for editing profile data such as email.
* Feature - Customer list reports.
* Feature - Reports - New design, export csvs, more data.
* Feature - Ability to link past orders to a customer (before they registered).
* Feature - Authorize option for paypal standard.
* Feature - Separate options for countries you can ship to and sell to.
* Feature - BACS supports multiple account details.
* Feature - PayPal PDT support (as alternative to IPN).
* Feature - Handling for password protected products.
* Feature - Schema markup selector for downloadables.
* Feature - woocommerce_get_featured_product_ids function.
* Feature - WC_DELIMITER to customise the pipes for attributes
* Feature - Standardized, default credit card form for gateways to use if they support 'default_credit_card_form'.
* Feature - Coupon usage limits per user (using email + ID).
* Feature - Option to limit reviews to purchasers.
* Feature - Option to install missing WooCommerce pages from tools page.
* Tweak - Added pagination to tax rate screens.
* Tweak - Added filter to check the 'Create account' checkbox on checkout by default.
* Tweak - Update CPT parameters for 'product_variation' and 'shop_coupon' to be no longer public.
* Tweak - COD processing instead of on-hold.
* Tweak - Added filter to explicitly hide terms agreement checkbox.
* Tweak - New System Status report layout, now plugin list is better visually and very better to read.
* Tweak - content-widget-product.php template for product lists inside core widgets.
* Tweak - Shipping is now renamed to Shipping and Handling on checkout.
* Tweak - Select all/none for countries in admin.
* Tweak - Handling for multiselect fields on checkout, and a filter for third party handling.
* Tweak - Made scripts/styles use protocol-relative URLs.
* Tweak - Revised shiptobilling functionality on the checkout. "ship to different address" option used instead.
* Tweak - Filterable page installer.
* Tweak - Order details optimised for small screens.
* Tweak - Streamlined account process - username and passwords are optional and can be automatically generated.
* Tweak - Updated/new dummy data (including .csv files to be used with [Product CSV Import Suite](http://www.woothemes.com/products/product-csv-import-suite/)).
* Tweak - Product shortcodes columns parameter now affects layout correctly.
* Tweak - Disabled button styles.
* Tweak - Hooks for overriding default email inline styles.
* Tweak - Flat rate shipping support for percentage factor of additional costs.
* Tweak - local delivery _ pattern matching for postcodes. e.g. NG1___ would match NG1 1AA but not NG10 1AA.
* Tweak - Improved layered nav OR count logic
* Tweak - Make shipping methods check if taxable, so when customer is VAT excempt taxes are not included in price.
* Tweak - Coupon in admin bar new menu #3974
* Tweak - Shortcode tag filters + updated menu names to make white labelling easier.
* Tweak - Removed placeholder polyfill. Use this plugin to replace functionality if required: http://wordpress.org/plugins/html5-placeholder-polyfill/
* Tweak - Replaced all instances of → and ← in frontent using wc icon font plus .wc-forward and .wc-backward utility classes.
* Tweak - Add review form no longer opens in lightbox.
* Tweak - Move average rating outside of hidden tab for google #3867.
* Tweak - Add formatted_woocommerce_price filter.
* Fix - Changed MyException to Exception in Checkout class as MyException class does not exist in WooCommerce
* Fix - Default cart widget styling on non-wc pages.
* Fix - Rounding for mijireh tax ex. price.
* Fix - Updated blockui to prevent errors in WP 3.6.
* Fix - Tweaked popularity sorting to work better when no sales are present.
* Fix - Quote encoding in email subjects.
* Fix - Added $wp_error parameter during checkout process to ensure WP_Error object is returned on error and checkout process is properly stopped.
* Refactor - Taken out Piwik integration, use http://wordpress.org/extend/plugins/woocommerce-piwik-integration/ from now on.
* Refactor - Taken out ShareYourCart integration, use http://wordpress.org/extend/plugins/shareyourcart/ from now on.
* Refactor - Moved woocommerce_get_formatted_product_name function into WC_Product class.
* Refactor - Improved parameter handling in woocommerce_related_products() function.
* Refactor - Widget classes (added abstract and combined similar widgets).
* Refactor - Removed pay and thanks pages. Endpoints are used instead.
* Refactor - Removed certain my-account pages. Endpoints are used instead.
* Localization - Portuguese locale by jpBenfica.
* Localization - Swedish translation by Björn Sennbrink.
* Localization - Japanese translation by Shohei Tanaka.
* Localization - Danish translation by Mikael Lyngvig.
* Localization - Spanish translation by Luis Giménez.
* Localization - French, Spanish, Romanian, Danish, Korean, Czech, Arabic, Hungarian updates.
= 2.0.16 - 14/10/2013 =
* Fix - woocommerce_change_term_counts needs to always return terms. Fixes category display.
* Fix - Attribute label display.
* Fix - add_to_cart shortcode correct use of setup_product_data
= 2.0.15 - 14/10/2013 =
* Fix - Added missing line break in plain text email.
* Fix - Strict standards warnings in category walkers
* Fix - Remember which attributes get registered to minimize conflicts
* Fix - Allow quotes in store name for display in emails
* Fix - Regression bug throwing warning in ShareThis integration
* Fix - Correct state code for Canadian state Newfoundland
* Fix - Tweaked popularity sorting to work better when no sales are present.
* Fix - Removed action from single add to cart templates to resolve issues with other plugins.
* Fix - Unsetting active classes #3896
* Fix - update_status checks if the order id exists #3904
* Fix - the first matching variation should be used (replaced pop() with shift()) @eef86ab
* Fix - get_children should get published products only for grouped products #3880
* Fix - Clean the SKU, prevents variations breaking when " was saved @dc6574b
* Fix - Correctly check attribute label and name upon creation @31c34f6
* Fix - Fixed Multiple Sets of Tabs on One Page @e584ea8
* Fix - Add tax_rate_id to objects returned from cart->tax_totals @40c85ec
* Fix - find_product_in_cart check if cart is array #3863
* Fix - bump_request_timeout strict standards @4798cb8
* Fix - Fix upload dir #3812
* Fix - Remove accents from taxonomy names + run through filters #3832
* Tweak - Always show returning customer login box.
= 2.0.14 - 05/09/2013 =
* Tweak - Update cart performance improvements
* Fix - Google Analytics no longer identifies users using custom vars
* Fix - Send tax inclusive, rounded item price to Google Analytics
* Fix - Use version_compare to check for required jQuery
* Fix - Made gateway abstract compatible with implementations to prevent strict notices
* Fix - Update order's GMT date ('post_date_gmt') when changing the order date via the "Edit Order" screen
* Fix - Hardened the checkout payment URL method
* Fix - Regression bug fixed, allowing 0 value attributes again
* Fix - API url function work when permalinks are not pretty
* Fix - Chosen select boxes now support RTL languages
* Fix - Refresh when creating an account to prevent nonce issues
* Other minor fixes
= 2.0.13 - 19/07/2013 =
* Tweak - Allow users with edit rights to add draft products to cart (and nobody else)
* Tweak - Handle pending status for paypal
* Tweak - Only refresh fragment when cart cookie > 0
* Tweak - Updated/new dummy data (including .csv files to be used with [Product CSV Import Suite](http://www.woothemes.com/products/product-csv-import-suite/)).
* Fix - Extra escaping on layered nav variables to prevent injection
* Fix - Improved sanitization of option fields
* Fix - Add fee total to cart total
* Fix - Flush rewrite rules after adding or editing attributes
* Fix - Set session after removing item from cart to prevent issues after removing last item
* Fix - Sale expiration now works for variations as well
* Fix - httpversion 1.1 for paypal upcoming changes
* Fix - Price filter widget: preserve orderby
* Fix - Fix paypal phone mask (whitespace)
* Fix - Correct sanitization of option fields
* Fix - Sanitized shipping calc form to fix persistent XSS issue.
* Localisation - ES States
= 2.0.12 - 17/06/2013 =
* Tweak - Add actions for attribute create/update/delete
* Fix - Fixed bug in cross sells loading in product data write panel
* Fix - Fixed posting shipping method when only one is available
* Fix - Fixed query breaking when using some product widgets
= 2.0.11 - 13/06/2013 =
* Tweak - Handling for multiselect fields on checkout, and a filter for third party handling
* Fix - Duplicate param keys for sale_product shortcodes
* Fix - Google Analytics tracking use get_order_number() method instead of id
* Fix - Replaced jQuery placeholder plugin to provide support in older browsers
* Fix - Rounding for mijireh tax ex. price
* Fix - Fixed is_on_sale function for products without prices
* Fix - Updated blockui to prevent errors in WP 3.6
* Fix - Extra data sanitization in some places
* Fix - Offer tax class option per variation to use same tax class as parent
= 2.0.10 - 15/05/2013 =
* Tweak - Searching for SKU in admin panel can also be done via lowercase 'sku:' instead of just 'SKU:'
* Fix - Cast term_id as int in product data write panel that will resolve issues with numerical attributes
* Fix - Correct label for RUB symbol - added a dot after it
* Fix - Javascript escapes to stop breaking scripts when used with translations
* Fix - PayPal button should use classes 'button' and 'alt', not 'button-alt'
* Fix - Have the remove_taxes() method set subtotal to subtotal_ex_tax
* Fix - Allow layered nav to work with non pa_ prepended taxonomies
* Fix - Better backwards compatibility with _woocommerce_exclude_image
* Fix - is_on_sale() method now returns true for products with a sale product of 0
* Fix - For when get_the_terms() returns false inside woocommerce_get_product_terms()
* Fix - PayPal has a 9 item limit
* Fix - Replace deprecated wp_convert_bytes_to_hr() with size_format()
= 2.0.9 - 02/05/2013 =
* Feature - Added is_product_taxonomy() conditional.
* Tweak - Notices during checkout for admin users if the checkout is mis-configured.
* Tweak - Named charts on report page to make modifications easier.
* Tweak - woocommerce_before_delete_order_item hook.
* Fix - Disable autocomplete for checkout fields which refresh totals - no events get fired on autocomplete.
* Fix - Clear rating transients when editing comments.
* Fix - Screen ids when plugin name localised.
* Fix - Brazilian state code BH -> BA. Data update required to update old values in orders.
* Fix - Fix incorrect CSS class being output in product image gallery.
* Fix - Mijireh page slurp.
* Fix - woocommerce_downloadable_product_name filter fixes.
* Fix - Pass order number to google analytics, not id
* Fix - check_jquery in WP 3.6 beta
* Fix - GA click tracking moved code to footer.
* Localization - Netherlands, Hungarian, Taiwan, Italian, CZ, Spanish, Catalan updates.
* Localization - Slovak translation by Dusan Belescak.
* Localization - Added RUB currency.
* Other minor fixes and localisation updates.
= 2.0.8 - 17/04/2013 =
* Feature - Related products shortcode.
* Tweak - Order item meta - skip serialized fields.
* Tweak - Support for the city field in shipping calc (filterable).
* Tweak - use base_country for tax calculations in manually created orders.
* Tweak - Download permissions meta box show cleaner filenames.
* Fix - Updated shareyourcart SDK.
* Fix - moved woocommerce_get_filename_from_url to core-functions as it is required in admin too.
* Fix - checkmark after adding to cart multiple times.
* Fix - Saving text attributes. Posted 'text' terms are not slugs. Only striptags/slashes - don't change to slugs.
* Fix - Insert URL button when working with multiple variations.
* Fix - Undefined found_shipping_classes in flat rate shipping.
* Fix - Fix saving options for attribute taxonomies containing special chars.
* Fix - Prevent empty meta queries.
* Localization - Norwegian updates by Tore Hjartland
* Localization - Spanish updates by Laguna Sanchez
* Localization - Romanian updates by Aurel Roman
* Localization - Finnish updates by arhipaiva
= 2.0.7 - 12/04/2013 =
* Feature - Option for GA _setDomainName.
* Tweak - Removed rounding when option to round at subtotal is set.
* Fix - Allow extra flat rate options even if main rate is 0.
* Fix - Fix email subject lines if options not set.
* Fix - Prevent over-sanitization of attribute terms when editing products.
* Fix - Sanitize terms when linking all variations.
* Fix - Sanitize coupon code names before checking/applying.
= 2.0.6 - 10/04/2013 =
* Tweak/Fix - Merge taxes by CODE so totals are displayed clearer. Also added additional function for getting merged tax totals, and to keep compatibility with themes.
* Tweak/Fix - Recent reviews show actual review stars, and allowed get_rating_html() to be passed a rating. Also removed unused $location var.
* Fix - Saving of meta values from paypal after payment.
* Fix - woocommerce_nav_menu_items - only hide pages, not other objects.
* Fix - woocommerce_add_tinymce_lang array key.
* Fix - Find_rates now works with both postcode and city together.
* Fix - PrettyPhoto content clearfixed.
* Fix - Fix the download method when force SSL is on.
* Fix - Put back sandbox pending fix. Apparently still needed for some accounts.
* Fix - Do not sanitize old attribute name to not mess up comparing
* Fix - Settings API empty value only used if set. In turn fixes blank values in flat rate shipping.
* Fix - Ensure API Request URL scheme is not relative to the current page.
* Fix - Fix saving of download permissions in order admin.
* Fix - Action woocommerce_product_bulk_edit_end is now properly executed instead of outputted as HTML.
* Fix - Fix IE Download via SSL bug and fix http file over SSL.
* Fix - Show non-existing product line items.
* Fix - Conflicts with W3 Total Cache DB Cache
* Fix - piwik tracking.
* Tweak - Added a check to parent theme for comments_template before loading plugin template.
* Tweak - Remove hard coded max from random products widget.
* Tweak - Add filter hook to the place order button for easy 3rd party manipulation.
* Tweak - UX - Placeholder fades out on focus
* Tweak - UX - Only display validation result on required fields
* Tweak - Product column widths in admin
* Tweak - .shipping_address clears to avoid flash of ugliness in some themes when revealing shipping address
* Tweak - created an icon font for the star ratings to improve consistency
* Tweak - woocommerce_show_page_title filter
* Tweak - wrapper / css tweaks for TwentyThirteen compatibility
* Tweak - Added filters for controlling cross-sell display
* Tweak - Made hierarchy code in breadcrumbs more reliable.
* Localisation - NZ States
* Other minor fixes and localisation updates.
= 2.0.5 - 26/03/2013 =
* Tweak - Made no shipping available messages filterable via woocommerce_cart_no_shipping_available_html and woocommerce_no_shipping_available_html.
* Tweak - disabled keyboard shortcuts in prettyPhoto.
* Tweak - woocommerce_date_format() function.
* Tweak - After adding to cart, add 'added_to_cart' to querystring - lets messages show with cache enabled.
* Tweak - Similar to above, on failure don't redirect. The POST should exclude from cache.
* Tweak - Version data on system status page.
* Fix - Fix orderby title - separated from menu_order.
* Fix - WC_Product::set_stock_status() to correctly set status.
* Fix - last_modified_date updated on status change for orders.
* Fix - Sanitize id in woocommerce_get_product_to_duplicate function
* Fix - Cancel order function now looks at post_modified instead of post_date.
* Other minor fixes and localisation updates.
= 2.0.4 - 18/03/2013 =
* Tweak - Like my account, added order_count attribute to view order shortcode.
* Tweak - Moved WC_Order_Item_Meta into own file.
* Tweak - PayPal standard gateway - no longer needs sandbox fix, and notify-validate should be first in the requests.
* Tweak - Flat rate interface tidy up.
* Tweak - Add order_id to woocommerce_download_product hook
* Tweak - Disabled prettyPhoto deeplinking
* Tweak - Applied a width to the product name column (edit products) to fix layout small screens
* Tweak - Filters for attribute default values.
* Tweak - Added filter to control order stock reduction when payment is complete.
* Tweak - Increase priority of woocommerce_checkout_action and woocommerce_pay_action so things can be hooked-in prior.
* Tweak - Tweaked default locale to include all fields so that checkout fields can fallback if specific properties are not set e.g. required.
* Tweak - Removed Base Page Title option - rename the page instead.
* Fix - WC_Order_Item_Meta support for keys with multiple values.
* Fix - Codestyling bug with meta.php
* Fix - Icon replacement in .woocommerce-info for Gecko
* Fix - prettyPhoto next/prev links and thumbnail navigation no longer appear when there's only one attachment
* Fix - Attribute base
* Fix - Fixed adjust_price method in product class, allowing negative adjustments
* Fix - Ratings and rating count transient syncing.
* Fix - Tax label vs name in order emails.
* Fix - Sendfile when FORCE_SSL_ADMIN is enabled.
* Fix - "for" attribute within product_length option.
* Fix - Encode the URLs generated by layered nav widget.
* Fix - Order Again for variations.
* Fix - Preserve arrays in query strings when using orderby dropdown.
* Fix - Move track pageview back to template_redirect to prevent headers_redirect, but give a later priority than canonical.
* Fix - Product tabs when a product type doesn't exist yet.
* Fix - Saving of variation download paths with special chars.
* Fix - Unset parent of children when deleting a grouped product.
* Fix - Removed Sidebar Login Widget. Use http://wordpress.org/extend/plugins/sidebar-login/ instead. A potential security issue was found regarding logging of passwords (since GET was used instead of POST). Sidebar Login 2.5 resolves this and the widget has been removed from WC to prevent needing to maintain two (virtually identical) codebases.
* Localization - Added indian rupees
* Localization - Updated French translation by absoluteweb
* Localization - Updated Brazilian translation by Claudio Sanches
* Localization - Updated Hungarian translation by béla.
= 2.0.3 - 11/03/2013 =
* Feature - Added products by attribute shortcode, e.g. [product_attribute attribute="color" filter="blue"]
* Tweak - Made coupon label more clear.
* Tweak - woocommerce_cart_redirect_after_error hook.
* Tweak - woocommerce_cancel_unpaid_order hook to control if an order should be cancelled (if unpaid)
* Tweak - woocommerce_valid_order_statuses_for_payment and woocommerce_valid_order_statuses_for_cancel hooks for pay pages/my account.
* Tweak - WC_START in checkout json requests to prevent notices breaking checkout.
* Tweak - Add filters to product images and thumbnails.
* Tweak - IPN email mismatch puts order on-hold.
* Tweak - Option to set main paypal receiver email.
* Tweak - Download file links show filename as part of link.
* Fix - Samoa -> Western Samoa
* Fix - Re-applied image setting tooltips
* Fix - Post code ranges (taxes) on insert.
* Fix - Moved init checkout to a later hook to prevent canonical template redirects kicking in.
* Fix - Made custom attributes more robust by using sanitized values for variations.
* Fix - woocommerce_cancel_unpaid_orders respects the manage stock setting.
* Fix - Mijireh Page Slurp.
* Fix - Removed unused 'woocommerce_prepend_shop_page_to_urls' setting from breadcrumbs.
* Fix - hide_cart_widget_if_empty option.
* Fix - Added legacy paypal IPN handling.
* Localization - Finnish translation by Arhi Paivarinta.
= 2.0.2 - 06/03/2013 =
* Fix - Frontpage shop when 'orderby' is set.
* Fix - Fix add-to-cart for grouped products which are sold individually.
* Fix - Payment method animation on the checkout.
* Fix - Updated chosen library.
* Fix - Saving of attributes/variations with custom product-level attributes.
* Fix - Include once to prevent class exist errors with widgets.
* Fix - Fixed welcome screen bug shown in updater frame
* Fix - Upgrade if DB version is lower than current.
* Fix - FROM prices now ignore blank strings for variations.
* Fix - Ensure order contents are saved before mailing via admin interface.
= 2.0.1 - 04/03/2013 =
* Fix - Added an extra permalink flush after upgrade to save needing to do it manually.
= 2.0.0 - 04/03/2013 =
* Feature - Sucuri audited and secured.
* Feature - Added sales by category report.
* Feature - Added sales by coupon report (kudos Max Rice).
* Feature - Multiple downloadable files per product/variation (kudos Justin Stern).
* Feature - Download expiry for variations (kudos niravmehta).
* Feature - Added wildcard support to local delivery postcodes.
* Feature - Option to enable Cash on Delivery for select shipping methods only.
* Feature - Stopped using PHP sessions for cart data - using cookies and transients instead to allow WC to function better with static caching. Also to reduce support regarding hosts and session configurations.
* Feature - Export and Import Tax Rates from a CSV file.
* Feature - Option to control whether tax is calculated based on customer shipping or billing address.
* Feature - New options for individual transaction emails with template editor.
* Feature - Added "On Sale" shortcode (thanks daltonrooney).
* Feature - Added "Best Selling" shortcode.
* Feature - Added "Top Rated" shortcode.
* Feature - Local pickup has the option to apply base tax rates instead of customer address rates.
* Feature - New product images panel to make working with featured images + galleries easier.
* Feature - Schedule sales for variations.
* Feature - Expanded bulk edit for prices. Change to, increase by, decrease by.
* Feature - Set attribute order (globally, per attribute).
* Feature - Allow setting the product post type slug to a static (non-translatable) text, mainly to be used for translating and WPML setups.
* Feature - Added lost password shortcode / email notification (thanks Max Rice).
* Feature - Simplified permalink/base settings now found in Settings > Permalinks.
* Feature - Support more permalink structures (from http://codex.wordpress.org/Using_Permalinks)
* Feature - Added option to resend order emails, checkboxes select which one.
* Feature - New layered nav current filters widget. This lists active filters from all layered nav for de-selection.
* Feature - Added the option to sell products individually (only allow 1 in the cart).
* Feature - New shop page/category archive display settings, and the ability to change display per-category.
* Feature - Allow shipping tax classes to be defined independent of items. https://github.com/woothemes/woocommerce/issues/1625
* Feature - Redone order item storage making them easier (and faster) to access for reporting, and querying purchases. Huge performance gains for reports. Order items are no longer serialised - they are stored in their own table with meta. Existing data can be be updated on upgrade.
* Feature - Update weights/dimensions for variations if they differ.
* Feature - is_order_received_page() courtesy of Lee Willis.
* Feature - Inline saving of attributes to make creating variable products easier.
* Feature - Zip code restriction for local pickup.
* Feature - New free shipping logic - coupon, min-amount, Both or Either.
* Feature - Taxes can be based on shipping, billing, or shop base.
* Feature - Filter coupons in admin by type.
* Feature - Append view cart link on ajax buttons.
* Feature - Revised the way coupons are stored per order and added new coupon reports on usage.
* Feature - Updated/new dummy data (including .csv files to be used with [Product CSV Import Suite](http://www.woothemes.com/products/product-csv-import-suite/)).
* Feature - Option to hold stock for unpaid orders (defaults to 60mins). When this time limit is reached, and the order is not paid for, stock is released and the order is cancelled.
* Feature - Added set_stock() method to product class.
* Feature - Linking to mydomain.com/product#review_form will now open the review form on load (if WooCommerce lightbox is turned on)
* Feature - Customers can sort by popularity + rating.
* Feature - Option to exclude coupons from sale items (thanks aj-adl)
* Feature - Logout "page" which can be added to menus.
* Templating - Revised pagination, sorting areas (sorting is now above products, numbered pagination below) and added a result count.
* Templating - email-order-items.php change get_downloadable_file_url() to get_downloadable_file_urls() to support multiple files.
* Templating - loop-end and start for product loops, allow changing the UL's used by default to something else.
* Templating - woocommerce_page_title function for archive titles.
* Templating - CSS namespacing changes (courtesy of Brian Feister).
* Templating - My account page broken up into template files (by Brian Richards)
* Templating - CSS classes standardised. Instances of '.woocommerce_' & '.wc-' replaced with '.woocommerce-'
* Templating - Ratings added to loop. Remove with [this snippet](https://gist.github.com/4518617).
* Templating - Replaced Fancybox with prettyPhoto
* Templating - loop-shop which was deprecated is now gone for good.
* Templating - Renamed empty.php to cart-empty.php to make clearer.
* Templating - Renamed sorting.php to orderby.php to better reflect contained hooks and code.
* Templating - Product tabs rewritten - new filter to define tab titles, priorities, and display callbacks.
* Templating - loop/no-products-found.php template added.
* Tweak - Sorting uses GET to make it cache friendly
* Tweak - Optimised class loading (autoload). Reduced memory consumption.
* Tweak - Moved shortcodes and widgets to classes.
* Tweak - Tweaks to gateways API. Must use WC-WPI for IPN requests (classes will only be init when needed).
* Tweak - Save hooks for gateways have changed to match shipping methods. Plugins must be updated with the new hook to save options.
* Tweak - Cron jobs for scheduled sales.
* Tweak - Improved product data panels.
* Tweak - Improved installation + upgrade process upon activation.
* Tweak - Protect logs and uploads with a blank index.html
* Tweak - Append unique hash to log file names
* Tweak - get_order_number support for PayPal (thanks Justin)
* Tweak - Taxes - removed woocommerce_display_cart_taxes option in favour of never showing tax until we know where the user is (for tax exclusive prices). Tax inclusive continues to use base so prices remain correct.
* Tweak - Taxes - tweaked display of tax when using inclusive pricing to avoid confusion.
* Tweak - Taxes - improved admin interface and simplified options.
* Tweak - More granular capabilities for admin/shop manager covering products, orders and coupons.
* Tweak - Added some calculations to the order page when manually entering rows. Also added accounting.js for more accurate rounding of floats.
* Tweak - Order page can now calculate tax rows for you.
* Tweak - Display tax/discount total for reference on orders
* Tweak - Humanised order email subjects/headings
* Tweak - Cleaned up the tax settings.
* Tweak - If a PayPal prefix is changed, IPN requests break for all existing orders - fixed. new woocommerce_get_order_id_by_order_key() function added. Thanks Brent.
* Tweak - On add to cart success, redirect back.
* Tweak - Prefix jquery plugins JS.
* Tweak - Made paypal use wc-api for IPN.
* Tweak - Due to new session handling, removed session section from the status page.
* Tweak - Removed upsell limit - show whats defined.
* Tweak - Args for upsells to control per-page and cols.
* Tweak - Recoded add_to_cart_action for better handling of variations and groups.
* Tweak - Admin sales stats show totals.
* Tweak - product_variations_{id} changed to product_variations array
* Tweak - Coupon description field.
* Tweak - Exclude up-sells from related products.
* Tweak - Allowed sku search to return > 1 result.
* Tweak - If only one country is enabled, don't show country dropdown on checkout.
* Tweak - Case insensitive coupons.
* Tweak - Made armed forces 'states' under the US rather than in their own 'country'.
* Tweak - Extended woocommerce_update_options for flexibility.
* Tweak - Added disabled to settings API.
* Tweak - Flat rate shipping - if no rules match, and no default is set, don't return a rate.
* Tweak - custom_attributes option added to woocommerce_form_field args. Pass name/value pairs.
* Tweak - Added html5 type inputs to admin with inline validation.
* Tweak - Use WP Core jquery-ui-slider
* Tweak - Further optimisation of icons in admin for HiDPI devices
* Tweak - On product search include post_excerpt, by krbvroc1
* Tweak - Attribute page restricts reserved terms by GeertDD
* Tweak - Arguments for taxonomies are now filterable
* Fix - Added more error messages for coupons.
* Fix - Variation sku updating after selection.
* Fix - Active plugins display on status page.
* Localization - Makepot added by Geert De Deckere for generating POT files.
* Localization - Admin/Frontend POT files to reduce memory consumption on the frontend.
* Localization - French update by Arnaud Cheminand and absoluteweb.
* Localization - Romanian update by silviu-bucsa and a1ur3l.
* Localization - Dutch updates by Ramoonus.
* Localization - Swedish updates by Mikael Jorhult.
* Localization - Localized shortcode button.
* Localization - Norwegian translation by frilyd.
* Localization - Italian update by Giuseppe-Mazzapica.
* Localization - Korean translate by Woo Jin Koh.
* Localization - Bulgarian update by Hristo Pandjarov.
* Localization - Spanish update by bolorino.
* Localization - Finnish translation by Arhi Paivarinta.
* Localization - Chinese (Taiwan) translation by Fliper.
* Localization - Brazilian update by Fernando Daciuk.
* Localization - Hungarian translation by béla.
* Localization - Indonesian translation by Stanley Caramoy.
== Upgrade Notice ==
= 2.0.1 =
This is a major update - Test extensions and your theme prior to updating and ensure that you keep backups. After updating there is no undo. See our [release post](http://www.woothemes.com/?p=165321) and our [preparation guide](http://www.woothemes.com/?p=158537) before upgrading.