Smart Woo Alamin 🚀

Dynamic Single Product Specifications Showcase & Steadfast Courier Live Order Tracking for WooCommerce.

🌟 Overview

Smart Woo Alamin is an all-in-one WooCommerce enhancement plugin designed for high conversion, modern ecommerce aesthetics, and automated parcel tracking in Bangladesh.

It delivers:

1. Premium Single Product Showcase: Pixel-perfect product specification cards, top feature badges, "Why You'll Love" section, dynamic size guide with custom diagram upload, and Bengali wash care instructions.
2. Steadfast Courier Live Tracking: Instant real-time parcel tracking via official Steadfast Courier API with live interactive timeline stepper and color-coded status badges.

✨ Key Features

1. 🛍️ Dynamic Product Showcase & Specifications

• Top 6 Badges Grid: Clean vector SVG icons highlighting essential product metrics (e.g. 100% Combed Cotton, 180-200 GSM Fabric, Premium DTF Print, Breathable & Soft, Low Shrinkage, Everyday Comfort).
• "Why You'll Love" Highlight Banner: Catchy headline, customizable Bengali description, and 5 circular feature icons (Soft & Smooth, Breathable, Sweat Friendly, Premium Look, Durable & Long Lasting) with Bengali subtitles.
• Detailed Specifications Table: Clean key-value specification list aligned with precision.
• Premium DTF Print Block: Highlight box with checkmark bullet points and custom image uploader.
• Print Care Pro-Tip Box: Helpful tips with lightbulb alert.
• Interactive Size Guide:
  • T-shirt measurement visual diagram.
  • Custom Image Upload: Upload any PNG, JPG, SVG, or WebP diagram per product or globally, with instant fallback to the default vector SVG diagram.
  • Dynamic size chart table (M, L, XL, XXL, etc.).
  • Size selection alert notice.
• Wash Care Rules: 6 Bengali care instructions with clean vector icons.
• Gutenberg & Classic Theme Compatible: Works seamlessly with Classic WooCommerce themes, Gutenberg / FSE blocks (data-block-name="woocommerce/product-details"), Elementor, Flatsome, Astra, WoodMart, and Divi.
• 100% Dynamic & Editable:
  • Global defaults configured in Smart Woo > All Settings.
  • Per-product override via the product edit screen metabox.

2. 🚚 Steadfast Courier Live Tracking Integration

• Direct Official API: Connects directly to Steadfast Courier API endpoints (status_by_cid, status_by_trackingcode, status_by_invoice, get_balance).
• Live Frontend Tracking Shortcode:

  [steadfast_tracking]

  (Alias: [smart_order_tracking])

• Real-Time AJAX Search: Customers can search by Consignment ID (CID), Tracking Code, Invoice ID, or WooCommerce Order ID without page reload.
• Visual 4-Step Progress Bar:
  • Step 1: Order Received (অর্ডার গ্রহণ)
  • Step 2: Processing / Hub (প্রক্রিয়াধীন)
  • Step 3: In Transit (ডেলিভারির পথে)
  • Step 4: Delivered (ডেলিভারি সম্পন্ন)
• WooCommerce Admin Order Screen:
  • Adds a live Steadfast Tracking metabox inside the WooCommerce Order edit screen with HPOS (High-Performance Order Storage) support.

📂 Plugin Structure

smart-woo-alamin/
├── smart-woo-alamin.php             # Main plugin bootstrap & metadata
├── readme.txt                       # WordPress Plugin Directory readme
├── README.md                        # GitHub documentation
├── .gitignore                       # Git ignore rules
├── includes/
│   ├── class-plugin.php             # Core plugin orchestrator & HPOS support
│   ├── class-icons.php              # Crisp inline SVG vector icons
│   ├── class-steadfast-api.php      # Steadfast API client & status mapper
│   ├── class-admin-settings.php     # Global settings page & API tester
│   ├── class-product-metabox.php    # Per-product customization metabox
│   ├── class-frontend-showcase.php  # Frontend showcase renderer & block filter
│   ├── class-tracking-shortcode.php # Frontend tracking shortcode & AJAX
│   └── class-order-metabox.php      # WooCommerce Admin Order tracking box
├── templates/
│   ├── single-product-showcase.php  # Product showcase layout template
│   └── tracking-form.php            # Steadfast tracking form & results template
└── assets/
    ├── css/
    │   ├── admin-style.css          # Admin settings & metabox styles
    │   ├── frontend-showcase.css    # Single product showcase stylesheet
    │   └── tracking-style.css       # Frontend tracking styles
    └── js/
        ├── admin-script.js          # Admin repeaters, image uploader & API test
        └── tracking-script.js       # Frontend AJAX tracking handler

🚀 Installation & Setup

1. Install Plugin:
   • Clone or download this repository into your WordPress plugins directory:

     cd wp-content/plugins/
     git clone https://github.com/developeralaminvi/smart-woo-alamin.git

2. Activate Plugin:
   • In your WordPress Admin Dashboard, navigate to Plugins and click Activate under Smart Woo Alamin.
3. Configure Settings:
   • Go to Smart Woo > All Settings in the WordPress menu.
   • Customize default texts, colors, size chart rows, or upload a custom size diagram.
   • Under Steadfast Courier API & Tracker, enter your Steadfast API Key and Secret Key. Click Test Steadfast API Connection to verify your account balance.
4. Publish Live Tracking Page:
   • Create a page in WordPress (e.g. Track Your Order) and add the shortcode:

     [steadfast_tracking]

🏷️ Shortcodes Reference

🛡️ License

This project is licensed under the GNU General Public License v2.0 or later.

👨‍💻 Author & Credits

Developed by Alamin & SarkarHost.
Website: https://sarkarhost.com/