Описание

Массовый Импорт Записей из файлов 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 Таблицу может быть достаточно сложной задачей. Наличие Ошибок — практически неизбежно. Более того, необходимо внимательно поддерживать соответствие вычисляемых формул в Таблице с Алгоритмами Формы. И если вы что-то изменили в алгоритмах Формы, то вам снова необходимо изменять а затем тестировать Формулы в Таблице. Даже писать об этом утомительно.

Более того, некоторые Значения Полей могут иметь Ограничения как по Значениям, так и по Формату. В обычных случаях, импорт без проверки таких Ограничений может привести к аварийному завершению процесса Импорта, или к неправильно заполненным Полям.
В любом случае, заниматься ручной коррекцией Записей после такого Импорта может потребовать больших затрат и ресурсов.

Вот для таких Задач и необходим этот Плагин.

Достаточно заполнить лишь Исходные Поля.

В нашем Примере — Поля: A B и Ratio.
Вычисляемое Поле «C» будет вычисляться в каждой импортируемой Записи внутренними алгоритмами Формы и будет сохранено.

Если некоторые Значения выходят за пределы Допустимых, то такая Запись не будет Сохранена и потребует коррекции непосредственно в процессе Импорта.

Демо:

1. Нажмите в Форме кнопку «Excel Import».
2. Нажмите «DownLoad Excel file for Template» и скачайте Шаблон.
   В Файле 3 строки:
   1. Первая строка — это ID Полей в Форме.
   2. Вторая строка — это Типы Полей и Подсказки для заполнения.
   3. Третья строка — это Названия Полей.
3. Заполните Поля Таблицы строки своими Данными.
4. Сохраните файл в формате CSV.
5. Откройте полученный CSV файл используя Редактор типа: «Notepad++».
   1. Убедитесь, что кодировка файла: UTF-8 без BOM.
   2. В качестве разделителя данных «;» (При необходимости, измените если там «,»)
   3. Сохраните CSV файл.
6. Нажмите кнопку «Upload CSV file» и выберите сохраненный вами CSV Файл.
7. Первая Запись из файла заполнит Поля Формы. Кнопка Формы «Отправить» — отключится.
8. Если все ОК, жмите кнопку «Save».
9. Автоматически подгрузится следующая Запись.

Или Скачайте готовый CSV файл с Демо данными.

Можно посмотреть как выглядит Исходный Шаблон для создания CSV файла и как выглядит Заполненный Шаблон.

Особенности и Возможности:

• Работает с PHP 7.4 (работает и на ранних версиях вплоть до PHP 5.4 если у вас ранние версии Gravity Forms)
• Работает с Gravity Forms начиная с версии 2.3.3.4 (более ранние версии просто не проверялись. Вероятно, что будет работать) и выше. Проверено вплоть до 2.5.15.4
• Записи для импорта — это строки текстового файла (обычно — CSV) с разделением значений запятыми.
• Можно выбрать любой другой разделитель.
• Можно перемещаться по списку импортируемых записей и сохранять только некоторые из них.
• Каждая запись перед сохранением проходит проверку на совместимость форматов полей.
• Если Поля Формы имеют внутреннюю логику, то каждая запись перед сохранением проходит обработку с учетом этой логики.
• Импортируются поля всех типов: «Text», «TextArea», «Number», «Date», «Select», «MultiSelect», «Radio», «CheckBox».
• Корректно работает с Кириллицей и другими Национальными кодировками символов.
• Каждая Форма имеет свою собственную опцию «Import Enable».
• Возможность выбора типа данных (Название / Значение) для Полей: «Select», «MultiSelect», «Radio», «CheckBox».
• Генерация Шаблона для удобного заполнения Таблицы Импорта. Шаблон — файл Excel формата XLSX.
• В Шаблоне указаны: ID Полей, их Названия, Тип и Подсказки для ввода.
• Подсказки для ввода содержат все Допустимые Варианты для данного Поля с учетом выбранного типа данных (Название / Значение).
• Корректно работает при наличии на Странице сразу нескольких дополнительных GForm в которых не используется Импорт.
• Возможность выбора кодировки CSV файла: ‘utf-8’ — default; ‘ISO-8859-1’; ‘CP1251’; etc…

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

Примеры:
В комплекте с Плагином в папке «gf-excel-import-pro/sample» идет Пример готовой GF Формы. (Более подробно смотри в «gf-excel-import-pro/sample/ReadMe.txt«.) Можно импортировать Форму и потестировать пример.

• Подробные Скриншоты и Комментарии к ним.

  1. Кнопка Импорта на странице с Полями формы «Gravity Forms» с активным плагином «Import Excel to Gravity Forms PRO».
  

  2. «Import Excel to Gravity Forms PRO» интерфейс. Шаг 1. Кнопки для скачивания Шаблона Импорта и для загрузки CSV файла с записями.
  

  3. «Import Excel to Gravity Forms PRO» интерфейс. Шаг 2. Выбор CSV файла для импорта.
  

  4. «Import Excel to Gravity Forms PRO» интерфейс. Шаг 4. Процесс Импорта. Навигация между записями, Сохранение.
  

  5. «Import Excel to Gravity Forms PRO». Страница Настроек.
  

  6. Страница Настроек «Gravity Forms» с опцией включения «Import Excel to Gravity Forms PRO».