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

توجه: برای خرید افزونه گرویتی فرمز اینجا کلیک کنید.

نحوه استفاده از تکرار کننده (بتا) در افزونه گرویتی فرمز

معرفی افزونه:

گرویتی فرمز یک افزونه قدرتمند وردپرس است که برای ساده سازی فرآیند ایجاد و مدیریت فرم ها در وب سایت ها طراحی شده. این افزونه که توسط شرکت (Rocketgenius) توسعه یافته، یک رابط کاربر پسند بصری را ارائه می دهد. که به کاربران اجازه می دهد بدون زحمت انواع مختلفی از فرم ها، مانند فرم های تماس، نظرسنجی، آزمون ها و موارد دیگر را بسازند. این افزونه طیف گسترده ‌ای از فیلد های فرم، شامل: فیلد های متنی، دکمه‌ های رادیویی، چک باکس‌ ها و آپلود فایل ‌ها را فراهم می ‌کند و کاربران را قادر می ‌سازد تا فرم‌ ها را برای رفع نیاز های خاص خود سفارشی کنند.

این افزونه در ویژگی‌ های پیشرفته‌ اش برتری دارد. و به منطق شرطی اجازه می‌ دهد تا فرم ‌های پویا را ایجاد کند که با ورودی ‌های کاربر سازگار است. علاوه بر این، به طور یکپارچه با خدمات محبوب شخص ثالث، مانند درگاه های پرداخت، ابزار های بازاریابی ایمیلی، و سیستم های (CRM) ادغام می شود و عملکرد آن را افزایش می دهد. این افزونه همچنین از فرم های چند صفحه ای، حفاظت از هرز نامه و مدیریت ورود فرم پشتیبانی می کند.

لطفاً توجه کنید:

این نوع فیلد که با نسخه (2.4) گرویتی فرمز منتشر می کند، در حال حاضر در نسخه بتا است. هنوز هیچ گزینه ای را جزء رابط کاربری ویرایشگر فرم برای این فیلد نساخته اند. این بدان معناست که نمی‌ توانید این فیلد را با استفاده از روش‌ رها سازی استاندارد. ویرایشگر فرم به فرم خود اضافه کنید. در حال حاضر این فیلد فقط برای توسعه دهندگانی است که می توانند فرم های خود را به صورت برنامه نویسی یا از طریق روش های دیگر بسازند.

معرفی افزونه:

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

• مثال-1: یک فیلد تکرار کننده برای شماره تلفن، که به کاربر امکان می‌دهد چندین کد کشور، شماره تلفن و اطلاعات نوع شماره تلفن مرتبط را در یک فرم ارسال تماس وارد کند.
• مثال-2: یک فیلد تکرار کننده متشکل از نام شرکت‌ کنندگان و عناوین شغلی، که به یک فرم ثبت‌ نام کنوانسیون اجازه می ‌دهد تا چندین نفر از یک سازمان را شامل شود.

علاوه بر این، فیلد های تکرار کننده را می توان در یک فیلد تکرار کننده دیگر تو در تو کرد. به عنوان مثال، می توانید با ترکیب دو مثال بالا، اجازه دهید چندین شماره تلفن تماس برای هر شرکت کننده وارد شود. قابلیت ذخیره و ادامه پشتیبانی می شود.

تنظیمات ظاهر برای تکرار کننده (بتا) در افزونه گرویتی فرمز

مثالی از یک فیلد “تکرار کننده” که فقط یک فیلد نام دارد.

مثالی با سه فیلد “تکرار کننده” تو در تو.

فیلد های فرعی در فیلتر لیست ورودی فهرست می باشند، تا مانند سایر فیلد های فرم جستجو شوند.

ویژگی های فیلد

ویژگی های فیلد “تکرار کننده” آرایه ای از فیلد ها (اشیاء GF_Field) است. انواع فیلد های پشتیبانی شده به شرح زیر است:

