Printful Integration for Botble E-commerce Store By Viral Addons

A powerful, multi-vendor compatible integration between Printful and your Botble E-commerce store. This plugin allows both the platform owner (Admin) and individual Vendors to sync products, calculate live shipping rates, and automate order fulfillment.

Multi-Vendor Support: Works seamlessly with or without the Botble Marketplace plugin.

Hierarchical Category Sync: Automatically mirrors Printful's category tree (e.g., Men's > Hoodies > Sweatshirts) into Botble.

Automated Webhooks: One-click setup to receive real-time updates from Printful for package shipping and order tracking.

Live Shipping Rates: Real-time shipping calculation during checkout using Printful's API, with customizable markup and mixed-cart strategies.

Intelligent Description Sync: Choose whether to pull descriptions from Printful or keep your store descriptions.

Dynamic Slug Generation: Automatically generates SEO-friendly URLs for all synced products and categories.

Cache Optimization: Automatically flushes category caches after sync to ensure new items appear in menus immediately.

1. Navigate to Printful Integration > Settings in the Admin panel.

2. Enter your Admin Printful API Token.

3. Configure your Mixed Cart Strategy (How to handle shipping when both Printful and store items are in the cart).

4. (Optional) Set a Default Category for fallback.

5. Click Register Webhooks Automatically to enable real-time tracking updates.

1. Vendors can find the Printful Settings tab under their Store Settings in the Vendor Dashboard.

2. Vendors enter their own private Printful API Token.

3. Vendors can set their own Shipping Markup and Default Category.

1. Admin Sync: Use the "Sync Printful Products (Admin Store)" button in the global settings to sync products owned by the main store.

2. Vendor Sync: Vendors use the "Sync Printful Products" button in their dashboard to pull their specific Printful products.

When a customer's cart contains mixed items, you can choose from:

1. Combine: Sum of Printful rates + Store shipping rates.

2. Highest Rate Only: Charge only the most expensive rate found in the cart.

3. Printful Shipping Only: Ignore store shipping rules if Printful items are present.

4. Standard Botble Shipping Only: Ignore Printful API rates and use your store rules.

Module Namespace: ViralAddons\PrinfulIntegration

Version: 1.0.0

Minimum Requirements: PHP 8.1+, Botble E-commerce Core.

Optional: Botble Marketplace Plugin.

Initial Release

Update UI: Completely redesigned the Printful settings dashboard with a clean, responsive layout and tabbed navigation.

Modernized Catalog Management: Added AJAX-powered catalog loading and a real-time progress bar to handle product syncing smoothly.

Fix Duplicate Product Import: Implemented logic to detect and prevent duplicate product entries during the import process.

Fix Bugs in Order Sync: Resolved issues with customer email validation and shipping address formatting to ensure reliable order transfers.

Enhanced Address Validation: Added automatic state-to-ISO code conversion for India, USA, Canada, and Australia to meet Printful API requirements.

Multi-Vendor API Support: Fixed authentication logic to ensure vendor-specific API tokens are correctly utilized for their respective products.