Kitgenix

Kitgenix PDF Invoicing for WooCommerce helps stores generate professional PDF documents from WooCommerce orders without a heavy stack.
It supports core document workflows out of the box: 
– Invoices 
– Receipts 
– Packing Slips 
– Credit Notes 
– Pro Forma Invoices 
– Delivery Notes 
– Statements
Key capabilities include: 
– Secure admin and customer downloads with nonce and capability checks 
– Batch ZIP exports from the WooCommerce orders list 
– Optional archived PDF reuse for stable re-downloads 
– Numbering controls with prefixes, padding, and reset periods 
– Rule-based document availability by status/payment state 
– Email attachment support for selected document types 
– Bundled templates with style and branding controls
The plugin is built for practical operations: support teams can quickly re-deliver documents, fulfilment teams can work with packing slips and delivery notes, and finance teams can keep consistent invoice/credit-note references.
For setup details and advanced options, see the bundled documentation and support links in this readme.
<h3>Secure Dompdf PDF rendering</h3>
<ul>
<li>Renders HTML templates into PDF (A4 portrait by default)</li>
<li>Remote fetching disabled by default</li>
<li>Dompdf “chroot” restricts filesystem access to allowed paths</li>
<li>PHP in templates disabled by default (advanced opt-in only)</li>
</ul>
<h3>Template overrides (theme and agency friendly)</h3>
Templates can be overridden without editing plugin files.
Template resolution order: 
1) Full override via filter 
2) Theme override path: 
 kitgenix-pdf-invoicing-for-woocommerce/{style}/ 
3) Plugin templates fallback: 
 templates/{style}/
Where <code>{style}</code> is the active template pack selected in settings: <code>standard</code>, <code>simple</code>, <code>modern</code>, or <code>business</code>. 
For compatibility, the resolver also checks <code>.../standard/</code> and legacy root locations if a file is not found.
<h3>Template packs</h3>
Choose between four bundled design packs: 
– Standard 
– Simple 
– Modern 
– Business
Each pack has its own document templates and stylesheet, while still using the same company details, logo, footer, notes, and colour settings from the plugin options.
<h3>Visual template designer</h3>
Non-technical stores can now reshape the bundled document layouts without editing PHP templates.
The Brand & Styling tab includes no-code controls for: 
– header alignment across the logo, company block, and document title 
– logo scale for compact or brand-led layouts 
– document density for tighter or more spacious tables and notes 
– boxed or tinted information panels around address/order-data sections 
– clean, striped, or grid-style item tables 
– boxed totals panels or highlighted final totals 
– footer alignment for legal text, bank details, or closing notes
These controls layer on top of the bundled Standard, Simple, Modern, and Business packs, so stores can fine-tune the presentation without creating a theme override.
<h3>Customer downloads (My Account)</h3>
Optional customer-facing downloads for the order owner: 
– Order details page buttons: 
 – Download Invoice (PDF) 
 – Download Credit Note (PDF) (only when refunds exist) 
– My Account → Orders table actions: 
 – View Invoice 
 – View Credit Note (when refunds exist)
Customer downloads are nonce-protected and/or can be validated by order key for guest access (see “Download permissions”).
<h3>Download permissions & security</h3>
PDF rendering supports secure query-arg requests: 
– kitgenix_pdf=1 
– kitgenix_doc={type} 
– order_id={id} 
– _wpnonce=…
Guest access (without a nonce) is permitted only when a valid WooCommerce order key is provided: 
– key= or order_key= must match the order’s key
Default per-document rules: 
– Invoice + Receipt + Pro Forma Invoice + Statement: 
 – order owner OR shop staff OR valid order key 
– Packing Slip + Delivery Note: 
 – shop staff only (by default) 
– Credit Note: 
 – staff OR order owner (only if refunds exist) OR valid order key (only if refunds exist)
