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