فاکتور ووکامرس فارسی: در یک افزونه حروف PDF برعکس شد، در یکی مربع و در یکی ایمیل سفارش نرفت

رسید فاکتور با سه ردیف: نام فروشگاه آینه‌ای در WooCommerce PDF Invoice، مربع‌های خالی در PDF Invoices & Packing Slips و صفر ایمیل با خطای فونت در YITH؛ کنارش عنوان مقاله با تأکید بر «ایمیل سفارش نرفت»
محصولات زیر برای شماست...
جدیدترین مقالات
دسترسی سریع
فهرست محتوا

روز ۲۴ آبان ۱۴۰۵ یک سفارش تومانی را روی یک سایت ووکامرسی فارسی از پنج افزونه فاکتور ووکامرس گذراندیم و خروجی هر کدام را باز کردیم. سه افزونه را فروشگاه وردپرس نیاز می‌فروشد: YITH PDF Invoices، WooCommerce PDF Invoice و Print Invoices/Packing Lists از SkyVerge. دو افزونه دیگر رایگان‌اند: PDF Invoices & Packing Slips از WP Overnight و PeproDev Ultimate Invoice.

با تنظیم پیش‌فرض، فارسی در WooCommerce PDF Invoice، PDF Invoices & Packing Slips و YITH درست چاپ نشد، هر کدام به شکلی. WooCommerce PDF Invoice هر خط فارسی را آینه‌ای چاپ کرد: حروف هر کلمه و کلمه‌های هر خط برعکس آمد. PDF Invoices & Packing Slips به‌جای هر حرف فارسی یک مربع خالی گذاشت.

در YITH دکمه ساخت فاکتور برای سفارش تومانی به صفحه خطا رسید و سفارشی که با Store API ثبت شد بدون هیچ ایمیلی ذخیره شد. PeproDev بدون تغییر هیچ تنظیمی درست چاپ کرد. افزونه SkyVerge هم درست بود، ولی PDF نمی‌سازد و صفحه چاپ را در مرورگر باز می‌کند. متن‌های خود افزونه و عددهای فاکتور هم فقط در PeproDev فارسی بود.

برای WooCommerce PDF Invoice و PDF Invoices & Packing Slips یک تنظیم یا یک افزونه جانبی کافی بود. برای YITH باید سه فایل فونت به پوشه افزونه اضافه شود.

همه‌چیز روی یک سایت آزمایشی در داکر اجرا شد: وردپرس ۷٫۱٫۴ فارسی، ووکامرس ۱۱٫۳٫۰، ووکامرس فارسی ۱۰٫۰٫۷ و PHP 8.3.36. برای ساختن PDF یک سفارش را با اسکریپت ساختیم: یک کفش کوهنوردی و دو کیف چرمی، با حمل و نقل پیک موتوری و پرداخت در محل. هر PDF را با دکمه خود افزونه در صفحه سفارش ساختیم.

برای ایمیل‌ها سفارش‌های دیگری هم ثبت کردیم، با درخواست‌های Store API ووکامرس، که فقط یک کفش داشتند؛ صفحه تسویه حساب را در مرورگر پر نکردیم. برای YITH یک سفارش دلاری و یک سفارش ریالی هم ساختیم. از هر افزونه فروشگاه همان فایلی را نصب کردیم که فروشگاه در ۲۴ آبان ۱۴۰۵ عرضه می‌کرد؛ نسخه تازه‌تر سازنده ممکن است فرق کند. ایمیل‌های سفارش را برای هر پنج افزونه شمردیم و پیوست‌ها را دیدیم. دانلود فاکتور از حساب کاربری مشتری، قانون‌های فاکتور رسمی و افزونه‌های WebToffee، Factori، iFact و فاکتورک را آزمایش نکردیم.

