﻿=== Factorland WooCommerce Connector ===
Contributors: factorland
Tags: woocommerce, accounting, inventory, sync, factorland
Requires at least: 6.0
Tested up to: 8.5
Requires PHP: 8.1
Stable tag: 1.0.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

اتصال فروشگاه ووکامرس به سیستم حسابداری فاکتورلند برای سینک خودکار سفارشات، محصولات و موجودی

== Description ==

**Factorland WooCommerce Connector** یک پلاگین قدرتمند برای اتصال فروشگاه ووکامرس شما به سیستم مدیریت حسابداری و انبارداری فاکتورلند است.

= ویژگی‌های کلیدی =

* ✅ **سینک خودکار سفارشات** - ارسال خودکار سفارشات جدید به فاکتورلند
* ✅ **آپدیت موجودی لحظه‌ای** - بروزرسانی خودکار موجودی محصولات از فاکتورلند
* ✅ **همگام‌سازی قیمت‌ها** - بروزرسانی خودکار قیمت محصولات
* ✅ **Webhook دوطرفه** - دریافت و ارسال اطلاعات به صورت Real-time
* ✅ **لاگ کامل** - ثبت تمام فعالیت‌ها برای رفع مشکل
* ✅ **امنیت بالا** - احراز هویت HMAC و رمزنگاری داده‌ها
* ✅ **رابط کاربری ساده** - پنل مدیریت کاربرپسند و فارسی

= چرا فاکتورلند؟ =

فاکتورلند یک سیستم جامع مدیریت حسابداری و انبارداری است که به شما کمک می‌کند:

* مدیریت حرفه‌ای انبار و موجودی
* صدور فاکتور و پیگیری مالی
* گزارش‌گیری دقیق از فروش
* مدیریت مشتریان و تامین‌کنندگان
* یکپارچه‌سازی با سیستم‌های دیگر

= نحوه استفاده =

1. پلاگین را نصب و فعال کنید
2. از پنل فاکتورلند، API Token دریافت کنید
3. در تنظیمات پلاگین، اطلاعات API را وارد کنید
4. دکمه "Test Connection" را بزنید
5. سینک خودکار فعال است!

= پشتیبانی =

