README

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

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

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

Пример в Twig:

{{ post.content | keywords }}

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

Управление ключевыми словами

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

1. Перейдите в Настройки > CMS > Ключевые слова.
2. Здесь вы можете добавлять, редактировать и удалять ключевые слова.

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

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

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

Настройки

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

Исключения

• Исключить HTML-теги: Вы можете выбрать теги, внутри которых замена ключевых слов производиться не будет. По умолчанию ссылки (<a>) и заголовки (<h1>, <h2>, <h3>) уже исключены. Доступные теги:

  • a (ссылки)
  • h1 (заголовок 1)
  • h2 (заголовок 2)
  • h3 (заголовок 3)
  • script (скрипты)
  • style (стили)

• Исключить страницы: Вы можете указать URL-адреса страниц, на которых плагин не будет работать. Можно использовать маски (wildcards), например: blog/*.

Кэширование

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

• Включить кэширование: Активирует кэширование обработанного контента.
• Время жизни кэша (в секундах): Указывает, как долго будет храниться кэш.

Важно:

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