Модуль IMGeneratorSeo - Генератор сео текстов и описаний продуктов (синонимайз) для OpenCart

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

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

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

Эти и прочие проблемы можно решить с помощью генератора сео текстов и описаний продуктов IMGeneratorSeo (OC 3) (синонимайз).

Плюсы и возможности
 

• Поддержка Быстрых шаблонов для товаров и категорий (данные в БД не меняются, только отображение; применяется в режиме "на лету"; можно быстро включать/отключать).
• Расширенная генерация записывает данные в БД, что позволяет не нагружать сайт (чем быстрее страница открывается — тем больше это нравится Яндекс, Google и другим поисковикам). Особенно учитывая широкий спектр возможностей модуля.
• Дополнительное поле с описанием для товаров (можно быстро включать/отключать). Так же доступно для редактирования в карточке товара
• Поддержка включения дополнительных полей с возможностью генерации и использования их значений для других полей. Например, вы можете подключить поле ean и другие.
• Поддерживаются Атрибуты продуктов
• Можно использовать условные функции ifequal (условия), replace (замена)
• Доступны для генерации самые основные значимые поля (не учитывая дополнительных полей). Возможность задавать описание продуктов, мета ключи, мета описание, теги, title и конечно h1 (при наличии).
• Большой фильтр для настройки генерации, включая магазин (мультимагазин), статусы, производителя.
• Возможность указать конкретные продукты (исходя из фильтра)
• Для каждого поля можно задать разные способы добавления: Ничего не делать, Заменить пустые, Добавить вначале, Добавить в конец, Перезаписать
• Кроме того, вам доступен тег [product_desc], который можно вставить куда угодно. Учтите, что если тип — добавление, то исходный текст продублируется (в том месте, где вы указали, и вначале/вконце, в зависимости от типа)
• Поддерживаются сложные синонимайз конструкции вида {{param1.1|param1.2|param1.3}|{param2.1|param2.2}| param3}
• Поддерживается главная категория, если такое есть
• Поддерживается поле [product_meta_h1], если он есть в базе
• При генерации запоминаются все настройки для пары "Категория, Язык", так что вы всегда с легкостью сможете продолжить генерацию текстов. При выборе категории, настройки автоматически подтягиваются. Если же для категории ранее не были сохранены настройки, то на форме останутся последние, что особенно полезно для последовательного обхода категорий.
• Мультилокализация/Мультиязык — генерируйте тексты под каждый язык отдельно
• Все сделано с использованием Ajax (кроме опций в Настройках, но их обычно достаточно 1 раз задать), так что вам не придется постоянно ожидать перезагрузки (актуально для разных схем генерации).

Быстрые шаблоны

Быстрые шаблоны позволяют "на лету" переопределять отображаемые мета-теги продуктов и категорий, такие как название, заголовок, h1 (при наличии), мета дескрипшен и мета ключи для каждого языка. И все это настраивается буквально за 5-10 минут.

Это особенно удобно для применения легкой и массовой генерации по шаблону. К примеру, 
"[name] [model] от [manufacturer] за [price] только у нас!" для title товара.

Учитывайте, что шаблон не перезаписывает данные в БД.

Технически шаблоны применяются на уровне ядра опенкарта (стандартные модели товаров и категорий), так что любые модули в клиентской части, использующие стандартную модель получения данных, так же будут "видеть" уже сгенерированные мета-теги.

Для каждого поля можно задать разные разные способы добавления: Ничего не делать, Заменить пустые, Добавить вначале, Добавить в конец, Перезаписать.

Поля автоматически чистятся от html-тегов и обрезаются до 255 символов.

Учтите, что если поле не заполнено и условия такие, что происходит замена, то отображаться будет пустое значение. Например, если для одного языка в H1 задан шаблон, а для другого пустое значение и выбран режим "Перезапись", то во втором языке H1 будет пустым. Чтобы этого не происходило (если вам не нужно добавлять что-либо для второго языка) добавьте значение поля. В данном случае "[meta_h1]". Данная возможность оставлена потому, что порой может возникать необходимость временно и быстро сделать поля пустыми (например, скопировали мета ключи и нужно их перевести и подкорректировать).


Дополнительное поле с описанием товаров

Практически каждый сталкивался с тем, что порой необходимо хранить описания товаров в дополнительном поле (а быть может и просто генерировать туда сео-текст). К примеру, импорт и экспорт.

Начиная с версии 1.7.0 такую возможность модуль IMGeneratorSeo предоставляет.

Как все устроено.

1. В бд создается отдельная таблица, где хранится данное поле для каждого товара и его языка.

2. Появляется возможность вручную редактировать это поле в карточке товара.