* 📧 ایمیل: support@factorland.ir
* 🌐 وبسایت: [factorland.ir](https://factorland.ir)
* 📚 مستندات: [factorland.ir/docs](https://factorland.ir/docs)
* 💬 تلگرام: @factorland_support

= نیازمندی‌ها =

* WordPress 6.0 یا بالاتر
* WooCommerce 7.0 یا بالاتر
* PHP 8.1 یا بالاتر
* حساب کاربری فعال در فاکتورلند

== Installation ==

= نصب خودکار =

1. به پنل مدیریت وردپرس بروید
2. به قسمت افزونه‌ها > افزودن بروید
3. "Factorland" را جستجو کنید
4. روی "نصب" و سپس "فعال‌سازی" کلیک کنید

= نصب دستی =

1. فایل ZIP پلاگین را دانلود کنید
2. به پنل مدیریت وردپرس > افزونه‌ها > افزودن بروید
3. روی "بارگذاری افزونه" کلیک کنید
4. فایل ZIP را انتخاب و آپلود کنید
5. پلاگین را فعال کنید

= تنظیمات اولیه =

1. به **Factorland > Settings** بروید
2. اطلاعات زیر را وارد کنید:
   * **API URL**: آدرس API فاکتورلند (مثال: https://api.factorland.ir)
   * **Shop ID**: شناسه فروشگاه شما
   * **API Token**: توکن دسترسی API
   * **Webhook Secret**: کلید امنیتی webhook (اختیاری)
3. روی "Save Settings" کلیک کنید
4. روی "Test Connection" کلیک کنید تا اتصال تست شود

= تنظیمات سینک =

* **Auto Sync**: فعال/غیرفعال کردن سینک خودکار
* **Sync Order Status**: انتخاب وضعیت‌های سفارش برای سینک
* **Enable Logging**: فعال/غیرفعال کردن لاگ

== Frequently Asked Questions ==

= آیا برای استفاده از این پلاگین نیاز به حساب کاربری فاکتورلند دارم؟ =

بله، شما باید یک حساب کاربری فعال در [factorland.ir](https://factorland.ir) داشته باشید.

= آیا این پلاگین رایگان است؟ =

بله، پلاگین کاملاً رایگان است. اما برای استفاده از سرویس فاکتورلند ممکن است نیاز به خرید اشتراک باشید.

= چگونه API Token دریافت کنم؟ =

1. وارد پنل فاکتورلند شوید
2. به قسمت تنظیمات > API بروید
3. روی "ایجاد Token جدید" کلیک کنید
4. Token را کپی کنید

= آیا اطلاعات من امن است؟ =

بله، تمام ارتباطات از طریق HTTPS رمزنگاری شده و از HMAC برای احراز هویت استفاده می‌شود.

= چگونه می‌توانم لاگ‌ها را ببینم؟ =

در تنظیمات پلاگین، گزینه "Enable Logging" را فعال کنید. لاگ‌ها در دیتابیس ذخیره می‌شوند.

= آیا با محصولات متغیر (Variable Products) کار می‌کند؟ =

بله، پلاگین از تمام انواع محصولات WooCommerce پشتیبانی می‌کند.

= چگونه می‌توانم سفارشات قبلی را سینک کنم؟ =

از دکمه "Sync Orders" در پنل تنظیمات استفاده کنید.

= آیا با پلاگین‌های دیگر سازگار است؟ =

بله، این پلاگین با اکثر پلاگین‌های معتبر WooCommerce سازگار است.

= چگونه می‌توانم webhook را تست کنم؟ =

آدرس webhook شما: `https://yoursite.com/wp-json/factorland/v1/webhook`

می‌توانید از Postman یا cURL برای تست استفاده کنید.

= اگر خطا دریافت کردم چه کنم؟ =

1. لاگ‌ها را بررسی کنید
2. اتصال اینترنت را چک کنید
3. API Token را مجدداً وارد کنید
4. با پشتیبانی تماس بگیرید

== Screenshots ==

1. صفحه تنظیمات اصلی پلاگین
2. وضعیت اتصال و اطلاعات API
3. تنظیمات سینک خودکار
4. دکمه‌های سینک دستی محصولات و سفارشات
5. نمایش لاگ‌های سیستم
6. صفحه تست پلاگین
7. نمایش اطلاعات فاکتورلند در صفحه سفارش

== Changelog ==

= 1.0.1 - 2026-07-13 =
* 🎨 بروزرسانی رنگ‌های سیمانتیک داشبورد و پیام‌های پیامک
* 🐛 اصلاح بررسی نسخه PHP
* 🔄 بهبود سینک و رفع مشکل حلقه وبهوک

= 1.0.0 - 2026-02-04 =
* 🎉 انتشار اولیه پلاگین
* ✅ سینک خودکار سفارشات به فاکتورلند
* ✅ آپدیت خودکار موجودی از فاکتورلند
* ✅ آپدیت خودکار قیمت از فاکتورلند
* ✅ Webhook دوطرفه
* ✅ سینک دستی محصولات
* ✅ سینک دستی سفارشات
* ✅ سیستم لاگ کامل
* ✅ احراز هویت HMAC
* ✅ پنل تست و دیباگ
* ✅ رابط کاربری فارسی

== Upgrade Notice ==

= 1.0.1 =
بهبودهای رابط کاربری و رفع اشکالات سینک. بروزرسانی توصیه می‌شود.

= 1.0.0 =
نسخه اول پلاگین منتشر شد. نصب و لذت ببرید!

== Additional Info ==

= حریم خصوصی =

این پلاگین اطلاعات زیر را به سرور فاکتورلند ارسال می‌کند:

* اطلاعات سفارشات (نام، آدرس، شماره تماس مشتری)
* اطلاعات محصولات (نام، قیمت، موجودی)
* وضعیت سفارشات

هیچ اطلاعات پرداخت یا کارت بانکی ارسال نمی‌شود.

= توسعه‌دهندگان =

کد منبع پلاگین در GitHub موجود است:
[github.com/factorland/woocommerce-connector](https://github.com/factorland/woocommerce-connector)

= Hooks & Filters =

**Actions:**
* `factorland_order_sent` - بعد از ارسال سفارش
* `factorland_stock_updated` - بعد از آپدیت موجودی
* `factorland_price_updated` - بعد از آپدیت قیمت
* `factorland_product_created` - بعد از ایجاد محصول
* `factorland_product_updated` - بعد از آپدیت محصول

**Filters:**
* `factorland_order_data` - فیلتر داده‌های سفارش قبل از ارسال
* `factorland_product_data` - فیلتر داده‌های محصول قبل از ارسال
* `factorland_sync_statuses` - فیلتر وضعیت‌های قابل سینک

مثال استفاده:

```php
add_action('factorland_order_sent', function($order_id, $factorland_id) {
    // کد شما
}, 10, 2);

add_filter('factorland_order_data', function($data, $order) {
    // تغییر داده‌ها
    return $data;
}, 10, 2);
== Credits ==

توسعه: تیم فاکتورلند
طراحی UI: استودیو طراحی فاکتورلند
تست: تیم QA فاکتورلند
با تشکر از جامعه وردپرس و WooCommerce

== Support ==

برای دریافت پشتیبانی:

📧 ایمیل: support@factorland.ir
🌐 تیکت: factorland.ir/support
📚 مستندات: factorland.ir/docs
💬 تلگرام: @factorland_support