Kitgenix

<p>Most WooCommerce stores eventually need proper order documents.</p>
<p>You might need a PDF invoice for accounting, a receipt for the customer, a packing slip for fulfilment, or a credit note when a refund is issued. You also want documents that look professional, match your branding, and work reliably across WooCommerce email flows.</p>
<p><strong>Kitgenix PDF Invoicing for WooCommerce</strong> is a lightweight, security-first PDF invoicing plugin that generates WooCommerce order PDFs on demand — without heavy background queues, and without filling your uploads folder with permanently stored PDFs.</p>
<p>It’s built around practical store requirements:<br />
– Stable document identifiers/numbering history (so regenerated PDFs stay consistent)<br />
– Secure Dompdf rendering defaults (chrooted paths, remote disabled by default, PHP in templates disabled by default)<br />
– Theme template overrides and developer hooks<br />
– Clean admin preview/download workflow on the order screen<br />
– Customer “My Account” download buttons and order table actions (optional)<br />
– Configurable WooCommerce email attachments that clean up temp files automatically</p>
<h4>Important: Dompdf dependency</h4>
<p>This plugin uses <strong>Dompdf</strong> (installed as a Composer dependency). If you are building from source, you must run Composer so the <code>vendor/</code> directory (Dompdf) is present. The WordPress.org release includes the required library.</p>
<h4>Documents generated (built-in types)</h4>
<ul>
<li>Invoice (PDF)</li>
<li>Receipt (PDF)</li>
<li>Packing Slip (PDF)</li>
<li>Credit Note (PDF) (only available when refunds exist)</li>
</ul>
<p>Document types are registered in a document registry and can be extended via filters.</p>
<h4>Why store owners choose Kitgenix PDF Invoicing</h4>
<p><strong>Secure by default</strong><br />
– Dompdf configured with strict defaults:<br />
  – chroot limited to allowed paths<br />
  – remote resource fetching disabled by default<br />
  – PHP execution inside templates disabled by default (opt-in only)<br />
– All admin/customer download actions are protected with nonces and permission checks.</p>
<p><strong>No bloat</strong><br />
– PDFs are generated only when needed.<br />
– Email attachments are created as temporary files and automatically cleaned up at shutdown.<br />
– No custom database tables.</p>
<p><strong>Built for WooCommerce documents</strong><br />
– Refund-aware credit notes<br />
– Email attachment mapping<br />
– Customer download links in the right places<br />
– Store-friendly templates and template override system</p>
<p><strong>Modular + extensible</strong><br />
Modules (Admin / Settings / Invoicing / Email / Frontend) are registered through a module manager and can be filtered for extension.</p>
<h4>Features</h4>
<h3>Admin settings (branding, numbering, styles)</h3>
<p>Settings page under the shared Kitgenix menu includes:<br />
– Company name, address, email/phone, tax ID<br />
– Logo upload (WordPress media)<br />
– Footer text and customer notes/footer notes<br />
– Document prefixes:<br />
  – Invoice prefix<br />
  – Receipt prefix<br />
  – Credit note prefix<br />
– Template style selector (Standard / Simple / Modern / Business)<br />
– Colour settings:<br />
  – Primary colour<br />
  – Accent colour<br />
  – Text colour<br />
  – Muted text colour<br />
  – Border colour<br />
  – Table header background<br />
  – Document background<br />
  – Footer background<br />
  – Footer text colour</p>
<h3>Admin order meta box (preview + PDF downloads)</h3>
<p>On WooCommerce order edit screens the plugin adds document actions:<br />
– Download Invoice (PDF)<br />
– Download Packing Slip (PDF)<br />
– Download Receipt (PDF)<br />
– Download Credit Note (PDF) (only shown when refunds exist)</p>
<p>Endpoints are secured using nonce + capability checks.</p>
<h3>Stable document identifiers & history</h3>
<p>For documents that require stable numbering (invoices/credit notes), the plugin persists document identifiers and relevant timestamps on first generation so the document remains consistent over time.</p>
<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>
<p>Templates can be overridden without editing plugin files.</p>
<p>Template resolution order:<br />
1) Full override via filter<br />
2) Theme override path:<br />
  kitgenix-pdf-invoicing-for-woocommerce/{style}/<br />
3) Plugin templates fallback:<br />
  templates/{style}/</p>
