Documentation

AbstractLanguagePlugin
in package

Application

AbstractYes

Commonly used functions for language plugins.

Constants

MARKER_SPLIT_TRANSLATION_ENTRY = 'splitTranslationEntry'
TEMPORARY_TEXT_DOMAIN_PREFIX = 'multilingual-temporary-text-domain'

Properties

$currentTranslationEntries : mixed: Current translations hold as an instance.
$findI18nKeyOfTranslationCache : mixed
$lockCurrentTranslations : mixed
$splitTranslationEntriesCache : SplObjectStorage<Translation_Entry, array<string|int, Translation_Entry>>: Cache for split translation entries.
$domain : string: Use this as text domain for translations. E. g. `post_title` is automatically passed while duplicating a post to another language.
$localesBeforeSwitch : array<string|int, string>: List of locales before switching locale via `switchToLanguage`.
$moFile : mixed
$overrideClass : mixed
$sync : Sync: The sync instance for this plugin.
$temporaryTextDomain : TemporaryTextDomain: Temporary text domain, if given.

Methods

__construct() : mixed: C'tor.
createTemporaryTextDomain() : mixed: Create a temporary text domain.
determineImplementation() : AbstractLanguagePlugin: Determine implementation class.
disableCopyAndSync() : mixed: Disable sync mechanism of our language plugin as it is handled by `Sync.php`.
filterWithExistingTranslatedTextDomain() : mixed: Filter a list of locales and check if translations from a PO/MO file exists.
findI18nKeyOfTranslation() : mixed: The same as `findI18nKeyOfTranslationRaw`, but with caching enabled as this could be called very often.
findI18nKeyOfTranslationRaw() : mixed: Find an i18n key for `__()` from a given translated string.
getActiveCountriesFlags() : mixed: Get the flags of all active languages.
getActiveLanguages() : array<string|int, string>: Get all active languages.
getCountryFlag() : string|false: Get a `src` compatible link to the country flag.
getCurrentLanguage() : string: Get current language.
getCurrentLanguageFallback() : mixed: Get current language or fallback to default language when the multilingual is in a state like "Show all languages" (option known in the admin toolbar).
getCurrentPostId() : int: Get current id of passed post id and fallback to passed id, when no translation found.
getCurrentTermId() : int: Get current id of passed term id and fallback to `0` when not translation found.
getDefaultLanguage() : string: Get default language.
getLanguageSwitcher() : array<string|int, array<string|int, mixed>>: Get a language switcher for the current page.
getLocalesBeforeSwitch() : mixed: List of locales before switching locale via `switchToLanguage`.
getOriginalPostId() : int: Get original id of passed post id.
getOriginalTermId() : int: Get original id of passed term id.
getOverrideClassInstance() : mixed: Get an instance of the `overrideClass`.
getPermalink() : string: Get the URL of a given URL for another locale.
getPostTranslationIds() : array<string|int, int>: Get all translations of a given post type.
getSkipHTMLForTag() : string: Get the HTML attribute so the "dynamic" replacement gets disabled on frontend side. This can be useful for texts which are directly translated in PHP already and gets translated via JavaScript again.
getSync() : mixed: Get `Sync` instance for this plugin. Can be `null` if not given.
getTaxonomyTranslationIds() : array<string|int, int>: Get all translations of a given taxonomy.
getTemporaryTextDomainName() : mixed: Get the current temporary text domain name which can be used for `__` when e.g. inside `switchToLanguage`.
getTranslatedName() : string: Get translated name for a given locale.
getWordPressCompatibleLanguageCode() : string: Get the WordPress compatible language code of a given locale.
isActive() : mixed: Is a multilingual plugin active?
isCurrentlyInEditorPreview() : bool: Check if the translate plugin is currently in edit mode (preview).
iterateAllLanguagesContext() : mixed: Iterate all language contexts.
iterateOtherLanguagesContext() : mixed: Iterate all other languages than current one and get their context.
lockCurrentTranslations() : mixed: Do not allow to take another snapshot of current translations.
maybePersistTranslation() : mixed: Maybe persist a translation in the database of available translations.
rest_prepare_post() : mixed: Add a `multilingual` section to a given post type.
rest_prepare_taxonomy() : mixed: Add a `multilingual` section to a given taxonomy.
setSync() : mixed: Set `Sync` instance for this plugin. Can be `null` if not given.
snapshotCurrentTranslations() : mixed: Snapshot the current translations.
splitTranslationEntries() : mixed: Split a translation entry key into multiple parts. This is useful when using e.g. TranslatePress and we need to find translations from MO file which is divided into multiple "parts" like `<strong>Text</strong>: Another text`.
switch() : mixed: Switch to a given language code. Please do not use this function directly, use `switchToLanguage` instead!
switchToLanguage() : mixed: Open given language and get their context. Context = switch to the language.
teardownTemporaryTextDomain() : mixed: Teardown the known temporary text domain.
translatableStrings() : array<string|int, array<string|int, string>>: Extract translatable strings from a given content. The returned array is a map of the original strings to the translatable strings.
translateArray() : array<string|int, mixed>: Translate a complete array to a given locale (recursively). This is mostly implemented by output buffer plugins like TranslatePress or Weglot.
translateInput() : mixed: Translate a given input from known translations (.po, .pot).
translateStrings() : mixed: Translate strings to a given locale. Do not use this function directly, use `translateArray` instead!
unsetCurrentTranslations() : mixed: Unset current translations.
translateStringFromMo() : array<string|int, mixed>: Translate string from `.mo` file. Please consider to create a temporary text domain before!

