Grav এর ফর্ম প্লাগইন ব্যবহার

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

Grav এর ফর্ম প্লাগইনটি খুবই নমনীয় এবং এর মাধ্যমে আপনি বিভিন্ন ধরনের ফর্ম কাস্টমাইজ করতে পারেন, যেমন ফর্ম ভ্যালিডেশন, ইমেইল নোটিফিকেশন, এবং ফর্ম ডেটা সংরক্ষণ করা।

Grav এর ফর্ম প্লাগইন ইনস্টল এবং কনফিগারেশন

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

১. ফর্ম প্লাগইন ইনস্টল করা

Grav সাইটে ফর্ম প্লাগইন ইনস্টল করার জন্য আপনাকে প্রথমে এটি ইনস্টল করতে হবে। এটি দুটি পদ্ধতিতে ইনস্টল করা যায়:

১.১. Admin Panel ব্যবহার করে ইনস্টলেশন

1. Grav Admin Panel এ লগইন করুন।
2. "Plugins" মেনুতে যান।
3. "Add Plugin" ক্লিক করুন এবং "Form" প্লাগইন খুঁজে ইনস্টল করুন।
4. ইনস্টলেশন শেষে প্লাগইনটি সক্রিয় করুন।

১.২. Composer ব্যবহার করে ইনস্টলেশন

আপনি Composer ব্যবহার করে ফর্ম প্লাগইন ইনস্টল করতে পারেন:

composer require getgrav/plugin-form

এটি প্লাগইন ইনস্টল করে আপনার সাইটে যুক্ত করবে।

Grav এর ফর্ম প্লাগইন কনফিগারেশন

ফর্ম প্লাগইন ইনস্টল করার পর, আপনি এটি কনফিগার করতে পারবেন যাতে এটি আপনার সাইটের প্রয়োজন অনুযায়ী কাজ করে। ফর্ম কনফিগারেশন YAML ফাইলের মাধ্যমে করা হয় এবং এটি সাধারণত user/config/plugins/form.yaml ফোল্ডারে পাওয়া যাবে।

ফর্ম কনফিগারেশন ফাইলের উদাহরণ:

enabled: true
type: 'email'
from: 'no-reply@example.com'
to: 'admin@example.com'
subject: 'New Form Submission'
template: 'forms/default'
file-upload-limit: 5M

এখানে:

• enabled: true ফর্ম প্লাগইন সক্রিয় করা হয়েছে।
• type: 'email' ফর্ম সাবমিট হলে ইমেইল প্রেরণ করা হবে।
• from, to, এবং subject ফিল্ডে ইমেইল কনফিগারেশন।
• template: 'forms/default' ফর্মের জন্য ডিফল্ট টেমপ্লেট।
• file-upload-limit: 5M ফর্মের মাধ্যমে আপলোড করা ফাইলের সাইজ সীমা।

Grav ফর্ম প্লাগইন দিয়ে কাস্টম ফর্ম তৈরি

Grav ফর্ম প্লাগইন দিয়ে খুব সহজেই কাস্টম ফর্ম তৈরি করা যায়। নিচে একটি সাদাসিধে যোগাযোগ ফর্মের উদাহরণ দেওয়া হলো:

২. ফর্ম তৈরি করা

আপনি একটি নতুন ফর্ম তৈরি করতে পারেন, যেমন একটি যোগাযোগ ফর্ম। এই ফর্মটি সাধারণত একটি .md (Markdown) ফাইল হিসেবে সাইটের পেজ ফোল্ডারে সংরক্ষিত থাকে।

উদাহরণ: contact.md ফাইল:

---
title: "যোগাযোগ করুন"
form:
  name: contact-form
  fields:
    - name: name
      label: "আপনার নাম"
      placeholder: "আপনার নাম লিখুন"
      autofocus: true
      required: true
    - name: email
      label: "ইমেইল ঠিকানা"
      placeholder: "আপনার ইমেইল ঠিকানা লিখুন"
      type: email
      required: true
    - name: message
      label: "বার্তা"
      placeholder: "আপনার বার্তা লিখুন"
      type: textarea
      required: true
  buttons:
    - type: submit
      value: "প্রেরণ করুন"
  process:
    - email:
        from: "{{ form.value.email }}"
        to: "admin@example.com"
        subject: "নতুন যোগাযোগ ফর্ম"
    - save:
        fileprefix: "contact"
        dateformat: "Y-m-d"
    - message: "ধন্যবাদ! আপনার বার্তা সফলভাবে প্রেরিত হয়েছে।"
---

এখানে:

• fields: ফর্মের ইনপুট ফিল্ডগুলির তালিকা। প্রতিটি ফিল্ডের জন্য name, label, type, required এবং অন্যান্য বৈশিষ্ট্য নির্ধারণ করা হয়েছে।
• buttons: ফর্মে একটি সাবমিট বাটন যুক্ত করা হয়েছে।
• process: ফর্মটি প্রক্রিয়া করার জন্য কনফিগারেশন। এটি ইমেইল পাঠানোর জন্য email অপশন ব্যবহার করছে এবং ফর্ম ডেটা সংরক্ষণ (save) করছে।

Grav ফর্ম প্লাগইন এর প্রক্রিয়া (Process)

Grav ফর্ম প্লাগইনটি বিভিন্ন প্রক্রিয়া পরিচালনা করতে সক্ষম, যেমন ফর্ম ডেটা প্রক্রিয়াকরণ, ইমেইল পাঠানো এবং ফাইল সংরক্ষণ। ফর্ম প্রক্রিয়া কনফিগারেশন YAML ফাইলের মাধ্যমে করা হয়।

ফর্ম প্রক্রিয়া উদাহরণ:

process:
  - email:
      from: "{{ form.value.email }}"
      to: "admin@example.com"
      subject: "নতুন ফর্ম সাবমিশন"
  - save:
      fileprefix: "submission"
      dateformat: "Y-m-d"
  - message: "ধন্যবাদ! আপনার ফর্ম সফলভাবে প্রেরিত হয়েছে।"

এখানে:

• email: ফর্ম সাবমিট হলে ইমেইল প্রেরণ করা হবে।
• save: ফর্মের ডেটা সংরক্ষণ করা হবে।
• message: সফল সাবমিশনের পর ব্যবহারকারীকে একটি ধন্যবাদ বার্তা প্রদর্শন করা হবে।

Grav ফর্ম প্লাগইন এর অন্যান্য বৈশিষ্ট্য

• ফাইল আপলোড: Grav ফর্ম প্লাগইন ফাইল আপলোড সাপোর্ট করে, যার মাধ্যমে ব্যবহারকারীরা ফর্মের মাধ্যমে ফাইলও আপলোড করতে পারেন।
• এজেক্স (AJAX) ফর্ম: Grav ফর্ম প্লাগইন AJAX সমর্থন করে, যা ফর্ম সাবমিট করার পর পেজ রিফ্রেশ না করেই দ্রুত রেসপন্স প্রদান করে।
• ফর্ম ভ্যালিডেশন: Grav ফর্ম প্লাগইন স্বয়ংক্রিয়ভাবে ফর্ম ভ্যালিডেশন পরিচালনা করে, যেমন একটি ফিল্ড পূর্ণ না হলে সেটি প্রম্পট করে।

সারাংশ

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