husivargal

<p><em>Make your PDF generation and email attachment process easy. Present yourself in pretty way to your customers.</em></p>
<p>Automatically generate and attach customizable PDF documents to WooCommerce emails by Payment method. Plugin uses external web service <a href="https://eledo.online" rel="nofollow ugc">eledo.online</a> for PDF generation which makes it lightweight and brings new possibilities.</p>
<h4>Main features</h4>
<ul>
<li>Automatic PDF document generation and attachment.</li>
<li>Manually create or delete PDF documents.</li>
<li>Bulk PDF documents creation.</li>
<li>Different documents for different Payment Methods and Email Types.</li>
<li>PDF documents managing page.</li>
<li>Export in ZIP file based on date range.</li>
</ul>
<h4>Guides</h4>
<ul>
<li><a href="https://eledo.online/blog/automatically_create_PDF_invoice_WooCommerce" rel="nofollow ugc">Automatically create and send custom PDF invoice in WooCommerce</a></li>
<li><a href="https://eledo.online/blog/how_to_print_shipping_labels" rel="nofollow ugc">How to print Shipping Labels with eledo</a></li>
</ul>
<h4>Support</h4>
<p>Support can take place on the <a href="https://wordpress.org/support/plugin/eledo-pdf-attachments-for-woocommerce" rel="ugc">forum page</a>, where we will try to respond as soon as possible.</p>


Eledo PDF Attachments for WooCommerce

Automatically generate and attach customizable PDF documents to WooCommerce emails by Payment method.

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.

Eledo PDF Attachments for WooCommerce vs Kitgenix PDF Invoicing for WooCommerce