افزونهچاپ فارسی با تنظیم پیش‌فرضچه چیزی درستش کردفاکتور پیوست ایمیل‌های سفارش، با تنظیم پیش‌فرض
WooCommerce PDF Invoice 5.1.2آینه‌ای: حروف هر کلمه برعکسموتور PDF روی MPDF؛ با Yes شدن «Use RTL layout»، چیدمان هم راست‌به‌چپ شدبله، در ایمیل سفارش تکمیل‌شده
PDF Invoices & Packing Slips 5.16.6مربع خالی به‌جای هر حرف فارسیافزونه mPDF خود WP Overnight؛ برای چیدمان راست‌به‌چپ، تیک «RTL support»نه؛ گزینه پیوست را بررسی نکردیم
YITH PDF Invoices 4.38.0با متن فارسی پررنگ، مثل «تومان» در مبلغ نهایی، خطا می‌دهد؛ سفارش دلاری درست بودسه فایل فونت در پوشه افزونهنه
Print Invoices/Packing Lists 3.15.2صفحه چاپ مرورگر درست است؛ PDF ساخته نمی‌شودچیزی لازم نبودنه؛ ایمیل جدا با فاکتور می‌فرستد
PeproDev Ultimate Invoice 2.2.6درست، با متن‌ها و عددهای فارسیچیزی لازم نبودبله، در هر سه ایمیل

در تنظیم پیش‌فرض دو افزونه فاکتور ووکامرس فارسی را خراب چاپ می‌کنند، یکی آینه‌ای و یکی با مربع

فاکتور PDF را یک موتور PDF می‌سازد، برنامه‌ای که HTML فاکتور را به فایل PDF تبدیل می‌کند. DOMPDF و mPDF دو موتورند؛ در تنظیمات WooCommerce PDF Invoice، mPDF با نام MPDF آمده است. این افزونه فاکتور را پیش‌فرض با DOMPDF می‌سازد. راهنمای کنار همین گزینه در تنظیمات می‌گوید: «DOMPDF does not support RTL invoices. If you are using RTL in your invoice then switch to MPDF.»

در فاکتور ما هر خط فارسی آینه‌ای چاپ شد: «پرداخت در محل» به شکل «لحم رد تخادرپ» درآمد. عددها و متن لاتین سر جای خود ماندند. گزینه «Use RTL layout» را با DOMPDF روی Yes گذاشتیم و چاپ همان آینه‌ای ماند. با انتخاب MPDF حروف و ترتیب کلمه‌ها درست شد و با Yes شدن «Use RTL layout» چیدمان صفحه هم راست‌به‌چپ شد. مشتری هم همین دو حالت را در پیوست ایمیل سفارش تکمیل‌شده گرفت، اول آینه‌ای و بعد درست.

چهار برش از فاکتورهای یک سفارش: نام مشتری و نشانی در Woocommerce Pdf Invoice با تنظیم پیش‌فرض آینه‌ای و با Mpdf و چیدمان راست‌به‌چپ درست، و در Pdf Invoices &Amp; Packing Slips با تنظیم پیش‌فرض مربع‌های خالی و با افزونه Mpdf و چیدمان چپ‌به‌راست درست
چهار حالت دو افزونه

PDF Invoices & Packing Slips روی سایت راست‌به‌چپ همان لحظه اول در صفحه سفارش اعلام می‌کند که موتور PDF فعلی راست‌به‌چپ را پشتیبانی نمی‌کند و افزونه mPDF خودش را پیشنهاد می‌دهد. PDF Invoices & Packing Slips در ۲۴ آبان ۱۴۰۵ در مخزن وردپرس دست‌کم ۳۰۰ هزار نصب فعال داشت. در PDF پیش‌فرض نام فروشگاه، نام مشتری، نشانی، نام محصول‌ها و واژه «تومان» همه مربع خالی بودند. فقط متن و عددهای لاتین چاپ شدند. فونت OpenSans که فاکتور با آن ساخته شد در بازه حروف فارسی و عربی هیچ حرفی ندارد.

مستندات WP Overnight می‌گوید زبان‌های راست‌به‌چپ مثل فارسی با dompdf، موتور PDF این افزونه، درست نمایش داده نمی‌شوند. مربع‌ها علت دیگری هم داشتند، یعنی فونت. در گیت‌هاب dompdf هم درخواست پشتیبانی از ترتیب، اتصال حروف و جهت متن از سال ۲۰۲۱ باز مانده است.

بعد از نصب افزونه mPDF خود WP Overnight (نسخه ۳٫۲٫۰، زیپ ۴۹ مگابایتی) حروف درست شد و سطرهای پررنگ، مثل مبلغ نهایی، هم چاپ شدند. چیدمان تا وقتی «RTL support» را در تنظیمات عمومی تیک نزدیم چپ‌به‌راست ماند. در ایمیل‌های سفارش PDF Invoices & Packing Slips، پیش از نصب افزونه mPDF و با تنظیم پیش‌فرض، فاکتوری پیوست نبود؛ گزینه پیوست را بررسی نکردیم. افزونه دیگری با نام تقریباً مشابه، «mPDF add-on for RTL and Unicode Support»، برای افزونه WebToffee است و کنار PDF Invoices & Packing Slips فعال نشد.

