=== خروجی اکسل سفارش‌های ووکامرس NH2T ===
مشارکت‌کنندگان: NaderHt
پیوند حمایت مالی: https://naderdev.com/
برچسب‌ها: ووکامرس، خروجی، اکسل، سفارش‌ها، خروجی سفارش‌ها
حداقل نسخه وردپرس: 6.5
آزمایش‌شده تا وردپرس: 7.1
حداقل نسخه PHP: 8.1
حداقل نسخه ووکامرس: 8.0
آزمایش‌شده تا ووکامرس: 11.0
نسخه پایدار: 1.3.4
مجوز: GPL نسخه 2 یا بالاتر
نشانی مجوز: https://www.gnu.org/licenses/gpl-2.0.html

از سفارش‌های ووکامرس با انتخابگر تاریخ شمسی و گزینه‌های فیلتر در قالب اکسل خروجی بگیرید.

== توضیحات ==

این افزونه به شما امکان می‌دهد سفارش‌های ووکامرس را با امکانات زیر در فایل اکسل خروجی بگیرید:

**حریم خصوصی در اولویت است:** اطلاعات مشتریان شما هرگز از وب‌سایتتان خارج نمی‌شود و به سرورهای بیرونی یا سرویس‌های شخص ثالث ارسال نمی‌شود.

* فیلتر سفارش‌ها بر اساس بازه تاریخ (با پشتیبانی از تقویم شمسی)
* انتخاب وضعیت‌های سفارش با دکمه‌های «انتخاب همه» و «پاک کردن همه»
* انتخاب ستون‌های اکسل و تغییر ترتیب با کشیدن یا دکمه‌های بالا و پایین
* ذخیره خودکار وضعیت‌ها، ستون‌های انتخاب‌شده و ترتیب آن‌ها برای هر کاربر در هر سایت
* خروجی گرفتن از ستون‌های رایگان، شامل:
  * شماره و وضعیت سفارش
  * تاریخ سفارش و اطلاعات مشتری (نام و نام خانوادگی، ایمیل، موبایل و نشانی)
  * نام، تعداد، قیمت واحد ثبت‌شده و تخفیف هر محصول در یک سلول چندخطی و خوانا
  * تخفیف و هزینه ارسال
  * مبلغ کل سفارش

هر سفارش در یک ردیف قرار می‌گیرد. هر ۱۱ ستون رایگان به‌صورت پیش‌فرض انتخاب شده‌اند. سه ستون روش پرداخت، روش ارسال و مبدأ ورود مشتری نمایش داده می‌شوند اما در نسخه رایگان غیرفعال هستند و ساختار دسترسی آن‌ها برای افزونه Pro آینده آماده است.

== نصب ==

1. فایل‌های افزونه را در مسیر `/wp-content/plugins/nh2t-orders-export-to-excel-for-woocommerce` بارگذاری کنید.
2. افزونه را از صفحه «افزونه‌ها» در وردپرس فعال کنید.
3. برای استفاده از افزونه، به «ووکامرس ← خروجی سفارش‌ها» بروید.

== پرسش‌های متداول ==

= آیا افزونه جانبی می‌تواند ستون خروجی اضافه کند؟ =

بله؛ از نسخه 1.3.3، ثبت ستون با هوک nh2t_wooex_columns و تأمین مقدار خام با هوک nh2t_wooex_column_value ممکن است. مقدار سفارشی به‌صورت متن امن صادر می‌شود. قرارداد اتصال، تشخیص نسخه API و مثال کامل ستون کد معرف در docs/integrations.md آمده است. این قابلیت فیلتر سفارش یا فیلد تسویه‌حساب اضافه نمی‌کند.

= آیا انتخاب ستون‌ها و وضعیت‌ها ذخیره می‌شود؟ =

بله؛ تغییرات، از جمله ترتیب ستون‌ها و انتخاب خالی، به‌صورت خودکار برای حساب شما در سایت فعلی ذخیره می‌شوند و به دریافت خروجی نیازی نیست. پیام ذخیره موفق نمایش داده می‌شود و در صورت خطا امکان تلاش دوباره وجود دارد. برای دریافت خروجی باید دست‌کم یک وضعیت و یک ستون فعال انتخاب کنید.

= چند محصول در فایل اکسل چگونه نمایش داده می‌شوند؟ =

