Custom Form Validation এবং Error Handling

Grav CMS এর ফর্ম সিস্টেমটি শক্তিশালী এবং কাস্টমাইজযোগ্য, যা ফর্মের ডেটা সংগ্রহ ও প্রক্রিয়াকরণের জন্য বিভিন্ন ধরনের বৈশিষ্ট্য প্রদান করে। ফর্ম সাবমিশন করার সময় কাস্টম ভ্যালিডেশন (Custom Validation) এবং ত্রুটি হ্যান্ডলিং (Error Handling) ব্যবহার করা খুবই গুরুত্বপূর্ণ, বিশেষ করে যখন আপনি ব্যবহারকারীর ইনপুট যাচাই করতে চান এবং ফর্মের ত্রুটিগুলি সঠিকভাবে হ্যান্ডল করতে চান।

Grav এ কাস্টম ফর্ম ভ্যালিডেশন এবং এরর হ্যান্ডলিং সেটআপ করার মাধ্যমে আপনি ফর্মের কার্যকারিতা উন্নত করতে পারবেন। এখানে Grav ফর্ম সিস্টেমে কাস্টম ভ্যালিডেশন এবং এরর হ্যান্ডলিং কিভাবে কাজ করে, তা বিস্তারিতভাবে আলোচনা করা হলো।

Grav ফর্ম সিস্টেমের জন্য কাস্টম ভ্যালিডেশন

Grav ফর্ম সিস্টেমে ডিফল্টভাবে বিভিন্ন ধরনের ফর্ম ফিল্ড ভ্যালিডেশন সাপোর্ট করা হয় (যেমন ইমেইল, টেক্সট, নাম্বার ইত্যাদি)। তবে আপনি চাইলে কাস্টম ভ্যালিডেশনও তৈরি করতে পারেন, যা আপনার ফর্মের ইনপুট ডেটার জন্য নির্দিষ্ট চেকিং প্রক্রিয়া যুক্ত করবে।

কাস্টম ভ্যালিডেশন কিভাবে তৈরি করবেন?

Grav ফর্ম সিস্টেমে কাস্টম ভ্যালিডেশন তৈরি করতে, আপনাকে একটি কাস্টম ফর্ম ফিল্ড এবং তার সাথে সম্পর্কিত ভ্যালিডেশন রুল সংজ্ঞায়িত করতে হবে। সাধারণভাবে, আপনি YAML কনফিগারেশন এবং PHP স্ক্রিপ্ট ব্যবহার করে এই কাস্টম ভ্যালিডেশন তৈরি করতে পারেন।

উদাহরণ:

ধরা যাক, আপনি একটি ফর্ম তৈরি করেছেন যেখানে ব্যবহারকারীরা একটি ইমেইল ঠিকানা এবং একটি কাস্টম "বয়স" ফিল্ড জমা দিবে। আপনি চাইলে কাস্টম ভ্যালিডেশন তৈরি করতে পারেন, যেমন যদি বয়স ১৮ বছরের কম হয়, তাহলে সাবমিট করা যাবে না।

form:
  name: example_form
  fields:
    - name: email
      label: "Your Email"
      type: email
      validate:
        required: true
        email: true

    - name: age
      label: "Your Age"
      type: number
      validate:
        required: true
        min: 18

এখানে:

• email ফিল্ডে ইমেইল ভ্যালিডেশন প্রয়োগ করা হয়েছে।
• age ফিল্ডে min: 18 কাস্টম ভ্যালিডেশন ব্যবহার করা হয়েছে, যাতে বয়স ১৮ বছরের কম হলে সাবমিট করা যাবে না।

কাস্টম PHP ভ্যালিডেশন ফাংশন

আপনি যদি আরও জটিল কাস্টম ভ্যালিডেশন চান, তাহলে PHP স্ক্রিপ্ট ব্যবহার করে এটি করতে পারেন। এজন্য আপনাকে user/plugins/form/form.php অথবা user/forms/ ফোল্ডারে ফর্ম ভ্যালিডেশন ফাংশন তৈরি করতে হবে।

public function customAgeValidation($value, $field, $form)
{
    if ($value < 18) {
        return 'You must be at least 18 years old.';
    }
    return true;
}

এই ফাংশনটি ফর্মের ক্ষেত্রে age ফিল্ডে কাস্টম ভ্যালিডেশন হিসেবে প্রয়োগ করা যাবে।

Grav ফর্ম সিস্টেমে এরর হ্যান্ডলিং

