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.

primersoftware

<p>Convert your e-shop orders to legal receipts and invoices directly from your wordpress website! No external ERP, fiscal machine or cash register is required!<br />
Only for Greek e-shops<br />
Works with woocommerse<br />
Compatibility with other e-shops coming soon!</p>
<p><strong>Needs an active MyData subscription service to work. <a href="https://primer.gr/plugin/" rel="nofollow ugc">Get MyData subscription here</a></strong></p>
<ul>
<li>Easy conversion of woocommerse orders to receipts/invoices</li>
<li>No MyData setup is needed – Works out of the box!</li>
<li>Free up time and cost from having to issue receipts/invoices manually</li>
<li>No external ERP/fiscal machine/Cash Register required!</li>
<li>No complicated connections with external software</li>
<li>Plugin automatically understands and issues the correct document (receipt/invoice/invoice within E.U./invoice outside E.U.</li>
</ul>
<h4>Features</h4>
<ul>
<li>Plugin is free (Needs MyData service to work)</li>
<li>Orders management</li>
<li>Receipts Management</li>
<li>Issue Receipts/Invoices/Invoices within E.U./Invoices outside E.U.</li>
<li>Manual conversion of orders to receipts/invoices</li>
<li>Automatic conversion of orders to receipts/invoices based on rules (when order status is “x”, issue receipt)</li>
<li>Connection to Primer MyData services</li>
<li>Automatically send receipt/invoice to email to the client using Primer Email servers</li>
<li>Checkout options (Receipt/Invoice)</li>
<li>Smtp options and Email builder – send the receipt your way!</li>
<li>Automatically export receipts/invoices to email/server</li>
<li>Connection with external software using export can be automated</li>
<li>Automatic MyData characterizations</li>
<li>Invoice/Receipt templates</li>
<li>Test environment to emulate the sending to AADE before sending to production environment</li>
<li>Easy to use interface</li>
</ul>
<h4>Translations</h4>
<ul>
<li>English </li>
<li>Greek</li>
</ul>


Primer MyData for Woocommerce

Issue legal receipts automatically directly from your wordpress using MyData provider Services.

Kitgenix PDF Invoicing for WooCommerce vs Primer MyData for Woocommerce