Author 詩語

Replace Default Flags

If you』re looking to replace the default flags for certain languages of your multilingual site you can use one of the two options below:
1. Replace Default Flags — directly from the Advanced tab
​You can add a new flag for an existing language directly from TranslatePress Settings –> Advanced tab –> Custom Language section.
From here you add all the information about an existing language, or just use another image for the flag.

 
Once you』ve uploaded and selected the new flag image make sure to click 「Save Changes」.
You can read more about Custom Languages here.
2. Alternative Code Based Method
Note: if you are looking to replace the default flags in order to add a custom language please consult the documentation here.
You can replace the default flags in TranslatePress by using a bit of coding:

Create an empty plugin like this:
https://gist.github.com/sareiodata/76f701e01db6685829dbSince this plugin will contain the new flags, you』ll have to include the plugin file inside a folder like /tp_custom_flags as well as to create /tp_custom_flags/flags subfolder where the new ones will be found.
Add the following code to the end of it:
/**
* Change flags folder path for certain languages.
*
* Add the language codes you wish to replace in the list below.
* Make sure you place your desired flags in a folder called "flags" next to this file.
* Make sure the file names for the flags are identical with the ones in the original folder located at 'plugins/translatepress/assets/images/flags/'.
* If you wish to change the file names, use filter trp_flag_file_name .
*
*/

add_filter( 'trp_flags_path', 'trpc_flags_path', 10, 2 );
function trpc_flags_path( $original_flags_path, $language_code ){

// only change the folder path for the following languages:
$languages_with_custom_flags = array( 'en_US', 'es_ES' );

if ( in_array( $language_code, $languages_with_custom_flags ) ) {
return plugin_dir_url( __FILE__ ) . '/flags/' ;
}else{
return $original_flags_path;
}
}

Modify the code by editing the language codes list with the languages you wish to replace. In the example we are adding custom flags for languages en_US and es_ES. The rest of the flags will not change.
Make sure you place your desired flags in a folder called 「flags」 next to this file. Put both the folder and this file into another folder.
Make sure the file names for the new flags are identical with the ones in the original folder located at 『plugins/translatepress/assets/images/flags/』.
Install this plugin via FTP (copy it inside wp-content/plugins) or create a zip archive with it and install it via the WordPress plugin upload functionality

Disable SQL errors notices

TranslatePress has a system that tracks SQL errors and helps you display them.
This system can be disabled in some cases, for example:

false positives
errors that announce various problems, these being false.

With the help of this code, TranslatePress no longer:

records SQL errors
prevents admin notices from appearing
and disables automatic translation

If you want to insert this custom code, follow these steps:
1. Create an empty plugin like this:
https://gist.github.com/sareiodata/76f701e01db6685829db
2. Add the following code to the end of it:
add_filter('trp_disable_error_manager','__return_true');
 
3. Install this plugin via FTP (copy it inside wp-content/plugins) or create a zip archive with it and install it via the WordPress plugin upload functionality.

Developers

Disable translation of Gettext strings

Strings outputted by WordPress themes or plugins are called Gettext strings. Translating these types of strings through TranslatePress can be unnecessary if they are already translated or you plan to translate them using the .po/.mo translation file system.

Disabling this feature of TranslatePress can improve the page load perfomance of you site in certain cases.

Download and activate the following plugin to disable translation of Gettext strings. No other setting is necessary.

Download Disable Gettext Strings Translation Add-on

Add a custom language

If you need to translate your WordPress site in a language that is not found in the All Languages drop-down you can easily add a custom language.
This feature lets you add one or more custom languages directly from TranslatePress Advanced Settings. Once the language(s) is added it will appear and can be selected from the languages list.
Steps to Add a Custom Language to your Multilingual WordPress Site
To add a custom language, navigate to TranslatePress -> Settings and select the Advanced tab. Then click the 「Custom language」 section.

Here you』ll be asked to input the following custom language details:

Language Code: the language code of the language, which will be used in the url
Language name: the name of the language, as it will appear in the languages list.
Native name: the native language name, which will be used only if you select the option to display languages in their native names
Automatic translation code: the code used by Google Translate or DeepL to do the automatic translations
Flag URL: in order to add a flag to your language, simply upload a PNG file into the WordPress media library and then copy its URL here (TranslatePress will take care of the resizing)
Text RTL: check only if the custom language is written in right to left format

Once you』ve added all the custom language details don』t forget to click the Add button and then Save Changes. Your custom language will now appear in the language list and you can select it.

After this, your custom language will appear in the front-end translation interface.

It will also be listed in the language switcher:

The premium version of TranslatePress has no limitation on the number of custom languages that you can add. In the free version the number of translation languages is limited to two.
Following these steps you can start translating your site in any language you want. Even Klingon!

 
Editing an existing language
If you wish to edit the name or the flag of an existing language you can achieve this by going to TranslatePress -> Advanced Tad -> Custom Languages.
You can add the Language Code of the language you wish to edit. The language code can be found in General Settings under Code.

Fill in the Language Code and the changes you want to make. The Language Code field is required but apart from that any field left unfilled will be automatically completed with the rest of the information.

By doing this you can edit the name or the flag of an existing language. After clicking Add and saving the changes, the language will appear in General settings under Custom Languages.

Do not remove dynamic strings until after ajax is finished

Set the showdynamiccontentbeforetranslation filter to true.