ফর্মের ইনপুট যখন সঠিকভাবে যাচাই করা হয় না, তখন ব্যবহারকারীকে ত্রুটি বার্তা দেখানোর জন্য Error Handling অত্যন্ত গুরুত্বপূর্ণ। Grav ফর্ম সিস্টেমে এরর হ্যান্ডলিং বেশ সহজ এবং কাস্টমাইজেবল। Grav ফর্ম স্বয়ংক্রিয়ভাবে ত্রুটি বার্তা তৈরি করে এবং সেগুলো ফর্মের সাথে যুক্ত করে প্রদর্শন করে।

এরর বার্তা কাস্টমাইজেশন

Grav ফর্মের ত্রুটি বার্তাগুলি স্বয়ংক্রিয়ভাবে ফর্ম ফিল্ডের নিচে প্রদর্শিত হয়। আপনি চাইলে ত্রুটি বার্তা কাস্টমাইজ করতে পারেন এবং নির্দিষ্ট ফিল্ডের জন্য নির্দিষ্ট বার্তা প্রদান করতে পারেন।

উদাহরণ:

আপনি যদি একটি কাস্টম বার্তা দিতে চান যখন কোনো ফিল্ড ইনপুট সঠিক না হয়, তাহলে এটি YAML ফাইলে সংজ্ঞায়িত করা যেতে পারে:

form:
  name: example_form
  fields:
    - name: email
      label: "Your Email"
      type: email
      validate:
        required: true
        email: true
        message: "Please enter a valid email address."

    - name: age
      label: "Your Age"
      type: number
      validate:
        required: true
        min: 18
        message: "You must be at least 18 years old to submit this form."

এখানে, আপনি message অপশনটি ব্যবহার করে কাস্টম এরর বার্তা প্রদান করতে পারেন।

কাস্টম এরর বার্তা পিপি স্ক্রিপ্টে

আপনি যদি PHP স্ক্রিপ্ট ব্যবহার করেন, তাহলে আপনি ফর্ম সাবমিট করার সময় এরর হ্যান্ডলিং করতে পারেন:

if ($form->isValid()) {
    // Process the form
} else {
    $form->setMessage('There were some errors with your submission.');
}

এখানে, setMessage ফাংশন ব্যবহার করে আপনি কাস্টম এরর বার্তা সেট করতে পারেন, যা ফর্মের ত্রুটির সাথে যুক্ত হবে।

Grav ফর্মে কাস্টম ভ্যালিডেশন এবং এরর হ্যান্ডলিং এর সুবিধাসমূহ

1. উন্নত কাস্টম ভ্যালিডেশন: Grav ফর্ম সিস্টেমের মাধ্যমে আপনি কাস্টম ভ্যালিডেশন তৈরি করতে পারবেন, যা আপনাকে ব্যবহারকারীর ইনপুট যাচাই করতে সাহায্য করবে।
2. ব্যবহারকারী বান্ধব ত্রুটি বার্তা: Grav ফর্ম সিস্টেমে ত্রুটি বার্তা স্বয়ংক্রিয়ভাবে প্রদর্শিত হয়, যা ব্যবহারকারীদের ফর্ম সাবমিশনের সময় ত্রুটির কারণ বুঝতে সাহায্য করে।
3. নমনীয় কাস্টমাইজেশন: আপনি চাইলে কাস্টম PHP ফাংশন ব্যবহার করে আরও জটিল ভ্যালিডেশন এবং ত্রুটি বার্তা কাস্টমাইজ করতে পারবেন।
4. পারফরম্যান্স উন্নতি: Grav এর ফর্ম সিস্টেম দ্রুত এবং কার্যকরী, এবং ফর্ম ভ্যালিডেশন ও এরর হ্যান্ডলিং একেবারে সরল এবং নির্ভরযোগ্য।

সারাংশ

Grav CMS এর ফর্ম সিস্টেমে কাস্টম ভ্যালিডেশন এবং এরর হ্যান্ডলিং অত্যন্ত শক্তিশালী এবং কাস্টমাইজেবল। আপনি YAML এবং PHP ব্যবহার করে কাস্টম ভ্যালিডেশন ফিল্ড, এরর বার্তা এবং অন্যান্য বৈশিষ্ট্য কাস্টমাইজ করতে পারেন। Grav এর ফর্ম সিস্টেম ব্যবহার করে আপনি সহজেই ফর্ম ইনপুট যাচাই করতে পারেন এবং ত্রুটি হ্যান্ডলিংয়ের মাধ্যমে ব্যবহারকারীদের সঠিক ফর্ম সাবমিশন অভিজ্ঞতা প্রদান করতে পারেন।