Translating Better Sharing

Translating Better Sharing

The Better Sharing block and templates are fully translatable through the combination of the admin UI and the provided language template file (POT).

For text strings that appear on the front end templates including placeholder text in fields, these strings can all be updated to the preferred language by directly editing the block templates.

For text strings that appear as field labels and other static text, these are included within the provided POT file located in /better-sharing/languages/ which is accessable by 3rd party tools to provide translations on the fly.

Translating the POT file

  1. Navigate to the plugin's code directory to /better-sharing/languages/
  2. Save a copy of the better-sharing-wp.pot to work from with the translation software (i.e. POEdit, etc.)
  3. Open the better-sharing-wp.pot with the translation and select option to create a new translation with the POT file,
  4. Select the language of the translation. 
    Note: this will usually set the ISO language code for the translation; however, it is suggested to confirm the correct code is used
  5. Select the Source Text to be translated then enter the preferred text in the Translation field. Do NOT alter the Source Text, otherwise the translation will not work.
  6. Save the translated file as better-sharing-wp-xx_XX.po where xx_XX is the language code of the final translated file.
  7. Upload both the better-sharing-wp-xx_XX.po and compiled better-sharing-wp-xx_XX.mo files to the /better-sharing/languages/

Alert
Important note: if the translation does not work, ensure that both the PO and MO files have been named correctly with the matchign language code as the WordPress installation (i.e. the Settings » General » Site Language) and have been uploaded to the /better-sharing/languages/ directory. The PO file informs the site as to what text to change; however, the MO file is what displays the new text.