=== WooCommerce === Contributors: automattic, mikejolley, jameskoster, claudiosanches, rodrigosprimo, peterfabian1000, vedjain, jamosova, obliviousharmony, konamiman, sadowski, wpmuguru, royho Tags: e-commerce, store, sales, sell, woo, shop, cart, checkout, downloadable, downloads, payments, paypal, storefront, stripe, woo commerce Requires at least: 5.3 Tested up to: 5.6 Requires PHP: 7.0 Stable tag: 4.8.0 License: GPLv3 License URI: https://www.gnu.org/licenses/gpl-3.0.html WooCommerce is the world’s most popular open-source eCommerce solution. == Description == WooCommerce is [the world’s most popular](https://trends.builtwith.com/shop) open-source eCommerce solution. Our core platform is free, flexible, and amplified by a global community. The freedom of open-source means you retain full ownership of your store’s content and data forever. Whether you’re launching a business, taking brick-and-mortar retail online, or developing sites for clients, use WooCommerce for a store that powerfully blends content and commerce. - **Create beautiful, enticing storefronts** with [themes](https://woocommerce.com/product-category/themes/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing) suited to your brand and industry. - **Customize pages in minutes** using modular [product blocks](https://docs.woocommerce.com/document/woocommerce-blocks/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing). - Showcase physical and digital goods, product variations, custom configurations, instant downloads, and affiliate items. [Bookings](https://woocommerce.com/products/woocommerce-bookings/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing), [memberships](https://woocommerce.com/products/woocommerce-memberships/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing), [subscriptions](https://woocommerce.com/products/woocommerce-subscriptions/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing), and [dynamic pricing](https://woocommerce.com/products/dynamic-pricing/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing) rules are only an extension away. - **Rise to the top of search results** by leveraging [WordPress’ SEO advantage](https://www.searchenginejournal.com/wordpress-best-cms-seo/). Built-in tools and popular integrations help you efficiently manage your business operations. Many services are free to add with a single click via the optional [Setup Wizard](https://docs.woocommerce.com/document/woocommerce-setup-wizard/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing). - **Choose how you want to get paid**. Conveniently manage payments from the comfort of your store with [WooCommerce Payments](https://woocommerce.com/payments/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing) (U.S.-only). Securely accept cards, mobile wallets, bank transfers, and cash thanks to [100+ payment gateways](https://woocommerce.com/product-category/woocommerce-extensions/payment-gateways/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing) – including [Stripe](https://woocommerce.com/products/stripe/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing), [PayPal](https://woocommerce.com/products/woocommerce-gateway-paypal-checkout/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing), and [Square](https://woocommerce.com/products/square/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing). - **Configure your shipping options**. Print USPS labels right from your dashboard and even schedule a pickup with [WooCommerce Shipping](https://woocommerce.com/products/shipping/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing) (U.S.-only). Connect with [well-known carriers](https://woocommerce.com/product-category/woocommerce-extensions/shipping-methods/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing) such as UPS, FedEx, and ShipStation – plus a wide variety of delivery, inventory, and fulfillment solutions for your locale. - **Simplify sales tax**. Add [WooCommerce Tax](https://woocommerce.com/products/tax/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing) or [similar integrated services](https://woocommerce.com/product-category/woocommerce-extensions/tax?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing) to make automated calculations a reality. = Grow your business, add features, and monitor your store on the go = WooCommerce means business. Keep tabs on the performance metrics most important to you with [WooCommerce Admin](https://wordpress.org/plugins/woocommerce-admin/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing) – a powerful, customizable central dashboard for your store. Expand your audience across marketing and social channels with [Google Ads](https://woocommerce.com/products/google-ads/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing), [HubSpot](https://woocommerce.com/products/hubspot-for-woocommerce/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing), [Mailchimp](https://woocommerce.com/products/mailchimp-for-woocommerce/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing), and [Facebook](https://woocommerce.com/products/facebook/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing) integrations. You can always check out the in-dashboard [Marketing Hub](https://docs.woocommerce.com/document/marketing-hub/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing) for fresh ideas and tips to help you succeed. Enhance store functionality with hundreds of free and paid extensions from the [official WooCommerce Marketplace](https://woocommerce.com/products/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing). Our developers [vet each new extension](https://docs.woocommerce.com/document/marketplace-overview/#section-6?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing) and regularly review existing inventory to maintain Marketplace quality standards. We are actively [looking for products that help store builders create successful stores](https://docs.woocommerce.com/document/marketplace-overview/#section-2?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing). Manage your store from anywhere with the free WooCommerce [mobile app](https://woocommerce.com/mobile/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing) (Android and iOS). Spoiler alert: Keep an ear out for the slightly addictive "cha-ching" notification sound each time you make a new sale! = Own and control your store data – forever = With WooCommerce, your data belongs to you. Always. If you opt to share [usage data](https://woocommerce.com/usage-tracking/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing) with us, you can feel confident knowing that it’s anonymized and kept secure. Choose to opt-out at any time without impacting your store. Unlike hosted eCommerce solutions, WooCommerce store data is future-proof; should you wish to migrate to a different platform, you’re free to export all your content and take your site wherever you choose. No restrictions. = Why developers choose (and love) WooCommerce = Developers can use WooCommerce to create, customize, and scale a store to meet a client’s exact specifications, making enhancements through extensions or custom solutions. - Leverage [hooks and filters](https://docs.woocommerce.com/document/introduction-to-hooks-actions-and-filters/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing) to modify or create functionality. - Integrate virtually any service using a robust [REST API](https://docs.woocommerce.com/document/woocommerce-rest-api/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing) and webhooks. - Design and build custom content blocks with React. - [Inspect and modify](https://docs.woocommerce.com/documentation/plugins/woocommerce/woocommerce-codex/extending/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing) any aspect of the core plugin code. - Speed up development with a lightning-fast [CLI](https://woocommerce.github.io/code-reference/classes/wc-cli-rest-command.html?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing). The core platform is tested rigorously and often, supported by a dedicated development team working across time zones. Comprehensive documentation is updated with each release, empowering you to build exactly the store required. = Be part of our growing international community = WooCommerce has a large, passionate community dedicated to helping merchants succeed, and it’s growing fast. There are [WooCommerce Meetups](https://woocommerce.com/meetups/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing) in locations around the world that you can attend for free and even get involved in running. These events are a great way to learn from others, share your expertise, and connect with like-minded folks. WooCommerce also has a regular presence at WordCamps across the globe – we’d love to meet you. = Contribute and translate = WooCommerce is developed and supported by Automattic, the creators of WordPress.com and Jetpack. We also have hundreds of independent contributors, and there’s always room for more. Head to the [WooCommerce GitHub Repository](https://github.com/woocommerce/woocommerce?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing) to find out how you can pitch in. WooCommerce is translated into multiple languages, including Danish, Ukrainian, and Persian. Help localize WooCommerce even further by adding your locale – visit [translate.wordpress.org](https://translate.wordpress.org/projects/wp-plugins/woocommerce/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing). == Frequently Asked Questions == = Where can I find WooCommerce documentation and user guides? = For help setting up and configuring WooCommerce, please refer to [Getting Started](https://docs.woocommerce.com/documentation/plugins/woocommerce/getting-started/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing) and the [New WooCommerce Store Owner Guide](https://woocommerce.com/guides/new-store/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing). For extending or theming WooCommerce, see our [codex](https://docs.woocommerce.com/documentation/plugins/woocommerce/woocommerce-codex/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing), as well as the [Plugin Developer Handbook](https://docs.woocommerce.com/document/create-a-plugin/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing). = Where can I get help or talk to other users about WooCommerce Core? = If you get stuck, you can ask for help in the [WooCommerce Support Forum](https://wordpress.org/support/plugin/woocommerce/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing) by following [these guidelines](https://wordpress.org/support/topic/guide-to-the-woocommerce-forum/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing), reach out via the [WooCommerce Community Slack](https://woocommerce.com/community-slack/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing), or post in the [WooCommerce Community group](https://www.facebook.com/groups/advanced.woocommerce?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing) on Facebook. = Where can I get help for extensions I have purchased on WooCommerce.com? = For assistance with paid extensions from the WooCommerce.com Marketplace: first, review our [self-service troubleshooting guide](https://docs.woocommerce.com/document/woocommerce-self-service-guide/). If the problem persists, kindly log a support ticket via [our helpdesk](https://woocommerce.com/my-account/create-a-ticket/). Our dedicated Happiness Engineers aim to respond within 24 hours. = I’m having trouble logging in to WooCommerce.com – what now? = First, troubleshoot common login issues using this helpful [step-by-step guide](https://docs.woocommerce.com/document/log-into-woocommerce-com-with-wordpress-com/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing). Still not working? [Get in touch with us](https://woocommerce.com/contact-us/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing). = Will WooCommerce work with my theme? = Yes! WooCommerce will work with any theme but may require some additional styling. If you’re looking for a theme featuring deep WooCommerce integration, we recommend [Storefront](https://woocommerce.com/storefront/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing). = How do I update WooCommerce? = We have a detailed guide on [How To Update WooCommerce](https://docs.woocommerce.com/document/how-to-update-woocommerce/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing). = My site broke – what do I do? = Start by diagnosing the issue using our helpful [troubleshooting guide](https://docs.woocommerce.com/documentation/get-help/troubleshooting-get-help/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing). If you noticed the error after updating a theme or plugin, there might be compatibility issues between it and WooCommerce. If the issue appeared after updating WooCommerce, there could be a conflict between WooCommerce and an outdated theme or plugin. In both instances, we recommend running a conflict test using [Health Check](https://docs.woocommerce.com/document/troubleshooting-using-health-check/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing) (which allows you to disable themes and plugins without affecting your visitors) or troubleshooting the issue using a [staging site](https://docs.woocommerce.com/document/how-to-test-for-conflicts/#section-3?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing). = Where can I report bugs? = Report bugs on the [WooCommerce GitHub repository](https://github.com/woocommerce/woocommerce/issues?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing). You can also notify us via our support forum – be sure to search the forums to confirm that the error has not already been reported. = Where can I request new features, themes, and extensions? = Request new features and extensions and vote on existing suggestions on our official [ideas board](https://ideas.woocommerce.com/forums/133476-woocommerce?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing). Our Product teams regularly review requests and consider them valuable for product planning. = WooCommerce is awesome! Can I contribute? = Yes, you can! Join in on our [GitHub repository](https://github.com/woocommerce/woocommerce/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing) and follow the [development blog](https://woocommerce.wordpress.com/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing) to stay up-to-date with everything happening in the project. = Where can I find REST API documentation? = Extensive [WooCommerce REST API Documentation](https://woocommerce.github.io/woocommerce-rest-api-docs/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing) is available on GitHub. = My question is not listed here. Where can I find more answers? = Check out [Frequently Asked Questions](https://docs.woocommerce.com/document/frequently-asked-questions/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing) for more. == 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 won’t 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 you’ve 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! Click “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://wordpress.org/support/article/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 == Changelog == = 4.8.0 - 2020-12-08 = **WooCommerce** * Enhancement - Limited the system status report's "not tested with version" warning to major versions. #28114 * Enhancement - Add shipping, tax, and fee lines to refund REST API response. #28241 * Enhancement - Added support for Twenty Twenty-One theme. #28134 * Tweak - Reduced the memory usage of AJAX product searches. #28177 * Tweak - Replaced deprecated jQuery functionality. #28005, #28058 * Tweak - Hid "Add to cart" button for out of stock grouped products. #28169 * Tweak - Made product date deserialization more explicit. #28052 * Fix - Stock adjustment when deleting a refunded order item. #28069 * Fix - Avatar display for recent reviews widget in admin area. #28067 * Fix - Incorrect product sorting user capability. #28062 * Fix - PayPal response emptying uninitialized cart. #28027 * Fix - Display of visual feedback after pressing "Place Order" in `Twenty Twenty` and `Twenty Nineteen` themes #27997 * Fix - Category and tag bulk deletion message. #27856 * Fix - Corrected Puerto Rico address validation. #28465 * Dev - Filter: `woocommerce_product_has_options` to products. #27514 * Dev - Added error message to `checkout_error` JS event. #28101 * Dev - Replaced usage of deprecated `woocommerce_reset_loop()` in product category shortcodes. #28242 * Dev - Set "Tested up to" header to WordPress 5.6. #28388 * Localization - Jamaican currency, states, and address structure. #27723 * Localization - Better display of inclusive taxes during checkout. #28064 * Localization - Validation for Belgium postcodes. #28145 **WooCommerce Admin - 1.7.0 & 1.7.1 & 1.7.2 & 1.7.3** * Enhancement - Variations report. #5167 * Enhancement - Add ability to toggle homescreen layouts. #5429 * Enhancement - Accordion component #5474 * Enhancement - Badge component #5520 * Tweak - Remove customer analytics data upon order deletion #5171 * Tweak - Updating Stripe key field validation to support test keys #5201 * Tweak - Wrap search control selected items in list #5231 * Tweak - Update store setup link to redirect to setup wizard #5200 * Tweak - Removing breadcrumbs from wc-admin header #5232 * Tweak - Use consistent markdown headers in navigation readme #5417 * Tweak - Remove Store Setup Alert #5499 * Tweak - Customers: Update column heading for date registered #5542 * Tweak - alter homescreen layout. #5465 * Fix - Added support for custom actionable statuses. #5550 * Fix - wrong casing used on the PayPal brand name #5514 🎉 @rtpHarry * Fix - Import @wordpress/base-styles/default-custom-properties #5491 * Fix - downloads report #5441 * Fix - missing custom autocompleter attribute in Search component of Advanced Filter #5448 * Fix - empty no posts state on Marketing page. #5411 * Fix - visual issues in the Search component. #5199 * Fix - Inconsistent line endings in readme.txt. #5281 * Fix - popover menu to expand menu item width to 100% #5519 * Fix - Wrong class name for querying Categories Report #5522 🎉 @zzap * Fix - Remove label printing mention for non us countries #5527 * Fix - First product script navigation dependency #5584 * Fix - Added support for custom actionable statuses #5550 * Fix - Display the store management links last on the homescreen #5579 * Fix - Ensure the "Set up additional payment providers" inbox notification is shown when relevant after completing the OBW. #5547 * Fix - Load wc-tracks in the homepage notice admin script. #5638 * Fix - Link component prop caused a React warning. #5653 * Fix - Flickering of order panel while loading. #5655 * Fix - Tax code duplicated when clicking the button to remove. #5638 * Fix - Restore Autoloading of WooCommerce Classes in PHP Tests. #5650 * Fix - Skip WC Payment plugin note if plugin not added through the onboarding process. #5619 * Fix - Use error_log() to log the deprecated class calls instead of `_deprecated_function()`. #5802 * Fix - Don't show the Orders panel on the homescreen with the Task List. #5552 * Fix - Home Screen: Do not show store setup activity panel. #5801 * Dev - Home Screen - migrate orders panel. #5455 * Dev - Store Profiler - include Creative Mail as a free extension #5543 * Dev - Add undefined check in intervals data util #5546 * Dev - Fix wakeup visibility for PHP 8 compatibility #5211 * Dev - Fix header height and positioning for wc nav #5173 * Dev - Add remote inbox notification rule processors for country and state #5203 * Dev - Rename admin notes classes and file names to fit conventions #514 * Dev - remove checks of store registration that are no longer needed. #5170 * Dev - Fix version update script for composer.json #5165 * Dev - Remove getAdminLink from data package #5158 * Dev - Bump @woocommerce/components dependencies. #5153 * Dev - Add note status remote inbox notifications rule processor #5207 * Dev - Make code chunk filenames more stable. #5229 * Dev - Inbox Panel component moved #5252 * Dev - Added animation to Inbox note deletion #5263 * Dev - Update starter pack dependencies #5254 * Dev - Ensure test zips have latest packages from npm and composer. #5313 * Dev - Add remote inbox notifications rule allowing access to any option #5206 * Dev - Add manage orders on the go admin note #5159 * Dev - Add WooCommerceDependencyExtractionWebpackPlugin package #5198 * Dev - Migrate devdocs examples to Storybook stories #5271 * Dev - Remove Enzyme in favor of React Testing Library #5299 * Dev - Add exclusion rule to PHPCS config for TODO comments #5388 * Dev - Remove no longer used isPanelEmpty logic. #5423 * Dev - Use new @wordpress/components Card on Marketing page. #5428 * Dev - Add PSR-4 naming checks to PHP linting. #5512 * Dev - Rearrange the store management links under categories add filter woocommerce_admin_homescreen_quicklinks. #5476 * Dev - Restyle the setup task list header to display incomplete tasks #5520 **WooCommerce Blocks - 3.7.0 & 3.7.1 & 3.8.0 & 3.8.1** * Enhancement - Allow shoppers to sign-up for an account from the Checkout block. #3331 * Enhancement - Standardise & refactor colors scss to align with Gutenberg colors and WooCommerce brand. #3300 * Tweak - Show the phone number field in the billing section when shipping is disabled in settings. #3376 * Tweak - Add new doc referencing feature flags and experimental interfaces. #3348 * Tweak - Add __experimental_woocommerce_blocks_checkout_order_processed action. #3238 * Fix - Fix PHP 8 error when argument is not invocable in AssetsDataRegistry::Add_data. #3315 * Fix - Improve layout of Cart block line item quantity selector & price on smaller screens. #3299 * Fix - Correctly process orders with $0 total (e.g. via coupon) in Checkout block. #3298 * Fix - Respect Enable Taxes setting for checkout block taxes display. #3291 * Fix - Fix 3D secure payment errors. #3272 * Fix - Show current selected attributes when re-edit Products by Attribute block. #3185 * Fix - Ensure that accounts are not created via checkout block request if account registration is disabled for WooCommerce. #3371 * Fix - radio controls and checkboxes in Twenty Twenty One dark theme. #3446 * Fix - Twenty Twenty One Price filter, Active filters and radio control styling. #3444 * Fix - Twenty Twenty One Button and Placeholder Styling. #3443 * Fix - checkbox and textarea styles in Twenty Twenty One when it has dark controls active. #3450 [See changelog for all versions](https://raw.githubusercontent.com/woocommerce/woocommerce/master/changelog.txt). == Upgrade Notice == = 4.0 = 4.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.