WooCommerce: решение проблем с транслитерацией ЧПУ (slug) товаров

Проблема с транслитерацией ЧПУ в WooCommerce

В магазинах на WooCommerce часто возникает ситуация, когда названия товаров на кириллице при создании URL (slug) преобразуются некорректно или остаются в виде символов, непригодных для SEO и удобочитаемости. Особенно это заметно при массовом импорте товаров или автоматическом создании. Это приводит к проблемам с индексацией, ухудшению SEO и неудобству пользователей.

Типичные симптомы

• ЧПУ товаров содержат нечитабельные символы или «кракозябры»;
• URL товаров выглядят как набор случайных букв вместо транслитерации;
• автоматическая генерация slug при массовом добавлении товаров не работает корректно;
• появляются ошибки при обновлении товара из-за конфликтов slug.

Диагностика проблемы с транслитерацией

Первым делом нужно проверить, как WordPress и WooCommerce обрабатывают транслитерацию. По умолчанию WordPress использует функцию sanitize_title_with_dashes(), которая транслитерирует заголовок в slug, но иногда встроенный механизм не справляется с кириллицей из-за отсутствия локализации или конфликтов плагинов.

Выполните в консоли WordPress следующий код для теста транслитерации:

echo sanitize_title_with_dashes('Тестовый товар');

Если результат – нечитаемые символы или пустая строка, значит стандартный метод транслитерации не работает.

Пошаговое решение: добавление кастомной транслитерации для WooCommerce

Для исправления проблемы рекомендуем реализовать собственный фильтр на хук sanitize_title с использованием проверенного метода транслитерации, например, через transliterator_transliterate() из PHP intl, либо через свой массив замены символов.

Пример кода для functions.php вашей темы или отдельного плагина:

add_filter('sanitize_title', 'custom_transliterate_slug', 10, 3);function custom_transliterate_slug($title, $raw_title, $context) {    // Работать только для товаров WooCommerce    if ('save' !== $context) {        return $title;    }    if (function_exists('transliterator_transliterate')) {        $translit = transliterator_transliterate('Any-Latin; Latin-ASCII', $raw_title);        $title = strtolower($translit);        $title = preg_replace('/[^a-z0-9\-\_]+/', '-', $title);        $title = trim($title, '-');        return $title;    }    // fallback: замена кириллицы на латиницу вручную    $converter = array(        'а' => 'a', 'б' => 'b', 'в' => 'v', 'г' => 'g', 'д' => 'd',        'е' => 'e', 'ё' => 'e', 'ж' => 'zh', 'з' => 'z', 'и' => 'i',        'й' => 'y', 'к' => 'k', 'л' => 'l', 'м' => 'm', 'н' => 'n',        'о' => 'o', 'п' => 'p', 'р' => 'r', 'с' => 's', 'т' => 't',        'у' => 'u', 'ф' => 'f', 'х' => 'h', 'ц' => 'c', 'ч' => 'ch',        'ш' => 'sh', 'щ' => 'sch', 'ь' => '', 'ы' => 'y', 'ъ' => '',        'э' => 'e', 'ю' => 'yu', 'я' => 'ya',    );    $title = mb_strtolower($raw_title, 'UTF-8');    $title = strtr($title, $converter);    $title = preg_replace('/[^a-z0-9\-\_]+/', '-', $title);    $title = trim($title, '-');    return $title;}

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

Проверка результата после внедрения

• Создайте новый товар с названием на кириллице, например «Новый товар»;
• Сохраните товар и проверьте, что в URL (slug) отображается корректный латинский вариант, например novyj-tovar;
• Проверьте, что при массовом импорте новых товаров транслитерация работает так же корректно;
• Проверьте на странице редактирования товара, что slug автоматически обновляется при изменении названия без ошибок.

Частые ошибки и их решения

• Слаг не меняется при изменении названия товара – проверьте, не отключена ли автоматическая генерация slug в WooCommerce или нет ли плагинов, блокирующих фильтр sanitize_title.
• Появляются дубли slug – WooCommerce автоматически добавляет суффиксы для дублирующихся URL, но если кастомный фильтр формирует одинаковые слаги, нужно дополнительно добавлять уникальные идентификаторы.
• Транслитерация не работает на сервере – проверьте, что расширение intl PHP установлено и доступно, иначе fallback-массив будет использоваться.

Практические советы по оптимизации и безопасности

• Для повышения производительности кэшируйте результаты транслитерации, если товары импортируются массово, например, через transient API.
• Не используйте в slug спецсимволы и пробелы, чтобы избежать проблем с URL и SEO.
• Регулярно обновляйте WooCommerce и WordPress, чтобы исключить баги, связанные с обработкой ЧПУ.
• Для сложных сценариев импорта используйте WP CLI и кастомные скрипты с проверкой транслитерации.

Сравнение вариантов транслитерации

Метод	Плюсы	Минусы	Пример кода
Стандартный WordPress	Встроен, не требует кода	Плохо с кириллицей, может создавать «кракозябры»	sanitize_title_with_dashes()
PHP intl (transliterator_transliterate)	Качественная транслитерация, поддержка множества языков	Требует расширение intl, не всегда доступно	см. пример выше
Ручной массив замены	Работает без расширений, контролируемо	Только для русского языка, требует поддержки	см. пример выше