Bu yazıda eIrene form modülünü web portalında nasıl kullanıldığını anlatacağım.

Sayfalarda form kullanmak için yapılması gereken iki farklı yapılandırma vardır:

1. Portal genelinde kullanılacak formlar ile ilgili yapılandırma
2. Her form için sayfa içerisinde yapılacak yapılandırma.

Portal Genelinde Form Yapılandırması

İki adet Site Sabitı tanımlanmalıdır:

1. f-mail-to-addr:  Form doldurulduğunuda girilen bilgilerin gönderileceği elektronik posta adresi. Buraya girilen elektronik posta kutusu site sahibinden kullanılmakta olan akif bir adres olmalıdır.
2. f-mail-to-name:  Form doldurulduğunuda girilen bilgilerin gönderileceği elektronik posta adresinin sahibi olan kişinin Adı ve Soyadı.

Form Sayfası Yapılandırması

Herhangi bir sayfada bir ya da daha çok sayıda form bloğu tanımlanabilir. Her bir form bloğu için ilgili sayfa tanımı içerisinde aşağıdaki şekilde bir xml düğümü tanımlanmalıdır.

<page im="form" fm="form_adı" name="sayfa_adı">
    <result-messages>
     <msg type="err" lang="tr">Bilinmeyen bir hata oluştu! Lütfen daha sonra tekrar deneyin.</msg>
     <msg type="err" lang="en">Unknown error! Please try again later.</msg>
...
     <msg type="ok" lang="tr">Kaydınız alındı. Teşekkür ederiz.</msg>
     <msg type="ok" lang="en">We received your request. Thank you.</msg>
...
    </result-messages>
...
      <content type="input-form" name="contact">
       <heading lang="başlık_dil_kodu" type="başlık_tipi"> başlık_olarak_gösterilecek_metin </heading>
       <heading ...>
...
       <input-item input_düğümü_için_HTML_attribute_değerleri...>
           <label lang="etiket_dili_kodu">etiket_değeri</label>
           <label lang="etiket_dili_kodu">...</label>
...
       </input-item>
       <input-item ...>
...
       </input-item>
... 
      </content>
...
</page>

Örnek olarak ziyaretçinin adı, soyadı ve elektronik posta adresinin girilebileceği bir form aşağıdaki şekilde tanımlanabilir:

<page im="form" fm="contact" name="form">
 <result-messages>
  <msg type="err" lang="tr">Bilinmeyen bir hata oluştu! Lütfen daha sonra tekrar deneyin.</msg>
  <msg type="err" lang="en">Unknown error! Please try again later.</msg>
  <msg type="ok" lang="tr">Kaydınız alındı. Teşekkür ederiz.</msg>
  <msg type="ok" lang="en">We received your request. Thank you.</msg>
 </result-messages>
 <content type="container" col="lg-12" name="form-page-content">
  <content type="input-form" name="contact">
   <heading lang="tr" type="h3">Bize Yazın</heading>
   <heading lang="en" type="h3">Write Us</heading>
   <input-item id="fName" name="fName" type="text" required="1">
    <label lang="tr">Ad Soyad:</label>
    <label lang="en">Name:</label>
   </input-item>
   <input-item id="fMail" name="fMail" type="email" required="1">
    <label lang="tr">E-posta:</label>
    <label lang="en">Email:</label>
   </input-item>
   <input-item id="fCaptcha" class="g-recaptcha" data-sitekey="Google_reCAPTCHA_sitekey/>
  </content>
 </content>
</page>

Not: reCAPTCHA yapılandırması ile ilgili olarak Google sayfalarından bilgi edinebilirsiniz.

Form Sayfasının Adresi

Yukarıda anlatıldığı şekilde tanımlanan formu menüye aklemek için kullanılacak adres aşağıdaki gibidir:

http://<portal_alan_adı>/?im=form&fk=<fform_sayfası_adı>&dil=<dil_kodu>

Örneğin Yörenet portalındaki iletişim formu sayfasının adresi şöyledir:

https://www.yorenet.com/?im=form&fm=contact&dil=tr