Just make sure you don't have any alt text on your fields like so (or your checkboxes will come out blank)
if you dump pdf form data with pdftk (google it) and see any records like this:
FieldName: Agree24Hours
FieldNameAlt: I agree to prov
FieldFlags: 0
FieldValue: Off
FieldJustification: Left
FieldStateOption: Off
FieldStateOption: Yes
open the form in acrobat and right click -> properties -> clear the tooltip field and try it again.
while you're here, fix the dumb chrome bug (blank boxes) by adding styling to the checkboxes (just a background and a filler shape should be fine!)
then uncompress the file with pdftk, and then run the dump fields again:
FieldName: Agree24Hours
FieldFlags: 0
FieldValue: Off
FieldJustification: Left
FieldStateOption: Off
FieldStateOption: Yes
you should be good to go!
i'm going to leave everything else here the same; props to oliver and codeshell for the good work, this library is great... just realllly need check boxes
todo: radio/image support properly, probably within the coming months we'll see how uni goes
The FPDM class allows to fill out PDF forms, i.e. populate fields of a PDF file. It is developed by Olivier Plathey, author of the FDPF Library, and has been released as Skript 93.
I created this repository for the following reasons:
- make the current FPDM source available via composer, autoload via classmaps
- bugfixing
- improvements (changes to the original codebase are prefixed with
//FIX: change descriptionand ended with//ENDFIX)- ADD: support for checkboxes (disabled by default, activate with
$pdf->useCheckboxParser = true;) 0375dd9 v2.9.2
- ADD: support for checkboxes (disabled by default, activate with
Based on version 2.9 (2017-05-11) available from fpdf.org/en/script/script93.php.
Note: If you find that a new version has been hosted on fpdf.org, please do not hesitate to drop me a short note to make sure I do not miss it out.
This repository only contains the separate php class written for form filling (FPDM). If you are looking for a repository containing the main FPDF Library, please head over to github.com/Setasign/FPDF.
Once again, all credits to Olivier Plathey for providing an easy to use script for form filling in addition to his FPDF library!
The preferred way of making FPDM available in your app is to install it via composer with
composer require tmw/fpdm
autoload FPDM class files by adding this to your code:
require 'vendor/autoload.php';
Load the top level entry point by calling
require_once '/abolute/path/to/fpdm.php';
or
require_once './relative/path/to/fpdm.php';
Autoloading classes with namespaces and following PSR-4: Autoloader would be desireable. Especially reducing the risk of naming conflicts by using vendor namespaces.
However, FPDM has been around for a long time and as such is used in many projects that use non-namespaced code (I refer to them as legacy projects). Legacy projects instantiate FPDM by calling $mypdf = new FPDM() which is unqualified but defaults to the global namespace with non-namespaced code.
Using psr-4 would autoload the class to a subnamespace (e.g. \codeshell\fpdm\FPDM) instead of the global namespace (e.g. \FPDM) thus breaking any legacy code no matter if it used new FPDM() or new \FPDM().
Classmaps are a compromise. They allow taking advantage of composers autoloading and dependency management. Yet classes are added to the global namespace. Legacy projects can switch to composer without having to refactor their code. Newer projects (e.g. utilizing frameworks like laravel, that heavily rely on namespaces) can still use legacy classes by using the fully qualified name (in this case the class name prefixed with global prefix operator as in new \FPDM()).
That's my reasoning for using classmaps over psr-4 for FPDM. Please let me know if there are use cases where classmaps won't work with modern frameworks.
I added support for checkboxes. The feature is not heavily tested but works for me. Can be enabled with useCheckboxParser = true like so:
<?php
$fields = array(
'my_checkbox' => 'anything that evaluates to true.', // checkbox will be checked; Careful, that includes ANY non-empty string (even "no" or "unchecked")
'another_checkbox' => false, // checkbox will be UNchecked; empty string or 0 work as well
);
$pdf = new FPDM('template.pdf');
$pdf->useCheckboxParser = true; // Checkbox parsing is ignored (default FPDM behaviour) unless enabled with this setting
$pdf->Load($fields, true);
$pdf->Merge();
$pdf->Output();You don't have to figure out the technical names of checkbox states. They are retrieved during the parsing process.
Everything below is mirrored from http://www.fpdf.org/en/script/script93.php .
Author: Olivier
License: FPDF
This script allows to merge data into a PDF form. Given a template PDF with text fields, it's possible to inject values in two different ways:
- from a PHP array
- from an FDF file
The resulting document is produced by the Output() method, which works the same as for FPDF.
Note: if your template PDF is not compatible with this script, you can process it with PDFtk this way:
pdftk modele.pdf output modele2.pdf
Then try again with modele2.pdf.
This example shows how to merge data from an array:
<?php
/***************************
Sample using a PHP array
****************************/
$fields = array(
'name' => 'My name',
'address' => 'My address',
'city' => 'My city',
'phone' => 'My phone number'
);
$pdf = new FPDM('template.pdf');
$pdf->Load($fields, false); // second parameter: false if field values are in ISO-8859-1, true if UTF-8
$pdf->Merge();
$pdf->Output();
?>View the result here.