Kitgenix PDF Invoicing for WooCommerce
| 开发者 |
kitgenix
|
| 更新时间 |
2026年1月28日 03:14 |
| 捐献地址: |
去捐款 |
| PHP版本: |
8.1 及以上 |
| WordPress版本: |
6.9 |
| 版权: |
GPLv3 or later |
| 版权网址: |
版权信息
|
详情介绍:
Most WooCommerce stores eventually need proper order documents.
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 those documents to look professional, match your branding, and be reliable across different WooCommerce email flows.
Kitgenix PDF Invoicing for WooCommerce is a lightweight, security-first PDF invoicing plugin that generates WooCommerce order PDFs on demand — without creating heavy background jobs, and without storing piles of PDF files in your uploads folder.
It’s built with real-world store requirements in mind:
stable numbering, safe PDF rendering, theme-overridable templates, email attachments that clean up after themselves, and a clean admin workflow for previewing and downloading documents from the order screen.
It is also designed to be modular and developer-friendly, so it can grow with your store and be customised safely.
What this plugin generates
This plugin can generate the following WooCommerce PDF documents:
Invoice (PDF)\
Receipt (PDF)\
Packing Slip (PDF)\
Credit Note (PDF) (when refunds exist)
Each document type is defined in a document registry and can be extended via filters, making it possible to add additional document types later without rewriting the core plugin.
Why store owners choose Kitgenix PDF Invoicing
It’s secure by default.
PDF generation uses Dompdf configured with strict defaults. Remote fetching is disabled by default, and Dompdf is chrooted to allowed paths. PHP execution inside templates is disabled by default (opt-in only), and all public/admin actions are protected by capability checks and nonces.
It doesn’t bloat your site.
PDFs are generated only when needed. Email attachments are created as temporary files and cleaned up automatically. The plugin avoids unnecessary processing on normal page loads.
It’s built for WooCommerce documents, not generic PDFs.
Everything revolves around WooCommerce orders: document numbering, refund-aware credit notes, email attachments, and customer download links in the right places.
It’s modular and extensible.
The plugin boots a module set (Invoicing, Frontend, Admin, Email, Settings) and allows developers to alter module registration. Document types, templates, filenames, HTML output and availability can all be filtered.
Features (in more detail)
安装:
- Install via Plugins → Add New (search for “Kitgenix PDF Invoicing”), or upload the ZIP file.
- Activate the plugin.
- Ensure WooCommerce is active.
- Go to WooCommerce → Orders and open an order.
- Use the Kitgenix PDF Invoicing meta box to preview or download documents.
- Optional: configure branding, numbering and email attachments in the settings page.
屏幕截图:
1.0.4
Maintenance and compatibility update. Recommended for all sites.
常见问题:
Does this plugin generate PDF invoices for WooCommerce automatically?
It can generate PDFs on demand and can also attach PDFs to WooCommerce emails, which effectively generates them automatically at send-time.
Are PDFs stored permanently in uploads?
No. PDFs are generated to secure temporary files and streamed/attached when needed. Temporary email files are cleaned up automatically.
Can customers download invoices from My Account?
Yes, the plugin can show customer download buttons in the order details screen for logged-in customers who own the order. Credit note links appear when refunds exist.
How do credit notes work?
Credit notes are refund-aware. When an order has refunds, credit note documents can be generated and offered in admin/customer contexts (depending on your configuration).
Is Dompdf bundled and safe?
Dompdf is bundled. The plugin configures it with strict defaults (remote fetching disabled by default and chroot limited). PHP execution inside templates is disabled by default and can be enabled only via a filter for advanced use cases.
How do I override templates?
Copy templates from templates/standard/ into your theme at kitgenix-pdf-invoicing-for-woocommerce/standard/ and edit them. You can also override the template resolution path via filters.
Can I attach PDFs to WooCommerce emails?
Yes. You can attach different documents to different WooCommerce email types. Attachments are generated as temporary files and cleaned up automatically.
Will this work with HPOS?
Yes. The plugin’s order integrations are designed to work with modern WooCommerce order storage and admin workflows.
Can I change invoice numbering, prefixes or filenames?
Yes. The settings allow prefixes and core numbering behaviour, and developers can filter filenames via kitgenix_pdf_document_filename.
Can I disable certain document types?
Yes. Document types can be enabled/disabled in settings, and developers can control availability per order via filters.
Does the plugin support custom document types?
Yes. Document types are registered in a document registry and can be extended via filters, making it possible to add additional document types (for example delivery notes or pro-forma invoices) in a clean way.
更新日志:
1.0.4 (27 January 2026)
- Fix: Fixed Email Attachments settings not persisting when saving other settings tabs (multi-form settings page could overwrite email attachment mapping).
- Fix: Fixed public document download permissions to allow guest access via valid WooCommerce
order_key links (matching documented behaviour).
- Fix: Fixed CSS injection for PDF rendering so valid CSS is not HTML-escaped (prevents broken selectors); hardened by stripping tags and neutralising closing
</style> sequences.
- Fix: Translation loading added (plugin text domain now loads from /languages).
- New: Added additional template packs (Simple, Modern, Business) and a setting to choose the active template style.
- New: Added Receipt and Packing Slip actions to the admin order meta box (download + generate).
- Tweak: Added a label for the refunded email row in the Email Attachments table.
- Tweak: Uninstall routine now also removes anonymous PDF generation metrics option.
- Tweak: Declared PHP requirement as 8.1 to match bundled dependency requirements.
- Maintenance: Minor fixes and translation loading improvements.
- Fix: Resolved a few edge-case settings and template issues affecting PDF generation and
- Maintenance: PHPCS/i18n/security fixes across plugin files (output escaping, translator comments, optional nonce checks) applied.
- Fix: Regenerated Composer autoload to resolve missing generated file mapping for thecodingmachine/safe and verified vendor autoload mappings are correct.
- Tweak: Harmonised admin hub enqueue checks and admin branding; shortened readme/header strings to conform to WordPress.org limits.
1.0.3 (06 January 2026)
- Update: Updated Composer dependencies to the latest compatible versions.
1.0.2 (06 January 2025)
- Fix: Fixed a WooCommerce compatibility issue that could trigger a fatal error during PDF generation (receipt/invoice templates) when
wc_get_order_item_totals() is not available.
- Fix: Totals now use the order API (
WC_Order::get_order_item_totals()) with safe fallbacks to prevent admin order saves and transactional emails from failing.
1.0.1 (01 January 2025)
- New: Added a shared top-level “Kitgenix” admin menu (hub) and moved PDF Invoicing settings under it.
- Improvement: Redesigned the settings UI with a new header and tabbed navigation (Settings, Brand & Styling, Email Attachments, Preview, Support).
- Improvement: Improved admin styling (including dark-mode friendly variables) and updated Kitgenix brand assets used in the admin.
- Improvement: Improved settings behaviour: initialise the WordPress color picker only when relevant tabs are visible.
- Improvement: Improved logo upload UI (cleaner preview markup + consistent show/hide behaviour for the remove button).
- New: Added privacy-safe PDF generation counters (totals + by document type) and display them in the Support tab.
- Improvement: Hardened admin asset loading to be scoped to the plugin settings page (hook suffix tracking with safe fallbacks).
1.0.0 (19 December 2025)
- Initial release: generate PDF invoices, receipts, packing slips and credit notes for WooCommerce orders.
- Included a standard template set and HTML wrapper with theme override support.
- Secure Dompdf configuration (chrooted paths, remote fetching disabled by default, PHP evaluation opt-in).
- Email attachments: attach PDFs to WooCommerce emails with automatic temporary file cleanup.
- Admin order meta box with preview, download/stream and generate actions (protected by nonces and capability checks).
- Settings UI for branding, company details, prefixes and email attachment mapping.
- Stable invoice numbering stored on first generation; credit notes tied to refund history.
- Developer-friendly filters and actions for templates, filenames, HTML, enablement and module registration.
- Translation-ready with localisation support.
Includes new PDF template packs and a template style selector.
This plugin bundles the Dompdf library to render HTML to PDF.
Remote fetching is disabled by default. Dompdf reads local files only under configured allowed paths (chroot), which include the plugin directory and the uploads directory for safe asset usage (such as a logo you upload).
This plugin does not send customer data to third-party services for PDF generation. PDFs are generated on your server.