Setup #
Requirements:
- Polylang
- Polylang WooCommerce addon (recommended)
Note: While Polylang by itself allows for PDF translations, managing multilingual content efficiently is difficult without the Polylang WooCommerce addon. This documetation focuses on the basics of our Polylang compatibility.
![An image of the multilingual settings](https://i.ibb.co/CJPnq7h/multilingual-settings-tablepng.png)
WooCommerce > PDF Invoices > Pro
At WooCommerce > PDF Invoices > Pro, unless you need to set the language to a fixed one, set the Document language to Order/customer language.
With Polylang configured, users will receive their documents in the language in which Polylang set their Checkout at the time of purchase,
Polylang also enhances certain settings of our Invoicing plugin by adding multi-lingual tabs to them. These language tabs are set via the Polylang ‘Languages’ menu.
![An image of Polylang settings](https://i.ibb.co/q566Mxr/languages-polylang.png)
The following list shows how the multilingual tabs appear for compatible settings.
Multilingual settings #
All document settings are saved in the WooCommerce order meta. These multilingual settings keep existing even if Polylang is uninstalled.
Shop Name #
- Path: WooCommerce > PDF Invoices > General
Note that the Shop Name setting is selected in French:
![An image of multilingual tabs](https://i.ibb.co/Rp80xwL/shop-name-setting.png)
Result on document in French:
![An image of the shop name on the Invoice](https://i.ibb.co/PmPMdMY/shop-name-in-french-on-pdf.png)
Shop Name setting selected in German:
![An image of multilingual tabs via settings](https://i.ibb.co/Xb0TLYD/shop-name-setting-2.png)
Result for document in German:
![An image of the shop name on the Invoice](https://i.ibb.co/1qGBdpD/shop-name-in-german-on-pdf.png)
Shop Address #
- Path: WooCommerce > PDF Invoices > General
![An image of the shop address setting](https://i.ibb.co/tZhgtR9/shop-address.png)
Footer #
- Path: WooCommerce > PDF Invoices > General
![An image of the footer](https://i.ibb.co/YX77h5X/footer.png)
Extra template fields #
- Requirement: Premium Templates extension
- Requirement: Modern template
- Path: WooCommerce > PDF Invoices > General
![An image of the extra template fields](https://i.ibb.co/gRVhXY1/extra-template-fields.png)
Document title #
- Path: WooCommerce > PDF Invoices > Documents, select the document type then scroll to Document title.
![An image of the Document Title setting](https://i.ibb.co/RvNZgbX/document-title.png)
PDF filename #
- Path: WooCommerce > PDF Invoices > Documents, select the document type then scroll to PDF filename.
![An image of the PDF Filename settings](https://i.ibb.co/LrhR8hC/pdf-filename.png)
Document number label #
- Path: WooCommerce > PDF Invoices > Documents, select the document type then scroll to Document number label.
![An image of the Document Number label](https://i.ibb.co/4RWKrQ6/document-number-label.png)
Document date label #
- Path: WooCommerce > PDF Invoices > Documents, select the document type then scroll to Document date label.
![An image of the Document label setting](https://i.ibb.co/Yc5k7T0/due-date-label.png)
Due date label #
- Path: WooCommerce > PDF Invoices > Documents, select the document type then scroll to Due date label.
![An image of the Due date setting](https://i.ibb.co/Yc5k7T0/due-date-label.png)
Address customization #
- Requirement: Professional extension
- Path: WooCommerce > PDF Invoices > Pro
Enjoy different address structures based on your document language.
![](https://i.ibb.co/SyJ0dGY/address-customization-pro-tab.png)
The fields to overwrite the Billing Address:
Similar to above, the fields to overwrite the Shipping Address:
![](https://i.ibb.co/Ttb11pX/multilingual-address-tabs-shipping-address.png)
Custom Block translation #
- Requirement: Premium Templates extension
The content from Custom Blocks is not translated by default, as demonstrated in the Invoice below. The document language below is in French, so we expect our text to be in French, not in English – as shown below.
![An image of an invoice with untranslated text](https://i.ibb.co/CP4xfrD/custom-block-non-translated-on-invoice.png)
This image below shows the Custom Block that is producing this text:
![An image of a Custom Block](https://i.ibb.co/ssgMjjV/added-via-custom-block-backend.png)
As seen in the image above, there are no multilingual tabs.
In order to translate these strings, they need to be searched via the Polylang settings at Languages > Translations.
Once in Polylang’s Translation settings, the arrow below indicates where to search the text to be translated.
The square shows the search results, showing the results of the search.
![An image showing Polylang settings](https://i.ibb.co/Drg1f1B/search-translation-of-custom-block.png)
When viewing the search results, the Group should always be PDF Invoices & Packing Slips for WooCommerce – Premium Templates.
![An image showing translation search results](https://i.ibb.co/Lxtbwz2/the-group-of-the-translation-search-results.png)
From here, the desired text can now be set per language.
![An image of translation modification in Polylang](https://i.ibb.co/74yRL3Z/french-translation-updated.png)
Here is the result on a document:
![An image of French translation on document](https://i.ibb.co/ckJd0D9/modified-custom-block-translation.png)
Troubleshooting #
- When viewing search results from the Polylang translation settings at Languages > Translations, it is important to take note of both the Name and Group of the result.
![An image showing the Name and Group of a search result](https://i.ibb.co/16WK4C6/group-and-name.png)
- Remember to leave the the Document language setting at ‘Order/customer language’ to avoid sending all your customers documents in the same forced language.
WooCommerce > PDF Invoices > Pro