3. В закладке "Настройки" модуля можно выбрать вариант вывода описания. Доступно 4 варианта: Из основной, Из основной + дополнительной, Из дополнительной + основной, Из дополнительной. То есть, вы можете задавать вариант отображения необходимым вам образом.

А теперь, к самому приятному.

Как генерировать текст в этом поле. 

Все очень просто. В закладке "Продукты" появился выпадающий список "Таблица с данными". Если выбрать "Основная", то будут заполняться стандартные поля товара. Если выбрать "Дополнительная", то будет заполняться ТОЛЬКО ПОЛЕ С ДОПОЛНИТЕЛЬНЫМ ОПИСАНИЕМ. Остальные настройки никак не влияют.

Обращаю ваше внимание, что это поле так же сохраняется в настройках шаблона (список "Таблица с данными").

САМОЕ ПРИЯТНОЕ. Весь функционал так же доступен для использования — функции, теги, синонимайз, атрибуты. Учтите, что все данные берутся только из основной таблицы. Единственно, проверка пустоты применяется к дополнительному полю (в случае "Заменить пустые").


Список доступных тегов и особенности расширенной генерации

{param1|param2|...} - синонимайз конструкции 

Теги: [product_id], [product_name], [product_sku], [category_id], [category_name], [manufact_id], [manufact_name], [product_tag], [product_meta_title], [product_price], [model_name],

Отдельно про [product_desc] - (позволяет использовать текущее описание, где захотите, но будьте аккуратны при выставлении типа замены)

Элементы управления "Выбор главной категории" и "использование мета H1" - влияют на генерацию только в случае, если в вашей базе они есть. Если H1 в базе нет, то [product_meta_h1] заменяется на пустое значение. Так на чистой OpenCart эти настройки никак не влияют, в ocStore имеют значение. Если поля в OpenCart были добавлены, то генерация будет происходить.

Поддерживаются атрибуты при генерации. Задаются они по следующему шаблону - [attr_%Имя атрибута%]. Если какого-то атрибута нет у продукта, то вместо [attr_%Имя атрибута%] будет пусто (заменяются любые конструкции вида [attr_%Некий текст%], но текст не может содержать символа "]"). Так, что вы можете составлять шаблоны без опаски промахнуться с атрибутами. Список готовых шаблонов с атрибутами находится внизу страницы генерации.


Учитывать названия групп атрибутов

В обычном режиме атрибуты используются в виде [attr_%Имя атрибута%], однако в некоторых случаях требуется детализировать название группы атрибутов. В таком случае будет шаблон будет [attr_%Группа атрибутов%_%Имя атрибута%].

Учитывайте, что замены в шаблонах происходят по выбранному варианту. Например, если вы указывали в шаблонах [attr_%Имя атрибута%] и выбрали использовать названия групп атрибутов, то конструкции не будут заменены корректными значениями (данные конструкции вообще не будут заменяться, разве что пустыми значениями, но будут заменяться [attr_%Группа атрибутов%_%Имя атрибута%], в обратной ситуации подход аналогичный).


Автоматическое копирование атрибута в буфер при выборе

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

Требуется, чтобы браузер поддерживал возможность копирования в буфер обмена силами JS (необходимы: document.execCommand("Copy") и jQuery().select()).


Условные функции

Чтобы включить условные функции, необходимо в выпадающем списке «Использовать условные функции» выбрать пункт «Использовать». По умолчанию функции отключены. Вложенные функции не поддерживаются.

Формат условных функций:

[[func:nameFunc:param1:::param2:::param3]]

где 

1. nameFunc — название функции
2. param1 и прочие являются параметрами. Разделитель :::

Запрещенные комбинации внутри параметров ]] и ::: 

Чтобы указать пустую строку в параметре просто введите подряд 2 раза разделитель.

Например:

[[func:ifequal:1:::0::::::{param1|param2}]]

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

Формат функции ifequal: 

[[func:ifequal:leftValue:::rightValue:::equal:::notEqual]]

- leftValue - левое значение в сравнении 
- rightValue - правое значение в сравнении 
- equal - выводится если значения совпадают 
- notEqual - выводится если значения не совпадают 

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

Пример функции

[[func:ifequal:[product_id]:::42:::[product_id] - [product_name]:::{Супер|Мега|Офигенный|Мега офигенный|Сверх офигенный} продукт]]

В случае если идентификатор продукта равен 42, то вывести id и название, иначе подобрать красивую фразу.

Формат функции replace: 
[[func:replace:ListSearch:::ListReplace:::Subject]]
- ListSearch - список искомых слов через запятую 
- ListReplace - список соответствующих замен через запятую 
- Subject - исходная строка 
Все теги (шаблоны), синонимайз и атрибуты поддерживаются для всех параметров. 
Пример функции
[[func:replace:Мой магазин, (23/7):::Мой супер магазин, (24/7/365):::[product_meta_title]]]
Заменить название магазина и подкорректировать ошибку в цифре.


