Массовый Импорт Записей из файлов 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’; итд…

== Демо ==

1. Загрузите CSV Файл с примером Записей для Импорта.
   в файле 3 строки:
   1. 1;2;3;5
   2. Alpha;2;3;1
   3. Omega;4;5;3
2. Первая строка – это ID Полей в Форме.
   Соответственно Поля: “Project Name”; “Number A”; “Number B”; “Ratio”;
3. Вторая и следующие строки – это Значения Полей в том же порядке, как ID.
4. В качестве разделителя в данном примере используется символ “;”
5. Замените Вторую и следующие строки своими Данными. (используйте Редактор типа: “Notepad++” чтобы гарантированно не изменилась кодировка файла. UTF-8 без BOM)
6. Сохраните CSV Файл.
7. Нажмите в Форме кнопку “Excel Import”.
8. Нажмите кнопку “Upload CSV file” и выберите сохраненный вами CSV Файл.
9. Первая Запись из файла заполнит Поля Формы. Кнопка Формы “Отправить” – отключится.
10. Если все ОК, жмите кнопку “Save”.
11. Автоматически подгрузится следующая Запись.

Текущая версия: 3.20 (2024.12.23) можно загрузить с этого сайта.

Скачать “gf-excel-import.zip” gf-excel-import_v3.20.zip – Загружено 753 раза – 26 KB

Или из Официального Репозитория WordPress

== Инсталляция ==

Обычная автоматическая установка.

* В комплекте с Плагином в папке “sample” идет Пример готовой GF Формы (samle-gf-form.csv) и CSV файл для импорта в нее (sample-csv-data-import.csv). Можно импортировать Форму и потестировать пример.

== PRO Версия ==

Особенности PRO Версии:

1. Возможность выбора типа данных (Название / Значение) для Полей: “Select”, “MultiSelect”, “Radio”, “CheckBox”.
2. Генерация Шаблона для удобного заполнения Таблицы Импорта. Шаблон – файл Excel формата XLSX. Вы просто заполняете Таблицу в привычном для себя способом, а затем сохраняете ее в формате CSV.
3. В Шаблоне указаны: ID Полей, их Названия, Тип и Подсказки для ввода.
4. Подсказки для ввода содержат все Допустимые Варианты для данного Поля с учетом выбранного типа данных (Название / Значение).

== Часто Задаваемые Вопросы ==
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”.