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

تا حالا شده با ذوق و شوق یه محصول جدید بذاری تو فروشگاه ووکامرس، بعد بری توی گوگل سرچ کنسول تست بگیری و یه دفعه بخوری به یه خطای عجیب که می‌گه Invalid ISO-4217 currency code.

اولین واکنشت اینه‌: “یعنی چی آخه؟! من فقط نوشتم تومن، حالا چرا گوگل اینقدر گیر می‌ده؟” همون لحظه هم احتمالاً می‌ری توی گوگل سرچ کنی و می‌بینی نصف بیشتر سایت‌ها نوشتن: “این خطا اختیاریه، مهم نیست!” ولی خب، اگه مهم نیست پس چرا گوگل ارور نشون میده؟

حقیقتش اینه که موضوع به یه داستان قدیمی برمی‌گرده: گوگل تومن ما ایرانیا رو قبول نداره و فقط ریال رو می‌شناسه. همین باعث می‌شه داده‌های محصولاتت تو نتایج گوگل درست نمایش داده نشن.

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

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

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

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

وقتی گوگل داده‌های محصولات ووکامرس رو بررسی می‌کنه، یکی از بخش‌هایی که بهش توجه ویژه‌ای داره، داده‌های ساختاریافته یا همون structured data هست. این داده‌ها برای گوگل حکم یه نقشه راه رو دارن. از روی اون‌ها متوجه میشه که قیمت محصول چقدره، واحد پولش چیه و چطور باید توی نتایج جستجو نمایش داده بشه. حالا اگر توی همین داده‌ها چیزی خلاف استاندارد جهانی باشه، گوگل سریع خطا می‌گیره و یکی از اون خطاها هم همینه: Invalid ISO-4217 currency code.

معرفی استاندارد ISO-4217

ISO-4217 یک استاندارد بین‌المللیه که برای همه‌ی واحدهای پولی دنیا کد سه‌حرفی تعیین کرده. اینطوری هیچ وقت دلار آمریکا با دلار کانادا یا پوند انگلیس با پوند مصر قاطی نمیشه. به عنوان مثال:

• USD یعنی دلار آمریکا
• EUR یعنی یورو
• GBP یعنی پوند انگلیس
• IRR یعنی ریال ایران

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

چرا گوگل فقط کدهای رسمی را می‌شناسد؟

ما ایرانی‌ها بیشتر با تومان سر و کار داریم و ریال خیلی وقت‌ها فقط روی اسکناس‌هاست. اما مشکل اینجاست که در ISO-4217 چیزی به اسم تومان تعریف نشده. به همین دلیل ووکامرس و بعضی از افزونه‌ها میان یه کد غیررسمی به اسم IRT رو برای تومان قرار میدن. این کد ساختگی وقتی به چشم گوگل می‌خوره، چون توی لیست رسمی ISO-4217 نیست، خطا میده و توی سرچ کنسول پیام Invalid ISO-4217 currency code رو نشون میده.

بنابراین ریشه‌ی مشکل اینه: گوگل فقط و فقط کدهای رسمی استاندارد رو می‌شناسه. برای ایران IRR یعنی ریال معتبره و IRT یعنی تومان هیچ جایگاهی توی استاندارد نداره. همین باعث میشه داده‌های محصولاتت توی نتایج گوگل درست نمایش داده نشن.

دلیل بروز خطای currency code در ووکامرس

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

تفاوت IRT (تومان) و IRR (ریال)

برای ایران در استاندارد ISO-4217 فقط یه کد معتبر وجود داره و اون هم IRR هست که به معنی ریال ایران شناخته میشه. اما ما در زندگی روزمره و حتی در فروشگاه‌های اینترنتی بیشتر از تومان استفاده می‌کنیم. چون ریال توی معاملات روزمره عملاً کاربردی نداره، ووکامرس و بعضی از افزونه‌ها اومدن یه کد جدید به اسم IRT تعریف کردن که همون تومان خودمونه.

مشکل اینجاست که گوگل هیچ‌وقت این کد رو به رسمیت نشناخته و احتمالاً هم به رسمیت نخواهد شناخت، چون واحد رسمی کشور ایران در اسناد بین‌المللی ریاله. بنابراین وقتی داده‌های محصول به گوگل فرستاده میشه و توی اون‌ها IRT دیده میشه، نتیجه‌اش فقط یه چیزه: خطای Invalid ISO-4217 currency code.

مشکل در structured data و Rich Snippet

