Переменные и их преобразования

В действиях расширения могут быть использованы следующее переменные:

• url – адрес страницы
• title – заглавие страницы
• text – текст страницы
• selected – выделенный на странице текст
• dt – текущая дата и/или время

Чтобы перейти к настройке переменной (в процессе создании/редактировании действия) достаточно выполнить двойной клик на ней.

Адрес страницы

При использовании адреса страницы доступны следующие его преобразования:

1. unicode – преобразование unicode-символов в читаемый текст (когда вместо https://ru.wikipedia.org/wiki/%D0%A3%D0%BA%D1%80%D0%B0%D0%B8%D0%BD%D0%B0 получаем https://ru.wikipedia.org/wiki/Украина);
2. clear – очистка маркетинговых и других служебных меток;
3. add – дополнения адреса своими параметрами, что может быть полезно, например, при подготовке линков для партнерских программ;
4. bitly, isgd, clck – сокращение адреса с помощью одного из сервисов bit.ly, is.gd, clck.ru.

Примеры того как выглядит описание переменной и ее преобразования:

• {{ url }} – адрес страницы будет использован в первоначальном виде;
• {{ url | bitly }} – перед использованием адрес страницы будет сокращен с помощью сервиса bit.ly;
• {{ url | clear | bitly }} – из адреса будут удалены маркетинговые метки, а потом он будет сокращен с помощью сервиса bit.ly.

Заглавие страницы

Для заглавия страницы доступна возможность сократить его длину до нужного количества символов, указав заменитель для обрезанной части (по умолчанию используется троеточие).

Примеры:

• {{ title }} – будет использовано заглавие страницы в его оригинальном виде;
• {{ title | limit:50 }} – заглавие будет сокращено до 50 символов с троеточием в конце.

Текст страницы

Для текста страницы, как и для заглавия, доступна возможность сокращения длины текста до нужного количества символов.

Выделенный на странице текст

Для переменной {{ selected }} можно:

1. Указать что будет использовано, если на момент выполнения действия на странице не окажется выделенного фрагмента текста (доступны: адрес страницы, заглавие страницы, полный текст страницы).
2. Удалить разрывы строк в выделенном фрагменте. Полезно, например, когда выделен небольшой фрагмент текста на границе двух абзацев.
3. Сократить длину выделенного фрагмента до нужного количества символов.

Примеры:

• {{ selected }} – выделенный фрагмент или заглавие страницы, есть на странице ничего не выделено;
• {{ selected ?? url }} – если на странице не будет выделенного фрагмента, то будет использован адрес страницы;
• {{ selected ?? url | rmbr }} – с выделенного фрагмента будут удалены разрывы строк (ReMove BReaks)

Текущие дата/время

Примеры:

• {{ dt }} – текущие дата и время в соответствии с настройками браузера;
• {{ dt:date }} – только дата;
• {{ dt:time }} – только время;
• {{ dt:DD/MM/YYYY (dddd):ru }} – дата в заданном формате 03/07/2019 (среда).