MARKER_SPLIT_TRANSLATION_ENTRY


    public
        mixed
    MARKER_SPLIT_TRANSLATION_ENTRY
    = 'splitTranslationEntry'

TEMPORARY_TEXT_DOMAIN_PREFIX


    public
        mixed
    TEMPORARY_TEXT_DOMAIN_PREFIX
    = 'multilingual-temporary-text-domain'

$currentTranslationEntries

Current translations hold as an instance.


    protected
        mixed
    $currentTranslationEntries
     = null

$findI18nKeyOfTranslationCache


    protected
        mixed
    $findI18nKeyOfTranslationCache
     = []

$lockCurrentTranslations


    protected
        mixed
    $lockCurrentTranslations
     = false

$splitTranslationEntriesCache

Cache for split translation entries.


    protected
        SplObjectStorage<Translation_Entry, array<string|int, Translation_Entry>>
    $splitTranslationEntriesCache
     = []

$domain

Use this as text domain for translations. E. g. `post_title` is automatically passed while duplicating a post to another language.


    private
        string
    $domain

$localesBeforeSwitch

List of locales before switching locale via `switchToLanguage`.


    private
        array<string|int, string>
    $localesBeforeSwitch
     = []

$moFile


    private
        mixed
    $moFile

$overrideClass


    private
        mixed
    $overrideClass

$sync

The sync instance for this plugin.


    private
        Sync
    $sync

$temporaryTextDomain

Temporary text domain, if given.


    private
        TemporaryTextDomain
    $temporaryTextDomain
     = null

__construct()

C'tor.


    public
                    __construct(string $domain[, string $moFile = null ][, mixed $overrideClass = null ]) : mixed

Parameters

$domain : string: Original text domain where post_title and so on are translated
$moFile : string = null: Needed for TemporaryTextDomain. E. g. /var/www/html/wp-content/plugins/real-cookie-banner/languages/real-cookie-banner-%s.mo
$overrideClass : mixed = null: A class with a getPotLanguages method

createTemporaryTextDomain()

Create a temporary text domain.


    public
                    createTemporaryTextDomain(string $locale[, bool $force = false ]) : mixed

Parameters

$locale : string
$force : bool = false

determineImplementation()

Determine implementation class.


    public
            static        determineImplementation([string $domain = '' ][, string $moFile = null ][, mixed $overrideClass = null ]) : AbstractLanguagePlugin

Parameters

$domain : string = ''
$moFile : string = null: Needed for TemporaryTextDomain. E. g. /var/www/html/wp-content/plugins/real-cookie-banner/languages/real-cookie-banner-%s.mo
$overrideClass : mixed = null: A class with a override method (arguments: locale)

Return values

AbstractLanguagePlugin

disableCopyAndSync()

Disable sync mechanism of our language plugin as it is handled by `Sync.php`.


    public
    abstract                disableCopyAndSync(Sync $sync) : mixed