حالا چرا این خطا دقیقاً به چشم گوگل میاد؟ چون داده‌های ساختاریافته یا همون structured data مثل یه قرارداد جهانی هستن. گوگل از روی اون‌ها متوجه میشه که محصول تو چه قیمتی داره و بعد همون اطلاعات رو به شکل Rich Snippet (یعنی همون بخش ویژه‌ای که زیر لینک سایت توی نتایج جستجو نشون میده) به کاربر نمایش میده.

وقتی توی این داده‌ها واحد پولی IRT درج شده باشه، گوگل دچار خطا میشه. به بیان ساده، گوگل می‌خواد قیمت رو نشون بده، اما چون نمی‌دونه IRT یعنی چی، مجبور میشه خطا صادر کنه. همین باعث میشه محصولت توی نتایج جستجو کامل و درست نمایش داده نشه و کاربر نتونه قیمت رو همون‌طور که باید ببینه.

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

چرا باید این خطا را برطرف کنیم؟

شاید بعضی‌ها بگن این خطا خیلی مهم نیست و چون سایت باز میشه و محصولات نمایش داده میشن، نیازی به رفعش نیست. اما واقعیت اینه که وقتی پای گوگل و نتایج جستجو وسط باشه، هیچ خطایی بی‌دلیل ظاهر نمیشه. خطای Invalid ISO-4217 currency code هم اگه درست نشه، مستقیم روی دیده شدن محصولاتت توی نتایج گوگل و حتی روی اعتماد کاربر تأثیر می‌ذاره.

تأثیر روی نمایش قیمت محصولات در نتایج گوگل

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

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

تجربه کاربری و اعتماد مشتریان

مسئله فقط گوگل نیست، کاربر هم مهمه. وقتی قیمت محصولت توی نتایج جستجو درست نمایش داده نشه یا با ریال و تومان قاطی بشه، کاربر دچار سردرگمی میشه. فرض کن کاربری ببینه محصولی که تو سایتت ۸۹۹ هزار تومان هست، توی نتایج گوگل ۸۹۹ هزار ریال نشون داده میشه. این اختلاف عددی می‌تونه باعث بی‌اعتمادی بشه و کاربر فکر کنه قیمت‌گذاری سایت درست نیست یا شفافیت نداره.

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

روش‌های رایج رفع خطا

برای رفع خطای Invalid ISO-4217 currency code توی ووکامرس، چند راه مختلف وجود داره. بعضی‌ها ترجیح میدن سریع‌ترین راه رو انتخاب کنن و بعضی‌ها دنبال روش اصولی‌تر هستن. هرکدوم مزایا و معایب خودش رو داره و بهتره بدونی دقیقاً داری چه کاری می‌کنی.

تغییر دستی کد ارز در قالب

یکی از اولین راه‌هایی که به ذهن خیلی‌ها می‌رسه اینه که برن سراغ کدهای قالب و واحد پولی رو به صورت دستی تغییر بدن. مثلاً برید توی فایل functions.php یا فایل‌های مرتبط با ووکامرس و مقدار IRT رو با IRR جایگزین کنید. این کار در ظاهر ساده‌ست، چون با چند خط تغییر توی کد همه‌چیز درست به نظر میاد.

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

استفاده از افزونه‌های آماده

راه دوم اینه که سراغ افزونه‌های آماده بری. بعضی از توسعه‌دهنده‌ها پلاگین‌هایی ساختن که واحد پول سفارشی رو به ووکامرس اضافه می‌کنن. این افزونه‌ها معمولاً بدون نیاز به کدنویسی نصب و فعال میشن و بهت اجازه میدن تومان رو تعریف کنی ولی در پشت صحنه کد معتبر ISO-4217 یعنی IRR رو به گوگل تحویل بدن.

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

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

بهترین روش پیشنهادی (ساخت افزونه سفارشی)

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

نصب افزونه خیلی راحت و سریع انجام میشه. کافیه فایل افزونه رو دانلود کنی و از بخش پیشخوان وردپرس به قسمت افزونه‌ها > افزودن > بارگذاری افزونه بری و فایل زیپ رو نصب کنی. بعد از فعال‌سازی افزونه، یه گزینه جدید توی تنظیمات ووکامرس ظاهر میشه که باید اونو انتخاب کنی. با این تغییر، قیمت محصولات روی سایت همچنان به تومان نمایش داده میشه، ولی توی داده‌های ساختاریافته‌ای که گوگل می‌خونه، IRR ثبت میشه و خطای Invalid ISO-4217 currency code برای همیشه برطرف میشه.

