Список переменных, которые используются в модуле SEO Tags Generator

Модуль SEO Tags Generator позволяет Вам автоматически генерировать HTML-тег Title, Мета-теги Description и Keywords, HTML-тег H1. На сегодняшний момент он является одним из самых востребованных модулей для OpenCart в Рунете с таким функционалом. К версии 3.x в нем появилось уже столько переменных, что теперь для них нужна отдельная документация. Также отдельно вынесена инструкция по Условным выражениям модуля и список функций для преобразования текста.

Универсальные переменные - доступны во всех сущностях

* Под "все сущности" имеется ввиду те, для которых в модуле в принципе реализована автоматическая генерация SEO-тегов. В данный момент это категории, товары, производители.

[shop_name] - название магазина, определенное в настройках. Часто в название магазина администраторы прописывают тайтл главной страницы, что является некорректным.

[config_telephone] - телефон, указанный в контактах в настройках магазина (не в шаблоне, и не в модуле)

[original_text] - переменная, которые хранят исходный текст категории (товаров, производителей) в момент генерации
Пример использования:
[original_text] При заказе на сумму от ххх - доставка по городу бесплатная. Гарантия возврата и обмена - 14 дней!

Переменные городов в модуле SEO Tags Generator

* Предупреждение
Следующие 2 переменные стоит изучать только если вы пытаетесь сделать так, чтобы в вашем магазине для каждого города была бы отдельная страница с мета-тегами, в которых для пущего SEO-эффекта упоминается название города.

[city...] - Переменные с названиями городов в мультимагазинах
ИСПОЛЬЗУЕТСЯ ТОЛЬКО ДЛЯ МУЛЬТИМАГАЗИНОВ И ТОЛЬКО ЕСЛИ НЕ УСТАНОВЛЕН GEO IP PRO (!)
Переменные появляются только после установки доп модификатора STG_city-in-shop-setting_for_STG-2.x_....ocmod.xml. Установив дополнительный модификатор, необходимо заполнить соответствующие поля в настройках каждого из мультимагазинов (!!!).
[city] - Название города в им. пад.
[city_genitive] - Название города в род. пад.
[city_dative] - Название города в дат. пад.
[city_prepositional] - Название города в предл. пад.

[group] - Переменная с названием города из модуля GeoIP
(!) Не путайте с предыдущей группой переменных (!)
Работает только с применением доп модификатора STG_group_in_meta_tags_for_STG...ocmod.xml
Почему вдруг название города хранится в группе клиента?
Потому что так работает модуль GEO IP.
Мой модуль просто делает замену [group] на то, что ему приходит в переменной $customer_group_info['name']. И все! Все остальные настройки модуля GeoIP - ищите в описании модуля GeoIP.
И еще:
Лучше использовать версию GeoIP PRO. В таком случае каждый "город" будет находиться на отдельном поддомене.
При этом важный технический момент: каждый поддомен города должен являться алиасом основного домена сайта, что настраивается в админ-панели хостинга. Иногда быстро всего одной настройкой, иногда вручную для каждого поддомена долго и нудно. А также есть решение для файла .htaccess, чтобы все поддомены становились алиасами основного автоматически.

Переменные, доступные для страниц категорий

[category_name] - название категории. Имеется ввиду главная категория товара. Если не установлен SEO PRO, то это понятие отменяется. И туда попадает категория, определенная эвристическим способом. Я предположил, что категория, которая была добавлена позже всех, является категорией наибольшей вложенности. То есть, такой категорией, которая обычно становится главной.

[static_category_h1] - хранит значение того HTML-тега H1, который заполнен вручную в админке, а не того, который генерится автоматом - учтите это!

[count_products] - переменная используется в мета-тегах категории. Ей возвращается кол-во товаров в данной категории. Бывают случаи, когда в категории нет товаров, а только дочерние подкатегории. В таком случае, этой переменной возвращается кол-во товаров, ее дочерних категорий.

[page_number] - номер страницы категории согласно пейджинации.
<if>( [page_number] ) - страница [page_number] </endif>
(!) Перед использованием этой переменной необходимо сначала проверить, не генерируется ли на вашем сайте нумерация страниц автоматически. К примеру, в некоторых шаблонах и при использовании модуля SEO Мультиязык оно уже генерируется.

[min_price] - минимальная цена товара в данной категории

[max_price] - максимальная цена товара в данной категории

[category_nested] - Цепочка всех категорий от Текущей категоии до ее Верхней родительской категории.
Это нужно, когда даны категории с неполными названиям (к примеру Велосипеды -> Горные -> Титановые)
Если мы открыли категорию "Титановые", то [category_name] в мета-тегах товара даст нам плохой ключ
А вот, как получить более качественный ключ:
[category_nested] => Титановые Горные Велосипеды
lower_case( [category_nested] ) => титановые горные велосипеды
upper_case_first( lower_case( [category_nested] ) ) => Титановые горные велосипеды