Parameters

$sync : Sync

filterWithExistingTranslatedTextDomain()

Filter a list of locales and check if translations from a PO/MO file exists.


    public
                    filterWithExistingTranslatedTextDomain(array<string|int, string> $locales[, array<string|int, string> $skip = [] ]) : mixed

Parameters

$locales : array<string|int, string>
$skip : array<string|int, string> = []: Allows to skip locales and they will never be in the result, e.g. minimal translations; the codes need to be compatible with the WordPress locale format.

findI18nKeyOfTranslation()

The same as `findI18nKeyOfTranslationRaw`, but with caching enabled as this could be called very often.


    public
                    findI18nKeyOfTranslation(string $input, bool &$found, array<string|int, string> &$contexts) : mixed

Parameters

$input : string
$found : bool
$contexts : array<string|int, string>

findI18nKeyOfTranslationRaw()

Find an i18n key for `__()` from a given translated string.


    public
                    findI18nKeyOfTranslationRaw(string $input, bool &$found, array<string|int, string> &$contexts) : mixed

Parameters

$input : string
$found : bool: Sets to true when a translation got found
$contexts : array<string|int, string>

getActiveCountriesFlags()

Get the flags of all active languages.


    public
                    getActiveCountriesFlags() : mixed

getActiveLanguages()

Get all active languages.


    public
    abstract                getActiveLanguages() : array<string|int, string>

Return values

array<string|int, string>

getCountryFlag()

Get a `src` compatible link to the country flag.


    public
    abstract                getCountryFlag(string $locale) : string|false

Parameters

$locale : string

Return values

string|false

getCurrentLanguage()

Get current language.


    public
    abstract                getCurrentLanguage() : string

Return values

string

getCurrentLanguageFallback()

Get current language or fallback to default language when the multilingual is in a state like "Show all languages" (option known in the admin toolbar).


    public
                    getCurrentLanguageFallback() : mixed

getCurrentPostId()

Get current id of passed post id and fallback to passed id, when no translation found.


    public
    abstract                getCurrentPostId(int $id, string $post_type[, string $locale = null ]) : int

Parameters

$id : int
$post_type : string
$locale : string = null: Get item of this language

Return values

int

getCurrentTermId()

Get current id of passed term id and fallback to `0` when not translation found.


    public
    abstract                getCurrentTermId(int $id, string $taxonomy[, string $locale = null ]) : int

Parameters

$id : int
$taxonomy : string
$locale : string = null: Get item of this language

Return values

int

getDefaultLanguage()

Get default language.


    public
    abstract                getDefaultLanguage() : string

Return values

string

getLanguageSwitcher()

Get a language switcher for the current page.


    public
    abstract                getLanguageSwitcher() : array<string|int, array<string|int, mixed>>

Return values

array<string|int, array<string|int, mixed>>

getLocalesBeforeSwitch()

List of locales before switching locale via `switchToLanguage`.


    public
                    getLocalesBeforeSwitch() : mixed

getOriginalPostId()

Get original id of passed post id.


    public
    abstract                getOriginalPostId(int $id, string $post_type) : int

Parameters

$id : int
$post_type : string

Return values

int

getOriginalTermId()

Get original id of passed term id.


    public
    abstract                getOriginalTermId(int $id, string $taxonomy) : int

Parameters

$id : int
$taxonomy : string

Return values

int

getOverrideClassInstance()

Get an instance of the `overrideClass`.


    public
                    getOverrideClassInstance() : mixed

getPermalink()

Get the URL of a given URL for another locale.


    public
    abstract                getPermalink(string $url, string $locale) : string

Parameters

$url : string
$locale : string

Return values

string

getPostTranslationIds()

Get all translations of a given post type.


    public
    abstract                getPostTranslationIds(int $id, string $post_type) : array<string|int, int>

Parameters

$id : int
$post_type : string

Return values

array<string|int, int>

getSkipHTMLForTag()

Get the HTML attribute so the "dynamic" replacement gets disabled on frontend side. This can be useful for texts which are directly translated in PHP already and gets translated via JavaScript again.


    public
    abstract                getSkipHTMLForTag([bool $force = false ]) : string

Parameters

