woocommerce/readme.txt

377 lines
35 KiB
Plaintext
Raw Normal View History

2016-01-18 11:34:57 +00:00
=== WooCommerce ===
2018-01-30 15:06:39 +00:00
Contributors: automattic, mikejolley, jameskoster, claudiosanches, claudiulodro, kloon, rodrigosprimo, jshreve, coderkevin
Tags: ecommerce, e-commerce, store, sales, sell, shop, cart, checkout, downloadable, downloads, payments, paypal, storefront, stripe, woo commerce, woo
Requires at least: 4.7
2019-03-15 11:35:07 +00:00
Tested up to: 5.1
2019-04-17 01:07:08 +00:00
Stable tag: 3.6.0
2012-06-10 19:12:06 +00:00
License: GPLv3
2016-05-27 01:48:49 +00:00
License URI: https://www.gnu.org/licenses/gpl-3.0.html
WooCommerce is a flexible, open-source eCommerce solution built on WordPress. Sell anything, anywhere and make your way.
2011-08-09 15:16:18 +00:00
== Description ==
WooCommerce is a flexible, open-source eCommerce solution built on WordPress. Whether you're launching a business, taking an existing brick and mortar store online, or designing sites for clients you can get started quickly and build exactly the store you want.
2012-02-16 16:54:22 +00:00
Activate the free WooCommerce plugin on a new or existing WordPress site, follow the optional guided tour, and set up a new store in minutes with:
- Product, Cart, and Checkout pages
- Secure payments by credit card and alternatives
- Configurable shipping options, including flat rates and [label printing](https://woocommerce.com/products/shipping/?utm_source=wp%20org%20repo%20listing&utm_content=3.6)
- Integrate content and commerce across your site via modular blocks
- [Automated tax calculations](https://woocommerce.com/products/tax/?utm_source=wp%20org%20repo%20listing&utm_content=3.6)
- [Google Analytics](https://woocommerce.com/products/woocommerce-google-analytics/?utm_source=wp%20org%20repo%20listing&utm_content=3.6), [MailChimp](https://woocommerce.com/products/mailchimp-for-woocommerce/?utm_source=wp%20org%20repo%20listing&utm_content=3.6), and [Facebook](https://woocommerce.com/products/facebook/?utm_source=wp%20org%20repo%20listing&utm_content=3.6) integration
- [Central store dashboard](https://woocommerce.com/posts/woocommerce-admin-a-new-central-dashboard-for-woocommerce/?utm_source=wp%20org%20repo%20listing&utm_content=3.6) with key metrics, and more.
Beyond the basics, WooCommerce is fully customizable and extendable:
- Choose a design to suit your brand and industry.
- Enhance your store with free and paid extensions: add features and integrate with local and global eCommerce web services.
- Inspect and modify any aspect of the core plugin code.
- Leverage hooks and filters to modify functions.
- Build on top of the REST API and webhooks.
2012-06-21 13:30:04 +00:00
Open-source freedoms mean full ownership of content and data forever plus the expertise of a friendly [global community](https://woocommerce.com/meetups/?utm_source=wp%20org%20repo%20listing&utm_content=3.6).
WooCommerce is built to allow store managers to run an eCommerce site themselves, no web developer needed. There is also a free WooCommerce [mobile app](https://woocommerce.com/mobile/?utm_source=wp%20org%20repo%20listing&utm_content=3.6) (Android and iOS) for store management on the go.
2012-06-21 13:30:04 +00:00
WooCommerce is developed and supported by Automattic, the creators of Jetpack and WordPress.com, along with independent contributors. The [official extension marketplace](https://woocommerce.com/product-category/woocommerce-extensions/?utm_source=wp%20org%20repo%20listing&utm_content=3.6) is on WooCommerce.com.
= From subscriptions to gym classes to luxury cars =
With WooCommerce, you can sell both physical and digital goods in all shapes and sizes, offer product variations, complex configurations, and instant downloads to shoppers; and even sell affiliate goods from online marketplaces.
2014-02-10 11:15:27 +00:00
And those are just the out-of-the-box options. With paid extensions, you can extend your WooCommerce store to take bookings, offer memberships, set up recurring payments by subscription, create dynamic pricing rules, and much more.
2012-06-10 19:12:06 +00:00
Start a monthly wine subscription box, offer a discount on yoga mats to members whove attended 10+ classes, offer configurable hampers or personalized jewelry its all possible with WooCommerce.
2014-02-10 11:15:27 +00:00
= Comprehensive payment options =
WooCommerce comes bundled with the ability to accept major credit cards, alternative payment methods, BACS (bank transfers), and cash on delivery.
2013-03-01 17:17:11 +00:00
For additional options, WooCommerce also integrates with more than 140 region-specific gateways including popular choices like [Stripe](https://woocommerce.com/products/stripe/?utm_source=wp%20org%20repo%20listing&utm_content=3.6), [PayPal](https://woocommerce.com/products/woocommerce-gateway-paypal-checkout/?utm_source=wp%20org%20repo%20listing&utm_content=3.6), [Square](https://woocommerce.com/products/square/?utm_source=wp%20org%20repo%20listing&utm_content=3.6) and [Amazon Pay](https://woocommerce.com/products/pay-with-amazon/?utm_source=wp%20org%20repo%20listing&utm_content=3.6). [Apple Pay](https://woocommerce.com/apple-pay/?utm_source=wp%20org%20repo%20listing&utm_content=3.6) and Google Pay are also supported.
2012-06-10 19:12:06 +00:00
Search for your payment service provider of choice on the [official marketplace](https://woocommerce.com/product-category/woocommerce-extensions/payment-gateways/?utm_source=wp%20org%20repo%20listing&utm_content=3.6).
2014-02-10 11:15:27 +00:00
= Ship locally and globally =
Shipping with WooCommerce is highly configurable. Adjust the built-in settings to offer free shipping or flat rate shipping, limit your shipments to specific countries by setting up shipping zones, or open your store up to the world.
2014-02-10 11:15:27 +00:00
Official extensions connect you with hundreds of local and international carriers including [Royal Mail](https://woocommerce.com/products/royal-mail/?utm_source=wp%20org%20repo%20listing&utm_content=3.6), [FedEx](https://woocommerce.com/products/fedex-shipping-module/?utm_source=wp%20org%20repo%20listing&utm_content=3.6), and [Australia Post](https://woocommerce.com/products/australia-post-shipping-method/?utm_source=wp%20org%20repo%20listing&utm_content=3.6) and let you integrate with [inventory management and fulfilment providers](https://woocommerce.com/product-category/woocommerce-extensions/shipping-methods/inventory-fulfillment/?utm_source=wp%20org%20repo%20listing&utm_content=3.6).
2014-02-10 11:15:27 +00:00
There are also extensions available to add [delivery and shipping options](https://woocommerce.com/product-category/woocommerce-extensions/shipping-methods/delivery-shipping-options/?utm_source=wp%20org%20repo%20listing&utm_content=3.6) and support strategies like buy-one-get-one free, free gifts, and add-ons. [WooCommerce Shipping](https://woocommerce.com/products/shipping/?utm_source=wp%20org%20repo%20listing&utm_content=3.6) supports real-time calculations and printing labels at home.
2015-02-04 16:40:13 +00:00
= Design your store with themes and blocks =
2015-02-04 16:40:13 +00:00
WooCommerce store design starts with a theme of your choice. There are hundreds of free and paid themes available, including [Storefront](https://woocommerce.com/storefront/?utm_source=wp%20org%20repo%20listing&utm_content=3.6) by Automattic -- it's free to all stores and you can choose to have it installed for you during the hguided setup.
2014-02-10 11:15:27 +00:00
Storefront offers deep WooCommerce integration and prioritizes speed and uptime. You can add your brand and define your style by customizing Storefront yourself or adding one of several industry-themed [Storefront child themes](https://woocommerce.com/product-category/themes/storefront-child-theme-themes/?utm_source=wp%20org%20repo%20listing&utm_content=3.6).
2012-02-18 14:17:07 +00:00
Personalize your store's design even more with WooCommerce Blocks (available in WooCommerce 3.6 and above) -- use them to add selections of or single products to any page, for a seamless blending of commerce into content.
= Customize your store with extensions =
The easiest way to add features and functionality to a WooCommerce store is with an extension:
- Sell anything - [Subscriptions](https://woocommerce.com/products/woocommerce-subscriptions/?utm_source=wp%20org%20repo%20listing&utm_content=3.6), [Memberships](https://woocommerce.com/products/woocommerce-memberships/?utm_source=wp%20org%20repo%20listing&utm_content=3.6), [Bookings](https://woocommerce.com/products/woocommerce-bookings/?utm_source=wp%20org%20repo%20listing&utm_content=3.6), [Product Bundles](https://woocommerce.com/products/product-bundles/?utm_source=wp%20org%20repo%20listing&utm_content=3.6), and [more](https://woocommerce.com/product-category/woocommerce-extensions/product-type/).
- Make your store, your way - [Product Add-Ons](https://woocommerce.com/products/product-add-ons/?utm_source=wp%20org%20repo%20listing&utm_content=3.6), [Checkout Field Editor](https://woocommerce.com/products/woocommerce-checkout-field-editor/?utm_source=wp%20org%20repo%20listing&utm_content=3.6), [Additional Variation Images](https://woocommerce.com/products/woocommerce-additional-variation-images/?utm_source=wp%20org%20repo%20listing&utm_content=3.6), and [more](https://woocommerce.com/customize-product-pages?utm_source=wp%20org%20repo%20listing&utm_content=3.6).
- Customize your shipping options - [Table Rate Shipping](https://woocommerce.com/products/table-rate-shipping/?utm_source=wp%20org%20repo%20listing&utm_content=3.6), [Shipment Tracking](https://woocommerce.com/products/shipment-tracking/?utm_source=wp%20org%20repo%20listing&utm_content=3.6), live rates from [top carriers](https://woocommerce.com/product-category/woocommerce-extensions/shipping-methods/shipping-carriers/?utm_source=wp%20org%20repo%20listing&utm_content=3.6), and [more](https://woocommerce.com/product-category/woocommerce-extensions/shipping-methods/?utm_source=wp%20org%20repo%20listing&utm_content=3.6).
- Find your audience, market to them your way - [Google Product Feed](https://woocommerce.com/products/google-product-feed/?utm_source=wp%20org%20repo%20listing&utm_content=3.6), [LiveChat](https://woocommerce.com/products/livechat/?utm_source=wp%20org%20repo%20listing&utm_content=3.6), [Amazon/eBay marketplace integration](https://woocommerce.com/products/amazon-ebay-integration/?utm_source=wp%20org%20repo%20listing&utm_content=3.6), and [more](https://woocommerce.com/product-category/woocommerce-extensions/marketing-extensions/?utm_source=wp%20org%20repo%20listing&utm_content=3.6).
- Drive sales [Dynamic Pricing](https://woocommerce.com/products/dynamic-pricing/?utm_source=wp%20org%20repo%20listing&utm_content=3.6), [Smart Coupons](https://woocommerce.com/products/smart-coupons/?utm_source=wp%20org%20repo%20listing&utm_content=3.6), [Google Ads](https://woocommerce.com/products/google-ads/?utm_source=wp%20org%20repo%20listing&utm_content=3.6), and [more](https://woocommerce.com/product-category/woocommerce-extensions/marketing-extensions/promotions/?utm_source=wp%20org%20repo%20listing&utm_content=3.6).
There are hundreds of official extensions reviewed by WooCommerce developers available on the WooCommerce.com marketplace, and many in the WordPress.org repository and on the wider web.
= Control your data forever =
2011-08-09 15:16:18 +00:00
WooCommerce gives you complete control from taxes to stock levels to customer accounts. Add and remove extensions, change your stores design, and switch themes or hosts or payment service providers, all as you please.
2011-08-09 15:16:18 +00:00
In a world increasingly aware of the importance of data protection, WooCommerce gives you full ownership over what is tracked and stored. If you opt to share [usage data](https://woocommerce.com/usage-tracking/?utm_source=wp%20org%20repo%20listing&utm_content=3.6) with us, your data is anonymized and kept secure. At any stage, you can opt out of all forms of tracking while still enjoying all of WooCommerce's capabilities.
With WooCommerce, your data belongs to you. One of the risks of using a hosted eCommerce platform the risk of losing your store if the provider closes. WooCommerce store data is future-proof -- youre are free to export all your content and take your site wherever you choose.
2011-08-09 15:16:18 +00:00
= Why developers like WooCommerce =
WooCommerce was originally created with developers in mind. Built with a REST API, it integrates with virtually any service. Store data can be accessed anywhere, anytime, 100% securely.
2011-08-09 15:16:18 +00:00
WooCommerce allows developers to easily create, modify, and scale a store that meets clients specifications, and to make enhancements either with extensions or with customs solution.
2011-08-09 15:16:18 +00:00
No matter the size of the store you want to build, WooCommerce has a robust framework that supports stores from basic to enterprise with content and commerce in a single, central location.
2011-08-09 15:16:18 +00:00
WooCommerce is audited by a dedicated team of developers who work across time zones to identify and patch any and all discovered bugs. There is comprehensive, easily-accessible documentation that is updated with each release. With our docs, youll learn how to create the site your client needs.
2011-08-09 15:16:18 +00:00
= Join our growing community =
2012-02-18 14:17:07 +00:00
WooCommerce is one of the fastest-growing eCommerce communities. Were proud that the helpfulness of the community and wealth of resources available online are frequently cited as reasons our users love it.
2012-02-18 14:17:07 +00:00
There are 80+ [WooCommerce Meetups](https://woocommerce.com/woocommerce/meetups/?utm_source=wp%20org%20repo%20listing&utm_content=3.6) taking place in cities across the world that you can attend for free and even get involved in running. WooCommerce also has a regular presence at WordCamps across the globe and wed love to meet you.
2012-02-18 14:17:07 +00:00
If youre interested in contributing to WooCommerce weve got more than 350 contributors, and theres always room for more. Head to the [WooCommerce GitHub Repository](https://github.com/woocommerce/woocommerce?utm_source=wp%20org%20repo%20listing&utm_content=3.6) to find out how you can pitch in.
2013-01-02 13:52:00 +00:00
WooCommerce is currently 100% translated into 24 languages, including Danish, Ukranian, and Persian. If youre interested in helping to localize WooCommerce by adding your local language, visit [translate.wordpress.org](https://translate.wordpress.org/projects/wp-plugins/woocommerce?utm_source=wp%20org%20repo%20listing&utm_content=3.6).
2013-01-02 13:52:00 +00:00
== Frequently Asked Questions ==
2011-10-03 08:00:10 +00:00
= Where can I find WooCommerce documentation and user guides? =
For help setting up and configuring WooCommerce please refer to our [user guide](https://docs.woocommerce.com/documentation/plugins/woocommerce/getting-started/?utm_source=wp%20org%20repo%20listing&utm_content=3.6)
For extending or theming WooCommerce, see our [codex](https://docs.woocommerce.com/documentation/plugins/woocommerce/woocommerce-codex/?utm_source=wp%20org%20repo%20listing&utm_content=3.6).
= Where can I get support or talk to other users? =
2015-08-25 06:05:32 +00:00
If you get stuck, you can ask for help in the [WooCommerce Plugin Forum](https://wordpress.org/support/plugin/woocommerce).
For help with paid extensions from WooCommerce.com, use [our helpdesk](https://woocommerce.com/my-account/tickets/?utm_source=wp%20org%20repo%20listing&utm_content=3.6).
2012-02-18 10:41:35 +00:00
= Will WooCommerce work with my theme? =
Yes! WooCommerce will work with any theme, but may require some styling. Please see our [codex](https://docs.woocommerce.com/documentation/plugins/woocommerce/woocommerce-codex/?utm_source=wp%20org%20repo%20listing&utm_content=3.6) for help. If you're looking for a theme with built in WooCommerce integration we recommend [Storefront](https://woocommerce.com/storefront/?utm_source=wp%20org%20repo%20listing&utm_content=3.6).
2012-02-18 10:41:35 +00:00
= Where can I request new features, eCommerce themes, and extensions? =
You can vote on and request new features and extensions on our [WooIdeas board](http://ideas.woocommerce.com/forums/133476-woocommerce?utm_source=wp%20org%20repo%20listing&utm_content=3.6)
= Where can I report bugs or contribute to the project? =
Report bugs on the [WooCommerce GitHub repository](https://github.com/woocommerce/woocommerce/issues?utm_source=wp%20org%20repo%20listing&utm_content=3.6). You can also report them in our [support forum](https://wordpress.org/support/plugin/woocommerce).
2015-12-17 10:48:46 +00:00
= Where can I find the REST API documentation? =
2015-01-30 15:34:51 +00:00
You can find the documentation of our REST API on the [WooCommerce REST API Docs](https://woocommerce.github.io/woocommerce-rest-api-docs/?utm_source=wp%20org%20repo%20listing&utm_content=3.6).
2015-01-30 15:34:51 +00:00
= WooCommerce is awesome! Can I contribute? =
Yes you can! Join in on our [GitHub repository](https://github.com/woocommerce/woocommerce/?utm_source=wp%20org%20repo%20listing&utm_content=3.6).
== Installation ==
= Minimum Requirements =
* PHP 7.2 or greater is recommended
* MySQL 5.6 or greater is recommended
Visit the [WooCommerce server requirements documentation](https://docs.woocommerce.com/document/server-requirements/?utm_source=wp%20org%20repo%20listing&utm_content=3.6) for a detailed list of server requirements.
= Automatic installation =
Automatic installation is the easiest option -- WordPress will handles the file transfer, and you wont need to leave your web browser. To do an automatic install of WooCommerce, log in to your WordPress dashboard, navigate to the Plugins menu, and click “Add New.”
In the search field type “WooCommerce,” then click “Search Plugins.” Once youve found us, you can view details about it such as the point release, rating, and description. Most importantly of course, you can install it by! Clicki “Install Now,” and WordPress will take it from there.
= Manual installation =
Manual installation method requires downloading the WooCommerce plugin and uploading it to your web server via your favorite FTP application. The WordPress codex contains [instructions on how to do this here](https://codex.wordpress.org/Managing_Plugins#Manual_Plugin_Installation).
= Updating =
Automatic updates should work smoothly, but we still recommend you back up your site.
If you encounter issues with the shop/category pages after an update, flush the permalinks by going to WordPress > Settings > Permalinks and hitting “Save.” That should return things to normal.
= Sample data =
WooCommerce comes with some sample data you can use to see how products look; import sample_products.xml via the [WordPress importer](https://wordpress.org/plugins/wordpress-importer/). You can also use the core [CSV importer](https://docs.woocommerce.com/document/product-csv-importer-exporter/?utm_source=wp%20org%20repo%20listing&utm_content=3.6) or our [CSV Import Suite extension](https://woocommerce.com/products/product-csv-import-suite/?utm_source=wp%20org%20repo%20listing&utm_content=3.6) to import sample_products.csv
== Contributors & Developers ==
“WooCommerce” has been translated into 55 locales. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/woocommerce/contributors) for their contributions. [Translate “WooCommerce” into your language](https://translate.wordpress.org/projects/wp-plugins/woocommerce?utm_source=wp%20org%20repo%20listing&utm_content=3.6).
INTERESTED IN DEVELOPMENT?
[Browse the code](https://plugins.trac.wordpress.org/browser/woocommerce/), check out the [SVN repository](https://plugins.svn.wordpress.org/woocommerce/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/woocommerce/) by [RSS](https://plugins.trac.wordpress.org/log/woocommerce/?limit=100&mode=stop_on_copy&format=rss).
2011-10-03 08:00:10 +00:00
2011-08-09 15:16:18 +00:00
== Changelog ==
= 3.6.0 - 2019-04-17 =
2019-03-11 15:49:22 +00:00
* Enhancement - Merged WooCommerce Gutenberg Products Block feature plugin. Adds blocks for the new editor, including
hand picked products, featured products, products by category/attribute, sale products, new products, top rated
products, and best selling products. #22954
2019-01-07 11:27:05 +00:00
* Enhancement - Only include order erasure bulk action if erasure is enabled in settings. #22354
2019-01-09 16:52:43 +00:00
* Enhancement - Customer notes containing URLs now automatically converts to clickable links. #21927
2019-01-22 15:21:25 +00:00
* Enhancement - Add increase and decrease stock options to bulk edit form. #22475
2019-01-31 13:39:09 +00:00
* Enhancement - Allow states in zones to be searched by country name. #22339
2019-02-08 13:06:53 +00:00
* Enhancement - Added registration success notices to account pages. #22650
* Enhancement - Store notice is visible again if the notice text is changed. #22645
2019-02-13 14:42:18 +00:00
* Enhancement - Add aria-label attribute to shop orderby selector to improve accessibility. #22683
2019-03-11 15:49:22 +00:00
* Enhancement - When adding, editing, and deleting items manually from orders, the corresponding product stock will be
updated to reflect the event and an order note will log the event. #22329
2019-03-13 15:10:06 +00:00
* Enhancement - Added suggestions for official extensions to Products, Edit Product and Orders screens.
* Enhancement - Store attribute values as post_excerpt for variations to support easier searching for variations. #22083
* Enhancement - Improved username generation and introduced wc_create_new_customer_username function. #23145
2019-01-16 11:35:51 +00:00
* Tweak - Generalize shipping estimate text on cart page. #22467
2019-01-16 15:12:11 +00:00
* Tweak - Include auto draft orders in order list filters. #22380
2019-01-22 14:38:49 +00:00
* Tweak - Only include the network orders widget on the main site dashboard. #22318
2019-01-23 13:27:37 +00:00
* Tweak - Only show available shipping continents when selecting shipping zone region. #22131
2019-01-23 15:25:47 +00:00
* Tweak - Use Shortcode block on default WooCommerce pages. #21817
2019-01-23 21:37:47 +00:00
* Tweak - Show full category hierarchy in product URLs when term IDs are not sequential. #22526
2019-02-08 13:06:53 +00:00
* Tweak - Make sure account and checkout endpoints only work under account and checkout pages. #22631
2019-02-12 16:17:31 +00:00
* Tweak - Show loading graphic when order form is submitted. #22664
2019-02-27 06:33:12 +00:00
* Tweak - Add alt text to gallery images #22863
2019-02-27 12:56:33 +00:00
* Tweak - Improved `display_name` generation during checkout. #22786
2019-03-07 16:39:15 +00:00
* Tweak - Send correct calling code and phone number to PayPal standard when using non-US addresses. #22693
2019-03-05 12:56:53 +00:00
* Tweak - Added tooltip to refund-amount input box and made it readonly when taxes are enabled. #22820
2019-03-11 13:28:54 +00:00
* Tweak - Remove admin alert for the WooCommerce Gutenberg Products Block feature plugin. #22982
2019-03-12 09:28:26 +00:00
* Tweak - Setup Wizard: support keyboard navigation to toggle on/off features. #22936
2019-03-12 13:36:12 +00:00
* Tweak - Set reply-to address for all emails. #22979
* Tweak - Setup wizard redirection improvements. #22977
* Tweak - Simplify display of discount amounts within orders. #22949
2019-01-31 16:33:13 +00:00
* Template - Moved the order of rememberme checkboxes for accessibility so they tab in order. #21454
2019-02-04 11:23:58 +00:00
* Template - New structure for attributes template, including new `woocommerce_display_product_attributes` filter. #22480
2019-03-14 07:43:30 +00:00
* Template - Admin cancelled order email reworded. #22971
* Dev - Update action scheduler to version 2.2.2. #23162
2019-03-13 17:20:49 +00:00
* Dev - Update action scheduler to version 2.2.1. #23016
2019-03-12 13:23:13 +00:00
* Dev - Use ActionScheduler for database updates. Improved update notice. #22904
2019-01-07 11:27:05 +00:00
* Dev - Introduce `woocommerce_reviews_title` filter. #22216
2019-01-07 12:51:10 +00:00
* Dev - Added `woocommerce_cheque_process_payment_order_status` filter allowing plugins to change the order status to the Cheque gateway. #21402
2019-01-07 12:53:00 +00:00
* Dev - Add the current coupon object to the `woocommerce_get_shop_coupon_data` filter. #21442
2019-01-07 13:06:23 +00:00
* Dev - New filter `woocommerce_gallery_image_html_attachment_image_params` for manipulating gallery images. #22005
2019-01-07 13:12:37 +00:00
* Dev - New filter `woocommerce_widget_get_current_page_url` for manipulating links in widgets. #21537
2019-01-08 14:24:19 +00:00
* Dev - Move wc_get_template filter to allow plugins to register locations for template files that do not exist in WooCommerce core. #21764
2019-01-08 15:01:28 +00:00
* Dev - Add support for custom classes on global/quantity-input.php. #21553
2019-01-09 11:53:21 +00:00
* Dev - Pass product object to `woocommerce_add_to_cart_redirect` filter where appropriate. #22123
2019-01-09 17:02:05 +00:00
* Dev - Add support for forgetting the cart contents and user session when switching between accounts using the User Switching plugin. #21991
2019-01-10 12:25:49 +00:00
* Dev - Added a consistent form class to the Track Order Form. #21991
2019-01-14 17:01:10 +00:00
* Dev - Add $orderby and $order params to filter `woocommerce_get_catalog_ordering_args`. #22257
2019-01-14 17:02:57 +00:00
* Dev - Add new pre query filter to WC_Product_Data_Store_CPT::search_products(). #22165
2019-01-10 12:28:41 +00:00
* Dev - Added additional parameters to the `woocommerce_variation_option_name` filter. #21153
2019-01-14 17:05:31 +00:00
* Dev - Added new filter `woocommerce_get_min_max_price_meta_query`. #22255
2019-03-11 15:49:22 +00:00
* Dev - Added a filter to WC_REST_CRUD_Controller::get_collection_params method to allow developers to change params in
the same way as WP_Rest_Posts_controller::get_collection_params. #21562
2019-01-16 13:02:14 +00:00
* Dev - Add $zone param to woocommerce_shipping_zone_before_methods_table and woocommerce_shipping_zone_after_methods_table actions. #21961
2019-01-16 14:49:05 +00:00
* Dev - Added `woocommerce_geolocation_ajax_get_location_hash` filter. #22350
2019-01-16 15:23:00 +00:00
* Dev - Added `woocommerce_variation_prices_array` filter. #21003
2019-01-16 16:27:38 +00:00
* Dev - Added `wc_emptied_cart` javascript event when cart is emptied. #22469
2019-01-21 15:23:55 +00:00
* Dev - Switched `woocommerce_ordered_again` hook to ref_array. #22425
* Dev - `woocommerce_checkout_before_order_review_heading` action added in checkout form template. #22481
2019-01-21 17:00:08 +00:00
* Dev - Added `woocommerce_variation_header` hook in variations list. #21341
2019-01-16 16:31:42 +00:00
* Dev - Add a filter, woocommerce_current_user_can_edit_customer_meta_fields, to bypass manage_woocommerce when editing customer meta fields. #22277
2019-03-11 15:49:22 +00:00
* Dev - Adds filter on the return value of function 'get_item_tax_rates'. This gives developers the possibility to
prevent the mandatory caching of tax rates. #22488
2019-01-21 16:00:05 +00:00
* Dev - Add filters for mail callback in WC_Email::send method. #22394
2019-01-22 12:01:54 +00:00
* Dev - Add an instance method to WC_Admin_Taxonomies. #21884
2019-01-22 13:10:41 +00:00
* Dev - Added `woocommerce_order_is_pending_statuses` filter and `wc_get_is_pending_statuses` function. #22409
2019-01-22 12:05:33 +00:00
* Dev - Filter save_payment_method_checkbox to allow "Save to account" checkbox to be removed from the checkout form. #21859
2019-01-22 11:23:53 +00:00
* Dev - Added triggers to the gallery script to allow 3rd parties to run scripts before and after initialization. #22501
2019-01-22 14:36:03 +00:00
* Dev - Added `woocommerce_add_to_cart_qty_html` filter. #21069
2019-01-22 18:18:36 +00:00
* Dev - Prevent extract from polluting hook arguments in wc_get_template(). #21722
2019-01-22 16:07:02 +00:00
* Dev - Add `woocommerce_pre_remove_cart_item_from_session` hook to allow removal of cart items when the cart is loaded from the session. #22290
2019-01-22 18:29:02 +00:00
* Dev - Add `$attribute` to `woocommerce_product_option_terms` filter. #21648
2019-01-23 15:17:22 +00:00
* Dev - Added error handling and timeout to cart fragment ajax call. #21043
2019-01-23 16:40:25 +00:00
* Dev - Remove unused legacy 'woocommerce_lock_down_admin' option and use filter only instead. #17796
2019-01-23 17:07:52 +00:00
* Dev - Allow custom settings sections in the Shipping tab. #21719
2019-01-31 13:33:10 +00:00
* Dev - Update Emogrifier library to 2.1. #22342
2019-01-31 13:39:09 +00:00
* Dev - Moved core state codes to a single file. #22339
2019-01-31 15:02:08 +00:00
* Dev - Adds filter for product categories displayed by `product_categories` shortcode. #22571
2019-01-31 15:48:26 +00:00
* Dev - Moves cart hash calculation to WC_Cart class. #21050
2019-02-04 11:23:58 +00:00
* Dev - Removed deprecated Simplify gateway. #22410
2019-02-12 16:17:31 +00:00
* Dev - Added `woocommerce_paypal_force_one_line_item` filter to control how items are sent to PayPal. #22653
2019-02-13 14:42:18 +00:00
* Dev - Added `woocommerce_update_product_stock_query` to filter the direct sql query to update product stock. #22672
* Dev - Added `woocommerce_product_loop_title_classes` filter to modify product title loop classes. #22717
2019-02-18 11:57:56 +00:00
* Dev - Delay `woocommerce_loaded` hook until all plugins are loaded. #22536
2019-02-19 10:01:12 +00:00
* Dev - Added `woocommerce_product_price_class` filter to modify product price classes. #22748
2019-02-26 14:07:16 +00:00
* Dev - `woocommerce_product_stock_status_options` filter added for stock status options. #22834
2019-03-01 10:04:59 +00:00
* Dev - `woocommerce_before_cart_emptied` action before cart is emptied. #22846
2019-03-04 13:51:12 +00:00
* Dev - Added filters for shipping options - `woocommerce_shipping_ID_option` and `woocommerce_shipping_ID_instance_option`. #22771
2019-03-06 16:49:54 +00:00
* Dev - Refactor comment/rating update functions. #22909
2019-03-08 10:08:36 +00:00
* Dev - Introduced wc_sanitize_phone_number() function. #22962
2019-03-11 15:49:22 +00:00
* Dev - Added `woocommerce_get_product_subcategories_cache_key` filter to allow the cache to be renamed if for instance
the site runs in multiple languages and needs a unique cache per language. #22915
2019-03-08 10:16:52 +00:00
* Dev - Inactive, MU, Dropin plugins and WooCommerce.com account connection status added to System Status Report. #22887
2019-03-11 13:28:54 +00:00
* Dev - Make error handling consistent in payment processing for pay page and checkout. #22916
2019-03-11 15:49:22 +00:00
* Dev - Improved usage and event tracking (if opted in). #22955
2019-03-14 07:30:48 +00:00
* Dev - Pass class context to woocommerce_email_styles filter. #23027
2019-03-06 16:49:54 +00:00
* Fix - Use correct address for taxes when applying/removing coupons. #22802
2019-01-22 13:32:49 +00:00
* Fix - Hide ratings on the shop page when reviews are disabled. #22476
2019-01-09 11:28:03 +00:00
* Fix - Fix W3C validation of single product page quantity input. #22333
2019-01-22 13:07:39 +00:00
* Fix - Give product variations a unique guid after creation. #22324
2019-01-22 13:30:14 +00:00
* Fix - Deduct correct refunded amounts in calculated net daily sales export CSV. #22518
2019-01-22 14:48:10 +00:00
* Fix - Country sorting for stores which use a language that uses a lot of accented characters, e.g. Spanish. #22417
2019-01-22 16:13:57 +00:00
* Fix - Customer VAT exempt status now carries through to order when placed via checkout. #22458
2019-01-23 15:13:17 +00:00
* Fix - Handle full refunds for taxes by code report. #21843
* Fix - Option "Used for variations" should show only for variable products when saving attributes. #22524
2019-01-23 21:57:04 +00:00
* Fix - Allow pa_ in product attribute slugs. #22112
2019-01-31 12:57:02 +00:00
* Fix - Fix customer creation dates in API. #22269
2019-01-31 13:36:09 +00:00
* Fix - Get widget instance setting defaults so it shows in customiser before save. #22345
2019-01-31 13:39:09 +00:00
* Fix - PR state codes. #22339
2019-03-11 15:49:22 +00:00
* Fix - Allow selecting states from the Country / State drop-down for your store address when you have the option
enabled to sell to specific countries. #22339
2019-02-01 14:41:21 +00:00
* Fix - Restrict the price filter widget to filtering the main product query. #22621
2019-02-04 11:23:58 +00:00
* Fix - Default placeholder image resizing. #22443
2019-02-05 11:03:27 +00:00
* Fix - HTML tags should be stripped from description in Structured Data of Product. #22596
2019-02-04 11:23:58 +00:00
* Fix - For logged in customers, pull default address fields from customer object, not session object, to avoid incorrect mixes of data. #22392
2019-02-12 16:17:31 +00:00
* Fix - Misc tax rounding improvements. #22420
2019-02-13 14:42:18 +00:00
* Fix - Respect shop page subcategories setting when `page/N/` is added to the URL. #22589
2019-02-19 10:01:12 +00:00
* Fix - Check for decoded taxonomy name when unsetting product terms. #22740
* Fix - If date paid is not set but payment complete status has passed, set it. #22735
* Fix - Prevent webhooks for drafts, and correct create vs updated for manual orders. #22731
* Fix - Ignore invalid default customer locations. #22357
* Fix - The state select field was missing a placeholder. #22357
* Fix - Fix state field rendering when customer address is not in a valid selling country. #22357
2019-02-26 10:25:24 +00:00
* Fix - Correctly handle negative fees when using the REST API. #22782
* Fix - Make sure local_pickup taxes do not hang around when local_pickup is not available for the selected location during checkout. #22826
2019-02-27 11:39:27 +00:00
* Fix - Remove Plugin and Theme background installer hooks, cannot run as there are no events scheduled for it. #22799
2019-02-28 12:09:07 +00:00
* Fix - Trigger zoom if moving cursor over image quickly in product gallery. #22784
2019-02-28 12:09:55 +00:00
* Fix - PayPal: Add meta data, before changing order status. #22892
2019-03-06 16:49:54 +00:00
* Fix - Make price filter widget tax aware when you have excl prices entered but show prices incl of tax. #22540
2019-03-11 13:28:54 +00:00
* Fix - Loop attribute panels to disable options rather than look at values to prevent notices. #22891
2019-03-11 15:56:25 +00:00
* Fix - When deleting zone methods, also remove setting options. #22867
2019-03-12 13:23:13 +00:00
* Fix - Correctly show state fields after posting the edit address form. #22948
* Fix - Validate coupon usage limit for manual orders correctly before order is saved. #22980
* Fix - Make coupon code sanitization match post_title sanitization. #22945
2019-03-12 13:50:44 +00:00
* Fix - Ensure WC_Helper sees plugin activation events via CLI. #22972
* Fix - Setup wizard redirection improvements. #22977
2019-03-12 18:15:43 +00:00
* Fix - Correctly show stock status for products when manually creating an order in the admin. #22997
2019-03-14 07:25:19 +00:00
* Fix - After logging in update customer session ID. #23001
2019-03-14 22:57:27 +00:00
* Fix - Narrow viewport css in setup wizard. #23033
2019-03-14 23:19:45 +00:00
* Fix - Allow entering of date only ( no time ) when placing a singular product on sale. #22973
* Fix - Download link URL in helper. #23146
* Fix - Completed email wording update. #23128
* Fix - REST API: Allow filtering by future status #23138
* Fix - Update refund reason to make it clear process is manual. #23149
* Fix - Hide stock status for variations when the parent is managing stock. #23069
* Fix - Force variation product type in WC_Ajax::add_variation. #23131
* Fix - WooCommerce writes current_theme_supports_woocommerce option on every regular page view. #23035
* Fix - Update the rating request text in the footer to be friendlier for screen reader users. #23039
* Fix - Null check variable before accessing its properties on checkout page. #23047
* Fix - Recognize all input fields with ID for checkout fields. #23050
* Fix - Avoid regenerating thumbnails on every page load. #21800
* Fix - Changed 'private' methods on WC_Breadcrumb class to 'protected'. #23057
* Fix - Jumping to top of page when dismissing store notice. #23066
2019-03-11 13:28:54 +00:00
* Performance - Product meta data lookup table used for sorting and slow queries. #22718
2019-01-31 13:29:24 +00:00
* Performance - Prime caches when reading variations. #22587
2019-02-04 11:23:58 +00:00
* Performance - Only include REST API classes and objects during `rest_api_init` hook. #22615
2019-02-06 13:19:42 +00:00
* Performance - Improved how versioned transients are set/cleanup to avoid cron. #22511
2019-02-07 13:35:08 +00:00
* Performance - Optimized product CSS class functions to avoid multiple product reads and duplication. #22610
2019-02-08 13:06:53 +00:00
* Performance - Improved caching of template loader, product types, and layered nav widget. #22612
2019-02-08 13:11:11 +00:00
* Performance - Remove external lookup of IP addresses on localhost. #22608
2019-02-19 10:01:12 +00:00
* Performance - Improved speed of the `find_matching_product_variation` variation lookup function. #22423
* Performance - Prevent frontend code from being loaded during REST API. #21090
* Performance - Load only active webhooks on pages and allow limits to be set by developers. #22760
2019-03-04 14:15:33 +00:00
* Performance - Index on downloadable_product_permissions to improve speed when fetching downloads for customers. #22906
2019-03-11 15:49:22 +00:00
* Performance - Improved term ordering queries, making the sorting apply by default via the DB query rather than sorting
all terms with PHP. Removed legacy term meta table usage. #22570
2019-03-07 16:39:15 +00:00
* Performance - Use day, not time, in status widget for caching. #22950
* Performance - Improve slow term ordering by using queries instead of php. #22570
* Performance - Removes legacy woocomerce_termmeta table and swap out all calls to legacy term meta functions to the new WP ones. #22570
* Performance - Apply term sorting using get_terms_defaults hook instead of custom parameters. #22570
* Performance - Use pre_get_terms hook to detect menu_order sorting param and apply to the term query. Meta sorting is now possible through WP. #22570
* Performance - Use terms_clauses hook to support numeric name sorting and to improve the menu order sorting so it works if meta is missing. #22570
2019-03-08 10:16:52 +00:00
* Performance - Added caching to System Status Report. #22887
2019-03-08 10:22:56 +00:00
* Performance - Delete empty meta on update in data-stores. #22773
2019-03-08 11:01:41 +00:00
* Performance - Image regeneration edge cases. #22818
2019-03-11 13:28:54 +00:00
* Performance - Dont query for an order count unnecessarily. #22984
2019-03-12 13:50:44 +00:00
* Performance - Add caching to attribute functions. #22938
2019-03-14 22:57:27 +00:00
* Performance - Add ability to run product lookup table updates via WP CLI. #23031
2019-01-07 12:42:16 +00:00
* Localization - Modify administrative regions of Greece to default to their english ISO 3166-2 names, instead of using the native GR names. #21945
2019-01-16 11:35:51 +00:00
* Localization - Added US Minor Outlying Islands as states to avoid confusion with US. #22468
2019-01-16 11:50:33 +00:00
* Localization - Dutch postcode validation. #22316
2019-01-21 15:23:55 +00:00
* Localization - Made municipality address field optional for Latvia. #22487
* Localization - Added new Venezuelan currency Bs S. #22435
* Localization - Added Danish locale. #22495
2019-01-31 12:43:50 +00:00
* Localization - Update Peruvian currency. #22602
2019-02-19 10:01:12 +00:00
* Localization - Update CA address format. #22692
2019-02-27 12:59:24 +00:00
* Localization - Updated JP field order. #22774
[See changelog for all versions](https://raw.githubusercontent.com/woocommerce/woocommerce/master/CHANGELOG.txt).
2015-11-11 21:50:25 +00:00
== Upgrade Notice ==
2017-05-31 15:43:36 +00:00
= 3.0 =
2017-05-01 01:16:37 +00:00
3.0 is a major update. Make a full site backup, update your theme and extensions, and [review update best practices](https://docs.woocommerce.com/document/how-to-update-your-site) before upgrading.