Несколько полезных функций для плагина qTranslate

Обычно для мультиязычных сайтов я использую плагин Polylang, про него еще напишу позже, но в последнем проекте попросили делать языковые версии на qTranslate. В принципе плагин не сложный, все просто и понятно, и даже несколько очень даже ощутимых плюсов я у него обнаружил.

Самый, конечно же, большой плюс — это то, что в одной записи вы можете заполнить все языковые варианты этой страницы, в отличие от Polylang, где для каждой языковой версии страницы нужно создавать отдельные записи.

При переключении между языками, открывается эта же страница только на другом языке, в отличие от Polylang, где по умолчанию перенаправляет на главную страницу, а иначе нужно настраивать связи между различными языковыми версиями страницы.

Также очень удобно, что у каждой языковой версии один и тот же урл, только добавляются префиксы языков, в Polylang из за того, что для каждой языковой версии создается своя запись, не получится сделать одинаковые урлы, то есть не получиться создать /ru/map/ и /en/map/, потому что адрес map может быть только у одной записи.

Так же при использовании qTranslate можно не настраивать шаблон на использование файлов локализации формата .mo, .po. Можно использовать простой код с вариантами для каждого языка. Это удобно для небольших сайтов, если же сайт большой и много статичных текстов в шаблоне, то, возможно, лучше использовать файлы локализации для каждого языка. Как его создать напишу чуть позже.

Но, единственный (пока замеченный) серьезный минус — это то, что дополнительные поля будут относиться ко всем языковым версиям, и не получится заполнить их отдельно для каждой версии с разными значениями. Можно, конечно для каждого языка создавать свое поле, но это не поможет, например, с плагином All In One Seo.

Длинное вступление, а теперь несколько полезных функций:

Выводим переключатель языков, в данном случае, выведется ненумерованный список с текстовым названием языков, стили отображения переключателя языков задаются в настройках плагина, можно вывести флаги, иконки, текст, но можно задать любые свои стили, прописав их в таблице стилей:

<?php qtrans_generateLanguageSelectCode('text', 'language'); ?>

Варианты:
'image'
'text'
'both'
'dropdown'

Вывод ссылки на главную в той же языковой версии:

<a href="<?php echo qtrans_convertURL(home_url( '/' )); ?>">Home</a>

Для того, чтобы не использовать файлы локализации, можно прямо в шаблоне прописать несколько языковых вариантов для статического текста:

<?php echo __('[:en]Map[:ru]Карта'); ?>

Есть так же еще один вариант, но первый точно работает и пишется гораздо короче, а нижний вариант еще нужно проверить, и получается он очень громоздкий:

<?php _e('<!--:en-->Map<!--:--><!--:ru-->Карта<!--:-->'); ?>

Так же можно сделать условие, что при английском языке выводится дополнительное поле для англ., а при русском выводится поле, созданное для русского языка:

<?php 
if ( get_field('title_en') && qtrans_getLanguage() == 'en' ) {
?>
<?php the_field('title_en'); ?>
<?php
}
elseif ( get_field('title_ru') && qtrans_getLanguage() == 'ru' ) {
?>
<?php the_field('title_ru'); ?>
<?php
}
else {
?>
<?php the_title(); ?>
<?php
}
?>

Или такой вариант, но он больше подходит для больших текстов или частей кода:

if ( qtrans_getLanguage() == 'ru' ) {
echo 'Карта';
} else {
echo 'Map';
}