eForm 1.4.6 Обратная связь, заказ звонка, оформление заказа товаров и т.д.

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

<input type="text" name="color" eform="A Color:string:1" />

Базовый вид параметра eform следующий:

[description/title]:[datatype]:[required]:[validation message]:[validation rule]

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

Все поля автоматически проверяют на пустоту значений.

• string - не имеет специальной проверки кроме пустоты и обязательности заполнения.
• date - проверяется на правильность формата даты (основано на функции strtotime())
• integer - проверяется на числовое значение (не проверяется, если оно целое)
• float - проверка на числовое значение
• email - проверяет правильность адреса email с использованием регулярных выражений
• file - (для поля загрузки файла) - проверяет соответствие разрешенному размеру, на текущий момент не имеет проверки типов файлов.
• html - также как тип string только перенос строки преобразуется в тэг <br />

Выпадающие списки, чекбоксы, и радиобатоны не требуют определения типа. eForm определяет их автоматически.

#LIST - перечисленные через запятую возможные значения.

Например:

#LIST красный,зеленый,оранжевый,синий

#RANGE - разделенные запятой возможный числовые значения или числовые диапазоны. При установке диапазона порядок не имеет значения. 1~10 и 10~1 будут одинаково определять числа между 1 и 10 (включительно). Можно использовать как положительные так и отрицательные числа.

Например:

#RANGE 1,3,-5~-15,60~82

#SELECT - определяет правильность значений, которые будут возвращены из базы при запросе. Запрос должен возвращать значения только одной колонки (функция проверяет только первую колонку). Вы можете использовать {\DBASE} {\PREFIX} тэги. Они будут автоматически заменены на название базы MODx и используемый префикс таблицы.

Например:

#SELECT keyword FROM {\PREFIX}site_keywords

#EVAL - строка кода PHP. Может возвращать true или false. Внимание! Хотя #EVAL все еще используется в eForm 1.4, но в будущих версиях они скорее всего больше не будут поддерживаться. Взамен используйте #FUNCTION.

#FUNCTION - название функции. Функция должна использовать только одно значение (значение поля) и возвращать TRUE или FALSE. Смотрите примеры, чтобы разобраться как это действует.

Например:

#FUNCTION myValidationFunction

#REGEX - регулярное выражение. Синтаксис preg_match() в PHP.

Пример:

#REGEX /^[\a-z]+ [\a-z0-9_]+/i

#FILTER - фильтры не проверяют введенных значений, но заменяют слова и значения, которые соответствуют критериям. Вы можете использовать следующие фильтры:

• #FILTER #LIST
  Используйте две вертикальные черты для разделения заменяемых и заменяющих слов.
  Например:

  #FILTER #LIST badword,verybadword||goodword,verygoodword

• #FILTER #EVAL
  Например:

  #FILTER #EVAL return myFilterFunction($value);

  (естественно вы должны быть уверены в существовании указанной функции)
  
  Примеры применения фильтра:

      function myFilterFunction($value){\
  
         $badWords = array('scribble','coding');
  
         $goodWords = array('design','sleep');
  
         return str_replace($badWords,$goodWords,$value);
  
      }

• #FILTER #REGEX
  Регулярное выражение замены. Синтаксис preg_replace() в PHP. Поиск и выражение замены разделяется двумя вертикальными чертами (||)

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

По умолчанию скрытые поля присутствуют как защита от подделки формы при сравнении используемых значений (как в полях select, radio и checkbox). Но в некоторых местах это может быть ненужно. Например если вы используете обработку javascript, которая хранит свои значения в скрытых полях. В это случае вы можете изменить это поведение используя параметр eform (включая или выключая проверку).

Скрытое поле пример 1:

Встроенное поведение удобно, если вы храните в скрытом поле идентификатор документа и не хотите чтобы он был изменен кем-либо. Поле должно выглядеть примерно так:

<input type="hidden" name="docId" value="31" />

Скрытое поле пример 2:

Если вы используете javascript, который хранит значения в скрытых полях, то вам необходимо убрать проверку поля так:

<input type="hidden" name="calculatedField" value="" eform="::0::" />

Скрытое поле пример 3:

Пример похожий на 2, но вы хотите убедиться, что возвращенные значения лежат в допустимом диапазоне чисел. Установим для параметра eform заголовок, числовой тип данных, обязательность заполнения, сообщение об ошибке и проверку на диапазон. Это будет выглядеть так:

<input type="hidden" name="calculatedField" value="" eform="Calculated Value:integer:1:Calculation out of range:#RANGE 1-10" />

Выпадающий список - обязательное поле (не требуется проверка)

<select name="mySelect" eform_options="Select Country::1" /> (тип данных не определен)
    <option value="en-au">Australia</option>
    <option value="en-us">USA</option>
</select>

Текстовое поле - обязательное поле и формат данных для дат.

<input type="text" name="dobDate" eform_options="Date of Birth:date:1:@EVAL return (strtotime($value)!==-1)?true:false;" />

Много чекбоксов - обязательное поле, можно выбрать несколько значений.

<input type="checkbox" name="myColors[]" value="Red" eform_options="Colors::1" /> (тип данных не определен)
<input type="checkbox" name="myColors[]" value="Green" /> (тип данных не определен)

Ситуация, когда надо вывести форму в модальном окне довольно частая. Выведем форму в модальном окне Bootstrap 3.

Модальное окно будет выглядеть примерно так:

<button class="btn" data-toggle="modal" data-target="#myModal"></button>

<div class="modal fade" id="myModal" tabindex="-1" role="dialog" aria-labelledby="myLargeModalLabel" aria-hidden="true">
    <div class="modal-dialog">
        <div class="modal-content">
            <div class="modal-header">
                <button type="button" class="close" data-dismiss="modal" aria-hidden="true">&times;</button>
                <h4 class="modal-title">Заголовок окна</h4>
            </div>
                <div id="myModal_form">
                    [!eForm? &formid=`Form` &tpl=`tplForm` &report=`tplReport` &thankyou=`tplThank` &subject=`Сообщение с сайта [(site_name)]`!]
                </div>
        </div>
    </div>
</div>

Чанк tplForm:

<form method="post" action="[~[*id*]~]" name="Form" id="Form">
    <div class="modal-body">
        <input value="" name="special" class="special" type="text" eform="Спец:date:0" style="display:none;">
        ...
    </div>
    <div class="modal-footer">
        <input type="submit" class="btn" name="submit" id="submit" value=" Отправить ">
    </div>
</form>

Чанк tplThank:

<div class="modal-body">
    Ваше сообщение отправлено.
</div>
<div class="modal-footer">
    <button type="button" class="btn btn-default" data-dismiss="modal">Закрыть</button>
</div>

Ну и последний штрих, нужно разместить примерно такой скрипт:

<script>
    $(function(){
        $(document).on("submit","#Form",function(e){
            e.preventDefault();
            var m_method=$(this).attr('method');
            var m_action=$(this).attr('action');
            var m_data=$(this).serialize();
            $.ajax({
                type: m_method,
                url: m_action,
                data: m_data,
                resetForm: 'true',
                success: function(result){
                    var data = $(result).find("#myModal_form").html();
                    $("#myModal_form").html(data);
                }
            });
        });
    });
</script>