=== Indian GST Invoice Suite ===
Plugin Name: Indian GST Invoice Suite
Contributors: jblgroup
Tags: indian gst, woocommerce, gst invoice, gst, indian tax
Requires at least: 5.0
Tested up to: 6.8
Requires PHP: 8.2
Stable tag: 1.2.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Generate GST Compliant PDF invoices, Supports CGST/SGST/IGST, HSN/SAC, and more for WooCommerce.

== Description ==

**Indian GST Invoice Suite** is a complete GST invoicing solution for WooCommerce stores operating in India.  
It automatically generates **GST-compliant PDF invoices** with GSTIN, HSN/SAC, CGST, SGST, IGST calculations, and supports download invoices.

**Perfect for:**
E-commerce businesses in India that need **professional, GST-compliant** invoices for customers and tax filing.

**Key Features:**
* Generate GST-compliant PDF invoices for WooCommerce orders.
* Show GSTIN, HSN/SAC codes, and tax slab details.
* Auto-calculates CGST, SGST, and IGST based on store & customer location.
* Compatible with variable and grouped products.
* Customizable invoice number.
* Customers can download Invoice PDF from **My Account → Orders** (Only Completed Orders)

**Add-ons Available:**
* **Packing Slips Addon** - Generate Packing Slips for warehouse. **(Free)**
* **Order List Addon** - Add invoice download button in WooCommerce admin order list. **(Pro)**
* **Delivery Note Addon** - Generate Delivery Labels with Customer Sign Area and Product list. **(Pro)**
* **Shipping Labels Addon** - Generate Shipping Labels with Courier Name and AWB Number and bar code. **(Paid)**
* **Model Number Addon** – Model Number Addon lets you store and display unique product model codes for electronics etc. **(Pro)**

**Add-ons Coming Soon:**
* **Email Invoice PDF Addon** - Automatically attach Invoice to order emails (when order is completed).
* **GST Filing Tool Addon** – Helps with monthly GST filing (GSTR-1, GSTR-3B prep).
* **Serial Number Addon** – for Electronics Goods etc.
* **Expiry Date Addon** – for Medicines and perishables.
* **Batch Number Addon** – for Medicines and perishables.
* **Multiple Invoice Templates**
* **Multiple Shipping Label Templates**

**Add-ons in Mind (Future Plan):**
* **Pro Forma Invoice Addon** – Generate pre-payment invoices (quotation-style).
* **Bulk PDF Generator Addon** - Download invoices, Packing Slips, Shipping Labels for multiple orders at once.
* **And Many More**

== Installation ==

**Important:** Requires the **WooCommerce** plugin to be installed and activated.
**Important:** Requires the PHP Extensions **gd** (cPanel: Enable it from Select PHP Version > Extensions > Check gd)

1. Upload the plugin files to the `/wp-content/plugins/indian-gst-invoice-suite` directory, or install it via the WordPress Plugins screen.
2. Activate the plugin through the 'Plugins' menu in WordPress.

3. Go to **WooCommerce → Settings → General** and configure:
   * Enable taxes = Checked

4. Go to **Indian GST → General Settings** and configure:
   * Your GSTIN number
   * Store State
   * GST Slab Rates
   * Save Settings
   * Regenerate GST Rates
   
5. Go to **Products → All Products** Edit existing product or Add new product
   * Tax status = Taxable
   * Setect GST Rate from dropdown
   * Enter HSN/SAC (optional)

6. Place an order

7. Go to **WooCommerce → Orders** Edit the order download invoice PDF.

== Frequently Asked Questions ==

= Does this plugin work for GST outside India? =
No. This plugin is specifically designed for Indian GST rules.

= Can customers download invoices from My Account? =
Yes, you can enable the download button in the customer's order view.

= Can I customize the invoice template? =
Yes. You can override the template in your theme or use the template editor.

== Screenshots ==

1. **Indian GST Settings** – Configure GSTIN, store state, and tax slabs.
2. **Invoice Settings** – Select invoice template, custom invoice number.
3. **WooCommerce Order Edit Page** – Download invoice buttons in admin.
4. **Add-ons Available** – Currently 3 Paid Addons are available.
5. **Invoice Example** – Free Invoice template preview.

== Changelog ==

= 1.2.1 =
* Fix Invoice Template CSS (Bug Fix)

= 1.2.0 =
* Fix GST Store Settings (Major Bug Fix)

= 1.1.0 =
* Fix Minor Bug
* Plugin name changed "Indian GST Woo Invoice" to "Indian GST Invoice Suite"
* Slug changed indian-gst-woo-invoice to indian-gst-invoice-suite
* Text domain changed indian-gst-woo-invoice to indian-gst-invoice-suite
* Added code to block direct access in activate.php
* Remove inline <style> code from notice.php
* Library picqer/php-barcode-generator updated to v3.2.3
* Fix Variation (Variable Products) GST rates issue
* Add addons and plugins Dependency check for available addons

= 1.0.0 =
* Initial release.
* Generate GST-compliant PDF invoices.
* Added HSN/SAC, CGST, SGST, IGST support.
* Download invoices from order edit page (Admin).
* Download invoices from My Account → Orders (Customers).

== External services ==
This plugin does not connect to any third-party services.

== Privacy ==
This plugin does not collect or share any personal data.  
It does not send any information to external servers.  
All invoice and tax data is stored locally within your WordPress database.

== Developer Notes ==
This plugin follows WordPress coding standards and enqueues all CSS/JS properly.  
In certain cases, inline `<style>` blocks are used inside PDF template files only.  
Reason: These templates are rendered by the PDF generator (dompdf/dompdf). WordPress functions like `wp_enqueue_style()` cannot be applied in this context because the output is not a browser page, but a static PDF.  
The inline CSS is always loaded from local files bundled with the plugin and does not include any dynamic code or external requests. This approach is required for correct PDF rendering.
All front-end and admin scripts/styles outside of PDF templates are enqueued using `wp_enqueue_style()` and `wp_enqueue_script()`.

== License ==
This plugin is licensed under the GPL v2 or later.  
You are free to use, modify, and redistribute it under the same license.

== Credits ==
Developed by **Radha Solution (jblgroup)**  
Built for use with [WooCommerce](https://wordpress.org/plugins/woocommerce/)

= Third-Party Libraries =
This plugin bundles and uses the following open-source libraries:

1. [picqer/php-barcode-generator](https://github.com/picqer/php-barcode-generator)  
   - Purpose: Generate barcodes (used in invoices).  
   - License: MIT License (GPL-compatible).  

2. [dompdf/dompdf](https://github.com/dompdf/dompdf)  
   - Purpose: PDF rendering for invoices.  
   - License: LGPL v2.1 or later (GPL-compatible).  