<p>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>.<br />
For compatibility, the resolver also checks <code>.../standard/</code> and legacy root locations if a file is not found.</p>
<h3>Customer downloads (My Account)</h3>
<p>Optional customer-facing downloads for the order owner:<br />
– Order details page buttons:<br />
  – Download Invoice (PDF)<br />
  – Download Credit Note (PDF) (only when refunds exist)<br />
– My Account <span aria-hidden="true" class="wp-exclude-emoji">→</span> Orders table actions:<br />
  – View Invoice<br />
  – View Credit Note (when refunds exist)</p>
<p>Customer downloads are nonce-protected and/or can be validated by order key for guest access (see “Download permissions”).</p>
<h3>Download permissions & security</h3>
<p>PDF rendering supports secure query-arg requests:<br />
– kitgenix_pdf=1<br />
– kitgenix_doc={type}<br />
– order_id={id}<br />
– _wpnonce=…</p>
<p>Guest access (without a nonce) is permitted only when a valid WooCommerce order key is provided:<br />
– key= or order_key= must match the order’s key</p>
<p>Default per-document rules:<br />
– Invoice + Receipt:<br />
  – order owner OR shop staff OR valid order key<br />
– Packing Slip:<br />
  – shop staff only (by default)<br />
– Credit Note:<br />
  – staff OR order owner (only if refunds exist) OR valid order key (only if refunds exist)</p>
<p>Final permission gate is filterable.</p>
<h3>Email attachments (configurable)</h3>
<p>Attach PDFs to WooCommerce emails using settings and filters.<br />
The plugin hooks WooCommerce’s email attachment pipeline, generates PDFs as temporary files for each email, attaches them, and cleans up automatically.</p>
<p>Sensible defaults (customisable):<br />
– Invoice: Processing + Completed<br />
– Receipt: Completed<br />
– Credit Note: Refunded<br />
– Packing Slip: New Order (admin email)</p>
<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>Generates temporary files for email attachments, 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</li>
<li>email attachments mapping</li>
</ul>
</li>
<li>Optional: enable customer downloads and order table actions.</li>
</ol>
<p>To customise layout, copy templates into your theme override folder and edit them.</p>
<h3>Template Overrides</h3>
<ol>
<li>
<p>Copy templates from:<br />
templates/{style}/</p>
</li>
<li>
<p>Paste into your theme at:<br />
kitgenix-pdf-invoicing-for-woocommerce/{style}/</p>
</li>
<li>
<p>Edit the theme copies.</p>
</li>
</ol>
<p>The plugin will automatically use your theme templates instead of bundled templates.</p>
<h3>Developers</h3>
<p>Text domain:<br />
kitgenix-pdf-invoicing-for-woocommerce</p>
<p>Architecture:<br />
– Modular plugin with Admin/Settings/Invoicing/Email/Frontend modules<br />
– Document types registry (extendable)<br />
– Template system with theme overrides + HTML/CSS filters<br />
– Secure download endpoints with nonce/capability checks and optional order key validation</p>
<p>Key filters:<br />
– kitgenix_pdf_invoicing_modules<br />
– kitgenix_pdf_document_types<br />
– kitgenix_pdf_document_enabled<br />
– kitgenix_pdf_document_user_can_download<br />
– kitgenix_pdf_document_filename<br />
– kitgenix_pdf_invoice_filename (back-compat)<br />
– kitgenix_pdf_document_attachment (inline vs download)<br />
– kitgenix_pdf_document_template_path<br />
– kitgenix_pdf_document_html<br />
– kitgenix_pdf_invoice_html (back-compat)<br />
– kitgenix_pdf_document_custom_css<br />
– kitgenix_pdf_document_lang<br />
– kitgenix_pdf_document_title<br />
– kitgenix_pdf_document_body_class<br />
– kitgenix_pdf_show_shipping_address<br />
– kitgenix_pdf_email_document_map<br />
– kitgenix_pdf_email_attach_document<br />
– kitgenix_dompdf_enable_php (advanced; default false)</p>
<p>Key actions:<br />
– kitgenix_before_stream_pdf_document<br />
– kitgenix_after_stream_pdf_document<br />
– kitgenix_before_stream_pdf_invoice (back-compat)<br />
– kitgenix_after_stream_pdf_invoice (back-compat)<br />
– Template hooks:<br />
  – kitgenix_pdf_before_document / kitgenix_pdf_after_document<br />
  – kitgenix_pdf_before_document_wrapper / kitgenix_pdf_after_document_wrapper<br />
  – kitgenix_pdf_after_notes<br />
  – kitgenix_pdf_after_order_data_rows</p>
