=== 3D Print Pricing Calculator ===

Contributors: odysse.io
Tested up to: 6.8.1
Requires at least: 5.7
Requires PHP: 7.4
Stable tag: 1.4.8.8
License: GPL-3.0
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Upload STL files to calculate printing estimates, weight, and cost, and display the results on your site’s frontend.

== Description ==
Quote and sell your 3D printing services. Low maintenance, scalable, customizable.

The 3D Print Pricing Calculator plugin allows users to upload STL files to your WordPress site. The plugin processes STL files locally on your site and returns pricing, material, and print time estimates.

== Setup Overview ==

### Step 1: **Install the Plugin**

- Download the plugin ZIP or upload it via `Plugins > Add New > Upload Plugin`.

### Step 2: **Activate and Configure**

- Activate the plugin, then go to `Settings > 3D Print Pricing Calculator` to configure pricing, currency, and checkout settings.

### Step 3: **Use the Shortcode**

- Copy the shortcode `[ppc3d_stl_upload_form]` and paste it into any page or post.

== Features ==

- **STL File Support**: Seamlessly upload and process STL files for 3D printing.
- **Customizable Pricing**: Set dynamic pricing based on various configurable options, ensuring flexibility and control.
- **Model Scaling**: Easily scale your 3D models to the desired size for accurate and efficient prints.
- **Filament Price Calculator**: Automatically calculate filament costs based on your model’s volume to help manage expenses.
- **Responsive Layout**: Enjoy a seamless experience on all devices with a fully responsive design.
- **Manual model rotation**: Rotate your 3D models manually for precise adjustments before printing.
- **Infill calculation**: Calculate infill percentages to optimize material usage and structural integrity.
- **Support material calculation**: Automatically estimate the support material required for your 3D prints.
- **Email Notifications**: Receive instant updates upon successful processing, ensuring both you and your customers stay informed with all the details.
- **WP Mail Integration**: Easily integrate email functionality into your WordPress setup for streamlined communication.
- **Shortcode**: The shortcode allows you to display the plugin anywhere on the site.
- **Zoom**: Zoom in, zoom out with mouse scroll or touch.

== Frequently Asked Questions ==

= How can I upload an STL file? =

To upload an STL file, go to the designated page or post, click on the "Upload STL File" button, and select your file from your device.

= What settings do I need to configure? =

Configure pricing, currency, material, quality, and checkout options in `Settings > 3D Print Pricing Calculator`.

= Do I need an API key? =

No. The plugin can process STL data locally without requiring an external API key.

= How can I fix issues with email functionality? =

If the email functionality is not working, ensure your WordPress installation is configured to send mail. You can also use WP Mail SMTP or another mail plugin if desired.

== Installation ==

### 1. **Install the Plugin**

- **From WordPress Plugin Repository**: Search for **3D Print Pricing Calculator** and click **Install Now**.
- **Manually Upload**: Download the plugin ZIP file and go to `Plugins > Add New > Upload Plugin`. Upload the ZIP file and click **Install Now**.

### 2. **Activate the Plugin**

- After installation, click **Activate Plugin**, or activate it from the `Plugins` menu.

### 3. **Configure Plugin Settings**

- Go to `Settings > 3D Print Pricing Calculator` in the WordPress admin panel.
- Configure pricing, currency, and notification settings.

### 4. **Add the Shortcode**

- Add `[ppc3d_stl_upload_form]` to any page or post to display the calculator.

### 5. **Test the Plugin**

- Upload an STL file to the page containing the shortcode to verify the pricing and checkout flow.

== Changelog ==

= 1.4.8.8 =
- Fixed currency symbol issues.

= 1.4.0 =

- Updated plugin to operate as a standalone STL pricing calculator without requiring an external API.
- Removed dependency on third-party API credentials.

= 1.3.7 =

- Added layout design for checkout.

= 1.3.6 =

- Robust Policy Handling for Canvas Error.

= 1.3.5 =

- Enhanced canvas viewer.

= 1.3.4 =

- Fixed issues with modal loadout on Divi theme editor.
- Added compatibility for Divi theme editor.
- Added support for bulk order processing.
- Better email sending.

= 1.3.3 =

- Increased grid texture resolution for sharper lines.
- Adjusted grid line widths for better visibility.
- Adjusted ground size to fit any object size.
- Object is centered on the grid.

= 1.3.2 =

