Данная инструкция не является окончательным вариантом и со временем будет обновляться

Настройка формы для приема анкет представителей.

Содержание

В данной инструкции мы рассмотрим как настроить анкету по своему вкусу, например добавить или удалить поле, сделать поле обязательным или необязательным для заполнения, поменять поля местами, указать свой вопрос для антиспам проверки и т.д.

Поля

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

Форма анкеты - это обычный тектовый файл, содержащий настройки ее полей, а также ее поведения. Для создания формы нужно создать текстовый файл, в котором мы пропишем настройки и поля анкеты. Каждое поле создается несколькими строками параметров. Параметры сгруппированы под именами полей, т.е. сначала задается индексное имя поля, а под ним располагаются параметры. Вот как будет выглядеть наша форма в текстовом файле:

[settings] ; Управление отправкой новых анкет ; отправлять анкету в базу данных send_to_db="1" ; отправлять анкету на эл.почту send_to_email="1" [obshie_dannie] header="общие данные" title="общие данные" [l_name] text="фамилия" description="введите фамилию" title="сюда напишите фамилию" require="1" [f_name] text="имя" description="введите имя" require="1" [birthday] text="дата рождения" description="формат: дд.мм.гггг" maxlength="10" format="date" require="0"

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

При задании имени поля желательно использовать только латинские символы, цифры и символ подчеркивания.
Каждое поле формы анкеты должно иметь свое уникальное (не повторяющееся) индексное имя. Если несколько полей будут иметь однаковое индексное имя, то на сайте отобразится только одно поле, которое в форме расположено ниже остальных.

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

Существуют поля, присутствие которых в форме строго обязательно. Это settings - самое первое поле, содержащее общие настройки анкеты, влияющие на ее поведение. Подробнее об этом поле читайте ниже.
l_name и f_name - это специальные поля для ввода в них фамилии (сокращенно от англ. lastname) и имени (firstname) соответственно - обработчику анкеты необходимо знать, в каких полях находятся фамилия и имя, чтобы занести эти данные в базу данных, для дальнейшего корректного отображения в панели управления. Индексное имя отчества m_name тоже можно указать, для отображения в панели управления полного имени, но это уже на ваше усмотрение.

В анкете можно выводить два вида полей: header (заголовок) и text (поле для ввода информации).
В примере выше, в поле под именем [obshie_dannie], первой строкой идет ключевой параметр header, который говорит обработчику, что это поле нужно вывести в виде заголовка. Далее стоит знак равно = и в кавычках указан текст заголовка.

Следует запомнить, что все параметры будут указываться в таком виде: параметр = "значение"

Заголовок служит для отображения названия подраздела анкеты, в нашем примере это "общие данные".

Вторым видом полей является text (в примере это поля [l_name], [f_name] и [birthday]), такое поле отображается, как поле для ввода пользовательских данных. В основном нам придется работать именно с этим видом полей.

Если в поле не указать ни одного ключевого параметра (header или text), то такое поле будет проигнорировано и в анкете не отобразится.
В нашем примере есть еще несколько параметров:

Если параметр require будет установлен в значение отличное от "0" (например будет равно "1"), то такое поле станет обязательным для заполнения и будет выделено цветом. Если значение параметра установить равным "0" или вообще не указать, то параметр не будет задействован и поле перестанет быть обязательным.

Например format="date" говорит о том, что в данное поле можно ввести только дату - другие данные не будут приняты. Как известно, формат даты выглядит так: "01.01.2012". Если попытаться ввести в это поле абракадабру типа "123abcdf", данные не будут приняты, о чем будет сообщено в ошибке.

Также поле format может принимать следующие значения:

Если Вам понадобятся еще какие-то форматы, которые достаточно распространены, но которых мы не внесли в список, пишите в поддержку.

Описанных выше параметров достаточно для создания простой формы и, если Вам не терпится, то уже можно начать ее делать, но есть более простой вариант.

Как вам уже известно, на сайте есть два вида анкет: простая (form1) и расширенная (form2). Их можно выбрать для отображения через список.

Вы можете просто скачать уже готовые файлы форм на свой компьютер и отредактировать их по своему усмотрению.
Скачать их можно здесь: form1.ini, form2.ini.

После этого, чтобы ваши отредактированные формы заработали, их файлы нужно закачать на сайт через пункт УПРАВЛЕНИЕ - Менеджер файлов в папку forms.

Что касается названия файла, то оно должно быть такого вида: form1.ini, где цифра 1 указывает на номер формы. Вы можете использовать любые числа, что означает возможность создания любого количества форм, не ограничиваясь двумя.

Установка и вывод формы на сайте

Теперь о том, как в конечном итоге вывести форму на странице сайта. Для этого нужно зайти в раздел МЕНЮ - Бизнес и выбрать желаемый пункт, или МЕНЮ - Главная - Главная, если хотите установить на главной странице. В тексте нужно разместить управляющий код вида [[form1]], затем под текстом, в раскрывающемся списке, выбрать анкету представителя: внутри текста (новая) и сохранить результат.

