=== DACAR Digital Facturas Bonitas ===
Contributors: gabydacar
Tags: woocommerce, invoice, pdf, invoicing, documents
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Requires Plugins: woocommerce
Stable tag: 0.3.8
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Create WooCommerce simplified invoices and courtesy documents as local PDFs.

== Description ==

Facturas Bonitas reads order data from WooCommerce and creates clear PDF documents on the store server. WooCommerce remains the source of products, customers, amounts, and taxes; the plugin does not recalculate or invent that information.

The Free edition includes:

* Simplified invoices with the reserved FSFR series.
* Optional non-fiscal courtesy documents with the reserved DCFR series.
* Local PDF generation with Dompdf.
* The local Minimal Free template.
* Text logo with left or centre alignment.
* Fixed DejaVu Sans typography and two included background styles: Paper White and Sky Blue.
* Optional text watermark, limited to 20 characters and stored in uppercase.
* Local preview, printing, and downloads.
* Automatic PDF attachment to the applicable WooCommerce email.
* Document access from My Account.
* A simple document list and lookup desk for authorised administrators.

The PDF and its references are stored locally with the order. This plugin does not transmit order or document data to DACAR Digital.

The store owner remains responsible for the accuracy of WooCommerce data and for the tax and legal obligations that apply to the store.

== Requirements ==

* WordPress 6.0 or later.
* An active, compatible version of WooCommerce.
* PHP 7.4 or later with the DOM and mbstring extensions.

== Installation ==

1. Install and activate WooCommerce.
2. Install Facturas Bonitas from WordPress, or upload its ZIP from Plugins > Add New Plugin.
3. Activate Facturas Bonitas.
4. Open Facturas Bonitas in the administration menu.
5. Complete the issuer details and review the Free document and design settings.

== Usage ==

1. Enter the issuer information under General settings.
2. Review the fixed FSFR simplified-invoice line.
3. Optionally enable the DCFR courtesy-document line.
4. Configure the available visual settings and check the local preview.
5. Complete a WooCommerce order to create the applicable local PDF.
6. View, download, or print the document from Facturas Bonitas or My Account.

== Frequently Asked Questions ==

= What is the difference between the two document lines? =

The FSFR line creates a simplified invoice. The optional DCFR line creates a non-fiscal courtesy document and does not replace an invoice.

= Does Facturas Bonitas change order taxes? =

No. It reads the lines, amounts, and taxes calculated by WooCommerce and represents them in the document.

= Where are PDFs stored? =

PDFs and their references are stored locally and linked to the corresponding WooCommerce order.

= What happens when the plugin is uninstalled? =

Technical tasks are cleared. Documents, numbering, order references, and settings are retained to prevent accidental loss of business records.

= Does installing the plugin guarantee tax compliance? =

No. The validity of a document depends on its data, configuration, and the obligations that apply to the store in its jurisdiction.

== Privacy ==

Buyer personal data belongs to the WooCommerce order and is handled through WooCommerce privacy and retention tools. Facturas Bonitas uses that data locally to create the applicable document and may retain its PDF and references with the order.

The plugin registers suggested privacy-policy text in WordPress for the store owner to review and adapt under Settings > Privacy. It does not publish or automatically modify the site's privacy policy.

== Changelog ==

= 0.3.8 =
* Prepare cooperative runtime ownership for an optional compatible Premium edition while keeping the Free plugin active.
* Add contextual links in the Templates and Bonitas settings to learn about available editions.
* Improve PDF pagination for product names and descriptions without leaving a page containing only the footer.
* Preserve existing courtesy documents when an ordinary generation event is repeated.
* Use one canonical WooCommerce fiscal reader for the saved net bases and tax amounts.

= 0.3.7 =
* Align the Free design controls with the features actually delivered by the plugin.
* Improve PHP 8.4 compatibility and load PDF dependencies only when a PDF is generated.
* Load administrative preview and print-window assets through the WordPress APIs.
* Strengthen settings sanitization and remove inactive legacy assets.
* Clarify that DCFR courtesy outputs are non-fiscal purchase receipts and standardize PDF dates as day/month/year.

= 0.3.6 =
* Limit the distributed product to the local Free document and design features.
* Align the plugin description, privacy guidance, settings, and translations with the Free runtime.
* Preserve local FSFR and DCFR generation, preview, download, print, email attachment, and My Account access.

= 0.3.5 =
* Adopt the DACAR Digital identity and WordPress.org translation domain.
* Improve WordPress.org compatibility and local PDF administration.