محصولات در یک سلول با شماره و سطر خالی از هم جدا می‌شوند. هر محصول شامل نام، تعداد، قیمت واحد قبل از تخفیف و مبلغ تخفیف کل همان ردیف محصول است. قیمت واحد و تخفیف بدون مالیات و از اطلاعات ثبت‌شده سفارش خوانده می‌شوند؛ بنابراین تغییر قیمت یا حذف محصول بر خروجی سفارش قدیمی اثر ندارد. جمع تخفیف و هزینه ارسال بدون مالیات هستند و مبلغ نهایی همان مبلغ ذخیره‌شده در ووکامرس است. دقت اعشار از تنظیمات ارز فروشگاه پیروی می‌کند.

= کدام ستون‌ها برای Pro در نظر گرفته شده‌اند؟ =

روش پرداخت، روش ارسال و مبدأ ورود مشتری. این ستون‌ها در نسخه رایگان قابل انتخاب یا خروجی نیستند. ساختار دسترسی برای افزونه Pro آینده آماده است. مبدأ ورود از اطلاعات انتساب سفارش ووکامرس خوانده می‌شود و برای سفارش فاقد این اطلاعات «نامشخص» خواهد بود.

= آیا این افزونه با آخرین نسخه ووکامرس کار می‌کند؟ =

بله، افزونه با ووکامرس نسخه 8.0 تا 11.0 آزمایش شده است.

= آیا می‌توانم سفارش‌های یک بازه تاریخی مشخص را خروجی بگیرم؟ =

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

= چه وضعیت‌هایی از سفارش پشتیبانی می‌شوند؟ =

تمام وضعیت‌های سفارش ووکامرس پشتیبانی می‌شوند.

= آیا افزونه با HPOS ووکامرس سازگار است؟ =

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

= آیا اطلاعات مشتریان به سرور بیرونی ارسال می‌شود؟ =

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

= آیا فایل خروجی روی سرور میزبان ذخیره می‌شود؟ =

خیر، فایل خروجی به‌صورت موقت ساخته و مستقیماً روی دستگاه شما دانلود می‌شود. این فایل به‌طور دائمی روی سرور میزبان ذخیره نمی‌شود.

= آیا افزونه از تقویم فارسی (جلالی) پشتیبانی می‌کند؟ =

بله، افزونه از تقویم فارسی (جلالی) پشتیبانی می‌کند و می‌تواند تاریخ سفارش‌ها را در قالب تاریخ جلالی خروجی بگیرد.

= آیا افزونه اطلاعات سفارش را تغییر می‌دهد؟ =

خیر، افزونه فقط اطلاعات سفارش را برای ساخت فایل خروجی می‌خواند و هیچ‌یک از اطلاعات سفارش را تغییر نمی‌دهد یا حذف نمی‌کند.

== تصاویر ==

1. صفحه تنظیمات خروجی با انتخابگر تاریخ و فیلترهای وضعیت
2. فایل اکسل ساخته‌شده به‌همراه جزئیات سفارش‌ها

== تاریخچه تغییرات ==

= 1.3.4 =
* ذخیره مبالغ به صورت عدد واقعی در اکسل و افزودن ردیف جمع تخفیف، حمل‌ونقل و جمع کل برای ستون‌های انتخاب‌شده.

= 1.3.3 =
* هوک ثبت و اعتبارسنجی ستون سفارشی و هوک تأمین مقدار آن با نسخه API اتصال 1.0.0 اضافه شدند.
* مقادیر سفارشی به‌صورت متن امن با حفظ صفرهای ابتدایی و کدهای طولانی صادر می‌شوند و به فرمول، لینک یا قالب‌بندی تبدیل نمی‌شوند.
* هنگام اضافه یا حذف شدن ستون افزونه جانبی، انتخاب‌های ذخیره‌شده کاربران و محدودیت Pro حفظ می‌شوند.
* نمونه اتصال کد معرف با API متای سفارش ووکامرس مستند شد؛ فیلتر تاریخ و وضعیت تغییری نکرد.

= 1.3.2 =
* پس از تغییر تاریخ شمسی، خروجی با تاریخ فعلی تقویم گرفته می‌شود و تاریخ قبلی از حافظه خوانده نمی‌شود.
* پس از پاک کردن یا ویرایش دستی تاریخ، از ارسال انتخاب قبلی تقویم جلوگیری می‌شود.

= 1.3.1 =
* در صورت نبود سفارش مطابق فیلترها، پیام اطلاع‌رسانی نمایش داده می‌شود و فایل خالی دانلود نمی‌شود.
* نمایش متن خطاهای واقعی سرور هنگام دریافت پاسخ خروجی اصلاح شد.

