SourcePlaceholders Guide
Автозамена текста и автоподстановка плейсхолдеров
1. Начало работы
1.1
Конфигурация модуля
Для управления параметрами используйте команду:
.cfg SourcePlaceholders
1.2
Привязка канала-источника
Перейдите в канал, где будут храниться ваши правила автозамены, и отправьте команду:
Также можно передать ID или юзернейм канала аргументом:
.psetsourceТакже можно передать ID или юзернейм канала аргументом:
.psetsource @my_placeholders
1.3
Параметры в меню настроек (.cfg)
•
•
•
•
•
•
•
source_channel_id — ID канала-источника с плейсхолдерами (начинается с -100).•
auto_parse_on_start (по умолчанию True) — автосканирование канала при старте.•
trigger_in_channels (по умолчанию False) — автозамена в каналах.•
trigger_in_groups (по умолчанию True) — автозамена в группах.•
trigger_in_pm (по умолчанию True) — автозамена в личных сообщениях (ЛС).•
preserve_case (по умолчанию True) — автоматическое сохранение заглавной первой буквы.•
max_delay (по умолчанию 5.0 сек) — таймаут обработки при сетевых задержках.
2. Создание плейсхолдеров
2.1
Способ А. Оформление в канале (Рекомендуемый)
1. Отправьте в канал пост с текстом заменяемого значения (например:
2. Ответьте (Reply) на этот пост триггером:
Модуль мгновенно привяжет замену. Если этого не произошло, примените
Прокопьевске).2. Ответьте (Reply) на этот пост триггером:
~прке.Модуль мгновенно привяжет замену. Если этого не произошло, примените
.pparse для пересканирования канала.
2.2
Способ Б. Через команду .padd
В любом чате ответьте на сообщение с финальным текстом и отправьте:
Бот сам отправит запись в канал-источник и добавит плейсхолдер.
.padd <формат_триггера> (например, .padd ~прке).Бот сам отправит запись в канал-источник и добавит плейсхолдер.
3. Форматы замен
3.1
Точное совпадение (
~триггер)
Заменяет только отдельное слово. Например,
Для эмодзи и спецсимволов автозамена автоматически работает по границам пробелов!
~прке заменит "в прке" на "в Прокопьевске", но не затронет слово "апрелька".Для эмодзи и спецсимволов автозамена автоматически работает по границам пробелов!
3.2
Частичное вхождение (
~~триггер)
Заменяет подстроку в любом месте текста независимо от границ слов. Например,
~~хз заменит "я хз вообще" на "я не знаю вообще".
3.3
Регулярные выражения (
~|regex)
Позволяет использовать регулярные выражения со сбором скобочных групп.
Пример триггера:
Текст замены:
Пример триггера:
~|баланс (\d+)Текст замены:
Ваш баланс составляет {msg-1} руб.
4. Встроенные переменные
4.1
Дата и время
•
•
•
•
•
•
{day} — День месяца (например, 09)•
{month} — Месяц (например, 08)•
{month_full_lower} — Полный месяц ("август")•
{year} — Год (например, 2026)•
{year_short} — Короткий год (26)•
{hour} : {minute} : {second} — Время
4.2
Юзеры и чаты
•
•
•
•
{owner_username} — Юзернейм владельца юзербота.•
{reply_username} — Юзернейм автора сообщения, на которое сделан reply (или собеседника в ЛС).•
{cur_chat_name} — Название текущего чата.•
{replaced_count} — Всего автозамен выполнено модулем.
5. Команды управления
5.1
Список CLI-команд
•
•
•
•
•
.pparse — Пересканировать канал плейсхолдеров.•
.padd <~триггер> — Добавить плейсхолдер ответом на сообщение.•
.psearch <запрос> — Поиск плейсхолдеров и получение прямых ссылок на них.•
.pignore [chat_id] — Добавить или исключить чат из обработки.•
.psetsource [chat_id] — Привязать канал с плейсхолдерами.