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

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

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

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

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

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

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

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

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

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

add_filter( 'woocommerce_currencies', 'add_mihanwp_IRR' );

function add_mihanwp_IRR( $currencies ) {
     $currencies['IRR'] = __( 'تومان میهن وردپرس', 'woocommerce' );
     return $currencies;
}

add_filter('woocommerce_currency_symbol', 'add_irr_currency_symbol', 10, 2);

function add_irr_currency_symbol( $currency_symbol, $currency ) {
     switch( $currency ) {
          case 'IRR': $currency_symbol = 'تومان'; break;
     }
     return $currency_symbol;
}

سپس با استفاده از بخش تنظیمات ووکامرس، واحد پولی را از تومان به تومان میهن وردپرس تغییر دهید.

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

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

رضا راد

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