i18n4marketpro - Мультиязычность товаров

Руководство по добавлению и редактированию переводов категорий и товаров в плагине i18n4marketpro

Оглавление

• Введение
• Подготовка к работе
  • Необходимые права доступа
  • Настройка плагина
• Перевод категорий (структуры)
  • Доступ к интерфейсу перевода категорий
  • Выбор языка
  • Заполнение формы перевода категорий
  • Сохранение переводов категорий
  • Пагинация
• Перевод товаров
  • Кнопки управления переводом на странице товара
  • Добавление нового перевода товара
  • Редактирование перевода товара
  • Удаление перевода товара
  • Просмотр переведённого товара
• Дополнительные поля (extrafields)
• Частые вопросы

Введение

Плагин i18n4marketpro предназначен для создания многоязычного каталога в модуле Market системы Cotonti. Он позволяет переводить категории (структуру) и товары (страницы) на несколько языков. Переводы хранятся отдельно от оригинального контента и автоматически подставляются при просмотре сайта на соответствующем языке.

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

Подготовка к работе

Необходимые права доступа

Перед началом работы убедитесь, что ваша учётная запись обладает нужными правами.

Для перевода категорий
Пользователь должен иметь право администрирования плагина. В коде это переменная $i18n4marketpro_admin. Обычно это право выдаётся администраторам сайта или специально настроенным группам пользователей.

Для добавления перевода товара
Требуется право записи $i18n4marketpro_write. Это право позволяет создавать новые переводы товаров.

Для редактирования перевода товара
Право на редактирование имеют:

• администраторы плагина ($i18n4marketpro_admin);
• пользователь, который является автором перевода (его ID совпадает с ipage_translatorid);
• в некоторых случаях владелец товара (fieldmrkt_ownerid).

Для удаления перевода товара
Удалять перевод могут:

• администраторы плагина;
• автор перевода (ipage_translatorid).

Точная настройка этих прав производится в административной панели Cotonti в разделе управления правами групп.

Настройка плагина

Перед началом использования плагина необходимо правильно его сконфигурировать.

1. Войдите в административную панель Cotonti.
2. Перейдите в раздел Расширения.
3. Найдите плагин Content Internationalization (i18n4marketpro) и откройте его настройки.

В настройках доступны следующие параметры:

Корневые категории (cats)
Поле, в котором через запятую перечисляются коды родительских категорий модуля Market, для которых будет включён перевод. Например: computers,notebooks,tablets. Только товары, находящиеся внутри этих категорий (и их подкатегорий), смогут иметь переводы, а также сами категории будут доступны для перевода.

Список локалей (locales)
Здесь задаётся список языков, на которые можно переводить. Формат: каждая строка содержит код|Название. Пример:

en|English
ru|Русский
ua|Українська

Первая часть — это код языка (например, ru), вторая — его отображаемое название. Основной язык сайта (defaultlang) автоматически добавляется в список, если отсутствует.

Опускать параметр языка в URL (omitmain)
Если включено (значение 1), то в URL страниц на основном языке параметр l не добавляется. Это влияет на формирование ссылок переключателя языков.

Включить ЧПУ для параметра языка (rewrite)
Если включено, то параметр языка в URL будет представлен в виде префикса пути (например, /ru/about). Требует настройки .htaccess.

Запоминать выбранный язык в cookie (cookie)
При включении выбранный пользователем язык сохраняется в cookie и используется при последующих посещениях.

После заполнения всех необходимых параметров сохраните настройки.

Перевод категорий (структуры)

Перевод категорий позволяет отображать названия и описания категорий на разных языках. Это важный аспект для полноценной локализации каталога.

Доступ к интерфейсу перевода категорий

Интерфейс перевода категорий доступен только администраторам плагина. Чтобы открыть его, перейдите по следующему адресу (замените example.com на ваш домен):

https://example.com/index.php?e=i18n4marketpro&m=structure

Если у вас недостаточно прав, вы увидите сообщение об ошибке или будете перенаправлены.

Выбор языка

При первом открытии страницы (или если не выбран язык, или выбран основной язык) вы увидите список доступных языков для перевода. Список формируется из настроек плагина, исключая основной язык.

Каждый пункт списка — это ссылка с названием языка. Например:

• English
• Русский
• Українська

Нажатие на язык приводит к переходу на страницу перевода категорий для этого языка. URL будет выглядеть примерно так:

index.php?e=i18n4marketpro&m=structure&l=ru

где l=ru указывает выбранный язык.

Заполнение формы перевода категорий

На странице перевода категорий отображается таблица (или список), содержащая все категории, которые попадают под действие плагина. Категория попадает в список, если её корневой родитель входит в список, указанный в настройке cats.