اگر دوست نداشتی از افزونه استفاده کنی یا می‌خواستی دستی این کار رو انجام بدی، می‌تونی همون کدی که در ادامه می‌بینی رو به فایل functions.php قالب سایتت اضافه کنی. البته یادت باشه که این روش یک ایراد داره و اون هم اینه که با هر بار آپدیت قالب، این کد از بین میره و باید دوباره اضافه‌اش کنی. پس بهتره فقط وقتی از این روش استفاده کنی که مطمئنی قالب رو زیاد به‌روزرسانی نمی‌کنی.

کد کامل به این شکله:

// Add settings to WooCommerce
function mihanwp_irr_add_settings( $settings ) {
    $settings[] = array(
        'title' => __( 'MihanWP IRR Schema Fix', 'mihanwp-irr-schema-fix' ),
        'type'  => 'title',
        'desc'  => sprintf( __( 'Settings for MihanWP IRR Schema Fix. More information <a href="%s" target="_blank">here</a>.', 'mihanwp-irr-schema-fix' ), 'https://mihanwp.com/invalid-iso-4217-currency-code/' ),
        'id'    => 'mihanwp_irr_schema_fix_options',
    );

    $settings[] = array(
        'title'   => __( 'Enable IRR Schema Fix', 'mihanwp-irr-schema-fix' ),
        'desc'    => __( 'Check this box to enable the IRR Schema Fix.', 'mihanwp-irr-schema-fix' ),
        'id'      => 'mihanwp_irr_schema_fix_enable',
        'default' => 'yes',
        'type'    => 'checkbox',
    );

    $settings[] = array( 'type' => 'sectionend', 'id' => 'mihanwp_irr_schema_fix_options' );

    return $settings;
}
add_filter( 'woocommerce_get_settings_products', 'mihanwp_irr_add_settings', 10, 1 );

// Custom currency function (Edit)
function mihanwp_irr_custom_woocommerce_currency( $currency ) {
    if ( 'yes' === get_option( 'mihanwp_irr_schema_fix_enable', 'yes' ) ) {
      // Return IRR directly without using backtrace
        return 'IRR';
    }

    return $currency;
}
add_filter( 'woocommerce_currency', 'mihanwp_irr_custom_woocommerce_currency', 10, 1 );

// Fix structured data for WooCommerce, Yoast, and Rank Math
function mihanwp_irr_fix_structured_data( $markup_offer ) {
    if ( 'yes' === get_option( 'mihanwp_irr_schema_fix_enable', 'yes' ) && is_array( $markup_offer ) ) {
        foreach ( $markup_offer as $key => &$value ) {
            if ( $key === 'priceCurrency' ) {
                $value = 'IRR';
            }

            if ( in_array( $key, [ 'price', 'lowPrice', 'highPrice' ], true ) ) {
                $value = intval( $value );
            }

            if ( is_array( $value ) ) {
                $value = mihanwp_irr_fix_structured_data( $value );
            }
        }
    }
    return $markup_offer;
}
add_filter( 'woocommerce_structured_data_product_offer', 'mihanwp_irr_fix_structured_data', 100 );
add_filter( 'wpseo_schema_offer', 'mihanwp_irr_fix_structured_data', 10, 3 );
add_filter( 'rank_math/snippet/rich_snippet_product_entity', 'mihanwp_irr_fix_structured_data', 100 );

این کد چند کار مهم انجام میده. اول اینکه تنظیمات جدیدی به ووکامرس اضافه می‌کنه که از اون طریق می‌تونی فعال یا غیرفعالش کنی. دوم اینکه کد ارز ووکامرس رو به جای IRT به IRR تغییر میده. و سوم، داده‌های ساختاریافته‌ای که توسط افزونه‌های سئو مثل Yoast یا Rank Math تولید میشن هم اصلاح می‌کنه تا همه‌چیز کاملاً با هم هماهنگ باشه.

به این ترتیب، چه از افزونه آماده استفاده کنی و چه این کد رو مستقیم توی functions.php بذاری، خطا کاملاً برطرف میشه و محصولاتت با قیمت درست و استاندارد در نتایج گوگل نمایش داده میشن.

تست نهایی در گوگل سرچ کنسول

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

اول وارد گوگل سرچ کنسول بشو و آدرس یکی از صفحات محصولت رو توی بخش “URL Inspection” وارد کن. بعد روی گزینه Test Live URL یا همون تست زنده کلیک کن. گوگل در لحظه صفحه محصولت رو بررسی می‌کنه و نتایج رو بهت نشون میده. این مرحله چند دقیقه بیشتر طول نمی‌کشه.

