=== EntryFoundry - PDF Builder for Formidable Forms ===
Contributors: entryfoundry
Tags: formidable forms, pdf builder, pdf generator, certificates, invoices
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 0.1.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Visual PDF builder for Formidable Forms. Create branded certificates, invoices, reports, and PDFs from form entries without code.

== Description ==

EntryFoundry is a visual PDF builder and PDF generator for Formidable Forms. Create branded certificates, invoices, receipts, and reports from form entries without writing code.

Arrange fields and design elements on a page, preview the document with a real Formidable entry, and publish it without writing a custom PDF template.

= Included in EntryFoundry Free =

* Visual drag-and-drop PDF builder inside WordPress.
* Live previews using an entry from the selected Formidable form.
* Formidable field values placed directly onto the document canvas.
* Heading, text, image, shape, manual-table, and entries-table elements.
* Three starter designs: Certificate, Document / Report, and Receipt / Simple Invoice.
* Fixed-page designs and flowing reports that continue onto additional pages.
* A4 portrait and landscape layouts with background colors and Media Library images.
* Typography, positioning, sizing, alignment, table styling, and image-fit controls.
* Private, capability-gated, and signed-token document access modes.
* Shortcodes for PDF downloads, embedded PDF viewing, and inline HTML output.
* Shortcodes that can be placed on pages or inside Formidable Views.
* Automatic PDF generation after a new entry is created, with support for email attachments.
* A Generate / Test PDF screen for checking a template and entry before publishing.

= EntryFoundry Pro roadmap =

EntryFoundry Pro is in development and is not yet available on WordPress.org. The planned Pro edition builds on the Free visual builder with:

* QR code and barcode elements with entry-aware values.
* Embedded shortcode elements with Formidable entry-token resolution.
* Conditional element visibility.
* Advanced date formatting.
* Repeater fields rendered as tables or lists, including multi-page flow and totals.
* Advanced entries-table controls, row visibility, and value-column calculations.
* Invoice, ID Card, and Ticket / Pass document profiles.
* Eleven additional premade designs for certificates, reports, invoices, ID cards, and event tickets.
* Flow trailers that keep totals, signatures, QR codes, and footers after variable-length content.

Planned features may change before the Pro release. No Pro purchase is required to use the Free features listed above.

= Where documents can appear =

EntryFoundry templates can provide:

* A PDF download link.
* An embedded PDF viewer.
* Inline HTML document output.
* A document inside a Formidable View.
* A PDF generated after form submission and attached to the request-time email workflow.

EntryFoundry is an independent product and is not affiliated with, endorsed by, or sponsored by Strategy11 or Formidable Forms. Formidable Forms is a trademark of its respective owner.

== Installation ==

1. Install and activate Formidable Forms.
2. Install EntryFoundry from the WordPress plugin directory and activate it.
3. Create a Formidable form and submit at least one test entry.
4. Go to **EntryFoundry > Add New EntryFoundry Template**.
5. Choose a starter design or blank profile, then select the Formidable form and a preview entry.
6. Map suggested fields when using a starter design.
7. Drag fields and elements onto the canvas and adjust their properties.
8. Save the template and copy its shortcode from the builder or EntryFoundry template list.

== Getting Started ==

= Create your first document =

1. Open **EntryFoundry > Add New EntryFoundry Template**.
2. Choose Certificate, Document / Report, or Receipt / Simple Invoice.
3. Select the Formidable form that supplies the document data.
4. Choose an entry to use for the live preview.
5. Add or reposition fields, text, images, shapes, and tables.
6. Set the page background and document access mode.
7. Save the template.
8. Place the generated shortcode on a page or in a Formidable View.

= Test a PDF manually =

Go to **EntryFoundry > Generate / Test PDF**, enter the EntryFoundry template ID and Formidable entry ID, and click **Generate PDF**. Use the resulting download link to inspect the document.

= Shortcode examples =

The shortcode shown beside each template creates a PDF download link:

