Створення форми
Автоматичне створення файлів на вашому сайті - дипломів, сертифікатів або чогось іншого. Відвідувачам вашого сайту достатньо буде заповнити форму та отримати файл.
Для створення файлів потрібно створити HTML форму на вашому сайті. Якщо це не можливо, то слід просто використовувати віджет створення.
Створення форми
Щоб надсилати запити на створення файлів в DiMaker, вам потрібно створити форму на своєму сайті. Ця форма може розташовуватись як у публічній, так і в закритій частині вашого сайту. За допомогою вашої CMS створіть сторінку та форму на сторінці.
Адреса форми
https://dimaker.app/api/v1/webform-create/Поля форми
Вам потрібно створити кілька схованих полів з такими значеннями:
-
secure*
Токен (рядок, 36 символів)
-
doc_id*
ID документа (рядок, 36 символів), який буде використовуватись для створення файла. ID можна отримати в адресній стрічці, коли документ відкритий. Документ не повинен бути в кошику, але може лежати в будь-якому паку Документів.
-
mail_id
ID шаблону листа (рядок, 36 символів) для відправлення електронною поштою. ID можна отримати в адресній стрічці, коли шаблон відкритий. Якщо змінна не передана, то листа відправлено не буде.
-
email_send
Час, коли відправляти лист з файлом. Може приймати наступні значення:
onfinish - Розіслати всі листи після створення всіх файлів (за замовчуванням)
oncreate - Відправляти листи одразу після створення файла. При створенні одного файла onfinish та oncreate ідентичні.
timeout - Розіслати листи через проміжок часу. У цьому випадку необхідно передати ще два параметри:
email_timeout_value - цифрове значення проміжку, через який відправляти листи, ціле значення
email_timeout_value - одиниця виміру проміжку. Може приймати значення "m" (хвилини), "h" (години), "d" (дні).
Або, для вказання точного часу відправки, потрібно передати час в форматі unix time в email_timeout_timestamp. Якщо передані timeout і email_timeout_timestamp, то пріоритет буде у останньої. -
folder_id
ID папки в Диску (рядок, 36 символів) збереження файлів. Якщо папки немає, то вона буде створена автоматично при створенні першого файла.
-
page_id
Номер сторінки (число або рядок), якщо у документі є декілька сторінок. Можна передати один номер (перша сторінка - 0), або номери (через кому) сторінок, які потрібно використати для створення файла.
Відправляти собі файл після створення
Файл буде відправлений на електронну пошту аккаунту одразу після того, як буде створений. У полі «Шаблон листа» можна вибрати, який шаблон використовувати для відправки. Попередньо в Шаблонах листів можна створити окремий шаблон для відправки листів на електронну пошту аккаунту. Якщо в тексті листа написати змінну %data, то в це місце будуть додані всі дані файлу у вигляді таблиці.
Скрипт і стилі
На сторінці інтеграції потрібно взяти код та вставити його в 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.