اگر سایت فروشگاهی دارید که واحد پولی اون تومان ایران هست، قطعا خطای invalid iso 4217 currency code رو توی سرچ کنسول گوگل مشاهده می‌کنید. امروز روش حل این مشکل رو به شما توضیح خواهم داد همراه با افزونه‌ای که برای این‌کار برنامه‌نویسی کردم.

بسیار بسیار مهم: کد در تاریخ ۲۰ دی ۱۴۰۲ آپدیت شد. لطفا از کد جدید استفاده کنید. با استفاده از کد جدید نیازی به تغییر واحد پولی از طریق تنظیمات ووکامرس نیست و مشکلی از بابت درگاه پرداخت نخواهید داشت.

برای استفاده از این کد حتما باید افزونه رنک مث را روی سایت‌تان نصب و فعال کنید. به غیر از رنک مث، هیچ افزونه سئو یا اسکیمای دیگری روی سایت‌تان فعال نباشد.

خطای invalid iso 4217 currency code ووکامرس

در دنیای تجارت الکترونیک، ووکامرس به عنوان یکی از پرکاربردترین پلتفرم‌های فروشگاهی شناخته می‌شود. با این حال، گاهی اوقات کاربران با خطاهای فنی مواجه می‌شوند که می‌تواند تجربه کاربری را تحت تأثیر قرار دهد. یکی از این خطاها، خطای “Invalid ISO 4217 currency code” است که برای فروشگاه‌هایی که از واحد پولی “تومان” استفاده می‌کنند، بسیار رایج است. این مقاله به بررسی علت این مشکل و راه‌حلی که توسط یک افزونه جدید ارائه شده، می‌پردازد.

دلیل بروز این ارور

این خطا زمانی رخ می‌دهد که ووکامرس سعی می‌کند واحد پولی “تومان” را با کد “IRT” به سیستم‌های خارجی مانند سرچ کنسول گوگل معرفی کند. متأسفانه، از آنجا که “تومان” به طور رسمی در استانداردهای ISO 4217 ثبت نشده است، گوگل نمی‌تواند این کد را به درستی تشخیص دهد و به این ترتیب خطای مذکور به وجود می‌آید. این مسئله می‌تواند بر شناسایی و رتبه‌بندی فروشگاه در نتایج جستجوی گوگل تأثیر بگذارد.

راه حل من برای حل این مشکل

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

نصب و پیکربندی این افزونه بسیار ساده است. کافیست افزونه را از این لینک دانلود و نصب بفرمایید.

یا به جای استفاده از افزونه می‌توانید کد زیر را به فایل functions.php قالب سایت خود اضافه کنید. (البته در این صورت با آپدیت قالب، کد حذف خواهد شد.)

add_filter( 'woocommerce_currency', 'mihanwp_irr_custom_woocommerce_currency', 10, 1 );

function mihanwp_irr_custom_woocommerce_currency( $currency ) {
    $backtrace = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 5); // Inspect the last few calls in the stack

    foreach ($backtrace as $trace) {
        // Check if any call is from the RankMath OpenGraph class
        if (isset($trace['class']) && strpos($trace['class'], 'RankMath\WooCommerce\Opengraph') !== false) {
            return 'IRR'; // Replace 'IRR' with your desired currency code
        }
    }

    return $currency; // Return the default currency otherwise
}

به همین راحتی! مشکل حل شد.

رضا رادمیلیون‌ها کیلومتر اسکرول کردم تا به هدفم نزدیک بشم و این داستان همچنان ادامه داره…