[category_nested SORT_FROM_PARENT_TO_CHILD] - Разворачивает цепочку категорий в обратном порядке
Пример 1: Велосипеды -> Горные -> Титановые
[category_nested] => Титановые Горные Велосипеды
[category_nested SORT_FROM_PARENT_TO_CHILD] => Велосипеды Горные Титановые

Пример 2: Одежда -> Для мужчин
[category_nested] => Для мужчин Одежда
[category_nested SORT_FROM_PARENT_TO_CHILD] => Одежда Для мужчин
lower_case( [category_nested SORT_FROM_PARENT_TO_CHILD] ) => одежда для мужчин

[category_nested sort="2,3"]
Пример: Главная категория товара - Пальто
Категория Пальто имеет следующую цепочку вложенности: Одежда -> Для мужчин -> Верхняя одежда -> Пальто
Генерация произойдет вот так:
[category_nested] => Пальто Верхняя одежда Для мужчин Одежда
[category_nested SORT_FROM_PARENT_TO_CHILD] => Одежда Для мужчин Верхняя одежда Пальто
[category_nested sort="1"] => Пальто
[category_nested sort="2,3"] => Верхняя одежда Для мужчин
lower_case([category_nested sort="2,3"]) => верхняя одежда для мужчин
upper_case_first( lower_case([category_nested sort="2,3"]) ) => Верхняя одежда для мужчин

[category_nested SORT_FROM_PARENT_TO_CHILD exclude="1"] - модификатор exlude="1"
Такая запись значит: использовать цепочку вложения категорий, сортировать от родителя к детям, исключить первое звено цепочки
Исходная цепочка "Подбор багажника по модели авто -> Audi -> A6 -> (С7) 2011-2018"
превратится в: "Audi A6 (С7) 2011-2018"

