=== Valabi Invoice ===
Contributors: valabi
Tags: woocommerce, invoice, pdf, persian, jalali, rtl, iran, tax-invoice
Requires at least: 6.0
Tested up to: 6.6
Requires PHP: 8.1
Stable tag: 0.5.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

صدور فاکتور (عادی، رسمی، حرارتی، برچسب ارسال) برای ووکامرس با ویرایشگر قالب و خروجی PDF فارسی.

== Description ==

افزونهٔ صدور فاکتور والابی برای ووکامرس. چهار قالب پیش‌فرض:

* **فاکتور عادی** — برای استفادهٔ روزمره و ارسال به مشتری
* **فاکتور رسمی** — مطابق الزامات سازمان امور مالیاتی (کد اقتصادی، شناسهٔ ملی، شمارهٔ ثبت، تفکیک مالیات بر ارزش افزوده، اصل/رونوشت)
* **فاکتور حرارتی** — برای پرینترهای حرارتی ۸۰mm
* **برچسب ارسال** — A5 افقی، با تأکید بر نشانی و کد پستی گیرنده

ویژگی‌ها:

* ویرایشگر HTML/CSS برای هر قالب در پنل مدیریت (با CodeMirror)
* پیش‌نمایش زندهٔ قالب در حین ویرایش
* امکان افزودن قالب‌های سفارشی، تکثیر، و بازنشانی
* خروجی PDF با mPDF و پشتیبانی کامل از RTL/فارسی
* تاریخ شمسی (morilog/jalali)
* مبلغ به حروف فارسی
* شماره‌گذاری مستقل سال مالی
* سازگار با HPOS ووکامرس
* به‌روزرسانی خودکار از مخزن خصوصی (Plugin Update Checker)

== Compliance Notice ==

از سال ۱۴۰۲ صدور فاکتور الکترونیکی برای ارسال به سامانهٔ مودیان (ITC) دارای فرمت مشخص و امضای الکترونیکی است. این افزونه برای **چاپ و آرشیو داخلی** و **ارسال نسخه به مشتری** کاربرد دارد. برای ارسال به سامانهٔ مودیان از راهکار اختصاصی استفاده کنید.

== Installation ==

1. افزونه را در `wp-content/plugins/valabi-invoice/` قرار دهید.
2. در صورت نصب از مخزن گیت، در پوشهٔ افزونه `composer install` را اجرا کنید.
3. افزونه را از پنل وردپرس فعال کنید.
4. به مسیر **فاکتور والابی → تنظیمات** بروید و اطلاعات فروشنده را وارد کنید.

== Changelog ==

= 0.5.0 =
* حذف سیستم لایسنس: افزونه دیگر به کلید نیاز ندارد و همیشه فعال است (بدون گیت، بدون صفحهٔ لایسنس). به‌جای آن یک «ضربان» فنی روزانه و بی‌صدا برای آمار استفاده ارسال می‌شود (آدرس سایت و نسخهٔ افزونه/وردپرس/ووکامرس/PHP)؛ بدون رابط کاربری و بدون اثر بر کارکرد سایت. با ثابت VALABI_INVOICE_TELEMETRY_OFF یا فیلتر valabi_invoice_telemetry_enabled قابل خاموش‌کردن است.

= 0.4.3 =
* رفع باگ فعال‌سازی لایسنس: پس از ثبت کلید، دیگر صفحهٔ «دسترسی ندارید» نمایش داده نمی‌شود و کاربر به صفحهٔ اصلی افزونه هدایت می‌شود. منوی «لایسنس» اکنون به‌جای ابتدای فهرست، در انتهای زیرمنوهای افزونه قرار می‌گیرد.
* رفع خطای ۴۰۴ در فرانت‌اند پس از فعال‌سازی (مسیرهای نمایش فاکتور): قوانین بازنویسی (rewrite rules) یک‌بار به‌صورت خودکار بازنشانی می‌شوند.

= 0.4.2 =
* افزوده شدن سیستم لایسنس والابی: افزونه با کلید معتبر فعال می‌شود و بدون آن به‌صورت ایمن غیرفعال می‌ماند (فروشگاه آسیبی نمی‌بیند). صفحهٔ «لایسنس»، بررسی روزانه، و بازهٔ مهلت در صورت در دسترس نبودن سرور. کلید لایسنس هرگز به‌صورت کامل نمایش داده نمی‌شود (فقط نسخهٔ ماسک‌شده) و نشانی سرور اعتبارسنجی نمایش داده نمی‌شود.

= 0.4.1 =
* تطبیق سیستم به‌روزرسانی با الگوی استاندارد والابی (mobodel.ir/wp-updates، کلاس Updater اختصاصی، تایم‌اوت ۱۰ ثانیه)

= 0.4.0 =
* افزودن سیستم به‌روزرسانی خودکار (Plugin Update Checker)
* طراحی جدید برای صفحات مدیریت با لهجهٔ بصری مستقل
* افزایش حاشیهٔ صفحه به ۱۰٪ (مطابق با اندازهٔ هر برگ)
* رفع باگ نمایش واحد پول (`&nbsp;` در ستون قیمت)
* پیش‌نمایش زنده در ویرایشگر قالب با پشتیبانی از فونت وزیر متن
* انتخابگر آیکون با ۶۰ آیکون
* انتخابگر رنگ برای پس‌زمینه و آیکون هر قالب

= 0.3.0 =
* انتشار اولیهٔ ویرایشگر قالب با Twig
* پیش‌نمایش زندهٔ قالب در پنل
* افزودن قالب «برچسب ارسال»

= 0.2.0 =
* ثبت قالب‌ها در پایگاه داده (مقاوم در برابر به‌روزرسانی)
* امکان افزودن، تکثیر، و حذف قالب‌های سفارشی
* انتخاب مکان نمایش هر قالب (باکس سفارش، ستون لیست، عملیات گروهی، حساب کاربری)

= 0.1.0 =
* انتشار اولیه.
