PHPackages                             sibirix/sibirix-translator - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Localization & i18n](/categories/localization)
4. /
5. sibirix/sibirix-translator

ActiveLibrary[Localization & i18n](/categories/localization)

sibirix/sibirix-translator
==========================

Sibirix.Translator composer package for Bitrix

0.2.3(7y ago)16PHPPHP ^7.0

Since Feb 7Pushed 7y ago1 watchersCompare

[ Source](https://github.com/SibirixScrum/sibirix-translator)[ Packagist](https://packagist.org/packages/sibirix/sibirix-translator)[ RSS](/packages/sibirix-sibirix-translator/feed)WikiDiscussions master Synced 2w ago

READMEChangelogDependenciesVersions (6)Used By (0)

Что это?
========

[](#что-это)

Пакет для 1С-Битрикс, для простой мультиязычности текстовых полей элементов/разделов инфоблоков. Удобно для создания симметричный языковых версий - в одном элементе инфоблока будут задаваться тексты для всех языкоовых версий сразу.

При редактировании элемента/раздела добавляется по вкладке для каждого языка в системе и в них дублируются нужные (какие вы настроите) текстовые поля. Введённые строки для всех языков **сохраняются в одно исходное поле** в специальном формате {{ru:Текст на русском}}{{en:English text}}.

В связи с этим и ограничение - запрет на использование в тексте двойных фигурных скобок и ограничение на максимальную суммарную длину текста. Но зато не требуются никакие изменения в БД.

Из-за ограничения на макс. длину текста модуль не рекомендуется использовать на сайтах с более чем 3 языками.

Возможности
===========

[](#возможности)

Поддерживается перевод только текстовых полей:

- стандартные поля элемента инфолбока NAME, PREVIEW\_TEXT, DETAIL\_TEXT
- дополнительные свойства элемента инфоблока типов Строка и HTML/Текст
- стандартные поля раздела инфоблока NAME, DESCRIPTION
- дополнительные свойства раздела инфоблока типа Строка

Установка
=========

[](#установка)

Установка модуля
----------------

[](#установка-модуля)

Если у вас в проекте уже используется composer:

`composer require sibirix/sibirix-translator`

Если вы хотите использовать данный модуль переводов в проекте, где ещё нет композера:

1. в папке /local/ выполнить `composer require sibirix/sibirix-translator`
2. подключить файл автозагрузки композера: в файле `/local/php_interface/init.php` (создайте, если он у вас отсутствует) добавить строку `require_once($_SERVER["DOCUMENT_ROOT"] . '/local/vendor/autoload.php');`

Добавление обработчиков событий
-------------------------------

[](#добавление-обработчиков-событий)

Добавьте обработчики событий модуля: в файле `/local/php_interface/init.php`:

```
use Bitrix\Main\EventManager as BitrixEventManager;
use Sibirix\Translator\IBlockLocales;

$manager = BitrixEventManager::getInstance();
$manager->addEventHandler("main", "OnBeforeProlog", [IBlockLocales::class, 'onBeforeProlog']);
$manager->addEventHandler("main", "OnAdminTabControlBegin", [IBlockLocales::class, 'onAdminTabControlBegin']);

```

Настройка формы редактирования в админке
========================================

[](#настройка-формы-редактирования-в-админке)

1. Открываем страницу редактирования элемента/раздела инфоблока
2. Открываем настройки формы редактирования
3. Жмём кнопку "Добавить" рядом со списком вкладок, вводим название вкладки "{{}}" (без кавычек, 2 открвающихся и 2 закрывающихся фигурных скобки)
4. Выбираем новую вкладку в спике и добавляем на неё те поля, для которых требуется выполнять перевод
5. Сохраняем настройки формы

В форме появятся вкладки с названиями "Перевод: ...", список языков для перевода берётся из языков, используемых в созданных в системе сайтах (Настройки - Настройки продукта - Сайты - Список сайтов. Открываем редактирование свойств сайта, блок "Региональные настройки", поле "Язык").

Вывод данных в шаблонах
=======================

[](#вывод-данных-в-шаблонах)

```

```

`$item['PROPERTY_TEXT_VALUE']` - строка с данными в формате {{}}, сохранённая пакетом в админке.

Выводит текст в языке текущего сайта (определяется по константе LANGUAGE\_ID, \[[https://dev.1c-bitrix.ru/api\_help/main/general/constants.php](https://dev.1c-bitrix.ru/api_help/main/general/constants.php)\])

###  Health Score

23

—

LowBetter than 26% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~29 days

Total

5

Last Release

2580d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/14814960?v=4)[Сибирикс | Scrum-студия](/maintainers/SibirixScrum)[@SibirixScrum](https://github.com/SibirixScrum)

---

Top Contributors

[![SibirixScrum](https://avatars.githubusercontent.com/u/14814960?v=4)](https://github.com/SibirixScrum "SibirixScrum (14 commits)")

### Embed Badge

![Health badge](/badges/sibirix-sibirix-translator/health.svg)

```
[![Health](https://phpackages.com/badges/sibirix-sibirix-translator/health.svg)](https://phpackages.com/packages/sibirix-sibirix-translator)
```

###  Alternatives

[smmoosavi/php-gettext

Wrapper for php-gettext by danilo segan. This library provides PHP functions to read MO files even when gettext is not compiled in or when appropriate locale is not present on the system.

1926.6k1](/packages/smmoosavi-php-gettext)[laradevs/spanish

labels translated to spanish

166.7k](/packages/laradevs-spanish)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)