وقتی تست کامل شد، روی بخش “View Tested Page” کلیک کن و بعد به قسمت Enhancements یا “Rich Results” برو. اینجا می‌تونی داده‌های ساختاریافته محصولت رو ببینی. مهم‌ترین چیزی که باید بررسی کنی مقدار priceCurrency هست.

اگر همه‌چیز درست پیش رفته باشه، به جای IRT باید ببینی: “priceCurrency”: “IRR”. این نشون میده گوگل داره کد استاندارد و معتبر رو می‌خونه، حتی اگر توی سایت برای کاربر کلمه “تومان” نمایش داده بشه.

اطمینان از رفع خطا

وقتی currency به IRR تغییر کرده باشه، خطای Invalid ISO-4217 currency code دیگه توی سرچ کنسول نشون داده نمیشه. ممکنه چند روز طول بکشه تا گوگل داده‌های جدید رو پردازش کنه، اما اگه تست زنده بدون خطا باشه، یعنی کارت رو درست انجام دادی.

از این لحظه به بعد محصولاتت می‌تونن توی نتایج جستجو به شکل Rich Snippet نمایش داده بشن. یعنی قیمت محصول درست زیر عنوان سایتت ظاهر میشه و این دقیقاً همون چیزی هست که باعث جذب کلیک‌های بیشتر و افزایش اعتماد کاربر میشه.

نکات مهم بعد از رفع خطا

برطرف کردن خطای Invalid ISO-4217 currency code باعث میشه خیالت راحت بشه که گوگل داده‌های محصولاتت رو درست می‌فهمه. اما باید بدونی بعد از این تغییر، چند نکته‌ی مهم وجود داره که لازمه بهشون توجه کنی تا بعداً دچار سردرگمی نشی.

نمایش قیمت‌ها به ریال در داده ساختاریافته

یکی از نتایج مستقیم این تغییر اینه که توی داده‌های ساختاریافته، گوگل همیشه قیمت رو بر اساس IRR (ریال) ثبت می‌کنه. یعنی اگر محصولت ۸۹۹ هزار تومان باشه، توی structured data گوگل اون رو به شکل ۸۹۹,۰۰۰ ریال درک می‌کنه. این موضوع شاید در نگاه اول عجیب به نظر برسه، چون ما عملاً داریم با تومان کار می‌کنیم، اما چاره‌ای نیست. دلیلش اینه که گوگل فقط ریال رو به رسمیت می‌شناسه و تومان رو اصلاً قبول نداره.

تفاوت بین نمایش به کاربر و نمایش به گوگل

اینجا باید یه تفاوت مهم رو در نظر بگیری. برای کاربر سایت هیچ چیزی تغییر نمی‌کنه. همچنان روی سایت قیمت‌ها به تومان نمایش داده میشن و همه‌چی همون‌طور که انتظار داری جلو میره. اما پشت صحنه، یعنی جایی که گوگل داده‌ها رو بررسی می‌کنه، کد رسمی ISO یعنی IRR ثبت میشه. به زبان ساده: کاربر می‌بینه: ۸۹۹,۰۰۰ تومان اما گوگل می‌بینه: ۸۹۹,۰۰۰ ریال.

این تفاوت ظاهری باعث میشه هم کاربر راحت باشه و هم گوگل هیچ خطایی نگیره. نکته‌ی کلیدی اینه که اصلاً لازم نیست نگران این اختلاف باشی، چون گوگل قیمت رو فقط برای نمایش Rich Snippet استفاده می‌کنه و کاربر هم همیشه همون تومان واقعی رو روی سایت می‌بینه.

نتیجه‌گیری

خطای Invalid ISO-4217 currency code یکی از رایج‌ترین خطاهایی هست که فروشگاه‌های ایرانی در ووکامرس باهاش مواجه میشن. دلیل اصلیش هم اینه که ما در عمل با تومان کار می‌کنیم، اما گوگل و استاندارد جهانی ISO-4217 فقط ریال (IRR) رو به رسمیت می‌شناسن. همین تفاوت ساده باعث میشه داده‌های محصولات درست پردازش نشن و سرچ کنسول خطا بده.

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

با این روش هم مشکل خطا برای همیشه برطرف میشه، هم داده‌های سایتت با استانداردهای جهانی هماهنگ میشه و هم محصولاتت شانس بیشتری دارن تا به صورت Rich Snippet توی نتایج گوگل نمایش داده بشن. شاد و سربلند باشید.🙂

رضا راد

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