Download the PHP package helsingborg-stad/wp-content-translator without Composer

Wp Content Translator

Minimalistic content translation in WordPress. The plugin handles translations for posts, postmeta, options, siteoptions (multisite) and usermeta.

While the plugin also handles comments and commentmeta they are not translated. Comments are mapped to a specific language (the langauge active when posting the comment) and will be displayed for that specific language. There's also an option to make languages inherit comments from other languages. Forinstance the nordic languages is very similar, so we want to load Danish and Norwegian comments along with the Swedish comments.

Translations

The GUI is is available in:

• English
• Swedish
• Norwegian

REDIS & Memcached

If you are using redis or memcached, you want to define a hash-key depending on selected language. The hash key cannot be changed at runtime after it has been set (defined as constant). Add this to your configuration:

Language selector

You can easily use the default language selector (a basic html element) or create a language selector with custom markup.

Use the function to display a language selector. If you want to use the default selector just run the function without any paramters. If you want to create a custom selector there's an option to pass markup for the wrapper and the "language rows".

Available template tags to use in the markup:

Wrapper:

• string languages (displays the language rows)

Language row:

• string code (sv_SE)
• string name (Swedish)
• string nativeName (Svenska)
• string url (//domain.tld/?lang=sv_SE)
• string isCurrent ("is-current" if it's the current language, otherwise empty string)

Configurations

Each translation component has it's own configuration filter which can be used to change it's configuration.

wp-content-translator/configuration/general

Available configurations:

• bool translate_fallback - Fallback to default language or not
• string translate_delimeter - Delimeter to use

wp-content-translator/configuration/post

Available configurations:

• bool translate - Use the component or not

wp-content-translator/configuration/{comment/meta/user/option/siteoption}

Available configurations:

• bool translate - Use the component or not
• bool translate_hidden - Translate options prefixed with underscore or not
• bool translate_numeric - Translate numeric values or not
• array untranslatable - Array with option keys of untranslatable options
• array translatable - Array with option keys of translatable options

Filters

wp-content-translator/should_download_wp_translation_when_installing

Decide if the plugin should download the WP language pack when installing languages.

• • The default answer
• • The language code
• • The language object

wp-content-translator/admin_bar/current_lang

Filters the name of the current language in the admin bar.

• • The name of the language
• • The language code

wp-content-translator/redirect_after_uninstall_language

Where to redirect to after a langauge have been uninstalled.

• • The default redirect url
• • The language code
• • The language object

wp-content-translator/comment/connections

Set up inheritance for comments. Load comments from multiple languages for a language. Example: Load Swedish, Norwegian and Danish comments if the current language is Swedish.

• • The default connections
• • The language code

wp-content-translator/{$component}/is_installed

Is the meta type translate component installed or not?

Available components: post, comment, option, siteoption, meta (postmeta), user (usermeta), comment (commentmeta)

• • The default is installed value
• • The langauge code

wp-content-translator/{$component}/remove_when_uninstalling

Whether to remove metadata when uninstalling the translation component.

Available components: post, comment, option, siteoption, meta (postmeta), user (usermeta), comment (commentmeta)

• • The default should remove value
• • The langauge code

wp-content-translator/{$component}/should_translate_default

Default return value for method

Available components: post, comment, option, siteoption, meta (postmeta), user (usermeta), comment (commentmeta)

• • The default should translate value
• • The langauge code

Actions

wp-content-translator/before_install_language

Runs before a language is installed.

• • The langauge code
• • The langauge object

wp-content-translator/after_install_language

Runs after a language have been installed.

• • The langauge code
• • The langauge object

wp-content-translator/before_uninstall_language

Runs before a language is uninstalled.

• • The langauge code
• • The langauge object

wp-content-translator/after_uninstall_language

Runs after a language is uninstalled.

• • The langauge code
• • The langauge object

wp-content-translator/admin_bar/before_add_switcher

Runs before language switcher is added to the admin bar.

wp-content-translator/admin_bar/after_add_switcher

Runs after language switcher have been added to the admin bar.

wp-content-translator/options/before_add_options_page

Runs right before the "language" options page is added to the admin menu.

wp-content-translator/options/aftere_add_options_page

Runs right after the "language" options page have been added to the admin menu.

wp-content-translator/{$component}/install

Runs when installing a translation component.

Available components: post, comment, option, siteoption, meta (postmeta), user (usermeta), comment (commentmeta)

• • The langauge code

wp-content-translator/{$component}/uninstall

Runs when uninstalling a meta type translate component.

Available components: post, comment, option, siteoption, meta (postmeta), user (usermeta), comment (commentmeta)

• • The langauge code