load_child_theme_textdomain()
Завантажує файл перекладу дочірньої теми (.mo) на згадку, для подальшої роботи з ним.
Це обгортка для дочірньої теми .
Створення перекладу для підтеми добре позначиться на оптимізації та структуруванні файлів. Наприклад, використовується тема twentyfifteen, до якої вже підключаються файли перекладу через load_theme_textdomain() і для теми вже є переклад у папці languages . Ми створили підтему з безлічі нових рядків із перекладом. Ми можемо додати ці рядки до файлів батьківської теми, але при оновленні ми втратимо зміни. Щоб цього не сталося, потрібно створити ще один переклад.
.mo має називатися точно як локаль, наприклад ru_RU.mo
Слід викликати під час хука after_setup_theme .
load_theme_textdomain()
Хуків немає.
Повертає
true|false. True, коли .mo файл підключений, false інакше.
Використання
load_child_theme_textdomain($domain, $path);
-
$domain
(рядок) (обов’язковий) -
Ідентифікатор, який буде використовуватись пізніше у функціях перекладу:
__()
_e() можна буде звернутися саме до цього рядка перекладу. Можна вказати такий самий, як і у батьківської теми. -
$path
(рядок) -
Шлях до папки з файлом
.mo . За промовчанням вказується шлях до каталогу підтеми:
get_stylesheet_directory() .
Типово: false
Приклади
#1 Підключимо файл перекладу дочірньої теми
add_action( 'after_setup_theme', 'my_child_theme_setup');
function my_child_theme_setup(){
load_child_theme_textdomain( 'my_child_theme', get_stylesheet_directory() . '/languages' );
}.mo файл повинен знаходитися в папці languagesв підтемі та мати назву локалі мови, наприклад: languages/de_DE.mo .
список змін
| З версії 2.9.0 | Введено. |
Код load_child_theme_textdomain() load child theme textdomain WP 6.0.2
function load_child_theme_textdomain( $domain, $path = false ) {
if (! $ path) {
$ path = get_stylesheet_directory();
}
return load_theme_textdomain($domain, $path);
}