آخرین بازبینی: ۱۴۰۴/۰۷/۱۴

اضافه کردن برچسب جدید برای تاییدیه‌ها در گراویتی فرم

گراویتی‌فرم یک افزونه‌ی حرفه‌ای برای ساخت انواع فرم‌ها در وردپرس است. با این حال ممکن است کارهایی باشد که در این افزونه قابل انجام نیست. در این نوشته به شما آموزش می‌دهیم که چه طور یک Tag یا برچسب جدید با عملکرد دلخواه به قسمت تاییدیه‌های گراویتی فرم اضافه کنید.

برای انجام این کار از فیلترهای وردپرس استفاده می‌کنیم و کدهای لازم را در فایل functions.php قالب اضافه می‌کنیم.

۱- اضافه کردن برچسب به بخش ویرایشگر

ابتدا لازم است تا برچسب دلخواه را به بخش ویرایشگر تاییدیه اضافه کنیم. در این مرحله، برچسب ما فقط قابل انتخاب خواهد بود و در عمل کارکردی ندارد.

فیلدی که می‌خواهیم آن را به بخش تاییدیه‌ها اضافه کنیم، برای نمایش تاریخ به شکل صحیح فارسی است. در حالت عادی فیلد تاریخ در جهت معکوس نشان داده می‌شود و ما فیلد جدید با نام «date_ymd» را اضافه می‌کنیم:

add_filter( 'gform_custom_merge_tags', 'roka_add_date_tag', 20, 1 );
function roka_add_date_tag( $tags ) {
	$tags[] = array( 'tag' => '{date_ymd}', 'label' => 'تاریخ صحیح فارسی' );
	return $tags;
}

add_filter( 'gform_custom_merge_tags', 'roka_add_date_tag', 20, 1 );

function roka_add_date_tag( $tags ) {

$tags[] = array( 'tag' => '{date_ymd}', 'label' => 'تاریخ صحیح فارسی' );

return $tags;

}

اکنون اگر به بخش ویرایشگر مراجعه کنید، یک برچسب جدید با عنوان «تاریخ صحیح فارسی» مشاهده می‌کنید.

۲- اضافه کردن عملکرد به برچسب جدید

اگر فیلد جدید را به ویرایشگر اضافه کنید، عملکردی ندارد. با استفاده از کدهای زیر، به آن عملکرد صحیح را اضافه می‌کنیم:

add_filter( 'gform_replace_merge_tags', 'roka_gform_replace_merge_tags', 20, 7 );
function roka_gform_replace_merge_tags( $text, $form, $entry, $url_encode, $esc_html, $nl2br, $format ) {
	$local_date_ymd = date_i18n( 'Y/m/d', GFCommon::get_local_timestamp( time() ), true );
	$text = str_replace( '{date_ymd}', $url_encode ? urlencode( $local_date_ymd ) : $local_date_ymd, $text );
	return $text;
}

add_filter( 'gform_replace_merge_tags', 'roka_gform_replace_merge_tags', 20, 7 );

function roka_gform_replace_merge_tags( $text, $form, $entry, $url_encode, $esc_html, $nl2br, $format ) {

$local_date_ymd = date_i18n( 'Y/m/d', GFCommon::get_local_timestamp( time() ), true );

$text = str_replace( '{date_ymd}', $url_encode ? urlencode( $local_date_ymd ) : $local_date_ymd, $text );

return $text;

}

در قطعه کد بالا از کلاس GFCommon که مربوط به افزونه‌ی گراویتی فرم است نیز کمک گرفته‌ایم.

استفاده از پارامترهای فرم پر شده در محاسبات

اطلاعات اصلی فرم در متغیر «form» و اطلاعاتی که کاربر در فرم پر کرده است در متغیر «entry» قابل مشاهده و استفاده هستند. برای مثال جهت مشاهده‌ی شناسه‌ی فرم و شناسه‌ی اطلاعات پر شده توسط کاربر از کدهای زیر می‌توانیم استفاده کنیم:

echo $entry[ 'id' ];
echo $entry[ 'form_id' ];

1 2	echo $entry[ 'id' ]; echo $entry[ 'form_id' ];

با بررسی سایر پارامترهای ارسالی به تابع می‌توانید اطلاعات کامل‌تری در مورد فرم و اطلاعات پر شده توسط کاربر به دست بیاورید.

برنامه‌نویسی افزونه‌های سفارشی برای وردپرس و گراویتی فرم

اگر می‌خواهید برای وردپرس یا گراویتی فرم افزونه سفارشی بنویسید، با ما تماس بگیرید.

اضافه کردن برچسب جدید برای تاییدیه‌ها در گراویتی فرم

۱- اضافه کردن برچسب به بخش ویرایشگر

۲- اضافه کردن عملکرد به برچسب جدید

استفاده از پارامترهای فرم پر شده در محاسبات

برنامه‌نویسی افزونه‌های سفارشی برای وردپرس و گراویتی فرم

بیشتر بخوانید:

دیدگاهتان را بنویسید لغو پاسخ