[category_level] - суть переменной в том, что она показывает, какой уровень вложенности у данной категории
К примеру, есть следующий уровень вложенности категорий:
Подбор багажника по модели авто -> Audi -> A6 -> (С7) 2011-2018 (см http://aguri.ru)
Задача:
Сделать так, чтобы в категории Audi и любой ее подкатегории не отображалась бы название самой первой родительской категории, но при этом у самой первой родительской категории ее название бы показывалось.
Как это сделать?
В дефолтной формуле можно указать
<if>( [category_level] > 1) [category_nested SORT_FROM_PARENT_TO_CHILD exclude="1"] <else> [category_name] </endif>

Если такие причудливые формулы нужны только для "Подбор багажника по модели авто", то формулу нужно вписать прямо в ней и выбрать переключатель "Наследовать" в настройках категории пункт "Наследование формул в дочерних категориях, если те будут пусты".

Альтернативным путем было бы вписать для каждой категории 2-го порядка (Audi, BMW, Chevrolet и тд) специфические формулы, где было бы указано: [category_nested sort="1"]
А для каждой категории третьего порядка: [category_nested sort="2, 1"]
И для каждой категории четвертого порядка: [category_nested sort="3, 2, 1"]
Через настройки отдельной категории это сделать возможно, но слишком рутинно, если учесть, что этих категорий десятки.

Дополнительные переменные для категорий

Внимание!
Далее перечислены переменные, при использовании которых необходимо приложить дополнительные усилия. Так что хорошенько подумайте перед тем, как это использовать 🙂

  1. В настройках модуля необходимо включить "Использовать падежи для названия категорий".
  2. В самих категориях ниже поля с названием заполнить необходимые падежи. При этом им. пад. ед.ч является ОБЯЗАТЕЛЬНЫМ к заполнению.

Использование модуля SEO Tags Generator: Включаем падежи для категорий

Модуль SEO Tags Generator: Заполняем обязательное поле "Обозначающее слово"

[category_name_singular_nominative] - название категории в единственном числе именительном падеже. "Картриджи для принтеров" становятся "Картридж для принтера". То есть, это так называемое "обозначающее слово", которое дает понять, о чем конкретно идет речь, и служит ключевым словом для товаров из этой категории.
Когда это может понадобиться?
К примеру, у одного клиента все товары имели название вида "CANON MP240" (то есть, содержали указание производителя и модели). Формула: "[product_name] купить в супер-пупер магазине по цене" давала мета-описание без ключевого слова "картридж". Получалось: "CANON MP240 купить в супер-пупер магазине по цене...".
А вот при использовании обозначающего слова получалась совсем другая история: "[category_name_singular_nominative] [product_name] купить в супер-пупер магазине по цене..." - генерирует: "Картридж для принтера CANON MP240 купить в супер-пупер магазине по цене..."

[category_name_plural_nominative] - название категории во множественном числе именительном падеже. Так категория с назаванием "Смартфоны" в этой графе будет абсолютно такой же самой "Смартфоны". Но вся прелесть начинается с дочерними подкатегориями и их сокращенными названиями. Так если у Вас подкатегория "Двухядерные", то в мн.ч. им. пад. должно быть прописано "Двухядерные смартфоны".

[category_name_plural_genitive] - название категории во множественном числе родительном падеже. "Смартфоны" становятся "смартфонов". Можно использовать формулу: "Большой выбор [category_name_plural_genitive]"

* Примечание
На самом деле над переменными [category_name_plural_nominative] и [category_name_plural_genitive] можно извращаться как угодно. У некоторых клиентов есть товары, которые можно обозвать разными словами или словосочетаниями. И вот они для себя решали, что в этих полях они будут хранить синонимы. Тут главное соблюсти принцип единообразия: если синоним хранится в [category_name_plural_nominative], то он должен прописываться именно в это поле абсолютно для всех категорий. Иначе, придется для каждой категории прописывать свою отдельную формулу.

Переменные, доступные для страниц товаров

[product_name] - название товара. Внимание! Название товара иногда содержит и название производителя, и название категории, и даже модель. В таком случае, не надо к названию товара добавлять соовтетсвующие переменные этих сущностей.

[static_product_h1] - хранит значение того Мета тега H1, который заполнен вручную в админке

[model] - модель товара

[sku] - Артикул товара (Складской номер)

Ряд кодов товаров для разных стран и регионов (кроме артикула). В некоторых магазинах эти поля приспособлены под другие нужды. Любое неиспользуемое поле (например, UPС) можно использовать под год выпуска телефона и так далее.
[upc] - универсальный код товара (штрих-код)
[ean] - европейский номер товара
[jan] - японский штрихкод
[isbn] - это международный номер бумажной или электронной книги
[mpn] - международный код производителя товара (или партии)

[price] - цена товара с учетом Скидки (discount). Акция (special) не учитывается. Подробнее о существенных отличиях Скидок и Акций в OpenCart читайте здесь - https://opencart-guide.com/vopros-otvet/chem-skidki-otlichayutsya-ot-akcij-v-opencart.html

[special] - акционная цена товара. Вы можете выпячивать акционную цену в мета-описании товаров, которые могу "засветиться" в сниппетах поисковиков. Испоьзуйте конструкцию: <if>([special]) Внимание, скидка! Старая цена [price]. Акционная цена: [special] <else> [price]</endif>

[manufacturer] - название производителя в мета-тегах товара

[static_manufacturer_h1] - хранит значение того Мета тега H1, который заполнен вручную в админке

[count_sales] - Кол-во продаж товара, если он был продан хотя бы 1 раз

[rating] - Рейтинг товара, если есть отзывы

[reviews] - Кол-во отзывов, если они есть

[attributes]
Выводит все атрибуты товара, которые определены в настройках модуля (для всех товаров по умолчанию)
или в настройках категории (для товаров данной категории)
Выводит атрибуты в таком формате:
Название атрибута 1: Значение атрибута 1; Название атрибута 2: Значение атрибута 2; ...
Пример:
Жесткий диск: 500 GB; Оперативная память: 8 GB ...

[attribute index="1"]
Выводит только значение атрибута, индекс которого соответствует тому, который задан в "Настройка атрибутов" в модуле для всех товаров по умолчанию или же для товаров конкретной категории в настройках этой категории.
Это можно использовать для сокращения кол-ва символов в мета-тегах, заменяя название атрибута на иконку utf-8
Пример: 💽: [attribute index="1"] => 💽: 500 GB

Модуль автоматической генерации title и description opencart: переменная для вывода атрибутов

Переменные категории, которые доступны в товарах

  • [category_name]
  • [static_category_h1]
  • [category_name_singular_nominative]
  • [category_name_plural_nominative]
  • [category_name_plural_genitive]
  • [category_nested] - изначально эта переменная была создана именно для использования в товарах, но пользователи приспособили ее и для использования в самих категориях
  • [category_nested SORT_FROM_PARENT_TO_CHILD]
  • [category_nested sort="2,3"]

[model_synonym] - синоним модели товара. Это ошибка природы, которая используется крайне редко. В версии 3.0.0 данная переменная была убрана из функционала модуля по умолчанию. Для ее использования необходимо устанавливать дополнительный модификатор.

Переменные, доступные для страниц производителей

[manufacturer_name] - название производителя в мета-тегах производителя

[static_manufacturer_h1] - хранит значение того Мета тега H1, который заполнен вручную в админке

[page_number] - номер страницы категории согласно пейджинации.
<if>( [page_number] ) - страница [page_number] </endif>
(!) Перед использованием этой переменной необходимо сначала проверить, не генерируется ли на вашем сайте нумерация страниц автоматически. К примеру, в некоторых шаблонах и при использовании модуля SEO Мультиязык оно уже генерируется.

Вам также может понравиться

Об авторе Serge Tkach

Добавить комментарий

Ваш e-mail не будет опубликован. Обязательные поля помечены *