Дополнительные поля для генерации

Важные моменты:
 

1. Поддерживаются только таблицы #product и #product_description, где # - это префикс в БД.
2. Существование полей в таблице проверяется в момент открытия модуля. Если вы удалили поле в БД, то необходимо перезагрузить модуль (вкладку в браузере).
3. Учитывайте, что обрезка по максимальному количеству символов происходит как есть. Т.е. если у вас html-поле размером 10 символов и вы пытаетесь записать '<a href=”page1.html”>page1.html</a>', то в поле будет записано '<a href=”p'. Еще учитывайте, что символы экранируются, поэтому если поле реально длиной в 10 символов, то будет записано еще меньше, а конкретно '<a href' (например, '<' преобразуется в '<', а двойные кавычки в '"').
4. В обычные текстовые поля (если выбрали такой тип) подставляются очищенные от html-тегов значения. В самом же поле вы можете записать html-тег.
5. Поля автоматически добавляются к спискам генерации в формате [ac_%p или pd%_%field%]. Например, добавили для таблицы product поле ean, то оно будет с тегом [ac_p_ean], а для таблицы product_description (если предположить, что добавили поле ean в таблицу) будет [ac_pd_ean]. Чтобы тег поля стал доступным, требуется, чтобы поле было добавлено в модуле как дополнительное. Например, если вы не добавили ean, то конструкция [ac_p_ean] не будет заменена значением поля.
6. Поддерживаются только поля с типами, начинающимися с CHAR, VARCHAR, TINYTEXT, TEXT, MEDIUMTEXT или LONGTEXT (регистронезависимо).
7. Повторяющиеся или некорректно добавленные поля игнорируются. В случае повторяющихся полей берется первое за основу.
8. Стандартные поля в модуле не изменить.
9. Учитывайте, что если вы заполняете поле в таблице product, то оно не зависит от языка. Это означает, что если вы для одних и тех же товаров сгенерировали поле, скажем, isbn с перезаписью вначале в "Язык 1", а затем в "Язык 2", то данные будут из "Язык 2".
10. Как бы это очевидно не звучало, помните: "больше полей = дольше генерация" (например, десяток html полей с тестовыми шаблонами увеличили время генерации в моем тестовом сервере примерно вдвое; но для этого всегда существует генерация по частям!).

Некоторые нюансы:
 

1. Если название не задано, то задается название, состоящее из таблицы и колонки. Например. 'p_ean', где p это таблица product, а ean это поле.
2. Если длина меньше или равна 0, то обрезание значения по длине не происходит.
3. Пустое поле длины означает 0.
4. Название поля очищается от html-тегов.

Сама настройка:

Во вкладке "Настройки" в поле "Дополнительные колонки для генерации" построчно задаются настройки дополнительных колонок. 1 строчка = 1 поле.

Формат записи (через запятую):

[%таблица%], [%поле%], [%тип редактора%], [%длина%], [%Название%]

[%таблица%] - p или pd. Значение p это таблица product, а pd это таблица product_description.

[%поле%] - название поля в таблице.

[%тип редактора%] - text, html и html_no_editor. Значение text это обычное текстовое поле. Значение html это поле с редактором. Значение html_no_editor это многострочное текстовое поле. Учитывайте, что для типа text вставляются очищенные от html-тегов данные, хотя само поле в результате может содержать html.

[%длина%] - это размер поля. Применяется для всех типов поля. Однако учитывайте, что при сохранении символы экранируются (см. момент про тег).

[%Название%] - название, которое отображается у поля редактирования. Если название не задано, то задается название таблицы и колонки. Например. 'p_ean', где p это таблица, а ean это поле. 

Так же добавлять поля можно с помощью элементов управления, расположенных ниже поля "Дополнительные колонки для генерации".

Чтобы настройки применились, необходимо сохранить настройки.

Вы можете отключить проверку типов полей (char, varchar и прочие), но в таком случае вы действуете на свой страх и риск.

Для этого в файле /system/IMGeneratorSeo/IMGeneratorSeoConfig.php поменяйте значение IMGS_ADD_COLUMNS_CHECK_DATA_TYPE с 1 в 0.


Особенности
 

