Жасау формасы
Сайтыңызда файлдарды автоматты түрде жасау - дипломдар, сертификаттар немесе тағы басқа нәрселер. Пайдаланушыға тек форманы толтырып, дайын файлды алу жеткілікті.
Файл жасау үшін сізге өз сайтыңызға HTML форма құру қажет. Егер мұндай мүмкіндік жоқ болса, онда жай ғана жасау виджетін пайдаланыңыз.
Форма жасау
DiMaker қызметіне файл жасау сұраныстарын жіберу үшін өз сайтыңызда форма жасау керек. Бұл форма ашық бетте де, жабық бетте де орналасуы мүмкін. CMS жүйеңіз арқылы жаңа бет жасап, оған форма қосыңыз.
Форманың Action-ы
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_unit - интервал өлшем бірлігі. "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; стилі берілуі тиіс.
Сәтті сұраныс кезінде result-success блогы көрсетіледі. Егер қате орын алса, result-danger блогы көрсетіледі, және қате туралы мәтін автоматты түрде енгізіледі.
Құжатқа деректерді енгізу
Құжатта %name немесе %course сияқты ауыстырылатын кем дегенде бір айнымалы болуы керек. Формада mask_ префиксімен басталатын өріс жасаңыз, мысалы, mask_name немесе mask_course. Пайдаланушы енгізген деректер осы айнымалыларды құжат мәтінінде ауыстырады. Электрондық пошта мекенжайын көрсету үшін mask_email айнымалысын қолданыңыз. Бірнеше мекенжай жазу үшін үтірмен немесе бос орынмен ажыратып көрсетіңіз. Диск жүйесінде жіберу статусы тек бірінші көрсетілген мекенжай үшін көрсетіледі.
Форма жұмысы
Форма жасалған соң жарияланған бетке кіріп, қалай жұмыс істейтінін тексеріңіз. Форма арқылы файл жасалып, оны жүктеп алуға арналған қалқымалы терезе көрсетіледі.
Бір құжат - бір толтыру
Қажет болған жағдайда, форманы толтыру санына шектеу қоюға болады. Егер көрсетілген email үшін doc_id бар файл бұрын жасалған болса, тек бір файл жасауға болатыны туралы ескерту көрсетіледі.
Менің құжаттарым
Пайдаланушының құжаттарын сайтыңыздың жабық бөлігінде көрсетуіңізге болады. Ол үшін жоғарыда көрсетілгендей форма жасаңыз. Кейін email, secure және doc_id жасырулы өрістерін қосыңыз. Email өрісіне пайдаланушының электрондық поштасын енгізіңіз, ал doc_id өрісіне all мәнін қосыңыз. Бетті ашқан кезде, форма орнында пайдаланушыға барлық құжаттар тізімі көрсетіліп, оларды жүктеп алу мүмкіндігі беріледі. Егер пайдаланушы бұрыннан форманы толтырып қойған болса, онда оған сол құжаты көрсетіледі, бірақ форма көрсетілмейді.