Final permission gate is filterable, and document availability can also be narrowed through the built-in rules table or the <code>kitgenix_pdf_document_enabled</code> filter.
<h3>Email attachments (configurable)</h3>
Attach PDFs to WooCommerce emails using settings and filters. 
The plugin hooks WooCommerce’s email attachment pipeline, generates PDFs as temporary files for each email, attaches them, and cleans up automatically.
Sensible defaults (customisable): 
– Invoice: Processing + Completed 
– Receipt: Completed 
– Credit Note: Refunded 
– Packing Slip: New Order (admin email)
Email workflow tools in settings: 
– Preview the currently mapped document set against a specific WooCommerce order 
– Open live PDF previews for each eligible mapped document from the email settings tab 
– Send an attachment-only test email to a safe inbox before relying on the live WooCommerce workflow 
– Reuse the same mapping, eligibility checks, and PDF-generation pipeline as production email attachments
<h3>Filenames, streaming vs download</h3>
<ul>
<li>Default filename: {type}-{order_number}.pdf (filterable)</li>
<li>Streams inline by default (Attachment=false), unless filtered to force download</li>
<li>Reuses archived immutable PDFs when available before falling back to fresh rendering</li>
<li>Generates temporary files for email attachments, cleaned up automatically</li>
<li>Generates temporary ZIP archives for batch exports, cleaned up automatically</li>
<li>Tracks simple generation metrics in an option (counts successful generations)</li>
</ul>
<h3>Customisation hooks (HTML/CSS/output)</h3>
<ul>
<li>Full HTML filter</li>
<li>Wrapper hooks before/after document</li>
<li>Custom CSS injection hook</li>
<li>Language attribute filter</li>
<li>Document title/body class filters</li>
<li>“Show shipping address” toggle filter</li>
</ul>
<h3>Quick Start</h3>
<ol>
<li>Install and activate the plugin (WooCommerce required).</li>
<li>Open any WooCommerce order in wp-admin.</li>
<li>In the Kitgenix PDF Invoicing meta box, click “Download Invoice (PDF)” to confirm output.</li>
<li>Configure settings:
<ul>
<li>branding + company details</li>
<li>prefixes, numbering tokens, and fiscal-year reset rules</li>
<li>field visibility, tax detail, and custom fulfilment/order-meta rows</li>
<li>email attachments mapping</li>
</ul>
</li>
<li>Generate a document once, then reuse the same archived PDF and stored document number for later admin/customer downloads when you need immutable record keeping.</li>
<li>Use the WooCommerce orders list plus the batch ZIP bulk actions when you need invoices, packing slips, receipts, or credit notes for a filtered set of orders.</li>
<li>Optional: enable customer downloads and order table actions.</li>
</ol>
To customise layout, copy templates into your theme override folder and edit them.
<h3>Template Overrides</h3>
<ol>
<li>
Copy templates from: 
templates/{style}/
</li>
<li>
Paste into your theme at: 
kitgenix-pdf-invoicing-for-woocommerce/{style}/
</li>
<li>
Edit the theme copies.
</li>
</ol>
The plugin will automatically use your theme templates instead of bundled templates.
<h3>Developers</h3>
Text domain: 
kitgenix-pdf-invoicing-for-woocommerce
Architecture: 
– Modular plugin with Admin/Settings/Invoicing/Email/Frontend modules 
– Document types registry (extendable) with built-in invoice, receipt, packing slip, credit note, pro forma invoice, delivery note, and statement types 
– Template system with theme overrides + HTML/CSS filters 
– Secure download endpoints with nonce/capability checks and optional order key validation 
– Token-based numbering engine for invoices, receipts, packing slips, and credit notes using stored order meta and a shared sequence-counter option 
– Rule-based document availability controls by type, order status, and payment state 
– Shared template display helper for configurable order rows, note blocks, and line-item metadata across bundled document templates
Numbering tokens available in settings: 
– {prefix} 
– {order_number} 
– {order_id} 
– {sequence} 
– {refund_sequence} 
– {year} 
– {yy} 
– {month} 
– {day} 
– {country} 
– {billing_country} 
– {shipping_country} 
– {fiscal_year} 
– {fiscal_year_short} 
– {fiscal_year_start} 
– {fiscal_year_end}
Key filters: 
– kitgenix_pdf_invoicing_modules 
– kitgenix_pdf_document_types 
– kitgenix_pdf_document_enabled 
– kitgenix_pdf_document_user_can_download 
– kitgenix_pdf_document_filename 
– kitgenix_pdf_batch_archive_filename 
– kitgenix_pdf_persistent_archive_enabled 
– kitgenix_pdf_archive_relative_root 
– kitgenix_pdf_invoice_filename (back-compat) 
– kitgenix_pdf_document_attachment (inline vs download) 
– kitgenix_pdf_document_template_path 
– kitgenix_pdf_document_html 
– kitgenix_pdf_invoice_html (back-compat) 
– kitgenix_pdf_document_custom_css 
– kitgenix_pdf_document_lang 
– kitgenix_pdf_document_title 
– kitgenix_pdf_document_body_class 
– kitgenix_pdf_show_shipping_address 
– kitgenix_pdf_email_document_map 
– kitgenix_pdf_email_attach_document 
– kitgenix_dompdf_enable_php (advanced; default false)
Key actions: 
– kitgenix_before_stream_pdf_document 
– kitgenix_after_stream_pdf_document 
– kitgenix_before_stream_pdf_invoice (back-compat) 
– kitgenix_after_stream_pdf_invoice (back-compat) 
– kitgenix_pdf_document_archived 
– Template hooks: 
 – kitgenix_pdf_before_document / kitgenix_pdf_after_document 
 – kitgenix_pdf_before_document_wrapper / kitgenix_pdf_after_document_wrapper 
 – kitgenix_pdf_after_notes 
 – kitgenix_pdf_after_order_data_rows