متن تک خطی، متن پاراگراف، کشویی، چند انتخاب، عدد، چک باکس ها، دکمه های رادیویی، نام، تاریخ، زمان، تلفن (فقط فرمت “بین المللی”)؛ نشانی، سایت اینترنتی، پست الکترونیک، فهرست، تکرار کننده (تودرتو).

زیر فیلد های مجاز عبارت اند از:

برچسب

مقدار ویژگی “برچسب” در بالای فیلد تکرار کننده مشاهده می شود.

حداکثر آیتم های تکرار کننده

حداکثر تعداد موارد مجاز در یک تکرار کننده را می توان با استفاده از ویژگی فیلد (maxItems)، (درست/نادرست) تنظیم کرد.

متن دکمه

متون دکمه برای افزودن و حذف موارد برای هر فیلد ” تکرار کننده ” را می توان با ویژگی های فیلد “افزودن دکمه متن” و ” افزودن دکمه متن ” تعریف کرد.

تو در توی میدان تکرار کننده

یک فیلد “تکرار کننده” را می توان در داخل یک فیلد دیگر قرار داد.

هیچ محدودیت اجباری برای عمق تو در تو وجود ندارد، اگرچه طراحان فرم باید مفاهیم را به خصوص در هنگام طراحی برای صفحات باریکتر در نظر بگیرند.

محدودیت ها

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

• منطق شرطی هنوز اجرا نمی شود.
• محاسبات هنوز اجرا نمی شود.
• ترتیب مجدد موارد در فیلد تکرار کننده در هنگام ورود فرم هنوز اجرا نمی شود.
• ویرایشگر متن غنی در قسمت پاراگراف کار نمی کند.
• ویژگی رابط کاربری پیشرفته برای یک فیلد انتخابی کشویی کار نمی کند.
• ویژگی تایید فیلد ایمیل کار نمی کند.
• فرمت “استاندارد” ایالات متحده برای زمینه تلفن همانطور که انتظار می رود کار نمی کند.
• آپلود فایل، فیلد امضا و قسمت رمز عبور را نمی توان در مجموعه فیلد های ” تکرار کننده” گنجاند.
• کلاس های “css” برای فیلد های داخل ” تکرار کننده” کار نمی کنند.
• جمعیت پویا هنوز پشتیبانی نمی شود.
• حفظ مقادیر پیش ‌فرض برای موارد جدید هنوز پشتیبانی نمی ‌شود.
• اختصاص ویژگی های (tabindex) منحصر به فرد به موارد جدید هنوز پشتیبانی نمی شود. توصیه می کنیم هنگام جاسازی فرم با استفاده از مقدار 0، (tabindex) را غیر فعال کنید.

ورودی های تکرار کننده (بتا) در افزونه گرویتی فرمز

همه موارد فیلد ” تکرار کننده” مقادیری نمایش می دهد که می ‌توان آنها را در هنگام ویرایش ورودی ویرایش کرد. برای کمک به خوانایی، صفحه نمایش ورودی فیلد ” تکرار کننده ” از تو رفتگی و شکست خط برای نمایش سطوح (احتمالاً چندگانه) ورودی دریافتی در فیلد ” تکرار کننده” تک برای یک ورودی استفاده می‌ کند.

برون ریزی برای تکرار کننده (بتا) در افزونه گرویتی فرمز

تنظیمات ” منطق شرطی ” برای خروجی ورودی اجازه فیلتر کردن بر اساس مقادیر فیلد های فرعی را می دهد.

توجه داشته باشید که وقتی اطلاعات ” تکرار کننده ” را برون ریزی می‌ کنید، تو رفتگی‌ ها و شکاف ‌های خط وجود ندارد.

کد نمونه برای تکرار کننده (بتا) در افزونه گرویتی فرمز

به عنوان مثال نحوه افزودن فیلد “تکرار کننده” به صورت برنامه ریزی شده:

// Adjust your form ID
add_filter( 'gform_form_post_get_meta_149', 'add_my_field' );
function add_my_field( $form ) {

// Create a Single Line text field for the team member's name
$name = GF_Fields::create( array(
'type' => 'text',
'id' => 1002, // The Field ID must be unique on the form
'formId' => $form['id'],
'label' => 'Name',
'pageNumber' => 1, // Ensure this is correct
) );

// Create an email field for the team member's email address
$email = GF_Fields::create( array(
'type' => 'email',
'id' => 1001, // The Field ID must be unique on the form
'formId' => $form['id'],
'label' => 'Email',
'pageNumber' => 1, // Ensure this is correct
) );

// Create a repeater for the team members and add the name and email fields as the fields to display inside the repeater.
$team = GF_Fields::create( array(
'type' => 'repeater',
'description' => 'Maximum of 3 team members - set by the maxItems property',
'id' => 1000, // The Field ID must be unique on the form
'formId' => $form['id'],
'label' => 'Team Members',
'addButtonText' => 'Add team member', // Optional
'removeButtonText' => 'Remove team member', // Optional
'maxItems' => 3, // Optional
'pageNumber' => 1, // Ensure this is correct
'fields' => array( $name, $email ), // Add the fields here.
) );

$form['fields'][] = $team;

return $form;
}

// Remove the field before the form is saved. Adjust your form ID
add_filter( 'gform_form_update_meta_149', 'remove_my_field', 10, 3 );
function remove_my_field( $form_meta, $form_id, $meta_name ) {

if ( $meta_name == 'display_meta' ) {
// Remove the Repeater field: ID 1000
$form_meta['fields'] = wp_list_filter( $form_meta['fields'], array( 'id' => 1000 ), 'NOT' );
}

return $form_meta;
}

مثال 2: این قطعه تمام فیلد ها را از یک فرم دیگر می گیرد، آنها را در یک فیلد ” تکرار کننده” قرار می دهد و تکرار کننده را به فرم اضافه می کند.

توجه داشته باشید: که ممکن است لازم باشد ویژگی ” شماره صفحه ” را تنظیم کنید.

// Adjust your form ID
add_filter( 'gform_form_post_get_meta_150', 'add_fields_from_another_form' );
function add_fields_from_another_form( $form ) {

$repeater = GF_Fields::create( array(
'type' => 'repeater',
'id' => 1000,
'formId' => $form['id'],
'label' => 'My Repeater',
'pageNumber' => 1, // Ensure this is correct
) );

$another_form = GFAPI::get_form( 103 );
foreach ( $another_form['fields'] as $field ) {
$field->id = $field->id + 1000;
$field->formId = $form['id'];
$field->pageNumber = 1; // Ensure this is correct

if ( is_array( $field->inputs ) ) {
foreach ( $field->inputs as &$input ) {
$input['id'] = (string) ( $input['id'] + 1000 );
}
}
}

$repeater->fields = $another_form['fields'];
$form['fields'][] = $repeater;

return $form;
}
// Remove the field before the form is saved. Adjust your form ID
add_filter( 'gform_form_update_meta_150', 'remove_my_field', 10, 3 );
function remove_my_field( $form_meta, $form_id, $meta_name ) {

if ( $meta_name == 'display_meta' ) {
// Remove the Repeater field: ID 1000
$form_meta['fields'] = wp_list_filter( $form_meta['fields'], array( 'id' => 1000 ), 'NOT' );
}

return $form_meta;
}

قرار دادن فیلد “تکرار کننده” در یک فرم

جاسازی فیلد ” تکرار کننده” در فرم نیز نیاز به کنترل برنامه ای دارد. در اینجا یک مثال نشان می دهد که چگونه می توانید فیلد تکرار کننده را در یک موقعیت خاص در آرایه فیلد ها وارد کنید:

array_splice( $form['fields'], 2, 0, array( $repeater ) );

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