YITH برای سفارش تومانی یا ریالی خطا می‌دهد و سفارش تومانی ثبت‌شده بی‌ایمیل می‌ماند

YITH PDF Invoices را با نسخه ۴٫۳۸٫۰ آزمودیم، همان که فروشگاه در ۲۴ آبان ۱۴۰۵ عرضه می‌کرد. سرویس به‌روزرسانی YITH نسخه ۵٫۶٫۰ را هم فهرست می‌کرد و آن را آزمایش نکردیم. دکمه Create در کادر «YITH PDF Invoice» برای سفارش دلاری فاکتور ساخت. همان کلیک روی سفارش تومانی صفحه «یک خطای مهم در این وب سایت وجود دارد.» داد و در لاگ سرور این خط بود:

CODE
وردپرس نیاز
PHP Fatal error:  Uncaught Mpdf\\MpdfException: Cannot find TTF TrueType font file "XB RiyazBd.ttf" in configured font directories.

آپاچی هر بک‌اسلش را در لاگ دو بار می‌نویسد. سفارش ریالی هم همین را داد. پوشه فونت‌های موتور PDF افزونه ۲۸ فایل دارد و از فونت فارسی XB Riyaz فقط وزن معمولی را. در PDF دلاری فقط فونت فارسی با وزن معمولی جا گرفته بود. PDF تومانی بعد از اصلاح فونت پررنگ را هم داشت؛ «تومان» در سطر پررنگ مبلغ نهایی آمده است. خطا از متن فارسی پررنگ یا مورب می‌آید: نام شرکت در سایت ما لاتین بود، پس فقط «تومان» پررنگ بود.

بدتر از دکمه، ثبت سفارش است. سفارش تومانی را با درخواست‌های Store API ووکامرس ثبت کردیم؛ این API سبد خرید را به سفارش تبدیل می‌کند. پاسخ «processing» بود و صفحه «سفارش دریافت شد» با کلید همان سفارش مبلغ تومانی و «متشکریم، سفارش شما دریافت شد» را نشان داد.

صفحه «سفارش دریافت شد» و جدول سفارش تومانی ۲۴، همان سفارشی که فقط یک یادداشت خطا داشت و ایمیلی برایش نرفت
صفحه سفارش دریافت شد

اما سفارش ۲۴ فقط یک یادداشت داشت، «خطا هنگام انتقال وضعیت» با همان متن فونت. نه به مدیر ایمیل «سفارش جدید» رفت و نه به مشتری ایمیل «سفارش در حال انجام». وقتی سه فایل فونت را گذاشتیم، همان ثبت سفارش (سفارش ۲۵) دو ایمیل فرستاد.

دو سفارش تومانی در Yith: سفارش ۲۴ با یک یادداشت خطا و بدون ایمیل، سفارش ۲۵ با سه یادداشت معمولی و دو ایمیل
یادداشت‌های دو سفارش

وقتی سفارش‌های تومانی را به «تکمیل‌شده» بردیم، بدون فایل‌ها، هم با کد و هم از صفحه سفارش، یادداشت خطا ماند و ایمیلی نرفت. با فایل‌ها، در سفارشی که با کد تکمیل کردیم، سه ایمیل رفت.

علت را کد افزونه نشان می‌دهد. گزینه «Enable pro-forma» پیش‌فرض روشن است و برای سفارش‌های در انتظار بررسی، در حال انجام و تکمیل‌شده پیش‌فاکتور PDF می‌سازد. پیش‌فاکتور تومانی همان فونت پررنگ را می‌خواهد. وقتی این گزینه را از صفحه تنظیمات خود افزونه خاموش کردیم و ذخیره کردیم، ثبت سفارش تومانی بدون فایل‌های فونت هم دو ایمیل فرستاد. اما فاکتور هنوز ساخته نمی‌شد: دکمه Create برای سفارش ریالی باز هم خطا داد.

راه‌حل ما اضافه کردن XB RiyazBd.ttf و XB RiyazIt.ttf و XB RiyazBdIt.ttf از بسته mPDF نسخه ۸٫۱٫۶ (همان نسخه داخل افزونه) به پوشه lib/vendor/mpdf/mpdf/ttfonts داخل پوشه افزونه بود. بعد از آن فاکتور تومانی ساخته شد و ایمیل‌ها رفتند.