<h3>Data Handling</h3>
<ul>
<li>Plugin settings stored in a single option: <code>kitgenix_pdf_invoicing_settings</code>.</li>
<li>Anonymous generation metrics stored in: <code>kitgenix_pdf_invoicing_for_woocommerce_metrics</code>.</li>
<li>Sequence counters for resettable numbering stored in: <code>kitgenix_pdf_invoicing_for_woocommerce_number_sequences</code>.</li>
<li>Document identifiers/history stored on the order to keep documents stable:
<ul>
<li><code>_kitgenix_pdf_invoicing_for_woocommerce_invoice_number</code></li>
<li><code>_kitgenix_pdf_invoicing_for_woocommerce_invoice_date</code></li>
<li><code>_kitgenix_pdf_invoicing_for_woocommerce_packing_slip_number</code></li>
<li><code>_kitgenix_pdf_invoicing_for_woocommerce_packing_slip_date</code></li>
<li><code>_kitgenix_pdf_invoicing_for_woocommerce_receipt_number</code></li>
<li><code>_kitgenix_pdf_invoicing_for_woocommerce_receipt_date</code></li>
<li><code>_kitgenix_pdf_invoicing_for_woocommerce_credit_note_count</code></li>
<li><code>_kitgenix_pdf_invoicing_for_woocommerce_credit_note_history</code></li>
</ul>
</li>
<li><code>_kitgenix_pdf_invoicing_for_woocommerce_archived_documents</code></li>
<li>Archived PDFs stored in uploads and reused as immutable document copies when available.</li>
<li>Batch ZIP exports generated on demand (temporary files).</li>
<li>Email attachments generated as temp files and cleaned up automatically.</li>
<li>No custom database tables created.</li>
</ul>
<h3>Security & Privacy</h3>
<ul>
<li>All admin actions protected with nonces and capability checks.</li>
<li>Inputs sanitised; outputs escaped appropriately.</li>
<li>Dompdf PHP execution disabled by default. Enable only if you understand the risk: 
add_filter( ‘kitgenix_dompdf_enable_php’, ‘__return_true’ );</li>
</ul>
Security identifiers (exact): 
– Admin meta box downloads use <code>admin-post.php</code> actions <code>kitgenix_admin_stream_invoice</code>, <code>kitgenix_admin_stream_receipt</code>, <code>kitgenix_admin_stream_packing_slip</code>, <code>kitgenix_admin_stream_credit_note</code>, <code>kitgenix_admin_stream_pro_forma_invoice</code>, <code>kitgenix_admin_stream_delivery_note</code>, and <code>kitgenix_admin_stream_statement</code>, protected by query arg <code>nonce</code> created/verified with nonce action <code>kitgenix_admin_pdf</code>. 
– WordPress action hooks for those admin-post actions: <code>admin_post_kitgenix_admin_stream_invoice</code>, <code>admin_post_kitgenix_admin_stream_receipt</code>, <code>admin_post_kitgenix_admin_stream_packing_slip</code>, <code>admin_post_kitgenix_admin_stream_credit_note</code>, <code>admin_post_kitgenix_admin_stream_pro_forma_invoice</code>, <code>admin_post_kitgenix_admin_stream_delivery_note</code>, and <code>admin_post_kitgenix_admin_stream_statement</code>. 
– Frontend document downloads use the optional <code>_wpnonce</code> value created/verified with nonce action <code>kitgenix_download_{doc_type}_{order_id}</code>. 
– WooCommerce order action key: <code>kitgenix_download_pdf_invoice</code> (hook: <code>woocommerce_order_action_kitgenix_download_pdf_invoice</code>). 
– WooCommerce bulk action keys: <code>kitgenix_pdf_batch_export_invoice</code>, <code>kitgenix_pdf_batch_export_packing_slip</code>, <code>kitgenix_pdf_batch_export_receipt</code>, <code>kitgenix_pdf_batch_export_credit_note</code>, <code>kitgenix_pdf_batch_export_pro_forma_invoice</code>, <code>kitgenix_pdf_batch_export_delivery_note</code>, and <code>kitgenix_pdf_batch_export_statement</code>.
Admin page hook suffix: 
– <code>kitgenix_page_kitgenix-pdf-invoicing-settings</code>
PDF generation is performed locally on your server using Dompdf. This plugin does not send customer data to a third-party PDF generation API.
<h3>External Services</h3>
This plugin includes a shared “Kitgenix hub” component in wp-admin which may fetch publicly available plugin metadata from WordPress.org using WordPress core’s <code>plugins_api()</code> function.
Caching: 
– Transient: <code>kitgenix_hub_wporg_active_installs_v1</code> 
– Transient: <code>kitgenix_hub_wporg_ratings_v1</code> 
– Transient: <code>kitgenix_hub_wporg_media_v1</code>
<h3>Uninstall</h3>
Uninstall removes the plugin settings option (<code>kitgenix_pdf_invoicing_settings</code>), metrics option (<code>kitgenix_pdf_invoicing_for_woocommerce_metrics</code>), and numbering sequence option (<code>kitgenix_pdf_invoicing_for_woocommerce_number_sequences</code>) when uninstalled via WordPress. 
It also deletes the activation redirect transient: <code>kitgenix_pdf_invoicing_for_woocommerce_do_activation_redirect</code>. 
Order meta, archived document metadata, and archived PDF files are intentionally preserved to avoid accidental loss of invoice, receipt, packing slip, or credit note history.
<h3>Support Development</h3>
If this plugin helps you generate clean WooCommerce PDFs and reduces admin work, you can support ongoing development here: 
https://buymeacoffee.com/kitgenix
<h3>Credits</h3>
Built with ❤︎ by @kitgenix – https://kitgenix.com 
Bundled library: Dompdf (see vendor/ for licenses)

Kitgenix PDF Invoicing for WooCommerce

Generate WooCommerce PDF invoices, receipts, packing slips, and credit notes with secure downloads, templates, and email attachments.

Faveren Caleb

Seris Order Manager (PDF Receipts and Packing Slips)


This plugin really works great and is easy to set up.I filled in a couple of fields, added a logo, and got a cool PDF receipt with the order confirmation.I also really like the addition of QR codes that let you track the order.Definitely recommend installing Seris Order Manager.


Easy setup, great features, and perfect PDF receipts

Elevate your WooCommerce store's order processing with customized receipts and packing slips, complete with QR and barcodes for efficient tracking.

Kitgenix PDF Invoicing for WooCommerce vs Seris Order Manager (PDF Receipts and Packing Slips)