SEO URL Generator for OpenCart 3 - Документация

Назад към модула История на версиите

ProBG SEO URL Generator автоматизира създаването на SEO адреси за основното съдържание в OpenCart 3.

Модулът работи със стандартната SEO URL система на OpenCart и може автоматично да генерира адреси за продукти, категории, производители и информационни страници.

Основни възможности

Автоматично генериране на SEO URL за продукти
Автоматично генериране на SEO URL за категории
Автоматично генериране на SEO URL за производители
Автоматично генериране на SEO URL за информационни страници
Поддръжка на множество езици
Отделни префикси за всеки език
Отделни префикси за различните типове съдържание
Опционално добавяне на езиков код към адреса
Добавяне на ID на обекта към генерирания адрес
Транслитерация на кирилица
Допълнителна транслитерация чрез iconv, когато е налична
Почистване на HTML entities и специални символи
Защита на вече съществуващи SEO URL записи
Използване на стандартната seo_url таблица на OpenCart

Поддържани секции

Модулът може да генерира SEO адреси за:

Продукти
Категории
Производители
Информационни страници

Автоматичното генериране може да бъде включвано и изключвано индивидуално за всяка поддържана секция.

Структура на SEO адресите

Генерираният SEO Keyword може да съдържа:

Код на езика
Префикс за типа съдържание
Уникално ID на обекта
Транслитерирано и оптимизирано заглавие

Обща структура:

език-префикс-ID-заглавие

Пример за продукт:

bg-produkt-42-apple-cinema

Пример за категория:

bg-kategoriya-15-monitori

Пример за производител:

bg-marka-8-apple

Пример за информационна страница:

bg-stranica-3-za-nas

Многоезична поддръжка

При използване на няколко активни езика модулът може да създава отделен SEO URL за всеки език.

Например:

bg-produkt-42-apple-cinema
en-product-42-apple-cinema

Заглавието на продукта, категорията или страницата се използва от съответната езикова версия.

За производителите, които в стандартния OpenCart не използват многоезично име, SEO адресът се създава за активните езици на базата на името на производителя.

Езиков префикс

Настройката Добавяне на префикс на езика определя дали кодът на езика да бъде включван в началото на генерирания SEO Keyword.

С активиран езиков префикс:

bg-produkt-42-apple-cinema
en-product-42-apple-cinema

Без езиков префикс:

produkt-42-apple-cinema
product-42-apple-cinema

Настройката е обща за модула и не зависи от конкретния език.

Многоезични префикси

Модулът позволява задаване на индивидуален префикс за всеки тип съдържание и всеки активен език.

Пример:

Български:

Продукти: produkt
Категории: kategoriya
Производители: marka
Страници: stranica

English:

Products: product
Categories: category
Manufacturers: brand
Pages: page

Префиксите могат да бъдат редактирани от настройките на модула.

ID на обекта в SEO адреса

Към генерирания SEO Keyword се добавя уникалното OpenCart ID на съответния обект.

Например:

product-42-apple-cinema
category-15-monitors
brand-8-apple
page-3-about-us

Използването на ID създава предвидима структура и намалява вероятността различни обекти с еднакви или сходни имена да получат еднакви SEO адреси.

Транслитерация

Заглавията на кирилица автоматично се преобразуват в подходящ за URL формат.

Пример:

Лаптопи и компютри
->
laptopi-i-kompyutri

Модулът съдържа собствена карта за транслитерация на кирилица.

Когато PHP функцията iconv е налична, тя може допълнително да се използва за преобразуване на други Unicode символи към ASCII.

Почистване на специални символи

Преди създаването на SEO Keyword текстът се почиства автоматично.

Обработката включва:

Декодиране на HTML entities
Премахване на HTML тагове
Премахване на стандартни и типографски кавички
Транслитерация
Преобразуване до малки букви
Замяна на неподходящите символи с тире
Обединяване на последователни тирета
Премахване на тирета от началото и края

Например:

Apple Cinema 30"
->
apple-cinema-30

Така символи като кавички и HTML entities не остават като част от крайния SEO адрес.

Защита на съществуващи SEO URL адреси

Преди генериране модулът проверява дали за съответния обект и език вече има SEO URL запис.

Ако такъв запис съществува, той не се презаписва автоматично.

Това позволява да бъдат запазени:

Ръчно въведени SEO адреси
Вече индексирани адреси
Съществуващи персонализирани SEO Keyword стойности

Тази функционалност е особено важна при инсталиране на модула в съществуващ OpenCart магазин.

Настройки на модула

Всички основни функции могат да бъдат управлявани от администрацията на OpenCart.

Налични са следните настройки:

Статус на модула - включва или изключва модула
Продукти - автоматично генериране за продукти
Категории - автоматично генериране за категории
Производители - автоматично генериране за производители
Информационни страници - автоматично генериране за страници
Добавяне на префикс на езика - включва или изключва езиковия код
Префикс за продукти - отделна стойност за всеки език
Префикс за категории - отделна стойност за всеки език
Префикс за производители - отделна стойност за всеки език
Префикс за страници - отделна стойност за всеки език

Примерна конфигурация

При следните настройки:

Добавяне на езиков префикс: Да

BG продукт: produkt
EN продукт: product

BG категория: kategoriya
EN категория: category

BG производител: marka
EN производител: brand

BG страница: stranica
EN страница: page

могат да бъдат генерирани адреси като:

bg-produkt-42-apple-cinema
en-product-42-apple-cinema

bg-kategoriya-15-monitori
en-category-15-monitors

bg-marka-8-apple
en-brand-8-apple

bg-stranica-3-za-nas
en-page-3-about-us

Интеграция с OpenCart

ProBG SEO URL Generator използва стандартната SEO URL архитектура на OpenCart.

Генерираните SEO записи се съхраняват в стандартната таблица:

{DB_PREFIX}seo_url

При стандартен префикс на базата данни това обикновено е:

oc_seo_url

Модулът не създава собствена паралелна система за обработка на SEO адресите.

OCMOD интеграция

Необходимите промени в стандартната OpenCart функционалност се прилагат чрез OCMOD.

Това означава, че оригиналните controller файлове на OpenCart не е необходимо да бъдат редактирани ръчно.

След инсталация или промяна на OCMOD пакета трябва да бъде обновен кешът на модификациите.

Инсталация

Влезте в администрацията на OpenCart.
Отворете Extensions -> Installer.
Качете файла на модула с разширение .ocmod.zip.
Изчакайте инсталацията да приключи.
Отворете Extensions -> Modifications.
Натиснете бутона Refresh.
Отворете Extensions -> Extensions.
Изберете тип Modules.
Намерете ProBG SEO URL Generator.
Инсталирайте модула.
Отворете неговите настройки.
Активирайте необходимите секции.
Конфигурирайте многоезичните префикси.
Запазете настройките.

Настройване на SEO URL в OpenCart

За да бъдат използвани генерираните SEO адреси във frontend частта на магазина, стандартната SEO URL функционалност на OpenCart трябва да бъде активирана.

Проверете настройката:

System -> Settings -> Server -> Use SEO URLs

Тя трябва да бъде активирана.

Web сървърът също трябва да бъде правилно конфигуриран за URL rewriting.

След инсталация

След инсталиране или обновяване на модула е препоръчително да обновите OCMOD модификациите:

Extensions
->
Modifications
->
Refresh

При необходимост изчистете и OpenCart кеша.

Важно за съществуващи записи

Модулът е проектиран да не заменя автоматично вече съществуващ SEO URL за съответния обект и език.

Ако продукт, категория, производител или страница вече има SEO Keyword, съществуващият адрес се запазва.

Съвместимост

OpenCart 3.x
PHP 7.2+
Стандартна OpenCart SEO URL система
OCMOD

Отстраняване на проблеми

SEO URL не се генерира

Проверете:

Дали модулът е активиран
Дали съответната секция е активирана
Дали съдържанието има въведено заглавие за съответния език
Дали вече съществува SEO URL за този обект и език
Дали OCMOD модификациите са обновени

SEO адресът не работи във frontend

Проверете:

Дали Use SEO URLs е активирано в OpenCart
Дали URL rewriting е правилно конфигуриран
Дали .htaccess е конфигуриран при Apache
Дали генерираният запис присъства в seo_url таблицата

Промених префикса, но старите адреси не се промениха

Това е очаквано поведение.

Модулът защитава съществуващите SEO URL записи и не ги презаписва автоматично само защото настройката за префикса е променена.

Новият префикс се използва при генериране на нов SEO URL.