Kitgenix PDF Invoicing for WooCommerce
| 开发者 | kitgenix |
|---|---|
| 更新时间 | 2026年3月19日 18:27 |
| 捐献地址: | 去捐款 |
| PHP版本: | 8.1 及以上 |
| WordPress版本: | 7.0 |
| 版权: | 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 documents that look professional, match your branding, and work reliably across WooCommerce email flows.
Kitgenix PDF Invoicing for WooCommerce 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.
It’s built around practical store requirements:
- Stable document identifiers/numbering history (so regenerated PDFs stay consistent)
- Secure Dompdf rendering defaults (chrooted paths, remote disabled by default, PHP in templates disabled by default)
- Theme template overrides and developer hooks
- Clean admin preview/download workflow on the order screen
- Customer “My Account” download buttons and order table actions (optional)
- Configurable WooCommerce email attachments that clean up temp files automatically
vendor/ directory (Dompdf) is present. The WordPress.org release includes the required library.
Documents generated (built-in types)
- Invoice (PDF)
- Receipt (PDF)
- Packing Slip (PDF)
- Credit Note (PDF) (only available when refunds exist)
- Dompdf configured with strict defaults:
- chroot limited to allowed paths
- remote resource fetching disabled by default
- PHP execution inside templates disabled by default (opt-in only)
- All admin/customer download actions are protected with nonces and permission checks. No bloat
- PDFs are generated only when needed.
- Email attachments are created as temporary files and automatically cleaned up at shutdown.
- No custom database tables. Built for WooCommerce documents
- Refund-aware credit notes
- Email attachment mapping
- Customer download links in the right places
- Store-friendly templates and template override system Modular + extensible Modules (Admin / Settings / Invoicing / Email / Frontend) are registered through a module manager and can be filtered for extension.
安装:
- 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 meta box to preview/download documents.
- Configure branding, numbering and email attachments in settings.
屏幕截图:
常见问题:
Does this plugin generate PDF invoices automatically?
PDFs are generated on demand and can be generated automatically at send-time by attaching them to WooCommerce emails.
Are PDFs stored permanently in uploads?
No. PDFs are generated to secure temporary files and streamed/attached when needed. Email temp files are cleaned up automatically.
Can customers download invoices from My Account?
Yes. The plugin can show customer download buttons on the order details screen and add “View Invoice”/“View Credit Note” actions in the Orders table. Credit notes only appear when refunds exist.
How do credit notes work?
Credit notes are refund-aware. When an order has refunds, credit note documents become available (admin and optionally customer).
Is Dompdf bundled and safe?
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).
How do I override templates?
Copy templates from templates/{style}/ into your theme at kitgenix-pdf-invoicing-for-woocommerce/{style}/ and edit them. {style} is the active template pack selected in settings (standard/simple/modern/business). You can also override template resolution via filters.
Can I attach PDFs to WooCommerce emails?
Yes. You can map different documents to different WooCommerce email types. Attachments are generated as temporary files and cleaned up automatically.
Will this work with HPOS?
Yes. Order integrations are designed to work with modern WooCommerce order storage and admin workflows.
Can I change invoice numbering, prefixes or filenames?
Yes. Prefixes are configurable in settings. Filenames and document behaviour can also be filtered by developers.
Can I disable certain document types?
Yes. Document types can be enabled/disabled in settings and controlled per order via filters.
Does the plugin support custom document types?
Yes. The document registry can be extended via filters to add additional document types (e.g., pro-forma invoice, delivery note).
更新日志:
1.0.6 (19 March 2026)
Update: Improved the Kitgenix admin header layout for better alignment and less clutter.
Update: Social links in admin headers now render as compact icon buttons (with accessible labels).
Update: Added responsive header helpers so titles/description and actions/links lay out consistently.
Fix: Admin notices now display above the Kitgenix header using the WordPress standard notice area.
Fix: Added defensive notice normalization to prevent notices being relocated into the header by other scripts.
Fix: Restored consistent spacing between settings tabs and section cards.
Update: Admin tables inside Kitgenix pages now use Kitgenix styling for a more consistent branded look.
Fix: Added spacing between adjacent action links/buttons (e.g., Edit/Delete).
Maintenance: Updated the plugin Author URI to the public Kitgenix WordPress.org profile and replaced the old custom admin-menu icon CSS with the native Dashicons icon.
1.0.5 (18 February 2026)
- Docs: Overhauled readme.txt.
- Docs: Updated WordPress.org screenshots.
- UI: Updated the Kitgenix hub cards (added Stock Sync for WooCommerce).
- Fix: Normalised Kitgenix hub card output for consistent layout and navigation.
- Dev: Regenerated /languages/kitgenix-pdf-invoicing-for-woocommerce.pot translation template.
- 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).
- Update: Translation loading added (plugin text domain now loads from /languages).
- Improvement: Minor fixes and translation loading improvements.
- Change: Declared PHP requirement as 8.1 to match bundled dependency requirements.
- Change: Harmonised admin hub enqueue checks and admin branding; shortened readme/header strings to conform to WordPress.org limits.
- Cleanup: PHPCS/i18n/security fixes across plugin files (output escaping, translator comments, optional nonce checks) applied.
- Cleanup: Uninstall routine now also removes anonymous PDF generation metrics option.
- 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 sequences.
- Fix: Regenerated Composer autoload to resolve missing generated file mapping for thecodingmachine/safe and verified vendor autoload mappings are correct.
- Fix: Resolved edge-case settings and template issues affecting PDF generation.
- UI: Added a label for the refunded email row in the Email Attachments table.
- Update: Updated Composer dependencies to the latest compatible versions.
- 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.
- New: Added a shared top-level “Kitgenix” admin menu (hub) and moved PDF Invoicing settings under it.
- New: Added privacy-safe PDF generation counters (totals + by document type) and display them in the Support tab.
- 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).
- Improvement: Hardened admin asset loading to be scoped to the plugin settings page (hook suffix tracking with safe fallbacks).
- New: Initial release — generate PDF invoices, receipts, packing slips, and credit notes for WooCommerce orders.
- New: Included a standard template set and HTML wrapper with theme override support.
- New: Secure Dompdf configuration (chrooted paths, remote fetching disabled by default, PHP evaluation opt-in).
- New: Email attachments — attach PDFs to WooCommerce emails with automatic temporary file cleanup.
- New: Admin order meta box with preview, download/stream, and generate actions (protected by nonces and capability checks).
- New: Settings UI for branding, company details, prefixes, and email attachment mapping.
- New: Stable invoice numbering stored on first generation; credit notes tied to refund history.
- New: Developer-friendly filters and actions for templates, filenames, HTML, enablement, and module registration.
- New: Translation-ready with localisation support.