Массовый Импорт Записей из файлов Excel (CSV) для «Gravity Forms» с Валидацией и поддержкой Внутренней Логики.
Если у вас есть Форма в которой имеются Вычисляемые Поля на основе Значений других Полей и необходимость в массовом импорте исходных данных, то вам точно будет полезен этот Плагин.
Например. Форма типа Калькулятор:
- Поле id=2 «A«: Слагаемое 1.
- Поле id=3 «B«: Слагаемое 2.
- Поле id=5 «Ratio«: Коэффициент.
- Поле «Calc«: C = (A + B) * Ratio
При Импорте Записей обычно вам необходимо подготовить все Значения всех Полей. A; B; Ratio; C.
А значит, провести предварительные вычисления.
Сложности начинаются, когда используется разветвленная Внутренняя Логика. Когда имеются различные дополнительные Поля выбора условий в виде Списков, Опций. («Gravity Forms» позволяет использовать как встроенную Внутреннюю Логику в каждом из Полей, так и подключать JS Скрипты со Сценариями.)
Перенести JS Скрипты со Сценариями в подготавливаемую Excel Таблицу может быть достаточно сложной задачей. Наличие Ошибок — практически неизбежно. Более того, необходимо внимательно поддерживать соответствие вычисляемых формул в Таблице с Алгоритмами Формы. И если вы что-то изменили в алгоритмах Формы, то вам снова необходимо изменять а затем тестировать Формулы в Таблице. Даже писать об этом утомительно.
Более того, некоторые Значения Полей могут иметь Ограничения как по Значениям, так и по Формату. В обычных случаях, импорт без проверки таких Ограничений может привести к аварийному завершению процесса Импорта, или к неправильно заполненным Полям.
В любом случае, заниматься ручной коррекцией Записей после такого Импорта может потребовать больших затрат и ресурсов.
Вот для таких Задач и необходим этот Плагин: «Import Excel to Gravity Forms«.
Достаточно заполнить лишь Исходные Поля.
В нашем Примере — Поля: A B и Ratio.
Вычисляемое Поле «C» будет вычисляться в каждой импортируемой Записи внутренними алгоритмами Формы и будет сохранено.
Если некоторые Значения выходят за пределы Допустимых, то такая Запись не будет Сохранена и потребует коррекции непосредственно в процессе Импорта.
= Особенности =
* Работает с PHP 7.4
* Работает с «Gravity Forms» версии 2.3.3.4 (более ранние версии просто не проверялись. Вероятно, что будет работать) и выше. Проверенно на 2.5.7.1
* Записи для импорта — это строки текстового файла (обычно — CSV) с разделением значений запятыми.
* Можно выбрать любой другой разделитель.
* Можно перемещаться по списку импортируемых записей и сохранять только некоторые из них.
* Каждая запись перед сохранением проходит проверку на совместимость форматов полей.
* Если Поля Формы имеют внутреннюю логику, то каждая запись перед сохранением проходит обработку с учетом этой логики.
* Импортируются поля всех типов: «Text», «TextArea», «Number», «Date», «Select», «MultiSelect», «Radio», «CheckBox».
* Корректно работает с Кириллицей и другими Национальными кодировками символов.
* Каждая Форма имеет свою собственную опцию «Import Enable».
* Корректно работает при наличии на Странице сразу нескольких дополнительных GForm в которых не используется Импорт.
* Возможность выбора кодировки CSV файла: ‘utf-8’ — default; ‘ISO-8859-1’; ‘CP1251’; итд…
== Демо ==
- Загрузите CSV Файл с примером Записей для Импорта.
в файле 3 строки:- 1;2;3;5
- Alpha;2;3;1
- Omega;4;5;3
- Первая строка — это ID Полей в Форме.
Соответственно Поля: «Project Name»; «Number A»; «Number B»; «Ratio»; - Вторая и следующие строки — это Значения Полей в том же порядке, как ID.
- В качестве разделителя в данном примере используется символ «;»
- Замените Вторую и следующие строки своими Данными. (используйте Редактор типа: «Notepad++» чтобы гарантированно не изменилась кодировка файла. UTF-8 без BOM)
- Сохраните CSV Файл.
- Нажмите в Форме кнопку «Excel Import».
- Нажмите кнопку «Upload CSV file» и выберите сохраненный вами CSV Файл.
- Первая Запись из файла заполнит Поля Формы. Кнопка Формы «Отправить» — отключится.
- Если все ОК, жмите кнопку «Save».
- Автоматически подгрузится следующая Запись.
Текущая версия: 1.17 (2022.11.17) можно загрузить с этого сайта.
Download “gf-excel-import.zip” gf-excel-import_v1.17.zip – Downloaded 303 times – 19 KB
Или из Официального Репозитория WordPress
== Инсталляция ==
Обычная автоматическая установка.
* В комплекте с Плагином в папке «sample» идет Пример готовой GF Формы (samle-gf-form.csv) и CSV файл для импорта в нее (sample-csv-data-import.csv). Можно импортировать Форму и потестировать пример.
== PRO Версия ==
- Возможность выбора типа данных (Название / Значение) для Полей: «Select», «MultiSelect», «Radio», «CheckBox».
- Генерация Шаблона для удобного заполнения Таблицы Импорта. Шаблон — файл Excel формата XLSX. Вы просто заполняете Таблицу в привычном для себя способом, а затем сохраняете ее в формате CSV.
- В Шаблоне указаны: ID Полей, их Названия, Тип и Подсказки для ввода.
- Подсказки для ввода содержат все Допустимые Варианты для данного Поля с учетом выбранного типа данных (Название / Значение).
== Часто Задаваемые Вопросы ==
N/A
== Скриншоты ==
1. Страница с полями «Gravity Forms» и активной опцией «GF Excel-Import».
2. Интерфейс «GF Excel-Import». Шаг 1. Кнопка загрузки CSV файла.
3. Интерфейс «GF Excel-Import». Шаг 2. Выбор CSV файла.
4. Интерфейс «GF Excel-Import». Шаг 3. Обработка записей. Навигация. Сохранение.
5. «Import Excel to Gravity Forms». Страница настроек.
6. Страница настроек «Gravity Forms» с активированным плагином «GF Excel-Import».
Can I buy pro version? Is this plugin is working?
I need “excel import button” in one of the gravity form in my website. I want to buy the pro version of your plugin. Is this plugin is still working? Kindly let me know.
Everything my Payment Accounts is blocked for Russian. And I don’t know when this will All End.
War…
I am from Sweden. I am using the plugin for importing «list» field. I am trying to import “list” field into the gravity form using csv file. But there is an error in console, Input_ID = 15_5_1 is not found.
How we can discuss this?