Для каждой категории выводится строка, разделённая на две колонки:

Левая колонка — оригинал
Здесь показаны:

• Название категории на основном языке.
• Описание категории на основном языке.

Эти данные доступны только для чтения, изменить их нельзя.

Правая колонка — перевод
Содержит два поля ввода:

• Название (текстовое поле) — сюда вводится переведённое название категории.
• Описание (многострочное текстовое поле) — сюда вводится переведённое описание.

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

В скрытом поле передаётся код категории, который используется при сохранении.

Сохранение переводов категорий

После заполнения нужных полей перевода, нажмите кнопку Обновить (или Update) в нижней части формы. Эта кнопка отправляет данные на сервер для обработки.

При сохранении система анализирует каждую категорию:

• Если поле «Название» пустое, существующий перевод для этой категории будет удалён. Если перевода не было, ничего не произойдёт.
• Если поле «Название» заполнено, и перевода ранее не существовало, будет создана новая запись перевода.
• Если поле «Название» заполнено, и оно отличается от сохранённого, перевод будет обновлён.

После обработки вы увидите сообщения о результатах:

• количество добавленных переводов;
• количество обновлённых переводов;
• количество удалённых переводов.

Эти сообщения отображаются в верхней части страницы.

Пагинация

Если количество категорий превышает установленный лимит на страницу (по умолчанию 15, может быть изменено в настройках Cotonti), список будет разбит на несколько страниц. Внизу страницы отображается навигация для перехода между страницами.

Перевод товаров

Перевод товаров позволяет создавать локализованные версии карточек товаров: название, описание, полный текст, а также дополнительные поля (мета-теги, H1 и т.д.).

Кнопки управления переводом на странице товара

На странице товара (при его просмотре) отображаются кнопки, связанные с переводом, если у пользователя есть соответствующие права. Эти кнопки появляются только если товар находится в категории, для которой включён перевод (согласно настройке cats).

Возможные кнопки:

• «Перевести» — отображается, если для текущего языка (выбранного пользователем) перевод ещё не создан, и у пользователя есть право на запись ($i18n4marketpro_write). Нажатие на неё открывает форму добавления перевода.
• «Редактировать» — отображается, если перевод существует, и пользователь может его редактировать (админ плагина, автор перевода или владелец товара). Открывает форму редактирования.
• «Удалить перевод» — отображается только администраторам плагина, если перевод существует. Удаляет текущий перевод (обычно с запросом подтверждения).

Эти кнопки могут быть размещены в любом месте шаблона товара с помощью тегов {MARKET_I18N4MARKETPRO_TRANSLATE}, {MARKET_I18N4MARKETPRO_ADMIN_EDIT}, {MARKET_I18N4MARKETPRO_ADMIN_DELETE}.

Если вы не видите кнопок, проверьте права доступа и настройки категорий.

Добавление нового перевода товара

Как открыть форму добавления

• На странице товара нажмите кнопку «Перевести» (если она есть).

• Либо перейдите по прямой ссылке:

  index.php?e=i18n4marketpro&m=market&a=add&id=ID_товара

  где ID_товара — числовой идентификатор товара.

Описание формы добавления
Форма разбита на две основные части: слева отображается оригинальный товар, справа — поля для ввода перевода.

Левая часть (оригинал):

• Заголовок товара на основном языке.
• Описание товара.
• Мета-заголовок (если есть).
• Мета-описание (если есть).
• Теги (если есть).
• Полный текст товара (в отформатированном виде).

Правая часть (перевод):

• Локаль — выпадающий список доступных языков. В списке только те языки, для которых ещё нет перевода (основной язык исключён).
• Название — обязательное текстовое поле. Минимальная длина — 2 символа. Если оставить пустым или короче, будет показана ошибка.
• Описание — многострочное поле для краткого описания товара (до 255 символов, в зависимости от структуры БД).
• Текст — большое текстовое поле с поддержкой HTML и парсера модуля Market. Сюда вводится полный переведённый текст товара.
• Дополнительные поля — если администратор создал дополнительные поля для таблицы переводов (например, мета-теги), они будут отображены здесь. Подробнее в разделе «Дополнительные поля».
• Теги — если активен плагин Tags и в шаблоне предусмотрен блок, можно ввести переведённые теги.

Сохранение
После заполнения полей нажмите кнопку Отправить. Произойдёт проверка:

• локаль допустима и не занята;
• название не короче 2 символов.

Если всё верно, перевод будет сохранён в базе данных, и вы будете перенаправлены на страницу товара с параметром языка (например, ?l=ru). Товар отобразится на переведённом языке.

Если есть ошибки (например, название слишком короткое), вы останетесь на форме, и будут показаны сообщения об ошибках. Введённые данные не теряются.

