افزونه واردسازی ورودی گرویتی فرمز | GravityImport

افزونه واردسازی ورودی گرویتی فرمز (GravityImport) از GravityKit ورودی‌های فرم‌های Gravity Forms را از یک فایل CSV وارد سایت می‌کند: به فرمی که از قبل دارید یا به فرمی که خودش از ستون‌های فایل می‌سازد. صفحه‌اش زیر منوی فرم‌ها در پیشخوان وردپرس باز می‌شود و کار را مرحله‌به‌مرحله جلو می‌برد. برای کار به Gravity Forms فعال نیاز دارد.

این افزونه را وردپرس نیاز در میان افزونه‌های کاربردی وردپرس عرضه می‌کند. پیش‌تر Import Entries نام داشت.

مرحله‌های واردسازی در GravityImport

منظور از «نصب آزمایشی» در این متن یک وردپرس فارسی تازه است که فقط برای بررسی این محصول ساخته شد و Gravity Forms روی آن فعال بود. فرم نمونه و فایل‌های CSV هم برای همین آزمایش ساخته شدند.

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

در نصب آزمایشی، متن فارسی و رقم‌های فارسی (مثل «نمونه ۱») در ورودی‌های وارد شده بدون تغییر ذخیره شدند. خانه‌ای که دو گزینه را با کاما از هم جدا کرده بود (ورزش و موسیقی) با مقصد «هر انتخابی» هر دو گزینه چک‌باکس را تیک زد. ستونی که فیلدی در فرم نداشت بی‌نگاشت ماند؛ برای چنین ستونی می‌شود «افزودن فیلد فرم» را زد، برچسب و نوع فیلد را داد و ستون را در همان واردسازی وارد کرد. در آزمایش، فرم یک فیلد متنی تازه گرفت و مقدار ستون در ورودی‌ها ذخیره شد.

ساخت فرم از روی فایل

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

خطاها و ردیف‌های ناموفق

پیش از شروع، افزونه نمونه‌ای از ردیف‌های فایل را بررسی می‌کند. در نصب آزمایشی فایلی با یک ایمیل نادرست و یک مقدار غیرعددی در فیلد عدد، دو کارت خطا نشان داد؛ هر کارت ستون و مقدار ناموفق را می‌نویسد، و دکمه ادامه تا وقتی گزینه «پیشرفته: ادامه با وجود خطاها» تیک نخورده بود غیرفعال ماند. فیلد الزامی خالی در این بررسی نشان داده نشد و هنگام واردسازی رد شد.

گزینه «ادامه پردازش در صورت بروز خطا» از ابتدا روشن بود: ردیف‌های دارای خطا رد می‌شوند و بقیه وارد می‌شوند. در آزمایش، از شش ردیف فایل سه ردیف وارد شد و سه ردیف رد شد: ایمیل نادرست، مقدار غیرعددی و ایمیل خالی. ایمیل خالی فقط به این دلیل رد شد که گزینه «نادیده گرفتن فیلدهای الزامی فرم» پیش از اجرا خاموش شده بود. گزارش خطا شماره ردیف و دلیل هر خطا را می‌نویسد، و ردیف‌های ناموفق را می‌شود به‌صورت فایل CSV دانلود کرد؛ در فایل CSV خطاها ستونی هم برای دلیل شکست بود. بخشی از متن پیام‌های خطا در کارت‌ها و گزارش در این آزمایش انگلیسی بود.

به‌روزرسانی ورودی‌های موجود

ستونی که به «شناسه ورودی» نگاشت شود، به‌جای ساختن ورودی تازه ورودی موجود را جایگزین می‌کند. افزونه پیش از ادامه هشدار می‌دهد که تمام مقدارهای ورودی‌های دارای همان شناسه پاک و بازنویسی می‌شوند. در نصب آزمایشی فایلی فقط با ستون‌های شناسه ورودی، امتیاز و توضیحات دو ورودی را جایگزین کرد: امتیاز و توضیحات تازه شدند و فیلدهای دیگر همان دو ورودی، مثل نام، ایمیل و شهر، خالی شدند. برای به‌روزرسانی، همه ستون‌هایی را که باید بمانند در فایل بگذارید.

واردات شرطی و نمایه واردات

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

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

فارسی و راست‌چین

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

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

پیش از خرید

اگر Gravity Forms فعال نباشد، پیشخوان اعلان می‌دهد که افزونه به آن نیاز دارد. به گفته سازنده، واردسازی در پیشخوان و با دسترسی مدیر کار می‌کند و فیلدهای Nested Form را این افزونه وارد نمی‌کند.

اگر داده‌های فرم‌های قدیمی یا ورودی‌های جمع‌آوری‌شده در یک فایل CSV را باید به Gravity Forms منتقل کنید، این افزونه ورودی‌ها را در پیشخوان وارد می‌کند و ردیف‌های ناموفق را با دلیلشان گزارش می‌دهد و می‌شود آن‌ها را به‌صورت CSV دانلود کرد. اگر نصب و راه‌اندازی آن یا رفع ناسازگاری با بقیه افزونه‌های سایتتان را به متخصص می‌سپارید، خدمات نگهداری و عیب‌یابی سایت همین کار را می‌کند.