Download the PHP package voskobovich/yii2-seo-toolkit without Composer
On this page you can find all versions of the php package voskobovich/yii2-seo-toolkit. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download voskobovich/yii2-seo-toolkit
More information about voskobovich/yii2-seo-toolkit
Files in voskobovich/yii2-seo-toolkit
Package yii2-seo-toolkit
Short Description SEO tools for Yii2
License MIT
Homepage https://github.com/voskobovich/yii2-seo-toolkit
Informations about the package yii2-seo-toolkit
Yii2 SEO Toolkit
Помогает реализовать управление урлами страниц системы как в CMS WordPress, с управлением из админпанели таблицей маршрутизации и редиректами.
Support
Usage
- Создать таблицу для хранения роутинга (применить миграцию)
- Создать свой экземпляр модели UrlRoute
- Настроить UrlManager
- Подключить класс UrlManager из пакета
- Подключить классы правил роутинга
- ClearUrlRule для очистки урлов от мусора (двойные слэши, слэш в окончании ...)
- UrlRule отвечает непосредственно за роутинг
- В нужной AR модели
- Реализовать интерфейс SeoModelInterface
- Подключить поведение CreateUrlBehavior
- Подключить ActualityUrlBehavior
-
Создаем CRUD для управления роутами
-
Создаем таблицу (применяем миграцию)
Унаследуйте созданный класс миграции от \voskobovich\seo\migrations\create_table__url_route.
Например:
Применяем миграцию
-
Создаем свой экземпляр модели UrlRoute
Yii2 SEO toolkit не знает с какими моделями и роутами ему придется работать.
Чтобы это исправить, нужно унаследоваться от модели UrlRoute из пакета и реализовать 2 метода из UrlRouteInterface.
Вот пример из моего проекта.
Из примера видно, что роутинг будет работать с 4-я объектами.
Для каждого объекта сконфигурирован список стандартных действий "показать все" (index) и "показать один" (view).
Действия нужны для того, чтобы различать логику обработки роута.
Например, мы можем сделать вот так:
- Роут /foo это действие index для объекта post. В итоге, перейдя по /foo мы получим список всех постов (в yii роутинге это равняется переходу на post/index).
-
Роут /bar это действие view для объекта post c id=3. В итоге, перейдя по /bar мы увидим запись с id=5 (в yii роутинге это равняется переходу на post/view).
Список действий можно расширить, дополнив список в методе getActionItems. -
Настраиваем UrlManager
В стандартном классе UrlManager реализовано кеширование роутов которое помогает ускорить процесс генерации ссылок в стандартном роутинге Yii2. Суть кеширования в том, чтобы запоминать для каких роутов нет правил в конфиге и больше не пытаться построить ссылку для этого роута. То есть, если для роута post/view нет правила, то больше для этого роута правил искаться не будет, что и логично. Но для нас это беда, и вот почему. Для роута post/view id=4 может быть правило в таблице маршрутизации, а для post/view id=5 может не быть. Если не отключить кеширование, то при генерации ссылок на посты если первой будет сгенерирована ссылка для post/view id=5 то UrlManager запомнит, что правила для этого роута нет и больше не будет его обрабатывать. В итоге мы не получим наших красивых ссылок для остальных постов. Итак, подключаем класс UrlManager из пакета.
Правило ClearUrlRule умеет:
- Заменить множество слэшей на один
- Удалить слэш в конце ссылки
- Буквы верхнего регистра перевести в нижний
Внимание! В целях оптимизации рекомендую настроить эти правила на уровне вашего веб-сервера.
Правило UrlRule отвечает за наш волшебный роутинг.
В атрибут modelClass передается модель UrlRoute которая была создана на прошлом шаге.
-
Настраиваем AR модель
Чтобы для новых моделей ссылки автоматом попадили в таблицу роутинга, нужно подключить CreateUrlBehavior и реализовать интерфейс SeoModelInterface.
Привожу пример модели Post из моего проекта.
Метод getSeoPath() должен возвращать путь, по которому будет доступна запись поста.
У меня этот роут состоит из пути к главной категории поста и короткого имени самого поста (/cat/subcat/post-slug).
Поведению нужно передать нашу модель UrlRoute и сообщить каким объектом является наша AR модель используя ранее созданные константы в модели UrlRoute.
-
Подключаем ActualityUrlBehavior
После настройки всего пользователь все еще может перейти по старой ссылке и увидеть страницу. Например, мы для /post/view?id=6 создали красивый урл /best-post. Но пользователь все еще может перейти по старой ссылке и получить страницу, хотя в идеале его нужно отправить на новый урл с 301-м редиректом.
Вот пример обработчика запроса из моего проекта.
Говорю сразу, подключать поведение на весь контролер не нужно. Это поведение нужно только для view экшена.
Этому поведению так же нужно передать класс нашей созданной модели UrlRoute и название объекта из константы.
-
Создаем CRUD для управления роутами
Во вьюхах есть небольшая логика, так что привожу примеры основных кусков кода из своего проекта.
Файл create.php
Файл update.php
Файл index.php
Installation
The preferred way to install this extension is through composer.
Either run
or add
to the require section of your composer.json
file.