Түзүү формасы

Сиздин сайтыңызда файлдарды автоматтык түрдө түзүү - дипломдор, сертификаттар же башка документтер. Сайтыңыздын коногу форманы толтуруп, файлды жүктөй алат.

Файл түзүү үчүн 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" (күн) маанисин кабыл алат.
  Мындан тышкары так убакытты көрсөтүү үчүн email_timeout_timestamp параметрин UNIX убакыт форматында киргизсеңиз болот. Эгер timeout жана email_timeout_timestamp бир убакта жөнөтүлсө, акыркысы артыкчылыктуу болот.

• folder_id

  Файлдарды сактоо үчүн дисктеги папканын ID (текст, 36 символ). Эгер папка жок болсо, ал биринчи файл түзүлгөндө автоматтык түрдө түзүлөт.

• page_id

  Документтеги барактын катар номери (сан же текст). Бир номурду (биринчи барак - 0) же бир нече номурду (үтүр менен ажыратылган) берсеңиз болот. Ушул барак(тар) файл түзүү үчүн колдонулат.

Файлды түзгөндөн кийин өзүңүзгө жөнөтүү

Файл түзүлгөндөн кийин, ал аккаунттун электрондук почтасына автоматтык түрдө жөнөтүлөт. "Каттын шаблону" талаасынан жөнөтүү үчүн кайсы шаблонду колдонууну тандай аласыз. Кат шаблондорунда өзүнчө шаблон түзүп алыңыз. Эгер кат текстине %data өзгөрмөсүн кошсоңуз, файлдын бардык маалыматтары таблица түрүндө ошол жерге жайгаштырылат.

Скрипт жана стилдер

Интеграция бетинен код алып, аны HEAD же беттин каалаган бөлүгүнө кошуңуз. Кодду сайттын бардык бетине кошуп кереги жок. Кодду формасы бар бетке гана кошуу керек.

Ошондой эле, "result-success" жана "result-danger" IDсы менен эки блок түзүшүңүз керек. Экөө тең жашырылган, display:none стили менен болушу зарыл. Алгачкы блок (result-success) файл ийгиликтүү түзүлгөндө көрсөтүлөт. Эгер бир ката кетсе, result-danger блогу автоматтык түрдө катанын текстин көрсөтөт.

Документке маалыматтарды жайгаштыруу

Документте алмаштыруучу кеминде бир өзгөрмө болушу керек, мисалы, %name же %course. Форманын талаасында mask_ алдына коюлган аталышты колдонуңуз, мисалы, mask_name же mask_course. Сайттын коногу киргизген маалымат ушул өзгөрмөгө жайгаштырылат. Электрондук почта дарегин кошуу үчүн mask_email өзгөрмөсүн колдонсоңуз болот. Бир нече дарекке жөнөтүү үчүн даректерди үтүр же боштук менен ажыратуу керек. Мындай учурда Диск статусу биринчи дарек үчүн көрсөтүлөт.

Форма иштөөсүн текшерүү

Форманы түзгөндөн кийин, жарыяланып жаткан бетти ачыңыз жана форманын иштешин текшерип көрүңүз. Файл түзүлүп, ал жүктөө үчүн калкыган терезеде көрсөтүлөт.

Бир документ = Бир толтуруу

Каласаңыз, форманы толтуруунун санын чектөөгө болот. Эгер көрсөтүлгөн электрондук почта дареги менен файл мурда эле doc_id колдонулуп түзүлгөн болсо, бир гана файл түзүүгө мүмкүн экенин көрсөткөн эскертүү чыгат.

Менин документтерим

Сайтыңыздын жабык бөлүгүндө коноктун документтерин көрсөтсөңүз болот. Ал үчүн жогоруда айтылгандай форма түзүп, ал жашыруун талааларды кошуңуз: email, secure жана doc_id. Алгачкысы - коноктун электрондук почтасы, акыркысы - "all" мааниси болушу керек. Бет ачылганда, конок форманын ордуна документтердин тизмесин көрүп, аларды жүктөй алат. Эгер мурда форма толтурулган болсо, форманын ордуна анын файлы көрсөтүлөт. Бул учурда email талаасы CMS аркылуу автоматтык түрдө толтурулат.

Башка интеграциялар