Если у вас есть Форма в которой имеются Вычисляемые Поля на основе Значений других Полей и необходимость в массовом импорте исходных данных, то вам точно будет полезен этот Плагин.

Например. Форма типа Калькулятор:

• Поле 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 – Загружено 1 раз – 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».

2,586 просмотров всего, 2 просмотров сегодня

GravityView (какое бы ни было к нему мое отношение) популярный инструмент. Но встроенный в него Экспорт, позволяет формировать лишь CSV файлы. Для многих это неудобно и недостаточно, потому, что требуется утомительная постобработка таких файлов. Присутствие в названии полей Кириллицы — может сильно испортить настроение и желание что-то делать.

Этот Плагин как раз и предназначен для того, чтобы решить эту проблему.

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

Скачать “gv-excel-export.zip” gv-excel-export_v3.5.zip – Загружено 809 раз – 1 MB

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

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

• Работает с ядром WordPress 6.7.1 (наличие PHP 7.4) Модифицированная библиотека phpExcel_7.4.3.1
• Работает с Формами GravityView версий 2.0 и выше. Проверено до 2.32
• Проверено с Gravity Forms до 2.9.1
• Учитывает результаты Поиска при отборе Записей.
• Учитывает Фильтры дополнений «Advanced Filter Extension».
• Учитывает опции «Override Date Format» для полей типа Дата.
• Корректно обрабатывает Кириллицу
• Имя результирующего Файла содержит Метку Времени, Имя Пользователя и Название Формы/Страницы.

Демонстрация работы:
* кликните на иконку Excel
* установите нужный Диапазон Дат!

* Pro версия имеет дополнительные возможности:

• Наличие Опции»Привилегии Администратора» для каждой Формы GV. Позволяет выводить все Записи, если текущий Пользователь имеет права Администратора.
• Виджет «Кнопка Excel-Export». Добавлен в общий список GV Виджетов. Теперь, чтобы вставить Кнопку «Excel-Export», достаточно просто кликнуть на этот Виджет. Без необходимости прописывания Шорткода.
• Наличие Опции «Альтернативное название для Excel» для каждого GV Поля. Позволяет изменять названия колонок в таблице Excel, делая их более осмысленными или компактными.
• Возможность Скрыть любое из GV Полей при выводе Записей на Фронтенд и/или в таблицу Excel.

Установка плагина:

Автоматическая инсталиция:
• Залогиньтесь на сайт WordPress как Admin.
• В Админке, откройте «Плагины»
• Кликните «Добавить новый»
• В поиске найдите «GV Excel-Export»
• Кликните «Установить» для найденного «GV Excel-Export».
• Активируйте плагин.
• В Формах GravityView, в которых вы хотите сделать Экспорт, добавьте GV Виджет «Custom content» и впишете Шорткод ‘gvxl_button_excelexport’

Ручная инсталяция:
• Загрузите Плагин «GV Excel-Export» на свой локальный компьютер.
• Распакуйте содержимое zip архива. У вас получится папка: ‘gv-excel-export’.
• Эту папку следует загрузить любым удобным вам способом в папку Плагинов WordPress ‘/wp-content/plugins/’.
• Активируйте плагин «GV Excel-Export» в Админке WordPress на странице Плагины.
• В Формах GravityView, в которых вы хотите сделать Экспорт, добавьте GV Виджет «Custom content» и впишете Шорткод ‘gvxl_button_excelexport’

== Часто Задаваемые Вопросы ==

Какие есть Настройки у Плагина «GV Excel-Export»?
• Основная опция: Enable/Disable — находится на странице Настроек GravityView. По умолчанию: Включено.
• В каждой GV Форме в Сайдбаре имеется «GV Excel-Export» Виджет с Опцией: Enable/Disable. По умолчанию: Включено.

Формат данных типа Дата, в Excel отличается от формата, принятого в PHP, который используется в GravityView. Каким образом можно устанавливать правильный формат для опции «Override Date Format», чтобы Дата/Время корректно отображалось и на Фронтенд и в таблицах Excel?
• Действительно, это так. Используйте PHP нотацию. Этот формат будет автоматически конвертирован в один из допустимых форматов Excel максимально близкий к вашему выбору.

Как можно выбрать Все Записи для Экспорта?
• Очистите поля «Date from» и «Date to» в блоке формы Экспорта. Но вам следует понимать, что слишком большие наборы записей для Экспорта, могут потребовать больших ресурсов вашего Сервера и иногда вызвать нехватку Оперативной Памяти.

== Screenshots ==

== Changelog ==

= 1.0 2021.02.04 =
* Initial release.

626 просмотров всего, 2 просмотров сегодня