The documentation for WooCommerce Blocks has moved to the WooCommerce monorepo.
Please refer to the documentation in the new location as the files in this repository will no longer be updated and the repository will be archived.
Since WordPress 2.1 "Ella", WordPress offers internationalization (i18n) for PHP files, and since WordPress 5.0 "Bebo", it also offers i18n for JS files. Handling translations is pretty straight forward. Both PHP and JS handle translations similar. WordPress offers the functions:
__()→ Available in PHP & JS/TS._e()→ Available in PHP only._ex()→ Available in PHP only._n()→ Available in PHP & JS/TS._x()→ Available in PHP & JS/TS._nx()→ Available in PHP & JS/TS.esc_html__()→ Available in PHP only.esc_html_e()→ Available in PHP only.esc_html_x()→ Available in PHP only.esc_attr__()→ Available in PHP only.esc_attr_e()→ Available in PHP only.esc_attr_x()→ Available in PHP only.
All translations are handled using GlotPress. As the WooCommerce Blocks plugin is hosted on https://wordpress.org/, all plugin-related translations can be found and managed on https://translate.wordpress.org/projects/wp-plugins/woo-gutenberg-products-block/.
Prior to WordPress 4.6 “Pepper Adams”, a text domain had to be defined to make the strings translatable. While it’s no longer a requirement to have a text domain, it does no harm to still include it. If the text domain is available, it has to match the slug of the plugin and is defined in the header of the main plugin file woocommerce-gutenberg-products-block.php:
<?php
/**
* [...]
* Text Domain: woo-gutenberg-products-block
* [...]
*/Prior to WordPress 4.6 “Pepper Adams”, loading the text domain was required. As translations now take place on https://translate.wordpress.org/, loading the text domain using load_plugin_textdomain() is no longer required. In case the plugin does not load the text domain, the header of the main plugin file must include the definition Requires at least:. This definition must be set to 4.6 or higher.
Only plugins that are not hosted in the official WordPress Plugin Directory need to define a Domain Path. As the WooCommerce Blocks plugin is hosted in the official WordPress Plugin Directory, it does not need a Domain Path.