README

Плагин для October CMS для создания автоматической внутренней перелинковки. Плагин находит ключевые слова в контенте и заменяет их ссылками.

Использование

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

Пример в Twig:

{{ post.content | keywords }}

Это найдет всехождения ключевых слов, заданных в настройках, внутри post.content и заменит их на соответствующие ссылки.

Ключевые слова и их URL-адреса управляются в бэкенде October CMS.

Каждое ключевое слово имеет следующие поля:

Ключевое слово: Текст, который будет искаться в контенте.
URL: Адрес, на который будет ссылаться ключевое слово.
Активно: Включает или отключает обработку данного ключевого слова.
Максимальное количество замен на странице: Ограничивает общее количество ссылок, которые плагин может создать на одной странице. Установите 0 для неограниченного количества.

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

Настройки плагина находятся в Настройки > CMS > Ключевые слова - настройки.

Исключить HTML-теги: Вы можете выбрать теги, внутри которых замена ключевых слов производиться не будет. По умолчанию ссылки (<a>) и заголовки (<h1>, <h2>, <h3>) уже исключены. Доступные теги:
- a (ссылки)
- h1 (заголовок 1)
- h2 (заголовок 2)
- h3 (заголовок 3)
- script (скрипты)
- style (стили)
Исключить страницы: Вы можете указать URL-адреса страниц, на которых плагин не будет работать. Можно использовать маски (wildcards), например: blog/*.

Для повышения производительности плагин поддерживает кэширование.

Важно:

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