🧾 PDF шот-фактураларында валюта таңбалары дұрыс көрсетілмейді

Егер сіз WooCommerce үшін PDF шот-фактуралар және орау парақтары плагинін тапсырыс шот-фактураларын жасау үшін қолдансаңыз, белгілі бір валюта белгілері — мысалы, ₴, ₸, ₺, ₽, € және басқалары — жасалған PDF файлдарында бос қораптар немесе сұрақ белгілері ретінде көрінуі мүмкін.

🔍 Неліктен бұл орын алады?

PDF жасау кітапханалары (DomPDF және mPDF, осы плагинмен қолданылатын) PDF-ке енгізілген қаріптерге сүйенеді. Бұл кітапханалар қолданатын әдепкі қаріп көптеген халықаралық валюта белгілері үшін глифтерді қамтымайды. Нәтижесінде, бұл таңбалар жай ғана көрсетілмейді және бұзылған болып көрінеді.

Шешім – PDF қозғалтқышын DejaVu Sans қаріпін қолдануға мәжбүрлеу — бұл бүкіл әлемде қолданылатын барлық валюта белгілерін қамтитын кең Unicode қамтуы бар қаріп.

✅ Шешім

Келесі кодты тақырыбыңыздың functions.php файлына немесе сайтқа арналған плагинге қосыңыз.

1-қадам: Кодты қосыңыз

// PDF шот-фактураларындағы валюта белгілерін түзету (WooCommerce үшін PDF шот-фактуралар және орау парақтары).
// Толық Unicode валюта белгісі қамтуы бар DejaVu Sans қаріпін мәжбүрлейді.

add_action('wpo_wcpdf_before_document', function() {
    echo '<style>body, * { font-family: dejavu sans, sans-serif !important; }</style>';
});

add_filter('wpo_wcpdf_dompdf_options', function($options) {
    $options['defaultFont'] = 'DejaVuSans';
    return $options;
});

add_filter('wpo_wcpdf_mpdf_font_data', function($font_data) {
    $font_data['dejavusans'] = [
        'R'  => 'DejaVuSans.ttf',
        'B'  => 'DejaVuSans-Bold.ttf',
        'I'  => 'DejaVuSans-Oblique.ttf',
        'BI' => 'DejaVuSans-BoldOblique.ttf',
    ];
    return $font_data;
});

2-қадам: DejaVu Sans қаріп файлдарын жүктеңіз

Қаріп файлдары серверіңізде қолжетімді болуы керек. DejaVu Sans (тегін, ашық кодты) жүктеп алыңыз және келесі төрт файлды серверіңізге жүктеңіз — мысалы, тақырып қалтасына немесе арнайы қаріптер каталогына:

DejaVuSans.ttf
DejaVuSans-Bold.ttf
DejaVuSans-Oblique.ttf
DejaVuSans-BoldOblique.ttf

💡 Қаріпті қайдан алуға болады: dejavu-fonts.github.io сайтынан жүктеп алыңыз — бұл толығымен тегін және ашық кодты.

💡 mPDF туралы ескерту: Егер сіз PDF қозғалтқышы ретінде mPDF қолдансаңыз, wpo_wcpdf_mpdf_font_data сүзгісіндегі файл жолдарын серверіңіздегі қаріп файлдарының нақты орнына сәйкестендіріңіз.

🔧 Қай PDF қозғалтқышын қолданасыз?

Плагин екі PDF көрсету қозғалтқышын қолдайды:

Жоғарыдағы код екі қозғалтқышты да қамтиды — қай қозғалтқыш белсенді болса да, барлық үш ілмекті қауіпсіз қосуға болады.

✅ Бұл шешіммен түзетілген белгілер

Шешімді қолданғаннан кейін келесі валюта белгілері (және тағы басқалары) PDF шот-фактураларыңызда дұрыс көрсетіледі:

⚠️ Маңызды ескертулер

• Бұл шешім тек WooCommerce үшін PDF шот-фактуралар және орау парақтары арқылы жасалған PDF файлдарына қолданылады
• Бұл WooCommerce дүкеніңіздің алдыңғы бетінің көрінісіне әсер етпейді
• Егер сіз плагин параметрлерінде PDF қозғалтқыштарын ауыстырсаңыз, шешім жұмысын жалғастырады — барлық үш ілмек қамтылған
• Кодты қосқаннан кейін, таңбалардың енді дұрыс көрсетілетінін растау үшін бар шот-фактураны қайта жасаңыз