$force : bool = false: Pass true to get the attribute and do not respect isCurrentlyInEditorPreview

Return values

string

getSync()

Get `Sync` instance for this plugin. Can be `null` if not given.


    public
                    getSync() : mixed

getTaxonomyTranslationIds()

Get all translations of a given taxonomy.


    public
    abstract                getTaxonomyTranslationIds(int $id, string $taxonomy) : array<string|int, int>

Parameters

$id : int
$taxonomy : string

Return values

array<string|int, int>

getTemporaryTextDomainName()

Get the current temporary text domain name which can be used for `__` when e.g. inside `switchToLanguage`.


    public
                    getTemporaryTextDomainName() : mixed

getTranslatedName()

Get translated name for a given locale.


    public
    abstract                getTranslatedName(string $locale) : string

Parameters

$locale : string

Return values

string

getWordPressCompatibleLanguageCode()

Get the WordPress compatible language code of a given locale.


    public
    abstract                getWordPressCompatibleLanguageCode(string $locale) : string

Parameters

$locale : string

Return values

string

isActive()

Is a multilingual plugin active?


    public
                    isActive() : mixed

isCurrentlyInEditorPreview()

Check if the translate plugin is currently in edit mode (preview).


    public
    abstract                isCurrentlyInEditorPreview() : bool

Return values

bool

iterateAllLanguagesContext()

Iterate all language contexts.


    public
                    iterateAllLanguagesContext(callable $callback[, array<string|int, string> $skip = [] ]) : mixed

Parameters

$callback : callable: Arguments: $locale, $currentLanguage
$skip : array<string|int, string> = []: Skip locales

iterateOtherLanguagesContext()

Iterate all other languages than current one and get their context.


    public
                    iterateOtherLanguagesContext(callable $callback) : mixed

Context = switch to the language.

Attention: If you are using switchToLanguage in a REST API call, please consider to pass the _wp_http_referer parameter. E.g. TranslatePress checks if the referer is an admin page and behaves differently.

Parameters

$callback : callable: Arguments: $locale, $currentLanguage

lockCurrentTranslations()

Do not allow to take another snapshot of current translations.


    public
                    lockCurrentTranslations([bool $state = false ]) : mixed

Parameters

$state : bool = false

maybePersistTranslation()

Maybe persist a translation in the database of available translations.


    public
    abstract                maybePersistTranslation(string $sourceContent, string $content, string $sourceLocale, string $targetLocale[, bool $force = false ]) : mixed

Parameters

$sourceContent : string
$content : string: Pass null to delete the translation
$sourceLocale : string
$targetLocale : string
$force : bool = false: Pass true to force persist the translation

rest_prepare_post()

Add a `multilingual` section to a given post type.


    public
                    rest_prepare_post(WP_REST_Response $response, WP_Post $post, WP_REST_Request $request) : mixed

Usage:

add_filter('rest_prepare_my_cpt', [$this->getCompLanguage(), 'rest_prepare_post'], 10, 3);

Parameters

$response : WP_REST_Response
$post : WP_Post
$request : WP_REST_Request

rest_prepare_taxonomy()

Add a `multilingual` section to a given taxonomy.


    public
                    rest_prepare_taxonomy(WP_REST_Response $response, WP_Term $term, WP_REST_Request $request) : mixed

Usage:

add_filter('rest_prepare_my_taxonomy', [$this->getCompLanguage(), 'rest_prepare_taxonomy'], 10, 3);

Parameters

$response : WP_REST_Response
$term : WP_Term
$request : WP_REST_Request

setSync()

Set `Sync` instance for this plugin. Can be `null` if not given.


    public
                    setSync(Sync $sync) : mixed

Parameters

$sync : Sync

snapshotCurrentTranslations()

Snapshot the current translations.


    public
                    snapshotCurrentTranslations([bool $force = false ]) : mixed

Parameters

$force : bool = false

splitTranslationEntries()

Split a translation entry key into multiple parts. This is useful when using e.g. TranslatePress and we need to find translations from MO file which is divided into multiple "parts" like `<strong>Text</strong>: Another text`.


    public
                    splitTranslationEntries(array<string|int, Translation_Entry> &$entriesToSplit) : mixed

Parameters

$entriesToSplit : array<string|int, Translation_Entry>