- Fixed mesh scroll issue.
- Removed UI radius for consistency.

= 1.3.1 =

- Adjusted camera targeting to center on the loaded STL model.
- Tweaked camera distance calculation to fit model height and width proportionally.
- Improved grid/bed appearance for a 3D printer bed style.
- Added environment texture option for enhanced material reflections.
- Updated material to glossy plastic for more realistic rendering

= 1.3.0 =

- Introduced a modal for admin view options configuration
- Displayed real-time API statistics on the main admin dashboard
- Added support for bulk order processing
- Improved UI for a more intuitive user experience
- Resolved various bugs and performance issues

= 1.2.2 =

- Added file management, currency settings, and API stats.
- Improved admin panel with new features.
- Included a built-in usage guide.

= 1.2.1 =

- Added enhancements for admin panel UI for better usability and a cleaner look.

= 1.2.0 =

- Introduced a new onboarding step to enhance the user setup experience.
- Redesigned the admin panel UI for better usability and a cleaner look.
- Added helpful tooltips throughout the interface to guide users more effectively.

= 1.1.0 =

- Introduced a new, improved UI for a more intuitive experience.
- Added form validations to ensure better data accuracy and user input handling.
- Calculation fixes.

= 1.0.8 =

- Added user-selected options to email output for better clarity.
- Updated the email design and layout for a more polished and user-friendly experience.

= 1.0.7 =

- Bug fixes.

= 1.0.6 =

- UI fixes.

= 1.0.5 =

- Added critical bug fixes.
- Fixed email functionality.
- Added support for WP Mail SMTP plugin to enhance email deliverability.

= 1.0.4 =

- Modified WordPress creator link.
- Corrected stable tag.

= 1.0.3 =

- Fixed critical bugs to improve overall stability.
- Added Edit and Delete functionalities to admin options for better management of settings.
- Resolved an issue with the mesh clear functionality to ensure proper rendering and cleanup.

= 1.0.2 =

- Applied critical bug fixes to address known issues.
- Improved performance and stability, enhancing the user experience.

= 1.0.1 =

- Initial public release of the plugin, introducing core features and functionality.

== Screenshots ==

1. **STL File Upload Interface**
   ![STL File Upload](/images/screenshot1.jpg)
   Description: The interface for uploading STL files.

2. **Frontend Display of Parsed Data**
   ![Frontend Display](/images/screenshot2.jpg)
   Description: Example of how the uploaded file is displayed on the frontend.

== External Libraries ==

This plugin uses Babylon.js for 3D model rendering and loads it from the CDN for optimal performance and minimal plugin footprint:

- **Babylon.js CDN**: [https://cdn.babylonjs.com/babylon.js](https://cdn.babylonjs.com/babylon.js)
- **Babylon.js Loaders CDN**: [https://cdn.babylonjs.com/loaders/babylonjs.loaders.min.js](https://cdn.babylonjs.com/loaders/babylonjs.loaders.min.js)

Babylon.js is licensed under the Apache License 2.0. For more information, visit [Apache License 2.0](http://www.apache.org/licenses/LICENSE-2.0).

== Requirements ==

- WordPress 5.7 or higher
- PHP 7.4 or higher
- Internet connection for CDN asset loading (Babylon.js)
- Local STL processing

== Compatibility ==

This plugin is fully compatible with local development environments like XAMPP, as long as the server has internet access to load Babylon.js from the CDN. All STL processing is done locally on your server.

== Support ==

If you encounter any issues or have any questions, feel free to reach out to our support team at [contact@pikocode.com](mailto:contact@pikocode.com).

== License ==

This plugin is licensed under the GNU General Public License v3.0 (or later), also known as GPLv3+. You can find the full text of the license in the [LICENSE.txt](LICENSE.txt) file included with this plugin. For more information about this license, visit the [GPL-3.0 License page](https://www.gnu.org/licenses/gpl-3.0.html).

== Support ==

If you encounter any issues or have any questions, feel free to reach out to our support team at [contact@pikocode.com](mailto:contact@pikocode.com).

== License ==

This plugin is licensed under the GNU General Public License v3.0 (or later), also known as GPLv3+. You can find the full text of the license in the [LICENSE.txt](LICENSE.txt) file included with this plugin. For more information about this license, visit the [GPL-3.0 License page](https://www.gnu.org/licenses/gpl-3.0.html).
