Заполнитель PDF форм для WPForms

Описание

Этот плагин позволяет пользователям WPForms добавлять PDF-вложения с данными отправки формы к уведомлениям и подтверждениям WPForms.

Если в PDF-вложении есть PDF-форма, плагин позволяет пользователям добавлять поля в форму WPForms и/или связывать их с полями в PDF. Плагин также позволяет встраивать изображения, предоставленные полями WPForms, в прикрепленные PDF-файлы. Заполненные PDF-файлы могут быть сохранены на веб-сервере.

Когда посетитель вашего сайта отправляет форму WPForms, форма в PDF-файле заполняется информацией из формы, изображения встраиваются, и полученный PDF-файл прикрепляется к уведомлению WPForms. Полученный PDF-файл также может быть загружен посетителями вашего сайта, если эта опция включена в настройках вашей формы.

Что делает этот плагин особенным, так это его подход к подготовке PDF файлов. Он не создает PDF документы с нуля. Он изменяет оригинальный PDF документ, который был подготовлен с использованием стороннего программного обеспечения и предоставлен плагину. Это позволяет пользователям свободно разрабатывать именно то, что им нужно, и использовать свои уже существующие документы.

Внешний веб-API (https://pdf.ninja) используется для заполнения PDF-форм (бесплатное использование имеет ограничения).

Пожалуйста, ознакомьтесь с Условиями использования Pdf.Ninja и Политикой конфиденциальности Pdf.Ninja.

Please see the tutorial video for detailed information.

Требования:
* PHP 5.5 или новее
* WordPress 5.4 или новее
* WPForms 1.6.9 или новее
* Chrome 63, Firefox 58 (или эквивалент) или новее

Известные несовместимые плагины:
* Imagify (удаляет формы из PDF файлов)
* ShortPixel Image Optimizer (удаляет формы из PDF файлов)

Особая благодарность следующим спонсорам этого плагина:
* BrowserStack

Скриншоты

  • Раздел PDF Forms доступен для доступа к интерфейсу вложений PDF
  • Интерфейс вложения PDF, который позволяет пользователям прикреплять PDF-файлы и устанавливать параметры вложения
  • Инструмент Field Mapper, который позволяет пользователям создавать и сопоставлять поля, смарт-теги и значения
  • Инструмент встраивания изображений, который позволяет пользователям встраивать изображения в PDF-файлы
  • Заполненный PDF файл

Установка

  1. Установите плагин WPForms.
  2. Загрузите папку этого плагина в каталог /wp-content/plugins/ или установите плагин напрямую через экран плагинов WordPress.
  3. Активируйте плагин через экран ‘Плагины’ в WordPress.
  4. Начните использовать раздел «PDF Forms» в редакторе WPForms в настройках.

Часто задаваемые вопросы

Позволяет ли этот плагин пользователям моего сайта редактировать PDF файлы?

Нет. Этот плагин добавляет функции только к интерфейсу WPForms в панели администратора WordPress.

Требуется ли для этого плагина специальная установка программного обеспечения на веб-сервере?

Нет. Плагин использует только основные функции WordPress и WPForms. Специальное программное обеспечение или расширения PHP не требуются. Работа с PDF-файлами осуществляется через Pdf.Ninja API. Рекомендуется иметь действующий сертификат SSL/TLS для проверки с помощью cURL.

Как поля формы WPForms сопоставляются с полями формы PDF?

Инструмент сопоставления полей позволяет сопоставлять поля по отдельности и, при необходимости, создавать новые поля WPForms на лету. Поля WPForms могут быть сопоставлены с несколькими полями PDF. Сопоставления могут быть связаны с конкретным PDF-вложением или со всеми PDF-вложениями. Также могут быть созданы сопоставления значений полей, позволяющие заполнять поля PDF данными, отличающимися от первоначально заполненных значений.

Мои поля не заполняются, что не так?

Убедитесь, что сопоставление существует в списке сопоставлений и имена полей совпадают.

Если вы прикрепили обновленный PDF-файл, и ваши сопоставления были связаны со старым идентификатором вложения, то эти сопоставления будут удалены, и вам потребуется создать их заново.

Иногда поля формы PDF имеют скрипты проверки, которые предотвращают заполнение значений в неправильном формате. Поля даты в PDF должны быть отформатированы с помощью смарт-тега.

Как обновить прикрепленный PDF файл, не прикрепляя новую версию и не теряя сопоставления и встраивания, связанные с идентификатором вложения?

Попробуйте использовать плагин Enable Media Replace, чтобы заменить PDF файл непосредственно в медиатеке.

Мои флажки и/или переключатели не заполняются, что не так?

Убедитесь, что экспортируемое значение флажка/радиокнопки в вашем PDF соответствует значению флажка в форме WPForms. Обычно это «On» или «Yes». Если вам нужно отобразить другое значение в форме WPForms, вам потребуется создать сопоставление значений.

WPForms позволяет использовать многострочные флажки, однако PDF-файлы не могут иметь несколько значений с полями флажков. Вам нужно либо переключиться на использование списка в вашем PDF, либо переименовать ваши флажки так, чтобы у каждого было уникальное имя, а затем правильно сопоставить их.

Некоторые программы для просмотра PDF неправильно отображают флажки в некоторых PDF-файлах. Вы можете решить эту проблему, пересоздав PDF в другом редакторе PDF. Если вы все еще используете Pdf.Ninja API v1, переход на v2 может решить вашу проблему.

Как удалить водяной знак в заполненных PDF-файлах?

Пожалуйста, посетите веб-сайт API Pdf.Ninja.

Отзывы

23.06.2024 1 ответ
I gave it a full day of testing, checkmarks and radio buttons are problematic specially when you have multiple out there it do not render it correctly. Then there is a watermark so its useless.
13.11.2023
It’s not the simplest UI to figure out, but once you do, it gets the job done. Step 1: Create a document (Word, or otherwise) that you need to place form data into.Step 2: Use a PDF application to convert it to PDF and ideally automatically add PDF form fields to it; these are what the plugin will read for mapping purposes. (Recommend using FoxIt PDF Creator for this.)Step 3: Upload the freshly minted PDF to your library.Step 4: In your WPForms form «Settings» tab, select «Step 1: Create a document (Word, or otherwise) that you need to place form data into.Step 2: Use a PDF application to convert it to PDF and ideally automatically add PDF form fields to it; these are what the plugin will read for mapping purposes. (Recommend using FoxIt PDF Creator for this.) Pro-Tip: Make sure to change the font and font size of these auto-generated form fields so that they are more legible than if you leave the font size set to «auto». I typically choose the font and font size that matches that used in creating the form for best results.Step 3: In your WPForms form «Settings» tab, select «PDF Forms» and click «Attach PDF file.» Upload your PDF.Step 4: Map existing WPForms form fields (left side) to «PDF field» (right side). If you’re doing multiple forms, I recommend selecting the PDF field (on the right) that has the bracketed [] numbers next to them. These numbers match the bracketed number above where you attached the PDF. This helps to keep straight which documents you’re mapping what fields to.Step 5: If you have any images or signatures to map, you’ll do this using the «Image Embedding Tool» section below the field mapping. Pick your field to map to which document, click «Embed Image,» and then draw where you want the image to be embedded (ie a signature line).You’re done except to test it’s all working. For $92 for the Pro version of PDF.Ninja to get rid of the watermark, it’s worth it. Or if you don’t mind the added watermark, use the free version! Emailed back and forth with Alex, the developer, several times. Excellent guy. Very helpful. Thank you so much for an awesome solution. Only feedback I have is I wish it handled certain WPForm fields better, like Address fields and Name fields that are segmented instead of all in one, and radio buttons. Also, handling dates is a bit clunky and could be made more user-friendly. I also wish there was the ability to embed uploaded PDFs into the PDF created, such as in the case of electronically «stapling» a voided check the user scanned in as a PDF to the form you’re having them fill out. (Just got an email from Alex: This is coming!) Disclaimer: Did not test paragraph text, dropdowns, number sliders, website/URL, password, rich text, ratings, Likert scale, Net Promoter Score, or any of the Payment-type fields. Your mileage may vary.
Посмотреть все 4 отзыва

Участники и разработчики

«Заполнитель PDF форм для WPForms» — проект с открытым исходным кодом. В развитие плагина внесли свой вклад следующие участники:

Участники

Журнал изменений

1.3.1

  • Release date: May 21, 2025

  • Fixed the issue of {entry_id} smart tag not working correctly

1.3.0

  • Release date: April 2, 2025

  • WARNING: This version includes changes that may affect plugin behavior. Please test your forms thoroughly after updating.

  • Fixed an issue with smart tags rendering: smart tag values were HTML-escaped when we need plain text
  • Field Mapper Tool UI issue fixed (column widths).

1.2.0

  • Release date: February 25, 2025

  • WARNING: This version includes changes that may affect plugin behavior. Please test your forms thoroughly after updating.

  • Switched from wpforms_process action to wpforms_process_after_filter filter for filling PDFs to fix an issue with file upload fields
  • Switched from using form submission raw data ($_POST) to formatted field data for filling PDFs
  • Fixed an issue with file upload URL not being accessible with non-smart-tag mappings
  • Fixed a bug with multi-selectable field detection
  • Temporarily added PDF as a supported image format for embedding (until capabilities feature is implemented)
  • Другие незначительные исправления и улучшения

1.1.11

  • Release date: December 28, 2024

  • Added ‘delete all value mappings’ button

  • Fixed value mapping dropdowns going off-screen caused by very long PDF field option labels
  • Fixed localization issues
  • Обновлены языковые файлы
  • Other bug fixes and improvements

1.1.10

  • Дата выпуска: 11 ноября 2024 г.

  • Незначительные исправления

1.1.9

  • Дата выпуска: 3 октября 2024 г.

  • Исправление ошибок

1.1.8

  • Дата выпуска: 30 мая 2024 г.

  • Добавлена возможность конкатенации вариантов множественного выбора при сопоставлении с текстовым полем

  • Исправлена ошибка с выпадающим списком поля WPForms при отображении значений, когда пользовательское значение не загружалось правильно
  • Добавлена поддержка настройки ‘значение’ для вариантов поля множественного выбора WPForms
  • Исправлена проблема с автоматической генерацией сопоставления значений, которая возникала, когда элементы списка опций были строками
  • Исправлена проблема: лишние строки и пробелы в сопоставлениях полей смарт-тегов вызывают несоответствия в сопоставлении значений
  • Другие незначительные изменения

1.1.7

  • Дата выпуска: 16 января 2024 г.

  • Удален ненужный префикс имени файла в подтверждениях загрузок

  • Исправлены возможные проблемы с коммуникацией API, вызванные неалфавитно-цифровыми символами в границе запроса
  • Другие незначительные исправления и улучшения

1.1.6

  • Дата выпуска: 9 ноября 2023 г.

  • Исправлены проблемы в коде снимка страницы

  • Улучшена поддержка удаленных вложений
  • Исправлен файл значка
  • Автоматическое изменение размера текстового поля умных тегов
  • Исправлена проблема с сохранением параметров текстовых вложений в некоторых случаях
  • Другие незначительные исправления и улучшения

1.1.5

  • Дата выпуска: 9 августа 2023 г.

  • Исправлена ошибка вложения уведомления из-за асинхронных уведомлений

  • Исправлена проблема, из-за которой генерировалось слишком много снимков страниц
  • Незначительные исправления ошибок и улучшения

1.1.4

  • Дата выпуска: 22 июня 2023 г.

  • Исправлена ошибка: настройки формы иногда не сохраняются

1.1.3

  • Дата выпуска: 17 мая 2023 г.

  • Добавлено обходное решение для флага GLOB_BRACE, который недоступен на некоторых системах, не использующих GNU

1.1.2

  • Дата выпуска: 6 мая 2023 г.

  • Исправления ошибок и улучшения

1.1.1

  • Дата выпуска: 2 декабря 2022

  • Обеспечьте поддержку WPForms 1.8.0

  • Уточнение незначительного предупреждающего сообщения

1.1.0

  • Дата выпуска: 2 декабря 2022

  • Были внесены некоторые исправления, которые влияют на логику процесса заполнения. Пожалуйста, проверьте свои формы после обновления, чтобы убедиться, что все работает как ожидалось, если вы думаете, что они могут быть затронуты!

  • Исправлена проблема с полями PDF, которые не очищались при пустых значениях полей CF7 (затрагивает предварительно заполненные поля в исходном PDF файле)

  • Исправлена проблема: сопоставления значений применяются рекурсивно (затрагивает сопоставления значений полей, которые имеют совпадающие значения CF7/PDF)
  • Исправление ошибки: отображение значений не работает с нулевыми значениями
  • Улучшена маркировка вариантов сопоставления пустых значений
  • Улучшено вложение PDF, влияющее на обнаружение действий
  • Исправлен перевод на немецкий
  • Обновлены языковые файлы
  • Другие исправления и улучшения

1.0.0

  • Дата выпуска: 9 сентября 2022 г.

  • Первоначальный выпуск