switch()

Switch to a given language code. Please do not use this function directly, use `switchToLanguage` instead!


    public
    abstract                switch(string $locale) : mixed

Parameters

$locale : string

switchToLanguage()

Open given language and get their context. Context = switch to the language.


    public
                    switchToLanguage(string $locale, callable $callback) : mixed

Parameters

$locale : string
$callback : callable: Arguments: $locale, $currentLanguage

teardownTemporaryTextDomain()

Teardown the known temporary text domain.


    public
                    teardownTemporaryTextDomain() : mixed

translatableStrings()

Extract translatable strings from a given content. The returned array is a map of the original strings to the translatable strings.


    public
    abstract                translatableStrings(array<string|int, string> $content) : array<string|int, array<string|int, string>>

Parameters

$content : array<string|int, string>

Return values

array<string|int, array<string|int, string>>

translateArray()

Translate a complete array to a given locale (recursively). This is mostly implemented by output buffer plugins like TranslatePress or Weglot.


    public
                    translateArray(array<string|int, mixed> $content[, array<string|int, string> $skipKeys = [] ][, string $locale = null ][, array<string|int, string> $context = null ]) : array<string|int, mixed>

Parameters

$content : array<string|int, mixed>
$skipKeys : array<string|int, string> = []
$locale : string = null
$context : array<string|int, string> = null

Return values

array<string|int, mixed>

translateInput()

Translate a given input from known translations (.po, .pot).


    public
                    translateInput(string $input[, array<string|int, string> $contexts = null ]) : mixed

Parameters

$input : string
$contexts : array<string|int, string> = null

translateStrings()

Translate strings to a given locale. Do not use this function directly, use `translateArray` instead!


    public
    abstract                translateStrings(array<string|int, string> &$content, string $locale[, array<string|int, string> $context = null ]) : mixed

Parameters

$content : array<string|int, string>: This parameter needs to be passed as reference map, see also translateArray. The implementation needs to update the references correctly
$locale : string
$context : array<string|int, string> = null

unsetCurrentTranslations()

Unset current translations.


    public
                    unsetCurrentTranslations() : mixed

translateStringFromMo()

Translate string from `.mo` file. Please consider to create a temporary text domain before!


    protected
                    translateStringFromMo(string $content, string $targetLocale[, array<string|int, string> $context = null ]) : array<string|int, mixed>

Parameters

$content : string
$targetLocale : string
$context : array<string|int, string> = null

Return values

array<string|int, mixed> —

[$found: boolean, $content: string]

AbstractLanguagePlugin in package Application

Table of Contents

Constants

Properties

Methods

Constants

MARKER_SPLIT_TRANSLATION_ENTRY

TEMPORARY_TEXT_DOMAIN_PREFIX

Properties

$currentTranslationEntries

$findI18nKeyOfTranslationCache

$lockCurrentTranslations

$splitTranslationEntriesCache

$domain

$localesBeforeSwitch

$moFile

$overrideClass

$sync

$temporaryTextDomain

Methods

__construct()

Parameters

Tags

createTemporaryTextDomain()

Parameters

determineImplementation()

Parameters

Return values

disableCopyAndSync()

Parameters

filterWithExistingTranslatedTextDomain()

Parameters

findI18nKeyOfTranslation()

Parameters

findI18nKeyOfTranslationRaw()

Parameters

getActiveCountriesFlags()

getActiveLanguages()

Return values

getCountryFlag()

Parameters

Return values

getCurrentLanguage()

Return values

getCurrentLanguageFallback()

getCurrentPostId()

Parameters

Return values

getCurrentTermId()

Parameters

Return values

getDefaultLanguage()

Return values

getLanguageSwitcher()

Return values

getLocalesBeforeSwitch()

getOriginalPostId()

Parameters

Return values

getOriginalTermId()

Parameters

Return values

getOverrideClassInstance()

getPermalink()

Parameters

Return values

getPostTranslationIds()

Parameters

Return values

getSkipHTMLForTag()

Parameters

Return values

getSync()

getTaxonomyTranslationIds()

Parameters

Return values

getTemporaryTextDomainName()

getTranslatedName()

Parameters

Return values

AbstractLanguagePlugin
in package

Application