ГрамотаДел ГрамотаДел Express В чём разница?

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

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

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

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

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

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

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

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

Action формы

https://gramotadel.ru/api/v1/webform-create/

Поля формы

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

Поле Обязательный Описание Комментарии
secure да Secure токен Нужно получить в настройках Webform.
doc_id да ID документа ID документа можно получить в адресной строке при его открытии. Документ не должен быть в корзине, но может лежать в любой паке в Документах. Создание сертификата об обучении в Tilda - id документа
mail_id нет ID письма ID письма можно получить в адресной строке при его открытии. Если переменная не передана, то письмо отправлено не будет. Создание сертификата об обучении в Tilda - 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 папки не меняется при её перемещении в другую папку. Если поле не переданно, то папка будет создана автоматически при создании первого файла. Остальные файлы будут добавлены в эту папку. Создание сертификата об обучении в Tilda - 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. Одно подставится в один документ, а другое - в другой.


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

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

Открыть