Beschreibung
„Neutrope Japanese Invoice PDFs for WooCommerce“ is a free plugin that generates Japanese-style invoice PDFs from your WooCommerce orders. It is designed for shops that need to deliver Japanese business documents (invoices and similar receipts) alongside their WooCommerce store.
Features (Free version)
- Invoice PDF generation (title, billing recipient block, line items, totals, consumption tax summary)
- One-click PDF output from the admin Order edit screen
- Customer-side invoice download from My Account (can be toggled on/off)
- Company name, address, and logo configurable from the settings screen
- Shipping lines and refunds reflected in the invoice PDF totals
- Sales Summary screen (WooCommerce > 売上サマリー): aggregates orders directly from order data — no dependency on WooCommerce Analytics caches — with date range, order status and payment method filters, aggregation by order date / paid date / completed date, refund-aware net totals, an order list, and UTF-8 (BOM) CSV export
- High-Performance Order Storage (HPOS) compatible
- Japanese-language PDF output powered by mPDF
- Template (
templates/invoice.php) can be overridden from your theme
Planned roadmap (no committed timeline)
The following items are being considered for a future paid version. They are not implemented in the free version and there is no guarantee they will ship.
- Qualified invoice number (Japan invoice system)
- Per-tax-rate display (10% / 8% reduced rate)
- Receipt document
- Bank transfer information
- Payment due date
- Company seal, header note, recipient honorific
The free plugin exposes filters and hooks so the items above can be added by add-on plugins without modifying the core.
Credits / Third-Party Licenses
This plugin bundles the following third-party software and fonts.
- mPDF — GPL-2.0-or-later. The PDF rendering engine. https://mpdf.github.io/
- Noto Sans JP — SIL Open Font License 1.1. Used for the Japanese text in the invoice PDF.
Full license text is bundled atassets/fonts/OFL.txt. https://fonts.google.com/noto
IPA fonts were not adopted because they are not GPL-compatible; OFL Noto Sans JP is used so the bundle stays GPL-compatible. - DejaVu Sans Condensed — Bitstream Vera Fonts License / Public Domain.
Four files (DejaVuSansCondensed.ttf / -Bold / -Oblique / -BoldOblique) are bundled because mPDF requires them as the internal sans-serif fallback.
Full license text is bundled atassets/fonts/DejaVu-LICENSE.txt. https://dejavu-fonts.github.io/
Screenshots
Installation
Server requirements
- PHP 7.4 or later
- PHP extensions mbstring and gd (required by the bundled mPDF library)
- WooCommerce 7.0 or later, active
Steps
- Upload the plugin ZIP and activate it. The distribution ZIP already bundles the PDF library and the Japanese font, so
composer installis not required. - Confirm that WooCommerce is active.
- Open WooCommerce > Japanese Invoice PDFs and fill in your company name, address, and logo.
- Open any order from the admin and click the invoice button in the „Japanese Invoice PDFs“ meta box.
For developers: the distribution ZIP excludes vendor/mpdf/mpdf/ttfonts via .distignore. If you run the plugin from source, run composer install first. The distribution ZIP can be rebuilt locally with powershell -File bin/build-zip.ps1. CI builds the same ZIP via GitHub Actions.
FAQ
-
Is WooCommerce required?
-
Yes. The plugin shows an admin notice and disables itself when WooCommerce is not active.
-
Can other people download my invoices?
-
No. Downloads from My Account require login, ownership of the order is enforced, and a nonce is verified.
-
Are PDFs stored on the server?
-
No. Every PDF is generated on demand and streamed to the browser, so there are no leftover files that could be linked directly.
-
Japanese characters look like garbled text
-
The plugin bundles Noto Sans JP (OFL 1.1), so no extra setup is needed. If you still see broken characters, verify that the PHP
mbstringandgdextensions are enabled on your server. -
Amounts display with decimals like „¥2,400.00“
-
The plugin follows the WooCommerce currency settings. To hide decimals for JPY, set WooCommerce > Settings > General > Number of decimals to 0.
-
Recipient name order and the „Japan“ suffix in the address
-
Name order, honorifics (sama, onchu, etc.) and country labelling are roadmap items. The free version uses WooCommerce default formatting.
-
Can I customize the template?
-
Yes. Copy
templates/invoice.phptowp-content/themes/<your-theme>/neutrope-japanese-invoice-pdfs-for-woocommerce/invoice.phpto override it.
Rezensionen
Zu diesem Plugin liegen noch keine Rezensionen vor.
Mitwirkende und Entwickler
„Neutrope Japanese Invoice PDFs for WooCommerce“ ist Open-Source-Software. Folgende Menschen haben an diesem Plugin mitgewirkt:
Mitwirkende
Übersetze „Neutrope Japanese Invoice PDFs for WooCommerce“ in deine Sprache.
Interessiert an der Entwicklung?
Durchstöbere den Code, sieh dir das SVN-Repository an oder abonniere das Entwicklungsprotokoll per RSS.
Änderungsprotokoll
1.1.1
- Add: completed date as a Sales Summary aggregation basis. Shops that mark orders completed when shipped can use completed date as a shipping-date report, while the existing default order-date behavior remains unchanged.
- Add: completed date to the Sales Summary order list and CSV export.
- Dev: expose the
wcjbp_sales_summary_date_basesfilter for safe date-basis label customization. Query keys remain limited to order date, paid date and completed date.
1.1.0
- Add: Sales Summary screen under WooCommerce > 売上サマリー. Aggregates orders directly from WooCommerce order data (HPOS compatible) without relying on WooCommerce Analytics caches. Filter by date range, order status (default: processing / completed), payment method, and aggregation basis date (order date or paid date). Summary cards (order count, gross/refunded/net totals, goods, shipping, tax, average) use the same refund-aware net logic as the invoice PDF. Includes an order list and a UTF-8 BOM CSV export (capability- and nonce-checked). A safety cap limits aggregation to 2000 orders and shows a warning when exceeded.
1.0.2
- Fix: account for refunds in invoice PDF totals. Refunded orders now show refund line(s) (負の金額) in the item table and compute the subtotal, tax, and total from the net (post-refund) amounts, so the PDF matches WooCommerce’s refunded totals. Handles product, shipping, and manual refunds, tax and tax-free, and multiple refunds. Orders without refunds are unchanged.
1.0.1
- Fix: include shipping lines in the invoice PDF. Orders with a shipping cost now show a „送料（配送方法名）“ row in the item table so the itemized rows reconcile with the subtotal and total. Zero-cost shipping is not shown; multiple shipping lines are supported.
1.0.0
- Initial release (free MVP).
- Invoice PDF generation, admin output, My Account download, settings screen, HPOS compatible.