`[entryfoundry_template id="123" entry="[id]"]`

Render the document as inline HTML:

`[entryfoundry_template id="123" entry="[id]" output="html"]`

Embed the PDF viewer:

`[entryfoundry_template id="123" entry="[id]" output="view"]`

You can also use the dedicated output shortcodes:

`[entryfoundry_download id="123" entry="[id]" label="Download PDF"]`

`[entryfoundry_view id="123" entry="[id]"]`

Replace `123` with the EntryFoundry template ID. In a Formidable View, `[id]` resolves to the current entry ID.

== Frequently Asked Questions ==

= Does EntryFoundry require Formidable Forms? =

Yes. EntryFoundry is specifically built to turn Formidable Forms entries into documents.

= How do I create a PDF from a Formidable Forms entry? =

Create an EntryFoundry template, select the Formidable form and a preview entry, arrange the document in the visual builder, then publish it with a shortcode. EntryFoundry hydrates the template with the selected form entry when it generates the PDF.

= Do I need EntryFoundry Pro to build PDFs? =

No. EntryFoundry Free includes the visual builder, three starter designs, standard fields and elements, flowing reports, shortcodes, secure document links, PDF generation, and email-attachment support.

= Which Formidable fields work in the Free version? =

Fields made available by the base Formidable Forms field registry can be placed in Free documents. Fields identified by Formidable as Pro-only are clearly marked **Pro** in the EntryFoundry builder and are reserved for the planned EntryFoundry Pro integration.

= Can EntryFoundry generate certificates and invoices? =

Yes. EntryFoundry Free includes starter designs for certificates, documents, reports, receipts, and simple invoices. Each design can be customized with Formidable field values, text, images, shapes, and tables.

= Can I show a PDF instead of only providing a download? =

Yes. Use `output="view"` to embed a PDF viewer or `output="html"` to render the hydrated document as HTML.

= Can I use EntryFoundry inside a Formidable View? =

Yes. Add the generated EntryFoundry shortcode to a Formidable View and use `entry="[id]"` so each row uses its current entry.

= Can generated PDFs be attached to Formidable emails? =

Yes. When a published EntryFoundry template is active for the submitted form, EntryFoundry generates the PDF after entry creation and makes it available to the request-time WordPress email workflow.

= Where do I find the template ID? =

Go to **EntryFoundry** in WordPress. The template list includes a complete shortcode containing the template ID.

= Is EntryFoundry Pro available now? =

Not yet. The Pro roadmap describes features currently being prepared and does not represent a purchasable WordPress.org add-on at this time.

== Screenshots ==

1. Build a course completion certificate from a Formidable form and preview live student and course data.
2. Customize the certificate with Free elements including headings, text, images, shapes, and tables.
3. Manage the certificate template, source form, document profile, and ready-to-copy shortcode from one screen.
4. Generate and test the completed certificate PDF using a real Formidable entry.

== Privacy ==

EntryFoundry Free generates and renders documents on your WordPress site. It does not send Formidable entry data to an external EntryFoundry document-generation service.

EntryFoundry includes the WordPress.org-compliant Freemius SDK for optional usage tracking, account management, and add-on licensing. The opt-in screen explains the information Freemius receives, and you can skip data sharing. Formidable form entries and generated document content are not sent to Freemius.

== Changelog ==

= 0.1.3 =
* Added the Freemius parent integration required for EntryFoundry Pro licensing, account management, and add-on updates.
* Preserved the responsive embedded PDF viewer behavior introduced in version 0.1.2.

= 0.1.2 =
* Fixed embedded PDF viewers so they use responsive page width and a practical viewport height.
* Improved the plugin description, tags, and FAQ language to make supported PDF use cases easier to find.

= 0.1.1 =
* Added WordPress.org listing screenshots.
* Expanded installation, usage, shortcode, and FAQ documentation.
* Clarified the features included in EntryFoundry Free and the planned EntryFoundry Pro roadmap.

= 0.1.0 =
* Initial EntryFoundry Free release.
