- Основные функции
- Пошаговое руководство
- Обратный адрес
- Оформление писем
- Шаблоны писем
- Функции при создании
- Проверка подлинности
- Форма получения
- Форма изменения
- Автоматизация
- Создание из Google Таблиц
- Отчёт в Google Таблицы
- Интеграция с GetCourse
- Интеграция с Tilda
- Форма создания
- Бот в Telegram
- API
- Печать и доставка
- Заказ печати
Автоматическое создание дипломов и сертификатов на вашем сайте
Настройте полностью автоматическое создание файлов на вашем сайте - дипломов, сертификатов или чего то другого.
Посетителю вашего сайта достаточно будет заполнить форму и получить файл.
Протестировать
С чего начать?
Вам нужно 1) создать шаблон, 2) создать документ, заполнить его. В том месте, где будут данные подставляться из формы поставьте строку для замены (латиницой, со знаком процента), например %name или %course. Если вы хотите дополнительно отправлять письмо на почту 3) напишите текст письма (в шаблонах). Обратите внимание, что обращение получателю письма у вас будет латиницей, например %name. Кроме того, если вы хотите, чтобы выданные файлы сохранялись определённую папку на Диске, то 4) создайте там папку.
В конечном итоге у вас должны быть:
- Документ, хотя бы с одной переменной для замены
- Шаблон письма, если вы хотите отправлять файл на электронную почту
Создание формы
Чтобы отправлять запросы на создания файлов в ГрамотаДел, вам нужно создать форму на своём сайте. Эта форма может располагаться как в публичной, так и в закрытой части вашего сайта. При помощи вашей CMS создайте страницу и форму на странице. Пример кода формы вы можете увидеть здесь. Обратитеть в техническю поддержку ГрамотаДела, если у вас есть трудности с созданием формы.
Action формы
https://gramotadel.express/api/v1/webform-create/Поля формы
Вам нужно создать несколько скрытых полей со следующими значениями:
Поле | Обязательный | Описание | Комментарии |
---|---|---|---|
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. Если переданы обе переменные, то приориет у последней.
|
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 другого нужного документа в ГрамотаДеле. Таких документов может быть любое количество. Другие поля, такие как 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. Одно подставится в один документ, а другое - в другой.
Нужна помощь?
Напишите нам в техническую поддержку или через чат. Мы с радостью поможем вам!