=== WooCommerce Multilingual - run WooCommerce with WPML ===
Contributors: AmirHelzer, sergey.r, mihaimihai, EduardMaghakyan, andrewp-2, kaggdesign
Donate link: http://wpml.org/documentation/related-projects/woocommerce-multilingual/
Tags: CMS, woocommerce, commerce, ecommerce, e-commerce, products, WPML, multilingual, e-shop, shop
License: GPLv2
Requires at least: 4.7
Tested up to: 5.4.2
Stable tag: 4.9.1
Requires PHP: 5.6

Allows running fully multilingual e-commerce sites using WooCommerce and WPML.

== Description ==

This 'glue' plugin makes it possible to run fully multilingual e-commerce sites using [WooCommerce](https://wordpress.org/plugins/woocommerce/) and [WPML](http://wpml.org).

= Key Features =

* Translate all WooCommerce products (simple, variable, grouped, external)
* Easy translation management for products, categories and attributes
* Keeps the same language through the checkout process
* Sends emails to clients and admins in their language
* Allows inventory tracking without breaking products into languages
* Enables running a single WooCommerce store with multiple currencies

= Compatibility with WooCommerce Extensions =

Almost every WooCommerce store uses some extensions. WooCommerce Multilingual is fully compatible with popular extensions, including:

* [WooCommerce Bookings](https://wpml.org/documentation/woocommerce-extensions-compatibility/translating-woocommerce-bookings-woocommerce-multilingual/)
* [WooCommerce Table Rate Shipping](https://wpml.org/documentation/woocommerce-extensions-compatibility/translating-woocommerce-table-rate-shipping-woocommerce-multilingual/)
* [WooCommerce Subscriptions](https://wpml.org/documentation/woocommerce-extensions-compatibility/translating-woocommerce-subscriptions-woocommerce-multilingual/)
* [WooCommerce Product Add-ons](https://wpml.org/documentation/woocommerce-extensions-compatibility/translating-woocommerce-product-add-ons-woocommerce-multilingual/)
* [WooCommerce Tab Manager](https://wpml.org/documentation/woocommerce-extensions-compatibility/translating-woocommerce-tab-manager-woocommerce-multilingual/)

Looking for other extensions that are tested and compatible with WPML? See the complete [list of WooCommerce extensions that are compatible with WPML](https://wpml.org/documentation/woocommerce-extensions-compatibility/).

= Usage Instructions =

For step by step instructions on setting up a multilingual shop, please go to [WooCommerce Multilingual Manual](http://wpml.org/documentation/related-projects/woocommerce-multilingual/) page.

After installing, follow the steps of the *setup wizard* to translate the store pages, configure what attributes should be translated, enable the multi-currency mode and other settings.

Then, continue to the 'Products' and any categories, tags and attributes that you use.

When you need help, go to [WooCommerce Multilingual support forum](http://wpml.org/forums/topic-tag/woocommerce/).

= Downloads =

This version of WooCommerce Multilingual works with WooCommerce > 3.3.0

You will also need [WPML](http://wpml.org), together with the String Translation and the Translation Management modules, which are part of the [Multilingual CMS](http://wpml.org/purchase/) package.

= Minimum versions for WPML and modules =

WooCommerce Multilingual checks that the required components are active and up to date.

If the checks fail, WooCommerce Multilingual will not be able to run.

== Installation ==

= Minimum Requirements =

* WordPress 4.7 or later
* PHP version 5.6 or later
* MySQL version 5.6 or later

* WooCommerce 3.3.0 or later
* WPML Multilingual CMS 4.3.7 or later
* WPML String Translation 3.0.7 or later
* WPML Translation Management 2.9.5 or later

= WordPress automatic installation =
In your WordPress dashboard, go to the Plugins section and click 'Add new'.

= WPML Installer =
If you're already using WPML on your site, in your WordPress dashboard, go to the Plugins section, click 'Add new' and go to the 'Commercial' tab.

= Manual Installation =
1. Upload 'woocommerce-multilingual' to the '/wp-content/plugins/' directory
2. Activate the plugin through the 'Plugins' menu in WordPress

= Setup =
After installing the plugin either automatically or manually:

1. Follow the steps of the setup wizard for the basic required configuration
2. Translate existing content: products, attributes, permalink bases
3. Optionally, add secondary currencies

= Updating =
Once you installer WooCommerce Multilingual, the built in Installer works together with the WordPress automatic update built in logic to make the updating process as easy as it can be.

== Frequently Asked Questions ==

= Does this work with other e-commerce plugins? =

No. This plugin is tailored for WooCommerce.

= What do I need to do in my theme? =

Make sure that your theme is not hard-coding any URL. Always use API calls to receive URLs to pages and you'll be fine.

= My checkout page displays in the same language =

In order for the checkout and store pages to appear translated, you need to create several WordPress pages and insert the WooCommerce shortcodes into them. You'll have to go over the [documentation](http://wpml.org/documentation/related-projects/woocommerce-multilingual/) and see that you performed all steps on the way.

= Can I have different urls for the store in the different languages? =

Yes. You can translate the product permalink base, product category base, product tag base and the product attribute base on the Store URLs section.

= Why do my product category pages return a 404 error? =

In this case, you may need to translate the product category base. You can do that on the Store URLs section.

= Can I set the prices in the secondary currencies? =

By default, the prices in the secondary currencies are determined using the exchange rates that you fill in when you add or edit a currency. On individual products, however, you can override this and set prices manually for the secondary currencies.

= Can I have separate currencies for each language? =

Yes. By default, each currency will be available for all languages, but you can customize this and disable certain currencies on certain languages.

= Is this plugin compatible with other WooCommerce extensions? =

WooCommerce Multilingual is compatible with all major WooCommerce extensions. We're continuously work on checking and maintaining compatibility and collaborate closely with the authors of these extensions.



== Screenshots ==

1. Products translation screen
2. Product translation editor
3. Global attributes translation
4. Multiple currencies
5. Status Page
6. Shop URLs translation screen

== Changelog ==

= 4.9.1 =
* Updated the translations.
* Fix fatal error when WooCommerce not activated.

= 4.9.0 =
* Manual shipping prices in secondary currencies.
* Fixed product attribute slug language not changed after changing value.
* Fixed missing numeric attribute values after translation using ATE.
* Fixed mini-cart total calculation when switching a currency.
* Fixed out of stock variable products if "Show only products with custom prices in secondary currencies" option is enabled.
* Fixed WC Tab Manager custom tab translation from ATE was not saved if the description is empty.
* Fixed an error which some additional plugins may cause with WC_Email object.
* Add a filter for WCML_WC_Gateways::get_current_gateway_language().
* Fixed not synchronized WooCommerce Tab Manager global tabs while saving product translation via ATE.
* Fixed not updated tax label after a change on settings page.
* Fixed the value of a custom attribute translation is overwritten on saving the original product.
* Fixed overwritten composite data title and description in translation after original product update.
* Fixed js console error in languages_notice.js file.
* Add language filtering for WooCommerce dashboard stock widgets.
* Fixed creating of several memberships in WooCommerce Membership plugin.

= 4.8.0 =
* Fixed JS SyntaxError on Products listing page.
* Fixed not registered 'Additional Content' emails setting text after first saving.
* Remove extra slash from the end of the translated base slug if a user added it.
* Fix custom fields translation in Translation Editor for Variations post type.
* Fixed customer Completed email has not translated heading and subject with WooCommerce 4.0.
* Fixed duplicated currency code in "Default currency" drop-down on Multi-currency settings page.
* Fixed language selector displayed in wrong place on Permalinks settings page.
* Fix customer order status email language when sent the shop manager use english language and english is not an active language.
* Fixed attributes synchronization may break variations relationships.
* Fixed not saved custom prices if translation is duplicated and Native screen editor selected.
* Fixed multiple same post meta keys translations.
* Add variation single "translatable" custom fields to translation package.
* Fixed error on Subscription renewal via PayPal.
* Fixed not saved The Events Calendar ticket meta if translation done by Translation Service.

= 4.7.0 =
* Replaced some Twig templates with pure PHP templates as the first step towards the removal of Twig dependencies.
* added comp. class to cover price update when products are edited with WOOBE plugin
* Added compatibility class for WooCommerce order status Manager  plugin
* Fixed an issue where the strings for the default payment methods were not properly translated on the Checkout page.
* Fixed an issue with the cache flush during language switching.
* Fixed in the original ticket.
* Fixed an issue where the gateway strings would always register in English instead of the site's default language.
* Fixed languages column width on products table.
* Fixed PHP Notice for WC Variations Swatches And Photos compatibility.
* WooCommerce Bookings compatibility : Fixed notice when trying to cancel booking.
* Fixed an issue where the total price on the Composite product page was not rounded.
* Fixed an issue causing wrong rewrite rules after saving the settings and visiting a page in a language other than the default.
* Fixed an issue with incorrect price converting for the Product add-ons.
* Fixed an issue with the WooCommerce Subscriptions availability in the secondary language after purchasing the subscription in the original language.
* Fixed an issue with the currency reverting to the default one during checkout.
* Fixed removed meta from original product not synchronized to translation.
* Fixed an issue where the BACS gateway instructions were not translated when re-sending the customer notification email from the admin.
* Fixed an issue with missing language information for attribute terms that happened after changing the attribute slug.
* Removed the Twig Composer dependency as it now relies on Twig from the WPML core plugin.
* Fixed an issue where customers would not receive notifications in the correct language.
* Fixed an issue where the Products shortcode was not working in the secondary language.
* Fixed error while sending WooCoomerce Bookings email for bookings which didn't have orders assigned.
* Added compatibility for free version of YIKES Custom Product Tabs.
* Updated compatibility class for WC Checkout Addons
* Fixed the images that were wrongly inserted in the translation job when attachments are not translatable.
* Significantly improved the site performance on when updating the page, post, or a WooCommerce product page in the admin.
* Added the "wp_" prefix to all cookies so that hosting and caching layers can properly handle them.
* Fixed a JavaScript error on the Store URLs tab.
* Fixed an issue where the "Fix translated variations relationships" troubleshooting option was removing translated variations.
* Fixed an issue where product names were not translated in the admin emails.
* Fixed an issue with the price filter widget not showing results in a secondary language.
* Fixed an issue where the shipping classes in secondary languages were not calculated during checkout.
* Display larger images when hovering thumbnails in the WooCommerce Multilingual Products admin page.
* Added the "wcml_new_order_admin_email_language" filter to allow setting the language of emails sent to admins for new or updated orders.

= 4.6.0 =
* Fix wrong currency code after removing item from manually created order
* Replace *_woocommerce_term_meta functions on *_term_meta
* Fix gallery images not showing up on translated product page
* Fix double calculating order item price while manually adding it from admin to order with WooCommerce 3.6.0
* Fix performance issues on checkout with manage stock products
* Fix performance issue on shop page with WooCommerce 3.6
* Fix loading scripts on admin pages
* Fix coupon discount when editing order from admin
* Fix wrong product price after adding another product to existing order from admin
* Fix my-account page endpoints in secondary language with pages set to "Display as translated"

= 4.5.0 =
* Add "get_post_metadata" hook to filter Woocommerce product data
* Added function in troubleshooting page to fix broken variations
* Fixed DB error when saving a variation with specific steps
* Fix refreshing of status icon when ATE Job of updated content is synced
* Fix few notices when removing a Elementor widget and refresh page
* Fetch ATE translations from WCML Product Translation Tab
* Fix warning when adding comment to product
* Fixed wrong price calculation when adding product to new order on backend
* Fixed bookings counter on admin bookings listing page
* Fixed stock quantity not synchronized to translation when creating it
* Fixed notice when saving translation
* Fixed translated attributes via ATE/Translation service not connected to translated product
* Fix not translated "On Hold" email subject after returning order from "Processing"
* Remove unneded $_SESSION variables on checkout page
* Fix PHP notice `Notice: Only variables should be passed by reference`
* Implemented dependency check for minimum compatible versions of required WPML plugins
* Fixed default variation not pre-selected on front-end for translated product with non latin attribute in default language
* Fix cannot change currency with "wcml_client_currency" filter
* Fixed not valid API key when trying manually update exchange rates
* WooCommerce Variation Swatches and Photos compatibility to translate attributes
* Fix related product displays in all languages
* Added compatibility with Yikes Custom Product Tabs
