Перейти к основному содержимому

Входные настройки проекта

🔗 Оригинальная страница — Источник данного материала


Входные настройки проекта

Описание

С помощью входных параметров, вы сможете внести нужные вашему проекту значения, для корректного запуска шаблона в ❗→ ZennoPoster или ❗→ ZennoBox.

Внимание

Входные настройки считываются только при старте потока!Изменение входных настроек во время выполнения проекта никак на последнем не отразится, пока не начнётся новое выполнение.

Добавить "Входные настройки" в проект

Для этого, необходимо нажать "Добавить" на ❗→ панели статических блоков ❗→ редактора проекта ProjectMaker, и в появившемся контекстном меню, выбрать "Добавить входные настройки", или нажав правой кнопкой мыши в любой области нижней части, вызвать контекстное меню.

image-20200810-083724

На панели появится соответствующая иконка, которая открывается двойным кликом мыши.

image-20200807-195053

Информация

Обратите внимание, что данный блок не может одновременно присутствовать в проекте с блоком "Интерфейс бота". При добавлении "Входные настройки", блок интерфейса "BotUI" удаляется! Равнозначно происходит и наоборот! Будьте внимательны и предварительно, сохраняйте входные настройки интерфейса!

Форма для редактирования входных параметров

image-20200809-130356

Имя

Под указанным здесь названием настройка будет отображена пользователю

Тип

image-20210508-151633

Входные настройки поддерживают разные типы данных. От выбранного типа зависит какие данные сможет внести пользователь и как эта настройка будет ему отображена.

Ниже каждый тип описан подробно, а также приведён скриншот того, как настройка отображается для пользователя.

Значение по умолчанию

Начальное значение параметра, которое, при старте шаблона, будет находиться в ❗→ переменной проекта, на случай, если пользователь проигнорировал данный параметр.

Сохранить в переменную

Имя переменной проекта, в которую будет записываться значение, введенное пользователем в форме.

Справка

Справочное пояснение для поля, в виде всплывающей подсказки.

image-20200809-132842

Предварительный просмотр

В любой момент редактирования настроек Вы можете посмотреть как они будут отображаться пользователю. Для этого надо кликнуть справа в окне по кнопке со значком "лупы".

Пример

image-20210509-064556

Экспорт

Позволяет сохранить текущие настройки в файл.

Импорт

Позволяет загрузить настройки из файла, которые были сохранены с помощью кнопки "Экспорт"

По умолчанию

Сбрасывает настройки до значений выставленных по умолчанию

Перемещение настроек вверх и вниз

Для того, чтобы переместить настройку выше или ниже по списку её надо выделить и перемещать с помощью кнопок "вверх" и "вниз" справа.

Пример

8LGfWTntQu

Удаление настройки

Для удаления надо выделить настройку и нажать кнопку "Удалить" в правой части окна

image-20210509-065132

Скопировать макрос переменной в буфер обмена

Для того, чтобы скопировать макрос переменной в буфер обмена, надо кликнуть по соответствующей кнопке напротив необходимой настройки

image-20210509-070218

Доступные типы параметров

Label

Заголовок. Может применяться, как визуальное разделение логических секций.

image-20210508-152417

Boolean

Чекбокс (галочка). Может принимать значения True или False.

image-20210508-152532

Number

Поле, где можно указать целое число.

image-20210508-152606

Text

Текстовое поле. Может содержать однострочный текст (по умолчанию) или многострочный текст. Чтобы вставить многострочный текст, нужно указать в имени параметра дополнительные установки в виде: {multi|height}. Например, если вам нужно многострочное поле «Пост», высотой 100 пикселей, укажите в имени параметра: Пост {multi|100}.

Однострочный текст

Редактор

image-20210508-152755

Конечный вид

image-20210508-152819

Многострочный текст

Редактор

image-20210508-153200

Конечный вид

image-20210508-153235

Select

Группа радио-кнопок, представляющая собой выбор из нескольких вариантов. Вам нужно указать в имени параметра все возможные варианты, например: {HTTP|SOCKS4|SOCKS5}.

Редактор

image-20210508-153548

Конечный вид

image-20210508-153606

FileName

Поле ввода для указания пути к файлу или директории в файловой системе. Можно прописать путь вручную, либо выбрать файл\директорию через окно выбора файлов кликнув по кнопке […].

Вы можете менять тип диалогового окна, которое будет открыто при клике по […]:

Открыть файл

Стандартное поведение этого поля. Открывается диалог для выбора существующего файла. Удобно использовать, когда надо выбрать файл из которого будут считываться данные.

Окно в редакторе настроек (1), настройка, как её видит пользователь (2) и диалоговое окно, которое открывается при клике по […] в Windows 10 (3)
Окно в редакторе настроек (1), настройка, как её видит пользователь (2) и диалоговое окно, которое открывается при клике по […] в Windows 10 (3)
Сохранить файл

