=== WooCommerce PDF Invoices & Packing Slips ===

Contributors: pomegranate

Donate link: https://wpovernight.com/downloads/woocommerce-pdf-invoices-packing-slips-bundle/

Tags: woocommerce, pdf, invoices, packing slips, print, delivery notes, invoice, packing slip, export, email, bulk, automatic

Requires at least: 3.5

Tested up to: 5.4

Requires PHP: 5.3

Stable tag: 2.5.2

License: GPLv2 or later

License URI: http://www.gnu.org/licenses/gpl-2.0.html



Create, print & automatically email PDF invoices & packing slips for WooCommerce orders.



== Description ==



This WooCommerce extension automatically adds a PDF invoice to the order confirmation emails sent out to your customers. Includes a basic template (additional templates are available from [WP Overnight](https://wpovernight.com/downloads/woocommerce-pdf-invoices-packing-slips-premium-templates/)) as well as the possibility to modify/create your own templates. In addition, you can choose to download or print invoices and packing slips from the WooCommerce order admin.



= Main features =

* Automatically attach invoice PDF to WooCommerce emails of your choice

* Download the PDF invoice / packing slip from the order admin page

* Generate PDF invoices / packings slips in bulk

* **Fully customizable** HTML/CSS invoice templates

* Download invoices from the My Account page

* Sequential invoice numbers - with custom formatting

* **Available in: Czech, Dutch, English, Finnish, French, German, Hungarian, Italian, Japanese (see FAQ for adding custom fonts!), Norwegian, Polish, Romanian, Russian, Slovak, Slovenian, Spanish, Swedish & Ukrainian**



In addition to this, we offer several premium extensions:



* Create/email PDF Proforma Invoices, Credit Notes (for Refunds), email Packing Slips, automatic upload to Dropbox & more with [WooCommerce PDF Invoices & Packing Slips Professional](https://wpovernight.com/downloads/woocommerce-pdf-invoices-packing-slips-professional/)

* Automatically send new orders or packing slips to your printer, as soon as the customer orders! [WooCommerce Automatic Order Printing](https://www.simbahosting.co.uk/s3/product/woocommerce-automatic-order-printing/?affiliates=2) (from our partners at Simba Hosting)

* More advanced & stylish templates with [WooCommerce PDF Invoices & Packing Slips Premium Templates](https://wpovernight.com/downloads/woocommerce-pdf-invoices-packing-slips-premium-templates/)



= Fully customizable =

In addition to a number of default settings (including a custom header/logo) and several layout fields that you can use out of the box, the plugin contains HTML/CSS based templates that allow for customization & full control over the PDF output. Copy the templates to your theme folder and you don't have to worry that your customizations will be overwritten when you update the plugin.



* Insert customer header image/logo

* Modify shop data / footer / disclaimer etc. on the invoices & packing slips

* Select paper size (Letter or A4)

* Translation ready



== Installation ==



= Minimum Requirements =



* WooCommerce 2.2 or later

* WordPress 3.5 or later



= Automatic installation =

Automatic installation is the easiest option as WordPress handles the file transfers itself and you don't even need to leave your web browser. To do an automatic install of WooCommerce PDF Invoices & Packing Slips, log in to your WordPress admin panel, navigate to the Plugins menu and click Add New.



In the search field type "WooCommerce PDF Invoices & Packing Slips" and click Search Plugins. You can install it by simply clicking Install Now. After clicking that link you will be asked if you're sure you want to install the plugin. Click yes and WordPress will automatically complete the installation. After installation has finished, click the 'activate plugin' link.



= Manual installation via the WordPress interface =

1. Download the plugin zip file to your computer

2. Go to the WordPress admin panel menu Plugins > Add New

3. Choose upload

4. Upload the plugin zip file, the plugin will now be installed

5. After installation has finished, click the 'activate plugin' link



= Manual installation via FTP =

1. Download the plugin file to your computer and unzip it

2. Using an FTP program, or your hosting control panel, upload the unzipped plugin folder to your WordPress installation's wp-content/plugins/ directory.

3. Activate the plugin from the Plugins menu within the WordPress admin.



== Frequently Asked Questions ==



= Where can I find the documentation? =



[WooCommerce PDF Invoices & Packing Slips documentation](https://docs.wpovernight.com/woocommerce-pdf-invoices-packing-slips/)



= It's not working! =



Check out our step by step diagnostic instructions here: https://wordpress.org/support/topic/read-this-first-9/











= Where can I find more templates? =



Go to [wpovernight.com](https://wpovernight.com/downloads/woocommerce-pdf-invoices-packing-slips-premium-templates/) to checkout more templates! These include templates with more tax details and product thumbnails. Need a custom templates? Contact us at support@wpovernight.com for more information.



= Can I create/send a proforma invoice or a credit note? =

This is a feature of our Professional extension, which can be found at [wpovernight.com](https://wpovernight.com/downloads/woocommerce-pdf-invoices-packing-slips-professional/)



= Can I contribute to the code? =

You're more than welcome! This plugin is hosted on github, where you can post issues or make pull requests.

https://github.com/wpovernight/woocommerce-pdf-invoices-packing-slips



= How can I display the HTML/CSS source for debugging/developing templates? =

There's a setting on the Status tab of the settings page that allows you to toggle HTML output. Don't forget to turn if off after you're done testing!





== Screenshots ==



1. Simple invoice PDF

2. Simple packing slip PDF

3. Quickly print individual invoices or packing slips from the order list

4. Print invoices or packing slips in bulk

5. Attach invoices to any WooCommerce email

6. Set shop name, address, header logo, etc.



== Changelog ==



= 2.5.2 =

* Fix: ImageMagick version conflict

* Translations: Updated POT



= 2.5.1 =

* Fix: Correct integration with permalink settings for `[wcpdf_download_invoice]` shortcode

* Fix: Plugin assets versioning



= 2.5.0 =

* Feature: Manually regenerate individual documents with latest settings (shop address/footer/etc)

* Feature: Shortcode to download invoice: `[wcpdf_download_invoice]`

* Feature: Logo height setting

* Fix: textdomain fallback would fail on specific site domains including .mo

* Fix: Unnecessary extra page on edge case table heights

* Fix: Settings disappearing when overriding document titles to empty string

* Fix: check if header logo file still exists before loading

* Fix: If document is already created, disregard 'disable for:' setting

* Fix: Reading document settings & number when stored incorrectly (by external plugins)

* Tested up to WooCommerce 4.2



= 2.4.10 =

* Tested up to WooCommerce 4.1



= 2.4.9 =

* Fix: Backwards compatibility with WooCommerce 2.6

* Fix: Description of the setting to disable invoice for free orders

* Changed: shorter my account button text ("Invoice" instead of "Download Invoice (PDF)")



= 2.4.8 =

* Dev: Added `wpo_wcpdf_pdf_data` filter for direct loading of PDF data

* Dev: Added `is_bulk` property to bulk documents



= 2.4.7 =

* Fix: missing order number in filename when invoice number not enabled

* Dev: Added action hook for document save method (`wpo_wcpdf_save_document`)

* Dev: Added action hook for printing custom data in PDF invoice data panel (`wpo_wcpdf_meta_box_after_document_data`)

* Tested up to WooCommerce 4.0 & WP 5.4



= 2.4.6 =

* Fix: Locale determination for admins on their own my account page

* Fix: Action buttons icon alignment in WP5.3+

* Fix: Add bulk actions via native WP methods

* Tweak: minimize calls to WooCommerce mailer class when loading settings



= 2.4.5 =

* Fix: Prevent errors for subscription tax fallback on refunds



= 2.4.4 =

* Fix: German Market thumbnail settings conflict

* Fix: Correctly sanitize wizard text input

* Fix: Link to documentation for increasing memory

* Fix: Fallback for subscription renewal tax rates



= 2.4.3 =

* Fix: Prevent errors unsetting a non-existing setting

* Fix: Potential crash on improperly initiated documents 

* Fix: Reversed tax rate calculation arguments

* Fix: Support tax rate functions for non-line items

* Fix: comma position on multiple tax rates

* Fix: Setup wizard styles

* Translations: Added lv locale for Latvian (keeping lv_LV as fallback)

* Translations: Updated bundled Czech translations

* Tested up to WooCommerce 3.9



= 2.4.2 =

* Fix: 'No' option in new date & number visibility setting

* Fix: Resetting headers caused unintended caching of PDF files on some hosts



= 2.4.1 =

* Fix: Creating invoices for draft orders would crash plugin

* Tweak: Include time in default invoice date



= 2.4.0 =

* Feature: Option to use order number & date for invoice number & date

* Fix: prevent errors during update when WC not active

* Fix: don't auto create invoice number when manually entered & directly changing order status

* Fix: invoice tax amount for refunded orders (in combination with WooCommerce tax setting "as a single total")

* Tweak: Default to today's date when editing empty invoice date





= 2.3.5 =

* Feature: Accept single order ID for wcpdf_get_document function

* Feature: Filter to change number store for invoice

* Tweak: Always prefer WC() function over global for WC3.0+

* Fix: Incorrectly stored attachment settings couldn't be reset

* Fix: Prevent error notices during setup wizard

* Tested up to WooCommerce 3.8



= 2.3.4 =

* Fix: Prevent duplicate invoice numbers for multiple attachment setups

* Fix: Apply email order filter for each email separately



= 2.3.3 =

* Tweak: Move filter to override order object to document level (rather than per email)



= 2.3.2 = 

* Fix: Load enhanced selection styles on settings page

* Fix: WC Bookings email attachment

* Tweak: Use WooCommerce 3.7 tax rate data when available.



= 2.3.1 =

* Fix: Errors for filtered formatted invoice numbers



= 2.3.0 =

* Feature: Setting to disable invoices globally for specific order statuses

* Feature: Control action buttons visibility from settings wizard.

* Feature: Allow loading of existing PDF file instead of generating on the fly via filter (`wpo_wcpdf_load_pdf_file_path`)

* Fix: Check if temp folder exists before creating

* Fix: Newlines in address from settings wizard

* Fix: Double images issue with WooCommerce German Market

* Fix: Only store document settings when creating one

* Tested with WooCommerce 3.7



= 2.2.14 =

* Fix: Set default PHPMailer validator to 'php' (fixing 'setFrom' errors on PHP 7.3)

* Fix: Attachment path for file lock check

* Tweak: Don't wait for file lock if locking disabled

* Tweak: JIT loading of core documents for early requests (before init 15)



= 2.2.13 =

* Feature: Better order notes formatting & optional filter for system notes

* Feature: add email object to attachment hook and allow order object filtering

* Fix: WooCommerce Chained Products row classes

* Fix: Issues with locked attachment files preventing the email from being sent correctly



= 2.2.12 =

* Tested up to WC3.6

* Fix: Prevent infinite loop on temporary folder creation for partially migrated sites or write permission issues

* Tweak: Removed height & width attributes from logo image (+filter `wpo_wcpdf_header_logo_img_element`)

* Dev: Enable guest access to PDF with order key in URL 



= 2.2.11 =

* Fix: Fatal error on orders with multiple refunds



= 2.2.10 =

* Fix: Possible conflict with latest Subscriptions

* Fix: Load correct translations when admin user profile language is set to different locale

* Fix: Use file lock to prevent parallel processes creating the same attachment file

* Fix: Prevent notices for incorrectly loaded email classes

* Feature: Allow different invoice number column sorting methods by filter

* Feature: Filter for global prevention of creating specific document (`wpo_wcpdf_document_is_allowed`)



= 2.2.9 =

* Feature: Added customer note email to attachment options

* Fix: Prevent empty invoice dates from being saved as 1970 (fallback to current date/time)



= 2.2.8 =

* Tested up to WP5.1

* Tweak: Re-use attachment file if not older than 60 seconds (tentative fix for parallel read & write issues)

* Dev: Added URL overrides to switch between output mode (`&output=html`) and debug (`&debug=true`)



= 2.2.7 =

* Fix: Hardened permissions & security checks on several admin actions (audit by pluginvulnerabilities.com)

* Feature: Show checkmarks for existing documents on order details page buttons too

* Tweak: Product Bundles compatibility, hide items by default, following bundle settings (Simple Template)

* Tweak: Fallback to billing address on packing slip for orders without shipping address



= 2.2.6 =

* Fix: ship to different address check for empty shipping addresses

* Fix: Fix notice when using invoice number by plugin

* Fix: Underline position

* Fix: PHP 7.3 compatibility

* Tweak: Updated dompdf to 0.8.3

* Tweak: move admin menu item to the end of WooCommerce menu

* Tweak: pass document object to paper format & orientation filters



= 2.2.5 =

* Feature: Check marks to indicate whether a document exists

* Feature: Test mode to automatically apply updated settings to existing documents

* Feature: Admin bar indicator for debug mode setting

* Fix: always use latest email settings

* Fix: WooCommerce Composit Products item name compatibility

* Fix: Use woocommerce_thumbnail for WC3.3+

* Tweak: apply woocommerce_order_item_name filter (fixes compatibility with WooCommerce Product Addons 3.0)

* Tweak: Use WooCommerce date format instead of WP date format



= 2.2.4 =

* Fix: excluding some display options from historical settings

* Fix: fix notices when requesting properties as custom fields (in a custom template)



= 2.2.3 =

* Fix: issues reading shop settings



= 2.2.2 =

* Feature: Added option to always use most current settings for the invoice

* Fix: Double check for empty document numbers on initialization

* New filter: `wpo_wcpdf_output_format` to set output per document type



= 2.2.1 =

* Fix: potential number formatting issues with `wpo_wcpdf_raw_document_number` filter

* Fix: prevent direct loading of template files



= 2.2.0 =

* Feature: Document settings are now saved per order - changing settings after a PDF has been created will no longer affect the output

* Feature: Button to delete invoice or packing slip

* Feature: Better error handling and logging via WC Logger (WooCommerce > Status > Logs)

* Fix: Broader payment gateway compatibility (lower priority for documents initialization)

* Fix: undefined variable in construct when loading document programmatically (props to Christopher)

* Fix: compatibility with renamed WooCommerce plugins (settings page detection)

* Tweak: Reload translations before creating attachment

* Translations: Updated translations POT



= 2.1.10 =

* Feature: Include invoice number and date in WooCommerce data remover and exporter 

* Fix: Row class for Chained Products compatibility

* Fix: Improved compatibility with Advanced Custom Fields

* Fix: Setting for diabling for free invoices should be applied even when other plugins are applying rules



= 2.1.9 =

* Feature: Automatic cleanup of temporary attachments folder (settings in Status tab)

* Fix: prevent infinite loop on sites without uploads folder

* Fix: tag replacements for externally hosted images (CDN)



= 2.1.8 =

* Fix: Fatal error on PHP 5.X



= 2.1.7 =

* Feature: add [order_number] placeholder for number format

* Feature: $order and $order_id variables now available directly template (without needing the document object)

* Feature: add actions before & after addresses

* Fix: Sorting orders by invoice number

* Fix: Aelia Currency Switcher - use decimal & Thousand separator settings

* Fix: fix jquery migrate warnings for media upload script

* Tweak: add calculated tax rate to item data



= 2.1.6 =

* Fix: Extended currency symbol setting for WooCommerce Currency Switcher by realmag777

* Fix: Apply WooCommerce decimal settings to tax rates with decimals

* Tweak: Pass document object to `wpo_wcpdf_email_attachment` filter



= 2.1.5 =

* Feature: Filter for number store table (wpo_wcpdf_number_store_table_name)

* Fix: prevent accessing order properties as custom field/order meta

* Fix: prevent wrong application of wpo_wcpdf_filename filter

* Fix: Improved tax rate calculation fallback



= 2.1.4 =

* Fix: WooCommerce 3.3 action buttons

* Feature: Added row classes for WooCommerce Composite Products 



= 2.1.3 =

* Fix: Fatal PHP error on My Account page.



= 2.1.2 =

* Feature: New action wpo_wcpdf_init_document

* Fix: Use title getters for my-account and backend buttons

* Fix: Legacy Premium Templates reference

* Tweak: Skip documents overview in settings, default to invoice



= 2.1.1 =

* Fix: WooCommerce Order Status & Actions Manager emails compatibility

* Feature: sort orders by invoice number column

* Tweak: pass document object to title filters

* Tweak: use title getter in template files (instead of title string)



= 2.1.0 =

* Feature: WooCommerce Order Status & Actions Manager emails compatibility

* Fix: Better url fallback for images stored in cloud

* Update: dompdf library updated to 0.8.2 - DOMDocument parser set to default again



= 2.0.15 =

* Fix: Prevent saving invoice number/date from order details page when not edited



= 2.0.14 =

* Feature: Manually resend specific order emails in WooCommerce 3.2+

* Tweak: Show full size logo preview in settings

* Tweak: Custom field fallback to underscore prefixed meta key

* Dev: added `wpo_wcpdf_before_sequential_number_increment` action



= 2.0.13 =

* Fix: Minor XSS issue on settings screens by escaping and sanitizing 'tab' & 'section' GET variables. Discovered by Detectify.

* Fix: Pakistani Rupee Symbol

* Feature: Automatically enable extended currency symbol support for currencies not supported by Open Sans

* Dev: added `wpo_wcpdf_document_number_settings` filter



= 2.0.12 =

* Option: Use different HTML parser (debug settings)



= 2.0.11 =

* Fix: Improved fonts update routine (now preserves custom fonts)

* Fix: Enable HTML5 parser by default (fixes issues with libxml)

* Tweak: Show both PHP & WP Memory limit in Status tab



= 2.0.10 =

* Fix: Set invoice number backend button

* Fix: Thumbail paths

* Tweak: Make dompdf options filterable



= 2.0.9 =

* Feature: use `[invoice_date="ymd"]` in invoice number prefix or suffix to include a specific date format in the invoice number

* Fix: Postmeta table prefix for invoice counter

* Fix: 0% tax rates



= 2.0.8 =

* Feature: Add support for Bedrock / alternative folder structures

* Dev: Filter for merged documents

* Fix: Better attributes fallback for product variations 



= 2.0.7 =

* Feature: Added button to delete legacy settings

* Feature: Option to enable font subsetting

* Fix: Invoice number sequence for databases with alternative auto_increment_increment settings

* Fix: Fallback function for MB String (mb_stripos)



= 2.0.6 =

* Feature: Improved third party invoice number filters (`wpo_wcpdf_external_invoice_number_enabled` & `wpo_wcpdf_external_invoice_number`)

* Fix: Underline position for Open Sans font

* Fix: Invoice number auto_increment for servers that restarted frequently

* Fix: Dompdf log file location (preventing open base_dir notices breaking PDF header)

* Fix: 1.6.6 Settings migration duplicates merging

* Tweak: Clear fonts folder when manually reinstalling fonts



= 2.0.5 =

* Feature: Remove temporary files (Status tab)

* Fix: Page number replacement

* Tweak: Fallback functions for MB String extension

* Tweak: Improved wpo_wcpdf_check_privs usability for my account privileges

* Legacy support: added wc_price alias for format_price method in document



= 2.0.4 =

* Fix: Apply filters for custom invoice number formatting in document too

* Fix: Parent fallback for missing dates from refunds



= 2.0.3 =

* Fix: Better support for legacy invoice number filter (`wpo_wcpdf_invoice_number` -  replaced by `wpo_wcpdf_formatted_document_number`)

* Fix: Document number formatting fallback to order date if no document date available

* Fix: Updated classmap: PSR loading didn't work on some installations

* Fix: Prevent order notes from all orders showing when document is not loaded properly in filter

* Tweak: Disable deprecation notices during email sending

* Tweak: ignore outdated language packs



= 2.0.2 =

* Fix: order notes using correct order_id

* Fix: WC3.0 deprecation notice for currency

* Fix: Avoid crashing on PHP5.2 and older

* Fix: Only use PHP MB String when present

* Fix: Remote images

* Fix: Download option



= 2.0.1 =

* Fix: PHP 5.4 issue



= 2.0.0 =

* New: Better structured & more advanced settings for documents

* New: Option to enable & disable Packing Slips or Invoices

* New: Invoice number sequence stored separately for improved speed & performance

* New: Completely rewritten codebase for more flexibility & better reliability

* New: Updated PDF library to DOMPDF 0.8

* New: PDF Library made pluggable (by using the `wpo_wcpdf_pdf_maker` filter)

* New: lots of new functions & filters to allow developers to hook into the plugin

* Changed: **$wpo_wcpdf variable is now deprecated** (legacy mode available & automatically enabled on update)

* Fix: Improved PHP 7 & 7.1 support

* Fix: Positive prices for refunds

* Fix: Use parent for attributes retrieved for product variations

* Fix: Set content type to PDF for download



= 1.6.6 =

* Feature: Facilitate downgrading from 2.0 (re-installing fonts & resetting version)

* Fix: Update currencies font (added Georgian Lari)

* Translations: Added Indonesian



== Upgrade Notice ==



= 2.1.10 =

2.X is a BIG update! Make a full site backup before upgrading if you were using version 1.X!