Жасау формасы
Сайтыңызда файлдарды автоматты түрде жасау - дипломдар, сертификаттар немесе басқа да заттар. Сіздің сайтыңыздың келушісіне тек форманы толтыру және файл алу жеткілікті болады.
Файлдарды жасау үшін сайтыңызда HTML формасын жасау қажет. Егер бұл мүмкін болмаса, жасау виджетін қолдансаңыз болады.
Форманы жасау
DiMaker-де файлдар жасауға сұраулар жіберу үшін, өз сайтыңызда форманы жасауыңыз керек. Бұл форма сайтыңыздың ашық бөлімінде немесе жабық бөлімінде орналаса алады. Сіздің CMS қолдану арқылы бет және форма жасаңыз.
Форма әрекеті
https://dimaker.app/api/v1/webform-create/Форма өрістері
Келесі мәндермен бірнеше жасырын өрістер жасауыңыз керек:
-
secure*
Токен (жол, 36 символ)
-
doc_id*
Файл жасау үшін қолданылатын құжат ID (жол, 36 символ). Құжат ашылғанда мекенжай жолында көрсетіледі. Құжат қоқыста болмауы керек, бірақ кез келген Құжаттар қалтасында орналасуы мүмкін.
-
mail_id
Электрондық пошта арқылы жіберуге арналған хат шаблонының ID (жол, 36 символ). Шаблон ашылғанда мекенжай жолында көрсетіледі. Айнымалы жіберілмесе, хат жіберілмейді.
-
email_send
Файлмен хатты қашан жіберу керектігі. Мынандай мәндер қабылдайды:
onfinish - Барлық файлдар жасалғаннан кейін барлық хаттарды жіберу (әдепкі)
oncreate - Файл жасалғаннан кейін хаттарды дереу жіберу. Бір файл жасалғанда onfinish және oncreate бірдей.
timeout - Хаттарды белгілі бір уақыт өткеннен кейін жіберу. Бұл жағдайда тағы екі параметр өту керек:
email_timeout_value - мезгілдің сандық мәні, хаттарды жіберу мезгілі, бүтін мән
email_timeout_unit - мезгілдің өлшем бірлігі. "m" (минут), "h" (сағат), "d" (күн) болатын мәндерді қабылдай алады.
Немесе нақты уақытты анықтау үшін, email_timeout_timestamp форматында unix time-мен уақыт өту керек. Timeout және email_timeout_timestamp берілгенде, соңғысы басым болады. -
storage_period
Файлдар Дискте сақталатын уақыт. Параметр көрсетілмесе, файлдар қолмен жойылмайынша шектеусіз сақталады. Уақыт өткеннен кейін жою үшін мән қабылдау керек:
timeout. Бұл жағдайда тағы екі параметр өту керек:
storage_period_timeout_value - файлдарды жою мезгілі, бүтін мән
storage_period_timeout_unit - мезгілдің өлшем бірлігі. "m" (минут), "h" (сағат), "d" (күн) болатын мәндерді қабылдай алады.
Немесе нақты уақытты анықтау үшін storage_period_timeout_timestamp-пен уақытты өту керек. Storage_period_timeout_value және email_timeout_timestamp берілгенде, соңғысы басым болады. -
folder_id
Файлдарды сақтау үшін Дисктегі қалта ID (жол, 36 символ). Қалта болмаған жағдайда бірінші файл жасалғанда автоматты түрде құрылады.
-
page_id
Құжатта бірнеше бет болса, парақтың реттік нөмірі (сан немесе жол). Бір нөмір (бірінші бет - 0) немесе файл жасау үшін қажет беттердің тізімін үтір арқылы беруге болады.
Файлды жасағаннан кейін өзіңізге жіберу
Файл жасалғаннан кейін аккаунттың электрондық почтасына дереу жіберіледі. "Хат шаблоны" өрісінде қай шаблонды қолдану керектігін таңдауға болады. Алдымен Хаттар шаблондары бөлімінде аккаунтқа электрондық почта жіберуге арналған жеке шаблон жасай аласыз. Егер хат мәтінінде %data айнымалысы жазылса, файлдың барлық деректері кесте түрінде сол жерге қосылады.
Скрипт және стильдер
Интеграция беті бетіне өтіңіз де, кодты көшіріп алыңыз және оны HEAD немесе беттің кез келген басқа жеріне қойыңыз. Бұл кодты сайттың барлық беттерінде қоюдың қажеті жоқ. Тек формалы бетке қою жеткілікті.
Сонымен қатар, result-success және result-danger идентификаторлары бар екі блок құру керек. Екі блок та жасырылған, display:none стилінде. Бірінші блокқа файлдың сәтті жасалғандығына байланысты мәтін жаза аласыз. Бұл блок табысты сұрауда көрсетіледі. Кез келген қате болса, result-danger идентификаторы бар блокты көрсетеді. Қате туралы мәтін автоматты түрде блокқа енгізіледі.
Құжатқа енгізу
Құжатта кем дегенде бір айнымалы болуы керек, мысалы %name немесе %course. Жүппкелушілерден алынған деректерді ауыстыру үшін форманың айнымалысының атауы mask_ префиксінен басталуы керек, мысалы mask_name немесе mask_course. Келушінің енгізген деректері құжат мәтініндегі тиісті айнымалыдарға ауыстырылады. Электрондық пошта мекенжайын көрсету үшін mask_email айнымалысын қолданыңыз. Хаттарды бірнеше адрестерге жіберу үшін үтір немесе бос орын арқылы көрсетіңіз. Бұл ретте, почтаның статусы Дискте бірінші мекен-жай бойынша көрсетіледі.
Форманың жұмысы
Форманы жасағаннан кейін, жарияланған бетті ашып, форманың жұмысын тексеруге болады. Файл жасалады және жүктелу үшін қалқыған терезеде көрсетіледі.
Бір құжат = бір толтыру
Қалауыңыз бойынша, форманы толтыру санын шектей аласыз. Егер көрсетілген электрондық поштаға doc_id арқыл файл жасалған болса, тек бір файл жасауға болатындығы туралы ескерту көрсетіледі.
Менің құжаттарым
Сайтыңыздың жабық бөлігінде келушінің құжаттарын көрсетуге болады. Ол үшін форманы жоғарыда көрсетілгендей жасаңыз. Содан кейін жасырын email, secure және doc_id өрістерін қосыңыз. Біріншіге келушінің электрондық пошта мекенжайын, соңғы өрісте all мәнін көрсетіңіз. Бетті ашқанда, келуші форма орнында барлық құжаттардың тізімін көріп оларды жүктей алады. Егер келуші бұрын форманы толтырса, форма орнына құжаты көрсетілсін десе, форманың email өрісі көрінбейтін және автоматты түрде сіздің CMS-ге енгізілген болуы керек.