= 1.3 =
* دکمه‌های انتخاب همه و پاک کردن همه برای وضعیت‌های سفارش اضافه شدند.
* ۱۴ ستون تعریف شد؛ ۱۱ ستون رایگان به‌صورت پیش‌فرض انتخاب و ۳ ستون برای Pro غیرفعال هستند.
* ایمیل مشتری، انتخاب ستون‌ها و مرتب‌سازی با کشیدن یا دکمه‌های بالا و پایین اضافه شدند.
* تنظیمات برای هر کاربر و سایت، مستقل از دریافت خروجی، به‌صورت خودکار ذخیره می‌شوند.
* محصولات هر سفارش در یک سلول چندخطی با شماره، قیمت واحد ثبت‌شده و تخفیف هر ردیف نمایش داده می‌شوند.
* شماره سفارشی سفارش، مقادیر متنی و دقت اعشار مبالغ حفظ می‌شوند.
* کنترل دسترسی ستون‌ها در سرور و امکان توسعه Pro اضافه شدند.
* ترجمه کامل فارسی رابط کاربری و ستون‌ها همراه افزونه قرار گرفت.
* در صورت وجود ترجمه قدیمی در پوشه زبان سایت، متن‌های جاافتاده از ترجمه همراه افزونه تکمیل می‌شوند و ترجمه‌های سفارشی قبلی حفظ می‌شوند.

= 1.2.7 =
* از توقف خروجی هنگام خالی یا غیرعددی بودن قیمت محصول یا سایر مبالغ سفارش جلوگیری شد.

= 1.2.6 =
* ترجمه کامل فارسی برای رابط کاربری و اطلاعات افزونه اضافه شد.
* نسخه کاملاً فارسی فایل راهنما اضافه شد.
* ترجمه‌های همراه افزونه با text domain یکسان با نامک افزونه بارگذاری می‌شوند.

= 1.2.5 =
* پیشوندگذاری فضای نام کتابخانه همراه SimpleXLSXGen برای جلوگیری از تداخل با افزونه‌ها و پوسته‌های دیگر.

= 1.2.4 =
* text domain با نامک افزونه یکسان شد.

= 1.2.3 =
* برچسب‌های ردیف محصول در خروجی اکسل ترجمه‌پذیر شدند.

= 1.2.2 =
* فایل‌های خروجی در حافظه ساخته و بدون نوشتن فایل اجرایی، مستقیماً ارسال می‌شوند.

= 1.2.1 =
* فایل‌های CSS و JavaScript مدیریت از طریق APIهای enqueue وردپرس بارگذاری می‌شوند.
* اعتبارسنجی خروجی و امنیت دانلود بهبود یافت.
* اطلاعات مشتری در خروجی اکسل به‌صورت متن خالص نگهداری می‌شود.

= 1.2.0 =
* کلاس تاریخ و زمان جلالی (شمسی) برای تبدیل تاریخ میلادی به جلالی در سایت‌های فارسی اضافه شد.

= 1.1.0 =
* پشتیبانی از ساخت فایل‌های `.xlsx` اضافه شد.

= 1.0.0 =
* انتشار اولیه
* قابلیت پایه خروجی گرفتن از سفارش‌ها
* یکپارچه‌سازی انتخابگر تاریخ شمسی
* فیلتر وضعیت سفارش‌ها

== اطلاعیه به‌روزرسانی ==

= 1.3.3 =
افزونه‌های جانبی می‌توانند ستون اختیاری اکسل ثبت کنند. تنظیمات قبلی و فیلتر تاریخ و وضعیت حفظ شده و مقادیر سفارشی به‌صورت متن امن صادر می‌شوند.

= 1.3 =
ستون‌های اکسل را انتخاب و مرتب کنید؛ انتخاب وضعیت‌ها و ستون‌ها ذخیره می‌شود و محصولات هر سفارش در یک سلول خوانا نمایش داده می‌شوند. شامل ۱۱ ستون رایگان و ساختار آماده برای امکانات Pro آینده.

= 1.2.7 =
خطای خروجی برای محصولات بدون قیمت و سایر مبالغ خالی ووکامرس برطرف شد.

= 1.2.6 =
بومی‌سازی کامل فارسی اضافه شد و بارگذاری صحیح ترجمه‌های همراه افزونه تضمین شد.