<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>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_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>PDFs 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:<br />
add_filter( ‘kitgenix_dompdf_enable_php’, ‘__return_true’ );</li>
</ul>
<p>Security identifiers (exact):<br />
– 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>, protected by query arg <code>nonce</code> created/verified with nonce action <code>kitgenix_admin_pdf</code>.<br />
– 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>.<br />
– Frontend document downloads use the optional <code>_wpnonce</code> value created/verified with nonce action <code>kitgenix_download_{doc_type}_{order_id}</code>.<br />
– WooCommerce order action key: <code>kitgenix_download_pdf_invoice</code> (hook: <code>woocommerce_order_action_kitgenix_download_pdf_invoice</code>).</p>
<p>Admin page hook suffix:<br />
– <code>kitgenix_page_kitgenix-pdf-invoicing-settings</code></p>
<p>PDF generation is performed locally on your server using Dompdf. This plugin does not send customer data to a third-party PDF generation API.</p>
<h3>External Services</h3>
<p>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.</p>
<p>Caching:<br />
– Transient: <code>kitgenix_hub_wporg_active_installs_v1</code><br />
– Transient: <code>kitgenix_hub_wporg_ratings_v1</code></p>
<h3>Uninstall</h3>
<p>Uninstall removes the plugin settings option (<code>kitgenix_pdf_invoicing_settings</code>) and metrics option (<code>kitgenix_pdf_invoicing_for_woocommerce_metrics</code>) when uninstalled via WordPress.<br />
It also deletes the activation redirect transient: <code>kitgenix_pdf_invoicing_for_woocommerce_do_activation_redirect</code>.<br />
Order meta and document history are intentionally preserved to avoid accidental loss of invoice/credit note history.</p>
<h3>Support Development</h3>
<p>If this plugin helps you generate clean WooCommerce PDFs and reduces admin work, you can support ongoing development here:<br />
https://donate.stripe.com/9B65kDgG3fTQ2Kzcmwf7i00</p>
<h3>Credits</h3>
<p>Built with ❤︎ by @kitgenix – https://kitgenix.com<br />
Bundled library: Dompdf (see vendor/ for licenses)</p>


Kitgenix PDF Invoicing for WooCommerce

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

Oliver Campion

<h4>Manage your accounts in WordPress</h4>
<p>If you are a UK company that is not VAT registered, you may want to use our plugin …</p>
<p>This plugin does the following:</p>
<ul>
<li>Manages your clients and their contact details</li>
<li>Allows you to raise invoices and receipts</li>
<li>View client statements</li>
<li>Manage your payments / bookkeeping</li>
<li>Send invoices and receipts to clients via email</li>
<li>Style email invoices / receipts</li>
<li>Download HTML statements</li>
<li>Download CSV reports</li>
<li>Assign a client to a WordPress user account so they can view their account statements</li>
<li>Integrate with WooCommerce to allow clients to pay by Paypal, Stripe etc</li>
</ul>
<p>When installed you will be able to manage your company accounts from within your WordPress website.</p>
<p>We have built this plugin for a UK based company that is not VAT registered. If you’d like us to develop it further to fit your business, contact us!</p>


Web:D Accounts

A little back story so you know how much finding this plugin has meant. I had cancer in 2015 survived and now 7 years on I am completely clear but the cancer op left its damage and I find it hard to do a full time job. I am a youth worker by trade and I am currently working 21 hours a week and doing a little web dev in the background to try to make ends meet. We were paying for an accounting system but with bills going up even this had to go which meant a struggle to do accounts....

And then I found this plugin and it works very well and exactly how I need it to work. The menu system is simple and intuitive and doesn't take very long to figure out. It does repetitive invoicing which fits with my business model perfectly. So many invoicing systems come with add-ons that were unnecessary. This doesn't. It helps in making managing a small business even easier. 

It has been a huge blessing and I cannot thank Oliver (the developer) enough.


Perfectly Simple


its look like an beginner developer with "hello world" app



bad interface



bad data validation






very bad plugin

Manage your Clients, Invoices, Receipts and Payments. Send Invoices and Receipts to clients via email.

Kitgenix PDF Invoicing for WooCommerce vs Web:D Accounts