This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
ru:plugins:i18n [2013/10/09 11:16] Arkady [Интернационализация (I18N) и плагины] |
ru:plugins:i18n [2013/10/09 12:23] (current) Arkady |
||
---|---|---|---|
Line 70: | Line 70: | ||
- | ===== Language files without country ===== | + | ===== Языковые файлы без кода страны ===== |
- | If you want to provide language files en.php, de.php, etc. (without country code), than use the following lines to load your texts: | + | Если вы в плагине применяете языковые файлы без кода страны, т.е. en.php, de.php, и.т.д., используйте для подгрузки перевода следующий код: |
<code> | <code> | ||
global $LANG; | global $LANG; | ||
- | i18n_merge('my_plugin', substr($LANG,0,2)) || i18n_merge('my_plugin','en'); | + | i18n_merge('мой_плагин', substr($LANG,0,2)) || i18n_merge('мой_плагин','en'); |
</code> | </code> | ||
- | ===== Front-end ===== | ||
- | If your plugin has to display texts on the front-end (the internet site itself) and you just support typical GetSimple installations, where the content is displayed in one language and the admin back-end is set to this language, you do it the same way as described above. | ||
- | The only difference is that you must provide language support, because where it might be acceptable for administrators and editors to see some information in english instead of their own language, it is unacceptable on the front-end. Without language support you basically limit your plugin to use in countries with the same language as your's. | + | ===== Фронтенд ===== |
+ | |||
+ | Если ваш плагин выводит текстовую информацию непосредственно на страницы сайта при типовой установке GetSimple, в случае когда контент сайта и язык административной панели совпадают, работают методы, уже описанные в настоящей секции. | ||
+ | |||
+ | Тем не менее – языковая поддержка должна быть обеспечена. Возможно, для администраторов или пользователей с правами редактора допустимо использование администраторского интерфейса на неродном языке (как правило, на английском). Но отсутствие поддержки плагином других языков во фронтенде недопустимо. Без мультиязычной поддержки вы практически ставите серьезную преграду для распространения вашего плагина среди пользователей, которые не владеют вашим родным языком. | ||
**GetSimple 3.0:** | **GetSimple 3.0:** | ||
- | In the frontend the variable $LANG is always en_US (due to the multi-user capabilities introduced with 3.0). The user should be encouraged to enter a line | + | Во фронтенде значение переменной $LANG всегда равно en_US (из-за многопользовательского функционала, внедренного в версии 3.0+). Пользователю следует указать на необходимость добавить строку |
+ | |||
<code> | <code> | ||
- | $LANG = 'de_DE'; | + | $LANG = 'de_DE'; или, в нашем случае, $LANG = 'ru_RU'; |
</code> | </code> | ||
- | or similar into gsconfig.php. | + | |
- | As an alternative the plugin can offer a functionality to set the frontend language. | + | в файл gsconfig.php. |
+ | |||
+ | В качестве альтернативы плагин может предлагать пользователю возможность для смены языка сайта. | ||
===== Multi-language Front-end ===== | ===== Multi-language Front-end ===== | ||
- | Some internet sites implemented with GetSimple support multiple languages. The language is determined from the user's preferences (his operating system language resp. the browser language) and he might be allowed to switch between the supported languages. | + | На некоторых интернет-сайтах, созданных с помощью GetSimple, реализована поддержка нескольких языков. Язык сайта определяется на основе предпочтений пользователя (язык операционной системы, язык браузера), посетитель имеет возможность переключаться с одного языка на другой. |
- | As multi-language sites are not supported natively by GetSimple, there currently exists one plugin, [[http://get-simple.info/extend/plugin/i18n/69/|I18N]]. | + | Создание и управление многоязычными сайтами не поддерживаются ядром GetSimple. В настоящее время для решения этой задачи существует единственный плагин [[http://get-simple.info/extend/plugin/i18n/69/|I18N]]. |
- | If your plugin should support multi-language sites using the I18N plugin, you must load the texts **only after the I18N initialization** (in the pretemplate hook) - in your function(s) that output text on the front end, with | + | Если ваш плагин должен поддерживать мультиязычные сайты с использованием плагина I18N, тексты из языковых фалов вашего плагина **должны загружаются только после инициализации I18N** (это происходит в хуке pretemplate), с помощью следующего кода: |
<code> | <code> | ||
global $LANG; | global $LANG; | ||
if (function_exists('i18n_load_texts')) { | if (function_exists('i18n_load_texts')) { | ||
- | i18n_load_texts('my_plugin'); | + | i18n_load_texts('мой_плагин'); |
} else { | } else { | ||
- | i18n_merge('my_plugin', substr($LANG,0,2)) || i18n_merge('my_plugin', 'en'); | + | i18n_merge('мой_плагин', substr($LANG,0,2)) || i18n_merge('мой_плагин', 'en'); |
} | } | ||
</code> | </code> | ||
- | If you need back end template texts directly when loading the plugin, you need to check, if the plugin is loaded in the backend: | + | Если при загрузке плагина в административную панель вам сразу требуются языковые строки - необходима проверка, загружен ли плагин в бэкенде. |
<code> | <code> | ||
if (basename($_SERVER['PHP_SELF']) != 'index.php') { // back end only - or do you know a better condition? | if (basename($_SERVER['PHP_SELF']) != 'index.php') { // back end only - or do you know a better condition? | ||
- | i18n_merge('my_plugin', substr($LANG,0,2)) || i18n_merge('my_plugin', 'en'); | + | i18n_merge('мой_плагин', substr($LANG,0,2)) || i18n_merge('мой_плагин', 'en'); |
} | } | ||
- | add_action('plugins-sidebar', 'createSideMenu', array($thisfile, i18n_r('my_plugin/CONFIGURE'))); | + | add_action('plugins-sidebar', 'createSideMenu', array($thisfile, i18n_r('мой_плагин/CONFIGURE'))); |
</code> | </code> | ||
- | This code will work (with GetSimple 3.0+), whether the I18N plugin is present or not. | + | Этот код будет работать (с GetSimple 3.0+) вне зависимости от того, установлен ли в системе плагин I18N или нет. |
+ | |||
+ | **На заметку**: функция i18n_load_texts доступна в версиях плагина I18N 1.0+. | ||
+ | |||
+ | **На заметку**: На текущий момент плагин I18N поддерживает только языковые коды без наименования страны, таким образом, языковым файлам должны присваиваться имена ''en.php'', ''de.php'', и пр., а не ''en_US.php'', и.т.д. | ||
+ | |||
+ | ====== Ссылки ====== | ||
+ | |||
+ | На главную [[ru:|Содержание]] | ||
- | Note: the function i18n_load_texts is available in the I18N plugin 1.0+. | + | ===== Страницы этой секции ===== |
- | Note: The I18N plugin currently only supports language codes without country, so you must have language files like ''en.php'', ''de.php'' etc. instead of ''en_US.php'', etc. | + | === Языки === |
+ | *[[ru:languages|Поддержка языков]] | ||
+ | *[[ru:lang:translate|Инструменты для перевода]] | ||
+ | *[[ru:plugins:i18nhashes|Встроенный хеш-массив интернационализации (I18N)]] | ||
+ | *[[ru:transifex|Рекомендации по использованию Transifex]] | ||