Подключение

Подключение скрипта формы в <head />:

<script type="text/javascript" src="/ds-comf/ds-form/js/dsforms.js"></script>

Подключение скрипта формы и дополнительной библиотеки jQuery версии >= 1.5:

<script type="text/javascript" src="/ds-comf/lib/jquery-1.11.3.min.js"></script>
<script type="text/javascript">
    gKweri = $.noConflict(true);
</script>
<script type="text/javascript" src="/ds-comf/ds-form/js/dsforms.js"></script>

Инициализация

Размещение формы в контейнере, через атрибуты данных:

<div id="" class="ds-form"></div>

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

<button data-dspopup-id=""></button>

data-dsconfig - атрибут для передачи массива данных из шаблона в формате JSON {'name':'значение'}

Размещение формы в контейнере, через вызов:

$(document).ready(function(){
    $('#form-block').dsform({
        formID : '',
        modal  : false,
    });
});

<div id="form-block"></div>

Установка всплывающей формы на кнопку, через вызов:

$(document).ready(function(){
    $('.form-button').dsform({
        formID : '',
    });
});
<button class="form-button"></button>

formID : (строка) — id формы назначаемой на элемент
modal : (флаг) — использовать назначенный элемент, как кнопку для всплывающей формы, по умолчанию true
additionalClass : (строка) — добавляет класс контейнеру в котором находится форма
config : (строка) — строка в JSON формате, то же самое что и атрибут data-dsconfig
inputmask : (объект) — объект формата {‘имя поля’ : {объект настроек}}, для inputMask
dates : (объект) — объект формата {‘имя поля’ : {объект настроек}}, для dscalendar
showLoader : (флаг) — определяет, показывать ли анимацию загрузки на месте "кнопки отправить", по умолчанию true
useFormStyler : (строка или флаг) — определяет использовать ли плагин Form Styler для формы, по умолчанию false. Если указать true, то стилизует все возможные элементы, можно указать строку с селекторами, чтобы ограничить стилизацию.
formstyler : (объект) — настройки специфичные для плагина Form Styler
onLoad : (функция) — функция по событию загрузки кода формы, срабатывает при обновлении формы, а именно :

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

onShow : (функция) — функция сработает по завершению анимации открытия модального окна.
onSuccess : (функция) — функция сработает, если сервер сообщит об успешной отправке письма, например если письмо действительно отправилось
onFail : (функция) — функция сработает, если в форме были ошибки заполнения полей
onClose : (функция) — функция сработает по завершению анимации закрытия модального окна
onServerError : (функция) — функция сработает, если сервер сообщит о неудачной отправке письма
animationspeed : (число) — скорость анимации модального окна в миллисекундах, на всякий случай
closeonbackgroundclick : (флаг) — определяет будет ли окно закрываться по клику на фоне, по умолчанию true
dismissmodalclass : (строка) — можно переназначить класс кнопки закрытия, принимает именно className, а не селектор