Как Вы уже догадались, [[form1]] соответствует первой форме и файлу form1.ini, который должен быть закачан на сайт через Файловый менеджер в папку forms. Если Вы создадите форму под номером 15, то файл должен называться form15.ini, а в тексте статьи нужно будет вставить код вида [[form15]].

Если все сделано правильно, на сайте, на месте вставленного управляющего кода [[form1]], появится анкета.

Если Вас полностью устраивают созданные нами формы и Вы ничего не хотите в них менять и хотите использовать их как есть, то не нужно выполнять шаги, связанные с закачиванием файлов form1.ini или form2.ini на свой сайт. При их отсутствии сайт автоматически подгрузит нужные формы. Просто установите управляющий код на странице и выберите нужную анкету в выпадающем списке.

Расширенные настройки полей

Теперь давайте рассмотрим оставшиеся возможности по настройке полей формы.

Если повнимательнее взглянуть на файл form1.ini, можно заметить еще несколько интересных параметров, например в поле [13]:

[13] text="работаете или работали
ранее представителем Avon?" description="" require="1" type="radio" values="работаю; работал(а); нет"

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

По сути оба типа работают одинаково и позволяют выбрать один из предложенных Вами вариантов ответа, но select более компактен и позволяет добавить большее количество вариантов.
Сами варианты, как Вы уже должны были догадаться, прописываются в параметре values. Писать их следует через точку с запятой (;).
Параметр values используется только в паре с параметром type равным radio или select, во всех остальных случаях он игнорируется (кроме одного исключения, читайте ниже про антиспам проверку.).

Осталось упомянуть еще два значения, которые могут быть указаны для параметра type:

Значение text (не путать с параметром text) является значением по умолчанию - это означает, что, если Вам нужен именно этот тип поля, указывать его не обязательно. Если не указано иное значение параметра type, оно автоматически становится равным text.
Значения text и textarea взаимозаменяемы между собой, так же, как и значения radio и select, поэтому, если Вам нужно поле побольше, выбирайте textarea, иначе выбирайте text.

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

Как создать эту галочку? Добавлением в заголовок всего трех параметров.

[21] header="адрес регистрации" title="адрес регистрации/прописки" checkbox="совпадает с адресом проживания" c_title="при включении заполнение не обязательно" unrequire="22;23;24" [22] text="почтовый индекс" description="например: 123456" maxlength="6" format="post_index" require="1" [23] text="область" require="1" [24] text="район" require="1"

Значения данного параметра указываются через точку с запятой (;) и представляют из себя номера полей, которые станут необязательными после установки данной галочки.
В нашем примере, после установки галочки, необязательными станут поля [22], [23] и [24].

Антиспам проверка

Поле с антиспам проверкой создается при помощи специального индексного имени [antispam]. В анкете оно выглядит, как обычное однострочное поле для ввода текста. В параметре values нужно перечислить все варианты допустимых ответов. Ответы нужно писать строчными (маленькими) буквами через точку с запятой ;. Обычно достаточно одного-трех ответов.

[antispam] text="напишите столицу России" values="москва; г.москва; г москва;" description="начинается на мо, заканчивается на а"

Как показывает практика, люди есть совершенно разные. Некоторые не знают, какой город является столицей России (да что там говорить, некоторые даже не знают, что вообще такое "столица"). Поэтому, каким бы простым (для вас) не был вопрос, который вы придумали, всегда давайте подсказку в параметре description.

Параметры анкеты (поле settings)

Поле settings содержит в себе параметры, управляющие поведением анкеты. Оно обязательно должно присутствовать в файле формы и должно иметь индексное имя [settings],
без этого анкета работать не будет

[settings] ; Управление отправкой новых анкет ; отправлять анкету в базу данных send_to_db="1" ; отправлять анкету на эл.почту send_to_email="1" ; отправлять незавершенную (с ошибкой заполнения) анкету на эл.почту ; error_to_email="1" ; отправлять на эл.почту неправильный ответ на антиспам вопрос ; antispam_debug="1" ; отправлять анкету в файл (см. УПРАВЛЕНИЕ - Файловый менеджер, папка forms/storage) ; send_to_file="1" ; отправлять анкету на смс (требуется включение в пункте УПРАВЛЕНИЕ - Настройки) send_to_sms="1" ; отправлять незавершенную (с ошибкой заполнения) анкету на смс ; error_to_sms="0" ; шаблон отправляемого на смс сообщения (указать нужные поля из анкеты) sms_template="Анкета на -domain: [l_name] [f_name] [mtel]"

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

У вас может возникнуть вопрос, почему некоторые параметры закомментированы знаком точки с запятой, ведь в таком случае они не действуют. Дело в том, что если некоторые параметры не указаны, то в этом случае будут использоваться значения по умолчанию.
Если не указать send_to_email или send_to_db, то данные заполненной анкеты будут отправлены и на почту и в базу данных, т.к. по умолчанию они всегда включены. Отключить их можно только явным указанием нулевого значения.

Пройдемся по этим параметрам подробнее.