در مقاله به‌روزرسانی دستی افزونه دیدیم که جایگزینی با زیپ تازه پوشه قبلی را پاک و پوشه تازه را کپی می‌کند. به‌روزرسانی عادی افزونه هم در کد وردپرس پوشه قبلی را پاک می‌کند، پس اگر نسخه تازه آن فایل‌ها را نداشته باشد، بعد از به‌روزرسانی باید دوباره اضافه شوند. صفحه محصول فروشگاه همین محدودیت فونت را از قبل نوشته است، از جمله برای نام شرکت فارسی پررنگ و دلیل استرداد فارسی مورب، اما از ایمیل‌هایی که نمی‌روند چیزی نگفته است.

فاکتور ساخته‌شده فارسی را درست چاپ می‌کند: حروف می‌چسبند و ترتیب کلمه‌ها درست است. متن‌های انگلیسی خود افزونه نقطه و پرانتزشان را سر دیگر خط می‌گذارند، مثل «:Customer info». در ایمیل‌های سفارش YITH، وقتی فایل‌ها بودند و با تنظیم پیش‌فرض، فاکتوری پیوست نبود.

افزونه چاپ SkyVerge PDF نمی‌سازد، ولی چاپ فارسی‌اش درست است

در زیپ Print Invoices/Packing Lists موتور PDF نیست. از کادر «سفارش اعمال» صفحه سفارش (Order actions)، «Print Invoice» را زدیم و یک صفحه HTML باز شد که مرورگر نشان می‌دهد و از آن چاپ می‌گیرد. حروف فارسی درست و راست‌به‌چپ بودند و تاریخ شمسی. افزونه به‌صورت خودکار دو ایمیل می‌فرستد: فاکتور برای مشتری و Packing List برای نشانی مدیر. هیچ‌کدام پیوست ندارند. «ذخیره به‌صورت PDF» از پنجره چاپ مرورگر را آزمایش نکردیم.

PeproDev بی‌هیچ تنظیمی درست چاپ کرد

PeproDev Ultimate Invoice در ۲۴ آبان ۱۴۰۵ در مخزن وردپرس دست‌کم ۵ هزار نصب فعال داشت و برای وردپرس تا ۶٫۹٫۱۱ آزمایش‌شده معرفی شده بود. بعد از فعال‌سازی فاکتور فارسی ساخت: متن‌های خود افزونه فارسی، چیدمان راست‌به‌چپ، عددها فارسی و تاریخ ۱۴۰۵/۰۸/۲۴. در خرید آزمایشی سه ایمیل (سفارش جدید برای مدیر، سفارش در حال انجام و سفارش تکمیل‌شده برای مشتری) هر کدام فاکتور را پیوست داشتند. این افزونه را فروشگاه نمی‌فروشد؛ ما آن را از مخزن وردپرس نصب کردیم.

تاریخ در هر پنج افزونه شمسی بود؛ متن‌های خود افزونه و عددها فقط در PeproDev فارسی بود

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

متن‌های خود افزونه («Invoice»، «Billing Details»، «Order Number») در چهار افزونه انگلیسی ماندند و فقط PeproDev متن فارسی داشت. نام سطرهای مبلغ، مثل «جمع جزء»، ترجمه خود ووکامرس است و در سه افزونه از آن چهار فارسی بود. عددها هم در چهار افزونه لاتین چاپ شدند (1,250,000)؛ عددی که فارسی تایپ کرده بودیم، مثل «پلاک ۱۲»، همان‌طور ماند. فقط PeproDev همه را فارسی نوشت، از جمله کدپستی و شماره تماسی که لاتین وارد شده بود.

کدام افزونه فاکتور ووکامرس را انتخاب کنیم

فاکتوری می‌خواهید که همان اول فارسی چاپ شود و به ایمیل‌ها پیوست شود؟ PeproDev را روی یک سایت آزمایشی امتحان کنید. فقط کاغذ لازم است؟ صفحه چاپ SkyVerge کافی است. برای WooCommerce PDF Invoice انتخاب MPDF و برای PDF Invoices & Packing Slips نصب افزونه mPDF خودش کافی است.

