=== Birlo 3D Print Lite for WooCommerce ===
Contributors: birloestudio
Tags: woocommerce, 3d-printing, stl, fdm, quotation
Requires at least: 6.3
Tested up to: 7.1
Requires PHP: 8.0
Stable tag: 1.0.9
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Create FDM 3D-printing quotations and WooCommerce orders from STL, OBJ and 3MF models.

== Description ==

Birlo 3D Print Lite for WooCommerce adds an FDM 3D-printing configurator and manufacturing workflow to WooCommerce.

Customers can upload STL, OBJ and 3MF files, preview the model in 3D, choose FDM material and print settings, receive an automatic estimate and add the configured part to the WooCommerce cart.

Main features:

* STL, OBJ and 3MF uploads.
* Local 3D model preview.
* FDM materials, colours, infill, quality and quantity configuration.
* Built-in geometric estimator for quotations.
* Optional local CuraEngine or OrcaSlicer integration when available on the server.
* WooCommerce cart, checkout and order integration.
* Production jobs and basic manufacturing workflow.
* Private handling of uploaded model files.
* Three.js r128 bundled locally with the plugin.

Birlo 3D Print Lite does not require a Birlo licence and does not use the Birlo commercial update service or Birlo Slicer Cloud.

Real G-code generation requires CuraEngine or OrcaSlicer to be installed and available on the server with a valid slicing profile. When a local slicer is unavailable, the built-in estimator can still calculate quotations.

== Installation ==

1. Install and activate WooCommerce.
2. Install and activate Birlo 3D Print Lite for WooCommerce.
3. Open the Birlo 3D Print settings and configure your FDM materials, printer and pricing.
4. Add the Birlo 3D Print configurator to the page where you want customers to configure their parts.

== Frequently Asked Questions ==

= Does the Lite version support resin printing? =

No. Birlo 3D Print Lite is focused on FDM printing.

= Does it require an external cloud service? =

No. The Lite version can work with its built-in estimator. Local slicers are optional.

= Which model formats can customers upload? =

STL, OBJ and 3MF.

= Is WooCommerce required? =

Yes. WooCommerce provides the cart, checkout and order system used by the plugin.

== Screenshots ==

1. FDM configurator with an STL model preview, material options, manufacturing analysis and an instant quotation.
2. WooCommerce cart showing the configured print, model thumbnail, price and edit configuration link.
3. Birlo 3D Print administration dashboard with quick links, printer overview and system status.

== Changelog ==

= 1.0.9 =
* Security hardening: anonymous upload, quote, comparison and cart-operation rate limits.
* Validates actual uploaded file size before processing.
* REST Print Node routes now enforce Bearer-token authentication in permission callbacks.
* Inline translation JSON hardened against script-tag injection and emitted through WordPress helpers.
* Manual quote requests and model delivery are throttled to reduce abuse.

= 1.0.4 =
* Prevented invalid production metadata in an order from causing a fatal error on the Smart Production screen.

= 1.0.3 =
* Fixed missing configurator data when the theme or a performance plugin changes the script loading order.

= 1.0.2 =
* Improved configurator startup when a site theme or script optimizer changes module script handling.
* Show a visible message when the 3D viewer cannot load.
* Improved layout of configurator options and accessibility of the model upload control.

= 1.0.1 =
* Removed the Python print-node file from the WordPress.org distribution.
* WordPress.org review compatibility improvements.
* Updated Three.js to 0.186.0 and included human-readable JavaScript source.
* Moved embedded styles and scripts to WordPress enqueue APIs.

= 1.0.0 =
* First public Lite release for WordPress.org.
* FDM configurator with STL, OBJ and 3MF support.
* Local 3D preview with bundled Three.js 0.186.0.
* Built-in quotation estimator and WooCommerce cart/order integration.
* No commercial licence manager, private updater or Birlo Slicer Cloud connection.

== Source code and third-party libraries ==

All Birlo 3D Print Lite PHP, JavaScript and CSS source code is included in this plugin package in human-readable form. No build step is required to modify the plugin's own code.

The 3D viewer uses Three.js 0.186.0 and the official STLLoader, OBJLoader and OrbitControls modules. Their unminified source files are included under assets/vendor/three-r186/. Three.js is licensed under the MIT License; see assets/vendor/three-r186/LICENSE. Upstream project: https://github.com/mrdoob/three.js
