Adds localization, tax, and legal formatting packs, additional document types with rule-based availability, a visual template designer, email attachment preview\/test-send tools, advanced document numbering, expanded document-field controls, immutable archived PDFs, and WooCommerce batch ZIP exports.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3465420,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3465420,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3465420,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3465420,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0","1.0.1","1.0.3","1.0.4","1.0.5","1.0.6","1.1.0","1.1.1","1.1.2"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3525580,"resolution":"1","location":"assets","locale":"","width":2696,"height":1462},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3525580,"resolution":"2","location":"assets","locale":"","width":2696,"height":1462},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3525580,"resolution":"3","location":"assets","locale":"","width":3020,"height":1548},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3525580,"resolution":"4","location":"assets","locale":"","width":3020,"height":1548},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3525580,"resolution":"5","location":"assets","locale":"","width":3020,"height":1428}},"screenshots":{"1":"Settings: branding, company details, prefixes, styles, colours, and email attachment mapping.","2":"WooCommerce order screen: admin meta box with download actions.","3":"Generated PDF invoice streamed in the browser.","4":"Credit note actions shown when refunds exist.","5":"Customer order view: Download Invoice \/ Credit Note buttons (when enabled)."}},"plugin_section":[],"plugin_tags":[16236,55959,1764,26411,286],"plugin_category":[45],"plugin_contributors":[246171],"plugin_business_model":[],"class_list":["post-270053","plugin","type-plugin","status-publish","hentry","plugin_tags-invoices","plugin_tags-packing-slips","plugin_tags-pdf","plugin_tags-receipts","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-kitgenix","plugin_committers-kitgenix"],"banners":{"banner":"https:\/\/ps.w.org\/kitgenix-pdf-invoicing-for-woocommerce\/assets\/banner-772x250.png?rev=3465420","banner_2x":"https:\/\/ps.w.org\/kitgenix-pdf-invoicing-for-woocommerce\/assets\/banner-1544x500.png?rev=3465420","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/kitgenix-pdf-invoicing-for-woocommerce\/assets\/icon-128x128.png?rev=3465420","icon_2x":"https:\/\/ps.w.org\/kitgenix-pdf-invoicing-for-woocommerce\/assets\/icon-256x256.png?rev=3465420","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/kitgenix-pdf-invoicing-for-woocommerce\/assets\/screenshot-1.png?rev=3525580","caption":"Settings: branding, company details, prefixes, styles, colours, and email attachment mapping."},{"src":"https:\/\/ps.w.org\/kitgenix-pdf-invoicing-for-woocommerce\/assets\/screenshot-2.png?rev=3525580","caption":"WooCommerce order screen: admin meta box with download actions."},{"src":"https:\/\/ps.w.org\/kitgenix-pdf-invoicing-for-woocommerce\/assets\/screenshot-3.png?rev=3525580","caption":"Generated PDF invoice streamed in the browser."},{"src":"https:\/\/ps.w.org\/kitgenix-pdf-invoicing-for-woocommerce\/assets\/screenshot-4.png?rev=3525580","caption":"Credit note actions shown when refunds exist."},{"src":"https:\/\/ps.w.org\/kitgenix-pdf-invoicing-for-woocommerce\/assets\/screenshot-5.png?rev=3525580","caption":"Customer order view: Download Invoice \/ Credit Note buttons (when enabled)."}],"raw_content":"\n
Kitgenix PDF Invoicing for WooCommerce helps stores generate professional PDF documents from WooCommerce orders without a heavy stack.<\/p>\n\n
It supports core document workflows out of the box:\n- Invoices\n- Receipts\n- Packing Slips\n- Credit Notes\n- Pro Forma Invoices\n- Delivery Notes\n- Statements<\/p>\n\n
Key capabilities include:\n- Secure admin and customer downloads with nonce and capability checks\n- Batch ZIP exports from the WooCommerce orders list\n- Optional archived PDF reuse for stable re-downloads\n- Numbering controls with prefixes, padding, and reset periods\n- Rule-based document availability by status\/payment state\n- Email attachment support for selected document types\n- Bundled templates with style and branding controls<\/p>\n\n
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.<\/p>\n\n
For setup details and advanced options, see the bundled documentation and support links in this readme.<\/p>\n\n
Templates can be overridden without editing plugin files.<\/p>\n\n
Template resolution order:\n1) Full override via filter\n2) Theme override path:\n kitgenix-pdf-invoicing-for-woocommerce\/{style}\/\n3) Plugin templates fallback:\n templates\/{style}\/<\/p>\n\n
Where Choose between four bundled design packs:\n- Standard\n- Simple\n- Modern\n- Business<\/p>\n\n 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.<\/p>\n\n Non-technical stores can now reshape the bundled document layouts without editing PHP templates.<\/p>\n\n The Brand & Styling tab includes no-code controls for:\n- header alignment across the logo, company block, and document title\n- logo scale for compact or brand-led layouts\n- document density for tighter or more spacious tables and notes\n- boxed or tinted information panels around address\/order-data sections\n- clean, striped, or grid-style item tables\n- boxed totals panels or highlighted final totals\n- footer alignment for legal text, bank details, or closing notes<\/p>\n\n 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.<\/p>\n\n Optional customer-facing downloads for the order owner:\n- Order details page buttons:\n - Download Invoice (PDF)\n - Download Credit Note (PDF) (only when refunds exist)\n- My Account \u2192 Orders table actions:\n - View Invoice\n - View Credit Note (when refunds exist)<\/p>\n\n Customer downloads are nonce-protected and\/or can be validated by order key for guest access (see \u201cDownload permissions\u201d).<\/p>\n\n PDF rendering supports secure query-arg requests:\n- kitgenix_pdf=1\n- kitgenix_doc={type}\n- order_id={id}\n- _wpnonce=...<\/p>\n\n Guest access (without a nonce) is permitted only when a valid WooCommerce order key is provided:\n- key= or order_key= must match the order\u2019s key<\/p>\n\n Default per-document rules:\n- Invoice + Receipt + Pro Forma Invoice + Statement:\n - order owner OR shop staff OR valid order key\n- Packing Slip + Delivery Note:\n - shop staff only (by default)\n- Credit Note:\n - staff OR order owner (only if refunds exist) OR valid order key (only if refunds exist)<\/p>\n\n Final permission gate is filterable, and document availability can also be narrowed through the built-in rules table or the Attach PDFs to WooCommerce emails using settings and filters.\nThe plugin hooks WooCommerce\u2019s email attachment pipeline, generates PDFs as temporary files for each email, attaches them, and cleans up automatically.<\/p>\n\n Sensible defaults (customisable):\n- Invoice: Processing + Completed\n- Receipt: Completed\n- Credit Note: Refunded\n- Packing Slip: New Order (admin email)<\/p>\n\n Email workflow tools in settings:\n- Preview the currently mapped document set against a specific WooCommerce order\n- Open live PDF previews for each eligible mapped document from the email settings tab\n- Send an attachment-only test email to a safe inbox before relying on the live WooCommerce workflow\n- Reuse the same mapping, eligibility checks, and PDF-generation pipeline as production email attachments<\/p>\n\n To customise layout, copy templates into your theme override folder and edit them.<\/p>\n\n Copy templates from:\ntemplates\/{style}\/<\/p><\/li>\n Paste into your theme at:\nkitgenix-pdf-invoicing-for-woocommerce\/{style}\/<\/p><\/li>\n Edit the theme copies.<\/p><\/li>\n<\/ol>\n\n The plugin will automatically use your theme templates instead of bundled templates.<\/p>\n\n Text domain:\nkitgenix-pdf-invoicing-for-woocommerce<\/p>\n\n Architecture:\n- Modular plugin with Admin\/Settings\/Invoicing\/Email\/Frontend modules\n- Document types registry (extendable) with built-in invoice, receipt, packing slip, credit note, pro forma invoice, delivery note, and statement types\n- Template system with theme overrides + HTML\/CSS filters\n- Secure download endpoints with nonce\/capability checks and optional order key validation\n- Token-based numbering engine for invoices, receipts, packing slips, and credit notes using stored order meta and a shared sequence-counter option\n- Rule-based document availability controls by type, order status, and payment state\n- Shared template display helper for configurable order rows, note blocks, and line-item metadata across bundled document templates<\/p>\n\n Numbering tokens available in settings:\n- {prefix}\n- {order_number}\n- {order_id}\n- {sequence}\n- {refund_sequence}\n- {year}\n- {yy}\n- {month}\n- {day}\n- {country}\n- {billing_country}\n- {shipping_country}\n- {fiscal_year}\n- {fiscal_year_short}\n- {fiscal_year_start}\n- {fiscal_year_end}<\/p>\n\n Key filters:\n- kitgenix_pdf_invoicing_modules\n- kitgenix_pdf_document_types\n- kitgenix_pdf_document_enabled\n- kitgenix_pdf_document_user_can_download\n- kitgenix_pdf_document_filename\n- kitgenix_pdf_batch_archive_filename\n- kitgenix_pdf_persistent_archive_enabled\n- kitgenix_pdf_archive_relative_root\n- kitgenix_pdf_invoice_filename (back-compat)\n- kitgenix_pdf_document_attachment (inline vs download)\n- kitgenix_pdf_document_template_path\n- kitgenix_pdf_document_html\n- kitgenix_pdf_invoice_html (back-compat)\n- kitgenix_pdf_document_custom_css\n- kitgenix_pdf_document_lang\n- kitgenix_pdf_document_title\n- kitgenix_pdf_document_body_class\n- kitgenix_pdf_show_shipping_address\n- kitgenix_pdf_email_document_map\n- kitgenix_pdf_email_attach_document\n- kitgenix_dompdf_enable_php (advanced; default false)<\/p>\n\n Key actions:\n- kitgenix_before_stream_pdf_document\n- kitgenix_after_stream_pdf_document\n- kitgenix_before_stream_pdf_invoice (back-compat)\n- kitgenix_after_stream_pdf_invoice (back-compat)\n- kitgenix_pdf_document_archived\n- Template hooks:\n - kitgenix_pdf_before_document \/ kitgenix_pdf_after_document\n - kitgenix_pdf_before_document_wrapper \/ kitgenix_pdf_after_document_wrapper\n - kitgenix_pdf_after_notes\n - kitgenix_pdf_after_order_data_rows<\/p>\n\n Security identifiers (exact):\n- Admin meta box downloads use Admin page hook suffix:\n- 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>\n\n This plugin includes a shared \u201cKitgenix hub\u201d component in wp-admin which may fetch publicly available plugin metadata from WordPress.org using WordPress core\u2019s Caching:\n- Transient: Uninstall removes the plugin settings option ( If this plugin helps you generate clean WooCommerce PDFs and reduces admin work, you can support ongoing development here:\nhttps:\/\/buymeacoffee.com\/kitgenix<\/p>\n\n Built with \u2764\ufe0e by @kitgenix - https:\/\/kitgenix.com\nBundled library: Dompdf (see vendor\/ for licenses)<\/p>\n\n\n PDFs are generated on demand and can be generated automatically at send-time by attaching them to WooCommerce emails.<\/p><\/dd>\n Yes. The plugin can retain immutable archived PDF copies in uploads for future re-delivery, while still using temporary working files for email attachments and batch ZIP creation. Stored document identifiers remain aligned with those archived copies.<\/p><\/dd>\n Yes. The plugin can show customer download buttons on the order details screen and add \u201cView Invoice\u201d\/\u201cView Credit Note\u201d actions in the Orders table. Credit notes only appear when refunds exist.<\/p><\/dd>\n Yes. From the WooCommerce orders list you can select orders, keep any status\/date filters you already use, and run a batch ZIP export for invoices, packing slips, receipts, credit notes, pro forma invoices, delivery notes, or statements.<\/p><\/dd>\n Yes. In the settings page you can add custom order meta rows using one entry per line in the format Yes. The settings page now includes localization\/tax\/legal formatting packs for VAT, GST, and Sales Tax styles, plus manual overrides for the displayed tax term and tax-registration label.<\/p><\/dd>\n Yes. You can switch invoices, receipts, and credit notes between tax-exclusive and tax-inclusive display, choose a custom document date format, and append ISO currency codes such as EUR, USD, GBP, or AUD after formatted amounts.<\/p><\/dd>\n No. Once an archived document copy exists, later downloads and batch exports can reuse that immutable file instead of regenerating a different version.<\/p><\/dd>\n Yes. Invoice, receipt, pro forma invoice, and statement downloads can be authorised with a valid WooCommerce order key. Credit notes can also use the order key when refunds exist. Packing slips and delivery notes remain staff-only by default.<\/p><\/dd>\n Credit notes are refund-aware. When an order has refunds, credit note documents become available (admin and optionally customer).<\/p><\/dd>\n Dompdf is used for rendering. The plugin configures strict defaults: chroot-limited paths, remote fetching disabled by default, and PHP execution inside templates disabled by default (advanced opt-in only).<\/p><\/dd>\n Yes. The settings page includes four built-in style packs: Standard, Simple, Modern, and Business. It also now includes a visual template designer for header alignment, logo scale, spacing density, panel styles, totals emphasis, and footer alignment.<\/p><\/dd>\n Copy templates from templates\/{style}\/ into your theme at kitgenix-pdf-invoicing-for-woocommerce\/{style}\/ and edit them. Yes. You can map different documents to different WooCommerce email types. Attachments are generated as temporary files and cleaned up automatically.<\/p><\/dd>\n Yes. The Email Attachments tab now includes an order-based preview tool that shows which PDFs are mapped to a WooCommerce email, opens live document previews for eligible files, and can send an attachment-only test email to a safe recipient before you rely on the live workflow.<\/p><\/dd>\n Yes. Order integrations are designed to work with modern WooCommerce order storage and admin workflows.<\/p><\/dd>\n Yes. Prefixes, token-based number formats, sequence padding, reset rules, and the fiscal year start month are configurable in settings. Existing issued documents keep their stored identifiers. Filenames and document behaviour can also be filtered by developers.<\/p><\/dd>\n Yes. The settings page now includes field controls for SKU, item meta, line-item tax, payment method, transaction ID, shipping method, customer notes, internal notes, and tax-total visibility.<\/p><\/dd>\n Yes. Numbering formats support tokens such as {sequence}, {refund_sequence}, {year}, {yy}, {month}, {country}, {billing_country}, {shipping_country}, {fiscal_year}, {fiscal_year_short}, {fiscal_year_start}, and {fiscal_year_end}. This makes it possible to implement fiscal-year resets and country-aware numbering rules without editing templates.<\/p><\/dd>\n Yes. Each built-in document type can be enabled or disabled in settings, limited to selected WooCommerce order statuses, and restricted to paid or unpaid orders only. Developers can also override availability per order via filters.<\/p><\/dd>\n Yes. The document registry can be extended via filters to add custom document types, and the plugin now includes built-in support for pro forma invoices, delivery notes, and statements in addition to invoices, receipts, packing slips, and credit notes.<\/p><\/dd>\n\n<\/dl>\n\n\n{style}<\/code> is the active template pack selected in settings: standard<\/code>, simple<\/code>, modern<\/code>, or business<\/code>.\nFor compatibility, the resolver also checks ...\/standard\/<\/code> and legacy root locations if a file is not found.<\/p>\n\nTemplate packs<\/h3>\n\n
Visual template designer<\/h3>\n\n
Customer downloads (My Account)<\/h3>\n\n
Download permissions & security<\/h3>\n\n
kitgenix_pdf_document_enabled<\/code> filter.<\/p>\n\nEmail attachments (configurable)<\/h3>\n\n
Filenames, streaming vs download<\/h3>\n\n
\n
Customisation hooks (HTML\/CSS\/output)<\/h3>\n\n
\n
Quick Start<\/h3>\n\n
\n
\n
Template Overrides<\/h3>\n\n
\n
Developers<\/h3>\n\n
Data Handling<\/h3>\n\n
\n
kitgenix_pdf_invoicing_settings<\/code>.<\/li>\nkitgenix_pdf_invoicing_for_woocommerce_metrics<\/code>.<\/li>\nkitgenix_pdf_invoicing_for_woocommerce_number_sequences<\/code>.<\/li>\n\n
_kitgenix_pdf_invoicing_for_woocommerce_invoice_number<\/code><\/li>\n_kitgenix_pdf_invoicing_for_woocommerce_invoice_date<\/code><\/li>\n_kitgenix_pdf_invoicing_for_woocommerce_packing_slip_number<\/code><\/li>\n_kitgenix_pdf_invoicing_for_woocommerce_packing_slip_date<\/code><\/li>\n_kitgenix_pdf_invoicing_for_woocommerce_receipt_number<\/code><\/li>\n_kitgenix_pdf_invoicing_for_woocommerce_receipt_date<\/code><\/li>\n_kitgenix_pdf_invoicing_for_woocommerce_credit_note_count<\/code><\/li>\n_kitgenix_pdf_invoicing_for_woocommerce_credit_note_history<\/code><\/li>\n<\/ul><\/li>\n_kitgenix_pdf_invoicing_for_woocommerce_archived_documents<\/code><\/li>\nSecurity & Privacy<\/h3>\n\n
\n
admin-post.php<\/code> actions kitgenix_admin_stream_invoice<\/code>, kitgenix_admin_stream_receipt<\/code>, kitgenix_admin_stream_packing_slip<\/code>, kitgenix_admin_stream_credit_note<\/code>, kitgenix_admin_stream_pro_forma_invoice<\/code>, kitgenix_admin_stream_delivery_note<\/code>, and kitgenix_admin_stream_statement<\/code>, protected by query arg nonce<\/code> created\/verified with nonce action kitgenix_admin_pdf<\/code>.\n- WordPress action hooks for those admin-post actions: admin_post_kitgenix_admin_stream_invoice<\/code>, admin_post_kitgenix_admin_stream_receipt<\/code>, admin_post_kitgenix_admin_stream_packing_slip<\/code>, admin_post_kitgenix_admin_stream_credit_note<\/code>, admin_post_kitgenix_admin_stream_pro_forma_invoice<\/code>, admin_post_kitgenix_admin_stream_delivery_note<\/code>, and admin_post_kitgenix_admin_stream_statement<\/code>.\n- Frontend document downloads use the optional _wpnonce<\/code> value created\/verified with nonce action kitgenix_download_{doc_type}_{order_id}<\/code>.\n- WooCommerce order action key: kitgenix_download_pdf_invoice<\/code> (hook: woocommerce_order_action_kitgenix_download_pdf_invoice<\/code>).\n- WooCommerce bulk action keys: kitgenix_pdf_batch_export_invoice<\/code>, kitgenix_pdf_batch_export_packing_slip<\/code>, kitgenix_pdf_batch_export_receipt<\/code>, kitgenix_pdf_batch_export_credit_note<\/code>, kitgenix_pdf_batch_export_pro_forma_invoice<\/code>, kitgenix_pdf_batch_export_delivery_note<\/code>, and kitgenix_pdf_batch_export_statement<\/code>.<\/p>\n\nkitgenix_page_kitgenix-pdf-invoicing-settings<\/code><\/p>\n\nExternal Services<\/h3>\n\n
plugins_api()<\/code> function.<\/p>\n\nkitgenix_hub_wporg_active_installs_v1<\/code>\n- Transient: kitgenix_hub_wporg_ratings_v1<\/code>\n- Transient: kitgenix_hub_wporg_media_v1<\/code><\/p>\n\nUninstall<\/h3>\n\n
kitgenix_pdf_invoicing_settings<\/code>), metrics option (kitgenix_pdf_invoicing_for_woocommerce_metrics<\/code>), and numbering sequence option (kitgenix_pdf_invoicing_for_woocommerce_number_sequences<\/code>) when uninstalled via WordPress.\nIt also deletes the activation redirect transient: kitgenix_pdf_invoicing_for_woocommerce_do_activation_redirect<\/code>.\nOrder meta, archived document metadata, and archived PDF files are intentionally preserved to avoid accidental loss of invoice, receipt, packing slip, or credit note history.<\/p>\n\nSupport Development<\/h3>\n\n
Credits<\/h3>\n\n
\n
\n
Does this plugin generate PDF invoices automatically?<\/h3><\/dt>\n
Are PDFs stored permanently in uploads?<\/h3><\/dt>\n
Can customers download invoices from My Account?<\/h3><\/dt>\n
Can I export a ZIP for multiple orders at once?<\/h3><\/dt>\n
Can I show tracking numbers, warehouse references, or other custom order fields on PDFs?<\/h3><\/dt>\n
meta_key|Label<\/code>. For example, _tracking_number|Tracking Number<\/code> or _warehouse_pick_ref|Warehouse Pick Ref<\/code>.<\/p><\/dd>\nCan I switch documents between VAT, GST, or Sales Tax wording?<\/h3><\/dt>\n
Can I show tax-inclusive prices, custom date formats, or ISO currency codes?<\/h3><\/dt>\n
Will repeat downloads regenerate a different PDF later?<\/h3><\/dt>\n
Can guests download documents with an order key?<\/h3><\/dt>\n
How do credit notes work?<\/h3><\/dt>\n
Is Dompdf bundled and safe?<\/h3><\/dt>\n
Can I choose different document styles without editing code?<\/h3><\/dt>\n
How do I override templates?<\/h3><\/dt>\n
{style}<\/code> is the active template pack selected in settings (standard\/simple\/modern\/business). You can also override template resolution via filters.<\/p><\/dd>\nCan I attach PDFs to WooCommerce emails?<\/h3><\/dt>\n
Can I preview or test email attachments before going live?<\/h3><\/dt>\n
Will this work with HPOS?<\/h3><\/dt>\n
Can I change invoice numbering, prefixes or filenames?<\/h3><\/dt>\n
Can I hide SKU, payment details, or customer\/internal notes without editing templates?<\/h3><\/dt>\n
Does the plugin support fiscal-year or country-based numbering rules?<\/h3><\/dt>\n
Can I disable certain document types?<\/h3><\/dt>\n
Does the plugin support custom document types?<\/h3><\/dt>\n
1.1.1 (7 May 2026)<\/h4>\n\n
\n
1.1.0 (7 May 2026)<\/h4>\n\n
\n
meta_key|Label<\/code>, so stores can surface tracking numbers, fulfilment references, warehouse picks, and other order meta without overriding templates.<\/li>\n1.0.6 (19 March 2026)<\/h4>\n\n
\n
1.0.5 (18 February 2026)<\/h4>\n\n
\n
1.0.4 (27 January 2026)<\/h4>\n\n
\n
1.0.3 (06 January 2026)<\/h4>\n\n
\n
1.0.2 (06 January 2025)<\/h4>\n\n
\n
1.0.1 (01 January 2025)<\/h4>\n\n
\n
1.0.0 (19 December 2025)<\/h4>\n\n
\n