با YITH فایل‌های فونت را اضافه کنید. ما با فایل‌ها فقط فاکتور سفارش تومانی را ساختیم؛ سفارش ریالی بدون فایل‌ها خطا داد. خاموش کردن «Enable pro-forma» ایمیل‌های سفارش تومانی را برگرداند؛ دکمه Create برای سفارش ریالی باز هم خطا داد. اگر نمی‌خواهید خودتان در پوشه افزونه فایل بگذارید، این کار را می‌توانید به خدمات پشتیبانی سایت وردپرس بسپارید یا درخواست بدهید.

افزونه خودتان را با همین چهار قدم و پیش از اولین سفارش واقعی بسنجید:

  1. یک سفارش آزمایشی با ارز فروشگاه بسازید، نه دلار.
  2. فاکتور را با دکمه خود افزونه بگیرید و PDF را باز کنید. حروف باید به هم چسبیده باشند و ترتیب کلمه‌ها درست.
  3. یادداشت‌های سفارش را بخوانید و ایمیل‌های رفته را بشمارید. «خطا هنگام انتقال وضعیت» یا ایمیلی که نرفته یعنی افزونه در ثبت سفارش دخالت می‌کند.
  4. سفارش را «تکمیل‌شده» کنید و پیوست ایمیل مشتری را هم باز کنید.

برای خواندن خط خطا از لاگ سرور مقاله خطای ۵۰۰ وردپرس را ببینید.

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

چرا فارسی در PDF فاکتور ووکامرس برعکس یا مربع چاپ می‌شود؟

در آزمایش ما WooCommerce PDF Invoice با DOMPDF، موتور پیش‌فرضش، هر خط فارسی را آینه‌ای چاپ کرد و PDF Invoices & Packing Slips به‌جای حروف مربع گذاشت، چون فونت OpenSans حرف فارسی ندارد. مستندات WP Overnight می‌گوید زبان‌های راست‌به‌چپ با dompdf درست نمایش داده نمی‌شوند و راهش افزونه mPDF خود آن‌هاست.

در WooCommerce PDF Invoice فارسی برعکس چاپ می‌شود، چه کنیم؟

در تنظیمات افزونه، گزینه «Choose which PDF Generator to use» را روی MPDF بگذارید. در آزمایش ما Yes کردن «Use RTL layout» به‌تنهایی با DOMPDF چاپ آینه‌ای را عوض نکرد و بعد از MPDF فقط چیدمان صفحه را راست‌به‌چپ کرد.

چرا بعد از نصب YITH PDF Invoices ایمیل سفارش‌های تومانی نمی‌رود؟

در نسخه ۴٫۳۸٫۰ که آزمودیم، پیش‌فاکتور خودکار برای سفارش تومانی فونت پررنگ فارسی می‌خواست که در پوشه افزونه نبود. سفارش ذخیره شد، اما ایمیل‌ها نرفتند و فقط یک یادداشت خطا ماند. افزودن سه فایل فونت یا خاموش کردن «Enable pro-forma» ایمیل‌های سفارش تومانی را برگرداند. دکمه ساخت فاکتور برای سفارش ریالی هم بدون فایل‌ها خطا داد.

PDF Invoices & Packing Slips به‌جای حروف فارسی مربع می‌گذارد؛ چطور درستش کنیم؟

در آزمایش ما افزونه mPDF خود WP Overnight (نسخه ۳٫۲٫۰) حروف را درست کرد. چیدمان راست‌به‌چپ با تیک «RTL support» در تنظیمات عمومی روشن شد.

تاریخ فاکتور ووکامرس شمسی می‌شود؟

با فعال بودن ووکامرس فارسی تاریخ سفارش در هر پنج افزونه‌ای که آزمودیم شمسی چاپ شد، بعد از اینکه فونت و موتور PDF درست شد. متن‌های خود افزونه و عددها به‌صورت پیش‌فرض فقط در PeproDev فارسی بودند.

بهترین افزونه فاکتور ووکامرس فارسی کدام است؟

در آزمایش ما PeproDev بدون هیچ تنظیمی فارسی را درست چاپ کرد و سه ایمیل سفارش را با فاکتور فرستاد. WooCommerce PDF Invoice بعد از انتخاب MPDF و PDF Invoices & Packing Slips بعد از نصب افزونه mPDF خودش هم درست چاپ کردند. YITH برای متن فارسی پررنگ، مثل «تومان» در مبلغ نهایی، فایل فونت می‌خواهد.

تصویر سمانه جعفری
سمانه جعفری
پیشنهاد میکنیم این مقالات را هم بخوانید

دیدگاه یا پرسش خود را بنویسید