• Перед каждым использованием модуля, рекомендуется делать резервную копию БД, так как при генерации (не быстрые шаблоны) данные записываются в БД и предыдущие значения будет невозможно восстановить. Для того, чтобы их можно было восстановить, и необходимо создавать резервные копии БД.
• Если у вас очень много товаров, шаблоны генерации сложные, много атрибутов и время на скрипты под php сильно ограничены, то используйте генерацию по частям.
• Учтите, что перезапись ведется на основе старых значений. Если вам нужна перезапись на основе сгенерированных полей, то вначале сгенерируйте их, а потом повторно используйте генератор.
• Для стандартных полей. Везде, кроме описания, подставляются очищенные от html-тегов данные. 
• Поле SKU не зависит от языка, поэтому будьте аккуратны. Аналогично и про поля из таблицы product, добавленные как дополнительные.
• Для стандартных полей. Мета поля автоматически обрезаются до 255 символов, а SKU до 64.
• Если вы вручную в чистый OpenCart добавили поля или через модули, то учтите, что необходимо проверить, что поле meta_h1 позволяет содержать 255 символов (по аналогии с ocStore), а не 100, как в некоторых версиях расширений. Если символов меньше, то необходимо увеличить размерность поля в phpMyAdmin. В противном случае могут возникать ошибки, если при генерации размер вставки будет превышать текущий размер поля.
• Учитывайте, что если внутри тегов находится html, то теги могут некорректно восприниматься модулем. Модуль заменяет только полные совпадения. Например, "[attr_test]" – это атрибут, а "<span>[</span>attr_test]" – это не атрибут. Соответственно, если возникла ситуация, когда у вас тег вроде добавлен, но не заменяется, то так же проверьте html-код.
  Функциональность дополнительного поля описания рассчитана на то, что будут использоваться стандартные модели опенкарта.
• Для копирования атрибутов в буфер обмена требуется, чтобы браузер поддерживал возможность копирования в буфер обмена силами JS (необходимы: document.execCommand("Copy") и jQuery().select()).
• С версии 1.8.0 иной подход к атрибутам — учитывайте это.
• Требуется, чтобы в настройках сайта было выставлено mbstring.func_overload 0. Если вы не знаете как это сделать , то уточните в вашем хостинге. В большинстве случаев по умолчанию это значение 0 (вам, как клиенту, ничего не нужно делать), но в некоторых хостингах выставляют значение 2. Это актуально в тех случаях, если у вас возникли проблемы с ключами и активацией модуля.
• Требуется boostrap и jquery

Установка и использование

0. Сделайте бэкап сайта — Это стандартная рекомендация для любых ситуаций, когда вы меняете или корректируете что-либо в сайте, которая позволяет в случае чего экономить кучу времени, сил и нервов.

1. Распакуйте архив и скопируйте в корень сайта каталоги «admin» и «system». Не волнуйтесь, никакие файлы не будут заменены

2. Откройте админку и установите модуль (переустановите)

3. Откройте Установку расширений и последовательно загрузите файлы "im_gen_seo_templates.ocmod.zip" и "im_gen_seo_product_info.ocmod.zip". После чего обновите модификаторы. Если переустанавливаете модули (следующие версии), то необходимо удалить предыдущие модификаторы.

4. Может понадобиться очистить кэш твига через панель админки

5. Откройте в админке модуль (редактирование) и пользуйтесь.

С версии 1.8.0 иной подход к атрибутам — учитывайте это!


Для тех, кто ранее не занимался генерацией

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

Перед использованием, вам стоит узнать о некоторых базовых основах. Начните с прочтения материалов в интернете на тему "Размножение статей". Как это делается. Зачем это нужно. Как оцениваются такие статьи поисковиками. Чем товарное описание отличается от статейного. Не обязательно сильно углубляться, но знать основы хотя бы на уровне обычного пользователя стоит.

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

С чего начать первую генерацию. 

1. В обязательном порядке делаете бэкап БД.  

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

3. Затем находите места, которые можно размножить (например, {Универсальный|Многофункциональный|Невероятный}) или же наоборот взять из атрибутов и полей (Производитель [manufact_name] выпускает отличный товар. Его аккумуляторы мощностью [attr_Мощность] славятся ...). И создаете шаблон.

4. Производите первую генерацию. Внимательно проверяйте все выставленные вами настройки и пытайтесь представить какого рода тексты будут на выходе (чтобы не получилась ситуация, что при повторной генерации у вас будет взят результат из прошлой генерации). Оцениваете насколько тексты получились разными. И корректируете шаблон до тех пор, пока тексты не начнут иметь уникальность хотя бы 80%.

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


Лицензия и использование

Сделано для версий OpenCart 3.0.1.1, 3.0.2.0, 3.0.3.0, 3.0.3.1-3.0.3.8, ocStore 3.0.2.0, 3.0.3.7

Купив модуль вы автоматически соглашаетесь с текстом лицензии.
Модуль имеет принцип распространения "as is" ("Как есть").