اگر شما صاحب یک وبسایت فروشگاهی هستید که از واحد پولی تومان ایران استفاده میکند، احتمالاً با خطای «invalid ISO 4217 currency code» در سرچ کنسول گوگل مواجه شدهاید. در این مقاله، راهحلی برای رفع این مشکل ارائه میدهیم و افزونهای که بهطور خاص برای این منظور توسعه دادهام را معرفی خواهم کرد.
توجه مهم: کد مربوطه در تاریخ 10 آگوست 2024 (20 مرداد 1403) بهروزرسانی شد. لطفاً از نسخه جدید استفاده کنید. این بهروزرسانی نیاز به تغییر واحد پولی از طریق تنظیمات ووکامرس را برطرف کرده و مشکلات مرتبط با درگاههای پرداخت را نیز حل میکند.
برای اجرای این کد، لازم است افزونه رنک مث (Rank Math) را روی وبسایت خود نصب و فعال کنید. توجه داشته باشید که هیچ افزونه سئو یا اسکیما دیگری نباید بهجز رنک مث روی سایت شما فعال باشد. این افزونه بهطور خاص برای هماهنگی با استانداردهای ISO 4217 طراحی شده و به شما کمک میکند تا خطاهای مربوط به واحد پولی را در سرچ کنسول گوگل برطرف کنید.
خطای invalid iso 4217 currency code ووکامرس
در حوزه تجارت آنلاین، ووکامرس به عنوان یکی از محبوبترین و پراستفادهترین سیستمهای فروشگاهی شناخته میشود. با این وجود، برخی کاربران ممکن است با چالشهای فنی روبرو شوند که تجربه کاربری آنها را مختل کند. یکی از این چالشها، خطای «Invalid ISO 4217 currency code» است که اغلب در فروشگاههایی با واحد پولی تومان مشاهده میشود. در این مطلب، به بررسی علت بروز این خطا و معرفی یک راهحل کاربردی با استفاده از یک افزونه اختصاصی خواهیم پرداخت.
علت ایجاد این خطا
این خطا معمولاً زمانی اتفاق میافتد که ووکامرس تلاش میکند واحد پولی تومان را با کد «IRT» به پلتفرمهای خارجی مانند سرچ کنسول گوگل ارسال کند. مشکل اینجاست که تومان به عنوان یک واحد پولی رسمی در استانداردهای بینالمللی ISO 4217 ثبت نشده است، بنابراین گوگل قادر به شناسایی صحیح این کد نیست و در نتیجه خطای مورد نظر ایجاد میشود. این موضوع میتواند تأثیر منفی بر روی شناسایی و جایگاه فروشگاه شما در نتایج جستجوی گوگل داشته باشد.
راه حل ما برای حل این مشکل
برای رفع این مشکل، یک افزونه اختصاصی توسعه دادهام که بهطور ویژه برای پشتیبانی از واحد پولی تومان در ووکامرس طراحی شده است. این افزونه با ایجاد یک ارتباط میان کد پولی «IRT» و استانداردهای قابل پذیرش توسط گوگل، مشکل را بهطور کامل برطرف میکند.
نصب و تنظیم این افزونه بسیار آسان است. تنها کافی است آن را از طریق لینک انتهای صفحه دانلود کرده و روی سایت خود نصب کنید.
در صورتی که تمایل به استفاده از افزونه ندارید، میتوانید کد زیر را به فایل functions.php
قالب خود اضافه کنید. البته توجه داشته باشید که با هر بار بروزرسانی قالب، این کد از بین خواهد رفت و باید مجدد آن را اضافه کنید.
add_filter( 'woocommerce_currency', 'fanabyte_irr_custom_woocommerce_currency', 10, 1 );
function fanabyte_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
}
به همین سادگی و سریع! مشکل حل شد.
آموزش نصب افزونه در وردپرس
برای نصب افزونه در وردپرس میتوانید از آموزش نصب افزونه در وردپرس که یکی از بخش های مینی دوره آموزش وردپرس میباشد استفاده کنید، این مینی دوره صفر تا صد ساخت سایت با وردپرس را به شما یاد می دهد که پس از آن میتوانید برای خودتان یک وبسایت با وردپرس طراحی کنید.