Getting Started

Summary

1. Before you start using WordPress you probably should already fix your base site language and permalink structure
2. after activating WooCommerce you should run through the initial setup
3. after Polylang you should add the languages you need and set the permalinks
4. after activating woo-poly-integration, you must visit Settings, WooPoly /wp-admin/options-general.php?page=hyyan-wpi and set the configuration to match your use case and press Save
5. note, if activating Polylang on an existing installation, existing items will not have a language set and may not be translatable, be sure to set the options you require before translating. Specifically, under Polylang settings - "Languages" on the admin menu - a message will come up about some items not having a default language set, with an option to click to set these to the default language: do this before starting to translate.
6. before translating a set of products, create and translate the Product Categories and Tags and Product Attributes which these products will use

Preparation

1. First, make sure you have done in the initial setup including basic configuration of Wordpress, WooCommerce and Polylang.
2. At this point you should know what languages you are going to use and what your urls look like (eg lang2.mysite.com or mysite.com/lang2 etc) and you should have translated some site pages, now you can activate woo-poly-integration

Global Translation Settings

Before you start translating, you should:

• Check the WooCommerce-Polylang Integration Features and Metas since these settings apply site-wide for all products.
• See the rest of this wiki for additional discussion for example on Stock and Pricing.

Adding a new Language

For each new language, first there are several steps to do in Polylang and Wordpress:

1. Add new language to Polylang
2. Add translation pages for the standard WooCommerce pages Shop, Basket, Checkout, My Account: Just open each page and press the '+' button next to the language flags in the Languages section, this is standard Polylang functionality. note the contents area for each page should contain the same shortcode as the original language version eg:
   • Shop: [woocommerce_checkout]
   • Basket: [woocommerce_cart]
   • Checkout: [woocommerce_checkout]
   • My Account: [woocommerce_my_account]
3. Add menu for the new language to Wordpress The site won't be usable in the new language without these steps! Next:

• Translate global WooCommerce options which this plugin adds to Polylang Strings Translations
• Translate the Product Categories, Product Tags and Product Attributes, the same as setting up a new Product Category below.

Setting up a new Product Category

Before adding your products, please create and translate the Categories, Tags and Attributes which you are going to use for these products:

1. Product Categories and Tags
2. Product Attributes Note: after create a new Product attribute, remember to both translate the name in Polylang Strings Translations, and if you also want to translate the Attribute Terms (the values), go to Polylang settings page Languages, Settings, Custom post types and Taxonomies /wp-admin/admin.php?page=mlang_settings and enable translation for the new attribute - see Product Attributes The plugin does have the capability to fill in missing translations for Categories, Tags and Attributes to avoid errors when you create a product translation. It does this by copying the source language value of the attribute. Any slugs created will be source language slug with language suffix, for example English "color" automatic fill-in translation in Spanish will be created as Name "color" and slug "color-es".

After creating the products it's a good idea to go back to Product Tags and Product Attributes to review any new Tags and attribute Terms which may have been created during the editing process.