Инструкция по переходу с версии 1.X на версию 3.X плагина «SEO-оптимизация»
Внимание! С версии плагина 3.0 отключена поддержка переменных версии 1.X. Переменные старого формата работать не будут. Необходимо будет заменить все переменные старого формата на переменные нового формата, которые использовались с версии 2.0.
Отключена поддержка хелперов вида {shopSeoViewHelper::getTagDescription()}.
Некоторые опции плагинов, которые интегрированы с плагином «SEO-оптимизация», не будут работать до выхода обновлений этих плагинов (в новых версиях плагинов «SEO-фильтр», «Навигация в хлебных крошках» уже добавлена поддержка плагина «SEO-оптимизация» версии 3.0, необходимо будет установить эти обновления).
Обязательно проверяйте корректность работы плагина и введенных шаблонов после обновления.
1. Проверьте настройки плагина, убедитесь, что используются переменные нового формата
Переменные нового формата используются с 2016 года с версии 2.0.
1.1. Как отличить переменные
Переменные нового формата выглядят так: {$category.seo_name}.
Узнать их можно по:
- синей подсветке (подсвечиваются в шаблонах везде, кроме шаблонов описаний);
- наличию в фигурных скобках знака $ (доллар).
Пример:
Старые переменные подсвечиваются зеленым (кроме описаний) и не содержат знак доллара.
Пример:
Ключевое отличие новых переменных в том, что они поддерживают Smarty.
С их помощью можно прописывать условия типа:
{if $page_number == 1} Текст 1 {else} Текст 2 {/if}
{foreach $parent_categories as $i => $_category}
{$parent_category_seo_names[$i] = $_category['seo_name']}
{/foreach}
Что значительно расширяет возможности настройки шаблонов.
Старые переменные такую возможность не поддерживали.
1.2. Как заменить переменные
Есть в шаблонах используются старые переменные, например:
...то их нужно заменить на новые. Получить новые переменные можно в подсказках справа.
Например, старая переменная {category_seo_name} выводила «SEO-название категории» и ее нужно заменить на {$category.seo_name}.
Как это сделать:
То есть после замены в шаблоне должны оставаться только новые переменные. Эту замену нужно сделать во всех полях: Title, Заголовок H1, META Description, META Keywords, Описание, Дополнительное описание.
Важно!
1. Замену нужно сделать во всех шаблонах. Свои шаблоны также могут быть настройках категорий, товаров и т.д.
2. Новая версия «SEO-оптимизации» не поддерживает старые переменные других плагинов - «SEO-регионы», «SEO-фильтра».
3. Переменная {region_name} плагина «SEO-регионы» больше не поддерживается! Ее нужно заменить на {$region.name}. Аналогично и с другими устаревшими переменными плагина «SEO-регионы».
1.3. Где могут быть настроены шаблоны плагина
Шаблоны плагина могут быть настроены в:
— Общих настройках (Магазин/Плагины/SEO-оптимизация);
— В общих настройках для конкретной витрины;
— В настройках категорий (в стандартных полях Title, Description, Keywords, Описание);
— В настройках категорий (дополнительный функционал «SEO-оптимизации» с выбором витрин);
— В настройках товаров (по аналогии с категориями).
2. Проверьте шаблоны темы дизайна, убедитесь, что в них не используются устаревшие хелперы
Ранее плагин поддерживал следующие хелперы:
- {shopSeoViewHelper::getCategoryAdditionalDescription()}
- {shopSeoViewHelper::getProductAdditionalDescription()}
- {shopSeoViewHelper::getTagDescription()}
- {shopSeoViewHelper::parseTemplate}
Эти хелперы больше не поддерживаются!
Их нужно заменить. Или удалить из кода шаблонов.
| Больше не поддерживаются | Нужно заменить на | Может присутствовать в шаблонах |
| {shopSeoViewHelper::getCategoryAdditionalDescription()} | {$category.additional_description|default:''} | category.html или другой шаблон, где выводится описание категории |
| {shopSeoViewHelper::getProductAdditionalDescription()} | {$product.additional_description|default:''} | product.html или другой шаблон, где выводится описание товара |
| {shopSeoViewHelper::getTagDescription()} | {$tag_description|default:''} | search.html |
| {shopSeoViewHelper::parseTemplate} | - | зависит от целей использования этой функции |
Пример замены:
3. После замены старых переменных и хелперов обновите плагин из Инсталлера
Перейдите в Инсталлер и кликните по кнопке «Обновить». Обновление установится автоматически.
После установки обновления рекомендуем еще раз проверить корректность отображения заголовков и описаний на случай, если не все переменные или хелперы были заменены.
