Form Oluşturma
Web sitenizde belgeler, sertifikalar veya farklı dosyaları otomatik oluşturabilirsiniz. Ziyaretçileriniz yalnızca formu doldurup dosyayı alabilir.
Dosya oluşturmak için web sitenizde bir HTML formu hazırlamanız gerekiyor. Eğer bu mümkün değilse, sadece form oluşturma widget'ını kullanabilirsiniz.
Form Oluşturma
DiMaker'da dosyaların oluşturulması için talepler göndermek adına web sitenizde bir form oluşturmanız gerekmektedir. Bu form, sitenizin hem herkese açık hem de kapalı bölümünde yer alabilir. CMS aracılığıyla bir sayfa oluşturup, içinde form yerleştirin.
Form Action
https://dimaker.app/api/v1/webform-create/Form Alanları
Aşağıdaki değerlere sahip olması gereken gizli alanlar oluşturmanız gerekiyor:
-
secure*
Token (36 karakter uzunluğunda bir dize)
-
doc_id*
Dosya oluşturmak için kullanılacak belgenin ID'si (36 karakter uzunluğunda bir dize). Belge açık durumdayken tarayıcı adres çubuğundan bu ID alınabilir. Belge çöp kutusunda olmamalıdır, ancak herhangi bir Belgeler klasöründe yer alabilir.
-
mail_id
E-posta gönderimi için kullanılacak şablonun ID'si (36 karakter uzunluğunda bir dize). Şablon açıkken ID, adres çubuğundan alınabilir. Eğer bu değişken gönderilmezse, e-posta gönderimi yapılmaz.
-
email_send
Dosyanın e-posta ile gönderileceği zaman. Aşağıdaki değerleri alabilir:
onfinish - Tüm dosyaların oluşturulmasından sonra mail gönder (varsayılan)
oncreate - Her dosyanın oluşturulmasından hemen sonra mail gönder. Bir dosya için onfinish ve oncreate aynıdır.
timeout - Belirli bir süre sonra mail gönder. Bu durumda şu iki parametreyi de göndermeniz gerekiyor:
email_timeout_value - Mektupların gönderileceği aralık değeri (sayısal, tam sayı değer)
email_timeout_unit - Zaman birimi. "m" (dakika), "h" (saat), "d" (gün) değerlerini alabilir.
Ayrıca, kesin bir gönderim zamanı belirtmek için unix zaman formatında email_timeout_timestamp değişkenini gönderebilirsiniz. Eğer timeout ve email_timeout_timestamp birlikte belirtilirse, öncelik ikinci yöntemdedir. -
folder_id
Dosyaların kaydedileceği Disk'teki klasörün ID'si (36 karakter uzunluğunda bir dize). Eğer klasör yoksa, ilk dosya oluşturulduğunda otomatik olarak oluşturulur.
-
page_id
Belgede birden fazla sayfa varsa kullanılacak sayfa numarası (sayı veya dize). İlk sayfa için 0 değerini geçebilirsiniz ya da kullanılacak sayfa numaralarını virgülle ayırabilirsiniz.
Oluşturulan Dosyayı Kendinize Göndermek
Oluşturulan dosya, hesap e-posta adresinize otomatik olarak gönderilir. "E-posta Şablonu" alanında kullanılacak şablonu seçebilirsiniz. Önceden E-posta Şablonları kısmında hesabınıza özel bir şablon oluşturabilirsiniz. Eğer e-posta metninde %data değişkenini yazarsanız, dosya bilgileri tablo halinde eposta içine eklenir.
Script ve Stil
Entegrasyon sayfası'na giderek kodu alıp HEAD veya sayfanızdaki başka bir alana yapıştırmanız gerekiyor. Bu kodu sitenizin tüm sayfalarına eklemeyin. Sadece formun yer aldığı sayfaya eklenmelidir.
Ayrıca, iki blok oluşturmanız gerekiyor: id = "result-success" ve id = "result-danger". Her iki blok başlangıçta gizlenmelidir ve "display: none;" stiline sahip olmalıdır. İlk bloğa başarılı dosya oluşturma hakkında bir mesaj yazabilirsiniz. Başarılı bir işlemde bu blok gösterilecektir. Eğer bir hata oluşursa, otomatik olarak hata mesajı ikinci bloğa yerleştirilir ve gösterilir.
Belge İçine Değişken Yerleştirme
Belge içerisinde, en az bir değişken bulunması gerekir, örneğin %name veya %course. Formda bir alan ekleyin ve değişkenin adı mask_ ön ekiyle başlamalıdır, örneğin mask_name veya mask_course. Ziyaretçiniz bu alanlara ne girerse, ilgili belgede bu değişkenlerle değiştirilir. E-posta adresi belirtmek için "mask_email" değişkenini kullanın. Birden fazla e-posta adresine mail göndermek için adresleri virgül veya boşluk ile ayırabilirsiniz. Ancak Disk'teki gönderim durumu yalnızca ilk adres referans alınarak gösterilir.
Formun Çalışması
Formu oluşturduktan sonra yayına aldığınız sayfayı açarak formu test edebilirsiniz. Bir dosya oluşturulacak ve indirme işlemi için bir pop-up penceresinde gösterilecektir.
Bir Belge = Bir Form Doldurma
Dilerseniz, form doldurma sayısını sınırlayabilirsiniz. Belirtilen e-posta adresiyle zaten bir doc_id'ye sahip bir dosya oluşturulmuşsa, yalnızca bir dosya oluşturulabileceği konusunda bir uyarı verilecektir.
Belgelerim
Ziyaretçilerinizin belgelerini sitenizin kapalı bir bölümünde görüntüleyebilirsiniz. Bunun için yukarıda açıklanan adımlarla bir form oluşturun. Formda email, secure ve doc_id alanlarını gizli olarak ekleyin. Email alanına ziyaretçinin e-posta adresi, son alana ise "all" değerini atayın. Sayfa açıldığında ziyaretçi, form yerine belgelerinin bir listesini görecek ve indirme seçeneği sunulacaktır. Eğer ziyaretçi zaten bir form doldurmuşsa, form yerine onun dosyası gösterilecektir. Bu durumda e-posta adresi form alanında CMS üzerinden otomatik olarak doldurulmalıdır.