শেষ পাঠে তৈরি করা প্রতিটি কাস্টম ফিল্ড শুধু ডেটাবেসে বসে আছে যতক্ষণ না একটি টেমপ্লেট আসলে সেটি ফিরিয়ে পড়ে। দুটো ফাংশন এটি করে, আর দুটোর মধ্যে পছন্দ একটি প্রশ্নে নেমে আসে: আপনার মানটি ব্যবহার করা দরকার, নাকি শুধু প্রিন্ট করা?
<?php the_field( 'client_name' ); ?>
<?php $client = get_field( 'client_name' ); ?>| ফাংশন | কখন ব্যবহার করবেন |
|---|---|
the_field() | আপনি শুধু চান মানটি সরাসরি পাতায় echo হয়ে যাক, ঠিক যেখানে আপনি এটি কল করেন — the_title()-এর ফিল্ড-লেভেল সমতুল্য |
get_field() | আপনার আগে একটি ভ্যারিয়েবলে মানটি দরকার — এটি চেক করতে, ফরম্যাট করতে, বা অন্য ফাংশনে পাস করতে |
বাস্তবে, get_field() প্রায় সবকিছু কাভার করে, কারণ সাধারণ আউটপুটও সাধারণত আগে একটি if চেক চায় (নিচে)। the_field() সত্যিই শুধু সবচেয়ে সহজ, সবসময়-উপস্থিত কেসের জন্য।
একটি ফিল্ডের টাইপ ঠিক করে get_field() যে আকারের মান ফেরত দেয় — এই অংশটাই মানুষকে প্রথমে বিভ্রান্ত করে:
| ফিল্ড টাইপ | রিটার্ন মান |
|---|---|
| Text / Textarea / Number | একটি সাধারণ string বা number — সরাসরি echo করা নিরাপদ (escape করার পর) |
| True / False | একটি সাধারণ PHP boolean — সরাসরি একটি if-এ ব্যবহার করুন |
| Image | ডিফল্টভাবে একটি অ্যারে — ['url'], ['alt'], ['width'], ['height'], ['ID'], আরও কিছুসহ |
| Link | একটি অ্যারে — ['url'], ['title'], ['target'] |
<?php $client = get_field( 'client_name' ); ?>
<?php if ( $client ) : ?>
<p>Client: <?php echo esc_html( $client ); ?></p>
<?php endif; ?>
<?php $photo = get_field( 'featured_photo' ); ?>
<?php if ( $photo ) : ?>
<img src="<?php echo esc_url( $photo['url'] ); ?>" alt="<?php echo esc_attr( $photo['alt'] ); ?>">
<?php endif; ?>ফিল্ড ঐচ্ছিক — ব্যবহারের আগে সবসময় চেক করুন
কাস্টম ফিল্ড প্রায় কখনোই বাধ্যতামূলক নয় — একজন এডিটর সবসময় একটি খালি রাখতে পারেন। প্রতিটি রিড ব্যবহারের আগে চেক করা উচিত, উপরে $client আর $photo যেভাবে চেক করা হয়েছে সেভাবে। চেক বাদ দিলে পাতাটি সরাসরি ক্র্যাশ করে না, কিন্তু যে পোস্টে ফিল্ডটি খালি রাখা হয়েছে তাতে এটি খালি <img> ট্যাগ আর পরে কিছু ছাড়া বিচ্ছিন্ন লেবেল তৈরি করে।
গঠনবদ্ধ ডেটা লেখা আর পড়া দুটোরই উপায় হয়ে যাওয়ার পর, পরের পাঠ বিশেষভাবে পুনরাবৃত্ত গঠনবদ্ধ ডেটার জন্য বানানো ফিল্ড টাইপ কাভার করে — ছবির একটি গ্যালারি, ফিচারের একটি তালিকা, শুধু একটি মান নয় এমন যেকোনো কিছু।