Автоподстановка имени на сайте, который открывается с помощью прокси-ссылки
Первоначальная настройка
Для работы функционала автоподстановки должны быть выполнены следующие условия:
-
На сайте должен быть установлен скрипт прокси-ссылок:
-
В настройках прокси-ссылки должна быть включена передача системной метки с именем пользователя. (Подстановка может срабатывать и без этого условия, если по прокси-ссылке зашел пользователь с новой версией телеграма, где версия Bot API >= 9.0)
Функционал
-
Перевод с латиницы. Сработает, если имя пользователя нашлось в словаре.
-
Проверка имени по словарю. Если имя не нашлось в словарях, то будет подставлено дефолтное значение (см. пункт "Описание параметров" второй параметр). Есть словари:
-
Общий словарь полных русских имен (без разделения по роду). Если попадается имя из этого списка, то определение рода будет проведено библиотекой
lvovich
. -
Словарь коротких имен с разделением на мужские и женские (маша, паша, петя). Если попадается имя из этого списка, то род заранее точно определен и библиотека
lvovich
лишь склонит его в нужный падеж.
Если имя гендерно-нейтральное (например Саша), то оно может попасться в первом списке, тогда род будет определен как нейтральный и склонение сделано верно.
-
Склонение в нужный падеж
-
Бесконечная автоподстановка при изменениях на сайте. Автоподстановка будет срабатывать каждый раз, когда на сайте произошло изменение (например, появился попап, где нужно подставить имя).
Формат для указания на сайте
Варианты указания подстановки имени на сайте:
-
{{name | клиент | 1 | dative}}
-
%%name | клиент | 1 | dative%%
(может быть полезно, если сайт использует React)
Описание параметров
-
name
- Неизменяемый параметр. Должен быть указан всегда. Обозначает название переменной для подстановки. -
клиент
- значение по умолчанию, которое подставится в автоподстановке, если скрипт не смог распознать имя пользователя как валидное. -
1
- формат написания имени:
Значение | Правило форматирования |
---|---|
1 | С большой буквы |
0 | С маленькой буквы |
не указано | Как в исходном тексте |
-
dative
- падеж:
Ключевое слово | Падеж | Вопросы |
---|---|---|
nominative | Именительный | кто? что? |
genitive | Родительный | кого? чего? |
dative | Дательный | кому? чему? |
accusative | Винительный | кого? что? |
instrumental | Творительный | кем? чем? |
prepositional | Предложный | о ком? о чём? |
Примеры указания части параметров:
-
Все параметры -
{{name | клиент | 1 | dative}}
-
Без второго параметра -
{{name || 0 | dative}
-
Без третьего параметра -
{{name | клиент || dative}}
-
Без второго и третьего параметра -
{{name ||| dative }}
-
Только название -
{{name}}
Все параметры кроме первого опциональные
Параметры пишутся по порядку. Если следующие параметры не нужны, можно ничего не писать. Если нужно пропустить параметр, ставим на его место пустую строку и указываем разделитель |
.