Автоматическое создание дипломов и сертификатов на вашем сайте

Настройте полностью автоматическое создание файлов на вашем сайте - дипломов, сертификатов или чего то другого. Посетителю вашего сайта достаточно будет заполнить форму и получить файл.
Протестировать

С чего начать?

Вам нужно 1) создать шаблон, 2) создать документ, заполнить его. В том месте, где будут данные подставляться из формы поставьте строку для замены (латиницой, со знаком процента), например %name или %course. Если вы хотите дополнительно отправлять письмо на почту 3) напишите текст письма (в шаблонах). Обратите внимание, что обращение получателю письма у вас будет латиницей, например %name. Кроме того, если вы хотите, чтобы выданные файлы сохранялись определённую папку на Диске, то 4) создайте там папку.

В конечном итоге у вас должны быть:

1. Документ, хотя бы с одной переменной для замены
2. Шаблон письма, если вы хотите отправлять файл на электронную почту

Создание формы

Чтобы отправлять запросы на создания файлов в ГрамотаДел, вам нужно создать форму на своём сайте. Эта форма может располагаться как в публичной, так и в закрытой части вашего сайта. При помощи вашей CMS создайте страницу и форму на странице. Пример кода формы вы можете увидеть здесь. Обратитеть в техническю поддержку ГрамотаДела, если у вас есть трудности с созданием формы.

Action формы

Поля формы

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

Поле	Обязательный	Описание	Комментарии
secure	да	Secure токен	Нужно получить в настройках Webform.
doc_id	да	ID документа	ID документа можно получить в адресной строке при его открытии. Документ не должен быть в корзине, но может лежать в любой паке в Документах.
mail_id	нет	ID письма	ID письма можно получить в адресной строке при его открытии. Если переменная не передана, то письмо отправлено не будет.
email_send	нет	Время отправки	Время, когда отправлять письмо с файлом. Может принимать следующие значения: onfinish - Разослать все письма после создания всех файлов в группе (по-умолчанию) oncreate - Отправлять письма сразу же после создания файла. При создании одного файла onfinish и oncreate идентичны. timeout - Разослать письма через промежуток времени. В этом случае необходимо передать ещё два параметра: email_timeout_value - цифровое значение промежутка, через который отправлять письма, целое значение email_timeout_value - единица измерения промежутка. Может принимать значение "m" (минуты), "h" (часы), "d" (дни). Либо, для указания точного времени отправки, передайте время в формате unix time в email_timeout_timestamp. Если переданы обе переменные, то приориет у последней.
genuine	нет	Лейбл проверки подлинности	С версии 1.1: лейбл для проверки подлинности готового файла. Может принимать следующие значения: ID лейбла Указанный лейбл будет нанесён на файл. ID плейбла можно посмотреть в заголовке окна, открыв его. none - не добавлять лейбл проверки подлинности. Эквивалентно отсутствию переменной в запросе.
folder_id	нет	ID папки на Диске	ID папки можно посмотреть в адресной строке, открыв на Диске нужную папку. ID папки не меняется при её перемещении в другую папку. Если поле не переданно, то папка будет создана автоматически при создании первого файла. Остальные файлы будут добавлены в эту папку.
yadisk	нет	Яндекс.Диск	Добавлять ли готовые файлы на ваш Яндекс.Диск. Может принимать следующие значения: all - добавлять создаваемые файлы в отдельную папку. all-f - добавлять создаваемые файлы в папку "Готовые файлы". Примечание: если передан параметр yadisk и group_id, то действие будут приминимо ко всем файлам этой группы.

Скрипт и стили

На странице настроек скопируйте код и вставьте его в HEAD или любое другое место страницы. Не нужно вставлять этот код на все страницы сайта. Необходимо вставить этот код только на страницу с формой.

Кроме того, вам нужно создать два блока с id result-success и result-danger. Оба блока скрытые, со стилем display:none; В первый блок вы можете написать текст с успешным созданием файла. Это блок будет показан при успешном запросе. Если произошла какая-то ошибка, то будет выведен блок с id result-danger. Текст ошибки будет вставлен в блок автоматически.

Подстановка в документ

В документе у вас должна быть хотя бы одна переменная для замены, например %name или %course. Добавьте в форме поле, где имя переменной должно начинаться с mask_, например mask_name или mask_course. Введёные посетителем данные в эти поля будут заменены на соответствующие переменные в тексте документа. Для указания адреса электронной почты используйте переменную mask_email. Для отправки писем на несколько адресов укажите их через запятую или пробел. При этом статус отправки в Диске будет отображаться по первому адресу.

Работа формы

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

Один документ = одно заполнение

По желанию, вы можете ограничить количество заполнений формы. Если на указанный email уже был создан файл с doc_id, то будет выведено предупреждение, что можно создать только один файл.

Мои документы

Вы можете вывести документы человека в закрытой части вашего сайта. Для этого создайте форму, как указано выше. Затем добавьте скрытые поля email, secure и doc_id. В первое - адрес электронной почты посетителя, а в последнее поле укажите значение all. При открытии этой страницы посетитель увидит на месте формы список всех документов с возможностью скачать их. Если вы хотите, чтобы если посетитель уже заполнял форму, то вместо формы ему выводился его файл, поле email формы должно быть скрытым и подставленно автоматически вашей CMS.

Автоматические отчёты в Google Таблице

Вы настроить отправку отчётов о созданных файлах в Google Таблицу. Информация о файлах, в том числе статус отправки, будет сохраняться в вашей таблице.
Посмотрите раздел документации Отправка автоматических отчётов в Google Таблицы.

Создание нескольких файлов в одном запросе

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

Чтобы создать такую форму, просто к имени поля doc_id добавьте две квадратные скобки, чтобы получилось doc_id[]. Затем добавьте ещё одно поле doc_id[], но со значением ID другого нужного документа в ГрамотаДеле. Таких документов может быть любое количество. Другие поля, такие как genuine, email_send, mail_id, folder_id, yadisk тоже могут быть отправлены подобным образом.

Например, необходимо создать два файла из разных документов и положить их в разные папки на Диске. Для этого необходимо создать два поля doc_id[] и два поля folder_id[] (в том же порядке). Кроме того, если стоит задача отправить их одним письмом, то нужно создать поле mail_id, с ID письма и два email_send[]. В первом указать "manual", а во втором - "oncreate". В этом случае вначале будет создан один файл, затем - второй. И только после создания второго произойдёт отправка с указанным в mail_id письмом. Оба файла будут выведены для скачивания.

Данные для замены могут быть одинаковые (для этого просто используйте одинаковые переменные в документе), либо отличаться. Например, в одном документе вы используете %name_ru, а в другом - %name_en. В этом случае создайте два поля - mask_name_ru и mask_name_en. Одно подставится в один документ, а другое - в другой.

Нужна помощь?

Напишите нам в техническую поддержку или через чат. Мы с радостью поможем вам!