База знаний
Войдите в личный кабинет для возможности задавать вопросы и отвечать на комментарии.
Полезная информация

Инструкция по переходу с версии 1.X на версию 3.X плагина «SEO-оптимизация»

Поддержка Bodysite
Поддержка Bodysite
1 марта 2019 14:20
+1
Внимание! С версии плагина 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. После замены старых переменных и хелперов обновите плагин из Инсталлера

Перейдите в Инсталлер и кликните по кнопке «Обновить». Обновление установится автоматически. 

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