hesabixWCPlugin/README.md

3.5 KiB

=== 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, 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)
  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 ==

== 👨‍💻 Credits ==

Developer: Mohammad Rezai
Website: 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.