Чтобы по клику по […] вызывался диалог на сохранение файла, то нужно к имени настройки добавить конструкцию вида {save}

Данный диалог удобно использовать, когда необходимо указать файл, в который будет сохраняться результат работы.

Окно в редакторе настроек (1), настройка, как её видит пользователь (2) и диалоговое окно, которое открывается при клике по […] в Windows 10 (3)
Окно в редакторе настроек (1), настройка, как её видит пользователь (2) и диалоговое окно, которое открывается при клике по […] в Windows 10 (3)
На заметку

Можно указать несуществующий файл. В то время как при диалоге "Открыть файл" указываемый файл обязательно должен существовать.

Путь к директории

Для указания пути к директории к имени параметра необходимо добавить {folder}

Окно в редакторе настроек (1), настройка, как её видит пользователь (2) и диалоговое окно, которое открывается при клике по […] в Windows 10 (3)
Окно в редакторе настроек (1), настройка, как её видит пользователь (2) и диалоговое окно, которое открывается при клике по […] в Windows 10 (3)

Выпадающий список с выбором значения. Есть 2 варианта настройки DropDown.

Отображать элементы "Как есть"

Пользователю варианты в выпадающем списке будут отображены так же, как Вы их зададите в редакторе настроек.

Синтаксис такой - Имя настройки {Вариант1|Вариант2|Вариант3} , соответственно значение по умолчанию будет одним из вариантов.

Окно в редакторе настроек (1), настройка, как её видит пользователь (2)
Окно в редакторе настроек (1), настройка, как её видит пользователь (2)
Именованные элементы

Синтаксис - Имя настройки {Вариант1:Значение1|Вариант2:Значение2|Вариант3:Значение3} Пользователю будет отображено название (Вариант1, Вариант2, Вариант3), но в шаблон попадёт значение (Значение1, Значение2, Значение3)

Окно в редакторе настроек (1), настройка, как её видит пользователь (2). В переменную сохранится RU, EN либо UA.
Окно в редакторе настроек (1), настройка, как её видит пользователь (2). В переменную сохранится RU, EN либо UA.

Выпадающий список с множественным выбором значений. Позволяет выбрать чекбоксами несколько значений одновременно. В поле значения по умолчанию можно прописать несколько значений через запятую.

Синтаксис такой же как и у типа DropDown - Имя настройки {Вариант1|Вариант2|Вариант3} (только вариант "Как есть", именованные значения не поддерживаются). Если выбрано несколько вариантов, то в переменную они сохранятся через запятую.

image-20210509-054029

CaptchaModules

Выбор сервиса ❗→ распознавания каптч из списка доступных в ZennoPoster.

image-20210509-053856

SmsServices

Выбор сервиса для ❗→ приёма смс из списка доступных в ZennoPoster.

image-20210509-054232

TranslateServices

Выбор сервиса для ❗→ перевода текста из списка доступных в ZennoPoster.

image-20210509-054444

Tab

Добавление ещё одной вкладки в окно настроек. Например, можно разделить "Основные" и "Дополнительные настройки" по вкладкам.

image-20210509-054813

Comment

Поле с комментарием или описанием, позволяющее вставлять текст во всю ширину окна настроек. Может использоваться как описание к другим настройкам.

Форматирование

Отображаемое значение в типе *Comment можно немного видоизменять. Поддерживаемые теги:

ОписаниеСинтаксис
Жирный текст<b>Текст</b>
Цвет шрифта<color=red>Красный цвет шрифта</color>
<color=#00ff00>Зеленый цвет шрифта</color>
Размер текста<size=6>Размер текста</size>

Пример отформатированного текста

image-20210509-061149

Первая строка - <size=15><b><color=green>Зелёный, жирный текст. Размер шрифта - 15</color></b></size>
Вторая строка - <size=13><color=#0E17C8>Синий текст. Размер шрифта - 13</color></size>

Password

Данные, вводимые в поле этого формата будут скрыты от просмотра (но в проект попадут в открытом виде)

image-20210509-061520

Символы Unicode

Во всех полях можно использовать Unicode символы. Пример - ± ♻ 📞 💙 🚢 (учтите, что браузер отображает их цветным, а в настройках эти символы отображаются так, как показано на скриншоте ниже):

image-20210615-152705

Обзор входных настроек в программе ZennoPoster

image-20200810-084846

Для того, чтобы открыть "Входные настройки проекта", необходимо нажать правой кнопкой мыши на проекте, в появившемся контекстом меню, выбрать "Настройки" или дважды кликнуть по проекту в списке проектов.

image-20200810-085124

Вот такой простой и в тоже время понятный, получился интерфейс для входных настроек, это не заняло много времени или каких-то особых знаний! Теперь мы можем легко передать наш проект другому пользователю программы ZennoPoster, и у него не возникнет проблем с запуском проекта!