Вставка языковых констант в контент Joomla!

Read in English

Плагин позволяет вставлять значения языковых констант в статьи, модули и другой контент Joomla с помощью синтаксиса {langos LANGUAGE_CONSTANT}.

---

⚠️ Проблема

При создании мультиязычного сайта на Joomla вы часто сталкиваетесь с ситуацией:

Нужно изменить всего несколько слов в модуле или статье в зависимости от языка — но приходится создавать отдельные копии контента для каждой языковой версии. Это неудобно и требует лишних усилий.

---

✅ Решение

Langos позволяет вставлять языковые константы прямо в контент с помощью простого синтаксиса:

{langos YOUR_LANGUAGE_CONSTANT}

Это работает как вызов \Joomla\CMS\Language\Text::_('YOUR_LANGUAGE_CONSTANT'), но без необходимости программировать или редактировать шаблоны.

Кроме того, плагин поддерживает загрузку языковых файлов конкретных расширений, например модулей или компонентов. Для этого просто укажите третий аргумент в шорткоде:

{langos MOD_FOOTER_LINE1, mod_footer}

Теперь плагин загрузит языковую константу из соответствующего языкового файла именно этого расширения.

---

💡 Ключевые особенности

• 🚀 Результаты работы плагина сохраняются в кэше, что положительно влияет на производительность сайта
• 🔁 Совместим с Joomla Cache, JotCache и другими популярными системами кэширования
• 🧩 Вставка языковых констант в любые элементы контента: статьи, модули и т.д.
• 🌐 Полная интеграция с системой мультиязычности Joomla
• 🔌 Работает «из коробки» с любыми стандартными типами контента
• 🛠 Не требует навыков программирования
• 🧪 Подходит для использования визуальными редакторами и не-программистами
• 📦 Поддержка загрузки языковых файлов конкретных расширений
• 🎯 Идеален для динамической замены текста в разных языках

---

⚙️ Требования

• Joomla >=4.2 | 5.x
• PHP >= 7.4

---

📦 Установка

1. Скачайте последнюю версию плагина
2. Перейдите в панель управления Joomla → Расширения → Менеджер расширений → Установка
3. Загрузите и установите .zip файл
4. После установки активируйте плагин через:
   Расширения → Плагины → Найдите "LangOS" и включите его

---

🛠 Как использовать

1. Простая вставка языковой константы

1. Перейдите в панель управления →
   Расширения → Языки → Переопределение
2. Выберите нужный язык
3. Нажмите Создать, заполните поля:
   • Языковая константа (например, COM_MY_CUSTOM_TEXT)
   • Текст (значение, которое будет показано на сайте)
4. Сохраните и повторите для других языков, если это необходимо
5. Откройте статью или модуль, где нужно использовать константу
6. Вставьте код:

   {langos COM_MY_CUSTOM_TEXT}
   

2. Загрузка константы из языкового файла расширения

Если константа относится к определённому расширению (например, модулю), передайте её имя третьим аргументом:

{langos MOD_FOOTER_LINE1, mod_footer}

Плагин автоматически загрузит правильное значение из языкового файла указанного расширения.

Note
Для HTML-модулей: Не забудьте включить опцию Обработка плагинами на вкладке Основные параметры модуля.

---

📄 Лицензия

Этот плагин распространяется под лицензией GNU General Public License v3.0.