Созлаш формаси
Сайтигизда автоматик равишда файллар яратиш — дипломлар, сертификатлар ёки бошқа ҳужжатлар. Сайтигиз фойдаланувчилари форма тўлдириб, файлни қўлга киритишлари мумкин бўлади.
Файллар яратиш учун сайтигизда HTML форма яратишингиз керак. Агар бу мумкин бўлмаса, сизга яратиш виджетидан фойдаланиш тавсия қилинади.
Формани яратиш
DiMaker га файл яратиш сўровларини юбориш учун сайтигизда форма яратишингиз керак. Бу форма сайтигизнинг очиқ ёки махфий қисмида жойлашиши мумкин. CMS орқали янги саҳифа ва унда форма яратишингиз мумкин.
Форманинг Action параметри
https://dimaker.app/api/v1/webform-create/
Форма полелари
Қуйидаги қийматларга эга яширин қаторларни яратишингиз керак:
-
secure*
Токен (матн, 36 белгидан иборат)
-
doc_id*
Ҳужжат ID (матн, 36 белгидан иборат), файл яратиш учун фойдаланиладиган ID. 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 ёки саҳифанинг бошқа жойига жойлаштиринг. Кодни барча саҳифаларга эмас, балки фақатгина форма бўлган саҳифага жойлаштириш керак.
Шунингдек, result-success ва result-danger ID га эга бўлган икки яширин блок яратиш керак. УК стринг display:none; бўлиши керак. Биринчи блокда муваффақиятли яратиш ҳақида хабар кўрсатиш мумкин. Агар хатолик юз берса, result-danger блокида хатонинг матни автоматик кўрсатилади.
Ҳужжатда ўзгарувчини қўшиш
Ҳужжатда ҳеч бўлмаганда бир та ўзгарувчи бўлиши керак, масалан, %name ёки %course. Форманинг керакли майдонида ўзгарувчи номи mask_ билан бошланиши керак, масалан, mask_name ёки mask_course. Фойдаланувчи ушбу қаторларга киритган маълумот ҳужжат матнида тегишли ўзгарувчи ўрнига қўшилади. Электрон почта манзили учун mask_email ўзгарувчидан фойдаланинг. Бир нечта манзилга хат жўнатиш учун уларни китоб ёки оралдида киритинг. Бунда юбориш статуси Дискда биринчи манзил бўйича кўрсатилади.
Форма ишлаш тартиби
Формани яратгандан сўнг уни текшириш учун формага эга саҳифани очинг. Янгидан яратилган файл юклаб олиш учун поп-ап ойнада кўрсатилади.
Битта ҳужжат = Бир марта тўлдириш
Ихтиёрий равишда, формани тўлдиришни чеклашингиз мумкин. Агар бир хил email манзили билан doc_id га эга файл аввал яратилган бўлса, битта файл яратиш мумкинлиги ҳақида хабар кўрсатилади.
Менинг ҳужжатларим
Сайтингизнинг махфий қисмида фойдаланувчи ҳужжатларини кўрсатишингиз мумкин. Формани юқорида кўрсатилганидек яратиш керак. Кейин яширин қаторларга email, secure ва doc_id қиёсий қийматларни киритинг. Биринчи катакчага фойдаланувчининг электрон почта манзилини, охиргига “all” қийматни киритинг. Саҳифани очганда фойдаланувчи форма ўрнида ўз ҳужжатлар рўйхатини кўради. Агар фойдаланувчи аввал форма тўлдирган бўлса, форма ўрнига унинг файли кўрсатилади. Формани CMS орқали автоматик тарзда фойдаланувчи аутентификациясидан ўтказиб қўшиш мумкин.