Редактирование перевода товара

Как открыть форму редактирования

• На странице товара нажмите кнопку «Редактировать» (если она доступна).

• Или перейдите по прямой ссылке:

  index.php?e=i18n4marketpro&m=market&a=edit&id=ID_товара&l=код_языка

  Например: ...&a=edit&id=10&l=ru.

Описание формы редактирования
Форма редактирования аналогична форме добавления, но поля уже заполнены текущими значениями перевода.

Особенности:

• В выпадающем списке Локаль можно выбрать другой язык, если он не занят другим переводом для этого товара. При смене языка проверяется уникальность, и если перевод на выбранный язык уже существует, будет показана ошибка.
• Все поля (название, описание, текст, дополнительные поля) можно изменять.
• Дата обновления (ipage_date) автоматически станет текущей.

Сохранение
После внесения изменений нажмите Отправить. При успешном обновлении вы будете перенаправлены на страницу товара с выбранной локалью. Если возникли ошибки, форма будет показана снова с введёнными данными и сообщениями.

Удаление перевода товара

Удалить перевод может администратор плагина или автор перевода.

Способы удаления:

• На странице товара нажмите кнопку «Удалить перевод» (только для администраторов).

• Используйте прямую ссылку:

  index.php?e=i18n4marketpro&m=market&a=delete&id=ID_товара&l=код_языка

При переходе по ссылке обычно появляется запрос подтверждения (через Cotonti механизм подтверждения). После подтверждения перевод удаляется из базы данных.

Если установлен и активирован плагин Trashcan и в его настройках включена опция trash_page, удалённый перевод будет помещён в корзину, что позволит его восстановить.

После удаления вы будете перенаправлены на страницу товара (на основном языке).

Просмотр переведённого товара

Когда пользователь просматривает товар на языке, отличном от основного, и для этого языка существует перевод, плагин автоматически подменяет следующие данные:

• Заголовок товара;
• Описание;
• Текст;
• Мета-теги (если переведены через дополнительные поля);
• Названия категорий в хлебных крошках (если категории переведены).

Это происходит благодаря хукам market.main и markettags.main. Пользователю не нужно выполнять никаких действий — система сама подставляет перевод.

Если перевода нет, отображается оригинальный контент.

Дополнительные поля (extrafields)

Плагин i18n4marketpro поддерживает перевод дополнительных полей, которые могут быть созданы администратором для таблицы переводов товаров. Это позволяет переводить, например, мета-теги (title, description), H1 и другие SEO-атрибуты.

Создание дополнительных полей

1. Перейдите в админ-панель Cotonti → Дополнительные поля.
2. В списке таблиц выберите таблицу «Переводы товаров» (обычно cot_i18n4marketpro_pages). Она появляется благодаря плагину.
3. Создайте нужные поля, задав им имена и типы. Например, поле mxtra_meta_title типа "строка".

Использование в форме перевода
После создания полей они автоматически появляются в форме добавления/редактирования перевода товара в правой колонке. Пользователь может ввести переведённые значения.

Вывод на странице товара
Переведённые значения дополнительных полей доступны в шаблонах товара через теги:

• {I18N_PAGE_ИМЯ_ПОЛЯ} — отформатированное значение.
• {I18N_PAGE_ИМЯ_ПОЛЯ_TITLE} — заголовок поля.
• {I18N_PAGE_ИМЯ_ПОЛЯ_VALUE} — исходное значение.

Также они могут быть выведены в <head> страницы через теги {I18N_HEADER_...}, которые формируются плагином.

Частые вопросы

Почему я не вижу кнопку «Перевести» на странице товара?
Возможные причины:

• У вас нет права записи ($i18n4marketpro_write).
• Категория товара не входит в список корневых категорий, указанных в настройках плагина (cats).
• Перевод для текущего языка уже существует.

Почему перевод категории не отображается на сайте?
Проверьте:

• Категория находится внутри разрешённых корневых категорий.
• Пользователь выбрал язык, отличный от основного.
• Для этой категории сохранён перевод (название не пустое).

Можно ли переводить товары вне разрешённых категорий?
Нет, плагин работает только для категорий, указанных в настройке cats.

Что произойдёт, если оставить поле названия категории пустым?
Существующий перевод для этой категории будет удалён.

Можно ли изменить язык перевода товара после его создания?
Да, при редактировании перевода можно выбрать другую локаль, если она не занята другим переводом этого же товара.

Как восстановить удалённый перевод?
Если был активен плагин Trashcan, удалённые переводы можно восстановить из корзины.

Данное руководство основано исключительно на анализе предоставленного исходного кода плагина i18n4marketpro.