diff --git a/README.txt b/README.txt index 2ceb688109daad4b71b8dd866dc38ff545d7e008..301df6e8596568056a9391773674c262802d8f50 100644 --- a/README.txt +++ b/README.txt @@ -15,31 +15,31 @@ There are three steps to setting up a form with Fill PDF: (1) creating the webfo 1. To create the webform/content-type wherein users will enter data. Options: * Use CCK * Use webform (see #374121: Webform Support) - + 2. To map the webform to a PDF, do the following: - 1. Go to /admin/content/fillpdf + 1. Go to /admin/structure/fillpdf 2. Upload a PDF template, a form mapping will be generated [2] 3. When editing fields, note the following: * "Label" is for your own use in identifying fields * "PDF Key" is the field-name from the original PDF Form (such as text_field_1) and is the piece that maps the form-field to the PDF field * "Value" is where you either enter static data to populate the field, or token-data to pull information form the users' forms. For example, if I created a CCK form with a text-field called field_first_name, then I would enter [field-field_first_name-raw] here. There is a list of tokens you can use at the bottom of that page. - - 3. Once your user fills a form, they'll need a link to download their PDF. You can place this link in a block, .tpl.php, or anywhere. - The link will need (1) The form-id (you can see an example URL on your form's edit-page), (2) the node-id, and/or (3) the webform's node-id and optionally its submission-id (defaults to latest-submission if none provided) + + 3. Once your user fills a form, they'll need a link to download their PDF. You can place this link in a block, .tpl.php, or anywhere. + The link will need (1) The form-id (you can see an example URL on your form's edit-page), (2) the node-id, and/or (3) the webform's node-id and optionally its submission-id (defaults to latest-submission if none provided) Here are some ways to generate the link: * Add the link in PHP (recommended). Examples: * One-node link: <?php echo l("PDF", fillpdf_pdf_link($form_id = 1, $node_id = 2)); ?> * One-webform link (common): <?php echo l("PDF", fillpdf_pdf_link($form_id = 1, null, $webform = array('nid'=>3,'sid'=>4))); ?> * Multiple nodes & webforms, later nids override conflicting fields (note: webforms without 'sid' default to latest submission) <?php echo l("PDF", fillpdf_pdf_link($form_id = 1, $nids = array(1,2), $webforms = array( array('nid'=>3,'sid'=>1), array('nid'=>3))); ?> - * Add the link manually in HTML. Examples: + * Add the link manually in HTML. Examples: * One-node link: <a href="/fillpdf&fid=1&nid=2">PDF</a> [3] - * One-webform link: <a href="/fillpdf&fid=1&webform[nid]=3&webform[sid]=4">PDF</a> + * One-webform link: <a href="/fillpdf&fid=1&webform[nid]=3&webform[sid]=4">PDF</a> * Multiple nodes & webforms, later nids override conflicting fields (note: webforms without 'sid' default to latest submission) <a href="/fillpdf&fid=1&nids[]=1&nids[]=2&webforms[0][nid]=3&webforms[0][sid]=1&webforms[1][nid]=3">PDF</a> Notes: - [1] http://fillpdf-service.com + [1] http://fillpdf-service.com [2] Make sure the PDF document isn't encrypted. If it is encrypted and non copy-righted (typical of government PDFs), then try a decrypting tool like "Advanced PDF Password Recovery". If you upload an encrypted PDF, you will have empty PDFs when you attempt to download your submissions. [3] If clean URLs is not enabled, the URL will be in the format: /?q=fillpdf&fid=10&nid=10