# acymailing/trunk/back/Core/wordpress/language.php

AcyMailing – An Ultimate Newsletter Plugin and Marketing Automation Solution for WordPress, version trunk. 309 lines.

- Page: https://pluginprobe.com/plugins/acymailing/trunk/code/back/Core/wordpress/language.php
- Raw: https://pluginprobe.com/plugins/acymailing/trunk/raw/back/Core/wordpress/language.php
- Modified: 2026-08-03T10:18:54+00:00

Line numbers below start at 1. Link to a line or a range by appending a fragment to the
page URL, for example `https://pluginprobe.com/plugins/acymailing/trunk/code/back/Core/wordpress/language.php#L10-L20`.

```php
<?php

defined('ABSPATH') || die('Restricted Access');

global $acymWPLangCodes;
$acymWPLangCodes = [
    'af' => 'af-ZA',
    'ar' => 'ar-AA',
    'as' => 'as-AS', // Not sure
    'az' => 'az-AZ', // Not sure
    'bo' => 'bo-BO', // Not sure
    'ca' => 'ca-ES',
    'cy' => 'cy-GB',
    'el' => 'el-GR',
    'eo' => 'eo-XX',
    'et' => 'et-EE',
    'eu' => 'eu-ES',
    'fi' => 'fi-FI',
    'gd' => 'gd-GD', // Not sure
    'gu' => 'gu-GU', // Not sure
    'hr' => 'hr-HR',
    'hy' => 'hy-AM',
    'ja' => 'ja-JP',
    'kk' => 'kk-KK', // Not sure
    'km' => 'km-KH',
    'lo' => 'lo-LO', // Not sure
    'lv' => 'lv-LV',
    'mn' => 'mn-MN', // Not sure
    'mr' => 'mr-MR', // Not sure
    'ps' => 'ps-PS', // Not sure
    'sq' => 'sq-AL',
    'te' => 'te-TE',
    'th' => 'th-TH',
    'tl' => 'tl-TL', // Not sure
    'uk' => 'uk-UA',
    'ur' => 'ur-PK', // Not sure
    'vi' => 'vi-VN',
];

global $acymLanguages;

/**
 * Display the translation based on a key
 *
 * @param bool $interpretBackSlashes Deprecated Interpret or not the \ like \t \n etc...
 */
function acym_translation(string $key, bool $jsSafe = false, bool $interpretBackSlashes = true, string $textdomain = 'acymailing'): string
{
    // Return the key passed by default as it may be a random text instead of a key
    $translation = $key;

    global $acymLanguages;
    acym_getLanguageTag();
    if (!isset($acymLanguages[$acymLanguages['currentLanguage']])) acym_loadLanguage();

    $acymailingEnglishText = '';
    foreach ($acymLanguages[ACYM_DEFAULT_LANGUAGE] as $fileContent) {
        if (isset($fileContent[$key])) {
            $acymailingEnglishText = $fileContent[$key];
            break;
        }
    }

    global $acymailingCustomTranslation;
    acym_getCustomTranslation();

    if (!empty($acymailingCustomTranslation) && isset($acymailingCustomTranslation[$key])) {
        $translation = $acymailingCustomTranslation[$key];
    } elseif (!empty($acymailingEnglishText)) {
        // If there is an english translation, get the WordPress translation. By default, it returns the text passed, so the english translation
        // phpcs:ignore WordPress.WP.I18n.MissingArgDomain,WordPress.WP.I18n.NonSingularStringLiteralText,WordPress.WP.I18n.NonSingularStringLiteralDomain
        $translation = empty($textdomain) ? __($acymailingEnglishText) : __($acymailingEnglishText, $textdomain);

        // If there is no translation on the WordPress side, and we're not in english, take the AcyMailing community translation
        if ($translation === $acymailingEnglishText && $acymLanguages['currentLanguage'] != ACYM_DEFAULT_LANGUAGE) {
            foreach ($acymLanguages[$acymLanguages['currentLanguage']] as $fileContent) {
                if (isset($fileContent[$key])) {
                    // If a translation is found for the specified key, take it
                    $translation = $fileContent[$key];
                    break;
                }
            }
        }
    }

    // Escape the quotes if we're in a javascript context
    if ($jsSafe) {
        $translation = str_replace('"', '\"', $translation);
    } elseif ($interpretBackSlashes && strpos($translation, '\\') !== false) {
        $translation = str_replace(['\\\\', '\t', '\n'], ["\\", "\t", "\n"], $translation);
    }

    if ($translation == $key) {
        // phpcs:ignore WordPress.WP.I18n.MissingArgDomain,WordPress.WP.I18n.NonSingularStringLiteralText,WordPress.WP.I18n.NonSingularStringLiteralDomain
        $translation = empty($textdomain) ? __($translation) : __($translation, $textdomain);
    }

    return $translation;
}

function acym_setLanguage(string $lang): string
{
    global $acymLanguages;
    $previousLanguage = $acymLanguages['currentLanguage'];
    $acymLanguages['currentLanguage'] = $lang;

    return $previousLanguage;
}

/**
 * Display the according translation
 */
function acym_translationSprintf(): string
{
    $args = func_get_args();
    $args[0] = acym_translation($args[0]);

    return call_user_func_array('sprintf', $args);
}

function acym_getLanguages(bool $uppercaseLangCode = false, bool $published = false): array
{
    global $acymWPLangCodes;

    $result = [];

    require_once ABSPATH.'wp-admin/includes/translation-install.php';
    $wplanguages = wp_get_available_translations();
    $languages = get_available_languages();
    foreach ($languages as $oneLang) {
        $wpLangCode = $oneLang;
        if (!empty($acymWPLangCodes[$oneLang])) {
            $oneLang = $acymWPLangCodes[$oneLang];
        }
        $langTag = str_replace('_', '-', $oneLang);

        $lang = new stdClass();
        $lang->sef = empty($wplanguages[$oneLang]['iso'][1]) ? null : $wplanguages[$oneLang]['iso'][1];
        $lang->language = $uppercaseLangCode ? $langTag : strtolower($langTag);
        $lang->name = empty($wplanguages[$wpLangCode]) ? $langTag : $wplanguages[$wpLangCode]['native_name'];
        $lang->exists = file_exists(ACYM_LANGUAGE.$langTag.'.'.ACYM_LANGUAGE_FILE.'.ini');
        $lang->content = true;

        $result[$langTag] = $lang;
    }

    if (!in_array('en-US', array_keys($result))) {
        $lang = new stdClass();
        $lang->sef = 'en';
        $lang->language = 'en-us';
        $lang->name = 'English (United States)';
        $lang->exists = file_exists(ACYM_LANGUAGE.'en-US.'.ACYM_LANGUAGE_FILE.'.ini');
        $lang->content = true;

        $result['en-US'] = $lang;
    }

    return $result;
}

function acym_getLanguageTag(bool $simple = false): string
{
    if (acym_isAdmin()) {
        $currentLocale = get_user_locale(acym_currentUserId());
    } else {
        $currentLocale = get_locale();
    }

    $currentLocale = acym_convertWPLocaleToAcyLocale($currentLocale);

    global $acymLanguages;
    if (!isset($acymLanguages['currentLanguage'])) {
        $acymLanguages['currentLanguage'] = $currentLocale;
    }

    return $simple ? substr($acymLanguages['currentLanguage'], 0, 2) : $acymLanguages['currentLanguage'];
}

function acym_getCustomTranslation()
{
    global $acymailingCustomTranslation;
    if (isset($acymailingCustomTranslation)) {
        return;
    }

    $acymailingCustomTranslation = [];
    $currentLanguage = acym_getLanguageTag();
    $filePath = ACYM_LANGUAGE.$currentLanguage.'.'.ACYM_LANGUAGE_FILE.'_custom.ini';
    if (file_exists($filePath)) {
        $data = acym_fileGetContent($filePath);
        $data = str_replace('"_QQ_"', '"', $data);
        $separate = explode("\n", $data);
        foreach ($separate as $raw) {
            if (strpos($raw, '=') === false) continue;

            $keyval = explode('=', $raw);
            $key = array_shift($keyval);

            $acymailingCustomTranslation[$key] = trim(implode('=', $keyval), "\"\r\n\t ");
        }
    }
}

function acym_loadLanguageFile(string $extension, ?string $basePath = null, ?string $lang = null, bool $reload = false, bool $default = true): void
{
    global $acymLanguages;
    $currentLanguage = acym_getLanguageTag();
    if (isset($acymLanguages[$currentLanguage][$extension]) && !$reload) {
        return;
    }

    if (ACYM_PRODUCTION) {
        $base = ACYM_LANGUAGE;
    }


    $language = $currentLanguage;

    if (!file_exists($base.$language.'.'.$extension.'.ini')) {
        $language = ACYM_DEFAULT_LANGUAGE;
        if (!file_exists($base.$language.'.'.$extension.'.ini')) {
            $base = ACYM_FOLDER.'language'.DS;
            $language = $currentLanguage;
            if (!file_exists($base.$language.'.'.$extension.'.ini')) {
                $language = ACYM_DEFAULT_LANGUAGE;
                if (!file_exists($base.$language.'.'.$extension.'.ini')) return;
            }
        }
    }

    $data = acym_fileGetContent($base.$language.'.'.$extension.'.ini');
    $data = str_replace('"_QQ_"', '"', $data);
    $separate = explode("\n", $data);
    $storeExtension = $extension === ACYM_LANGUAGE_FILE.'_custom' ? ACYM_LANGUAGE_FILE : $extension;
    foreach ($separate as $raw) {
        if (strpos($raw, '=') === false) continue;

        $keyval = explode('=', $raw);
        $key = array_shift($keyval);

        $acymLanguages[$acymLanguages['currentLanguage']][$storeExtension][$key] = trim(implode('=', $keyval), "\"\r\n\t ");
    }

    if (!empty($acymLanguages[ACYM_DEFAULT_LANGUAGE])) return;

    $data = acym_fileGetContent($base.ACYM_DEFAULT_LANGUAGE.'.'.$extension.'.ini');
    $data = str_replace('"_QQ_"', '"', $data);
    $separate = explode("\n", $data);

    foreach ($separate as $raw) {
        if (strpos($raw, '=') === false) continue;

        $keyval = explode('=', $raw);
        $key = array_shift($keyval);

        $acymLanguages[ACYM_DEFAULT_LANGUAGE][$extension][$key] = trim(implode('=', $keyval), "\"\r\n\t ");
    }
}

function acym_getLanguagePath(string $basePath, ?string $language = null): string
{
    return rtrim(ACYM_LANGUAGE, DS);
}

function acym_languageOption(?string $emailLanguage, string $name): void
{
}

function acym_convertWPLocaleToAcyLocale(string $locale): string
{
    if (strpos($locale, '-') !== false) return $locale;

    global $acymWPLangCodes;
    if (!empty($acymWPLangCodes[$locale])) {
        return $acymWPLangCodes[$locale];
    }

    if (strpos($locale, '_') === false) {
        return $locale.'-'.strtoupper($locale);
    } else {
        return str_replace('_', '-', $locale);
    }
}

function acym_getCmsUserLanguage(?int $userId = null): ?string
{
    if ($userId === null) $userId = acym_currentUserId();
    if (empty($userId)) return '';

    return acym_convertWPLocaleToAcyLocale(get_user_locale($userId));
}

function acym_getTranslationTools(): array
{
    $options = [
        (object)['value' => 'no', 'text' => 'ACYM_NO'],
    ];

    $polylangOption = (object)['value' => 'polylang', 'text' => 'Polylang'];
    if (!acym_isExtensionActive('polylang/polylang.php') && !acym_isExtensionActive('polylang-pro/polylang.php')) $polylangOption->disable = true;
    $options[] = $polylangOption;

    $wpmlOption = (object)['value' => 'wpml', 'text' => 'WPML'];
    if (!acym_isExtensionActive('sitepress-multilingual-cms/sitepress.php')) $wpmlOption->disable = true;
    $options[] = $wpmlOption;

    return $options;
}

```