hesabixWCPlugin/README.md

=== Hesabix for WooCommerce ===
Contributors: Mohammad Rezai
Tags: accounting, hesabix, woocommerce, jalali, invoice, integration, persian
Requires at least: 5.2
Tested up to: 6.6.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Modern, localized, and secure WooCommerce integration with Hesabix Cloud Accounting. Featuring full Jalali calendar support, real-time data sync, and advanced customization for Persian e-commerce.

== 🧩 Overview ==

**Hesabix for WooCommerce** connects your online store with [Hesabix](https://hesabix.ir), the powerful cloud-based accounting system built for Persian businesses.

From real-time product, order, and customer sync to full Persian date support, this plugin is everything a modern Iranian online store needs to automate its bookkeeping.

== ✨ Features ==

### 🔗 Seamless Integration
- Automatically syncs products, orders, and customers with your Hesabix account
- One-click synchronization for bulk data
- AJAX-powered UI for responsive operations

### 📅 Persian Calendar Support
- Native Jalali calendar UI
- Gregorian ↔ Jalali date conversion
- Custom date filters and ranges

### 💼 Smart Customer Handling
- Auto-create customers in Hesabix from WooCommerce orders
- National ID, economic code, and business info fields
- Custom checkout fields with flexible validation

### 🧾 Invoice & Finance Management
- Instant invoice generation on new orders
- Freight and shipping cost handling
- Payment method mapping

### ⚙️ Developer Tools
- Clean, modular code with hooks and filters
- Extendable data mappers for products and customers
- Debug logs and status monitoring

### 🌐 Localization & UI 
- Fully RTL and Persian language ready
- Modern, tabbed admin interface
- Responsive and mobile-friendly

== 🛠️ Installation & Setup ==

1. Upload the plugin to `/wp-content/plugins/hesabix-woocommerce/`
2. Activate via **Plugins > Hesabix for WooCommerce**
3. Go to **WooCommerce > Hesabix Settings**
4. Enter your API Key (get it from your [Hesabix account](https://app.hesabix.ir))
5. Test connection and start syncing!

== ❓ Frequently Asked Questions ==

**How do I get an API key?**  
Log in to your Hesabix account and navigate to *Settings > API*. Copy the key and paste it into the plugin settings.

**Is it compatible with Persian WooCommerce stores?**  
Yes — fully RTL compatible, Persian translations included, and Jalali calendar support is native.

**Can I control what data gets synced?**  
Absolutely — toggle options for each data type and use filters to customize.

**Does it work with subscription products?**  
Currently designed for standard WooCommerce orders.

**Is my data safe?**  
Yes — we follow WordPress best practices including nonce verification, secure API connections, and local data handling.

== 🖼️ Screenshots ==

1. Plugin Dashboard with sync status
2. Customer field customization
3. Jalali date picker for filtering
4. Invoice configuration
5. Product linking interface

== 🌐 Resources ==

- [Official Website](https://hesabix.ir)
- [User Guide](https://hesabix.ir/school)
- [Support](https://hesabix.ir/support)

== 👨‍💻 Credits ==

**Developer**: Mohammad Rezai  
**Website**: [pirouz.xyz](https://pirouz.xyz)

== 🔐 License ==

This plugin is licensed under the GPLv3. You are free to modify, distribute, and use it under the terms of the license.

== 🛡️ Privacy ==

No personal data is collected by this plugin. All communications are strictly between your WordPress site and Hesabix servers.