خدمات تخصصی وردپرس؛ از رفع خطا تا توسعه اختصاصی بررسی خدمات

رفع خطاهای اسکیما محصولات ووکامرس برای سایت های ایرانی

نوع ساختار هوک و اکشن استاندارد PHP
محل قرارگیری functions.php یا افزونه اختصاصی
نسخه تست‌شده وردپرس ۶.x / PHP 8.1+ / ووکامرس
تاثیر سرعت کاملاً سبک، بدون افت TTFB

رفع خطاهای اسکیما محصولات ووکامرس در Rank Math و Yoast SEO

اگر از افزونه‌های سئو مانند Rank Math یا Yoast SEO برای سایت فروشگاهی ووکامرس خود استفاده می‌کنید، احتمالاً در گوگل سرچ کنسول با خطاها و اخطارهای اسکیما مواجه شده‌اید. این مشکل به دلیل ناقص بودن اطلاعات وارد شده برای محصولات است و افزونه سئو نمی‌تواند اسکیما (ساختار داده) استاندارد را برای ربات گوگل تولید کند. در این مقاله از مجموعه مقالات آموزشی وردپرس، یک راهکار عملی برای رفع خطاهای اسکیما محصولات در هر دو افزونه Rank Math و Yoast SEO ارائه می‌دهیم. با استفاده از کدهای این مقاله، می‌توانید مقادیر پیش‌فرض و ساختگی را برای فیلدهای خالی تعیین کنید و تمام خطاهای گوگل سرچ کنسول مربوط به اسکیما را به سرعت برطرف نمایید.

خطاهای اسکیما محصولات ووکامرس و اهمیت رفع آن‌ها

اسکیما (Schema.org) یک زبان ساختاریافته است که به موتورهای جستجو مانند گوگل کمک می‌کند تا محتوای صفحات شما را بهتر درک کنند. برای محصولات ووکامرس، اسکیماهای استاندارد شامل اطلاعاتی مانند قیمت، موجودی، برند، شناسه محصول و موارد دیگر است. اگر این اطلاعات در پنل محصولات ووکامرس به طور کامل وارد نشده باشند، ربات گوگل با فیلدهای خالی مواجه شده و در گوگل سرچ کنسول خطا ثبت می‌کند. این خطاها نه تنها سئو سایت را تحت تأثیر قرار می‌دهند، بلکه ممکن است از نمایش ریچ اسنیپت محصولات در نتایج جستجو جلوگیری کنند. افزونه‌های سئو مانند Rank Math و Yoast SEO به طور خودکار اسکیماهای محصولات را تولید می‌کنند، اما اگر داده‌های مورد نیاز وجود نداشته باشد، خروجی آن‌ها ناقص خواهد بود.

این کدها برای رفع خطاهای زیر در گوگل سرچ کنسول طراحی شده‌اند:

  • Invalid ISO 4217 currency code (in “offers”)
  • Date/time not in ISO 8601 format in field “priceValidUntil” (in “offers”)
  • Missing field “priceValidUntil” (in “offers”)
  • Missing field “priceCurrency” (in “offers”)
  • Missing field “price” (in “offers”)
  • Missing field “sku”
  • No global identifier provided (e.g., gtin, brand)
  • Missing field “brand”

خطاهای زیر توسط این کدها حل نمی‌شوند و برای رفع آن‌ها باید نظر ساختگی (یک نظر با امتیاز ۵) به صفحه محصولات اضافه شود:

  • Either “offers”, “review”, or “aggregateRating” should be specified
  • Missing field “aggregateRating”
  • Missing field “review”

راهکار رفع خطاهای اسکیما با کد اختصاصی

برای رفع این خطاها، دو راه حل وجود دارد: یا تمام محصولات را به صورت دستی ویرایش کرده و اطلاعات را تکمیل کنید، یا با استفاده از یک کد اختصاصی، مقادیر پیش‌فرض را به جای فیلدهای خالی به اسکیما اضافه کنید. روش دوم به ویژه زمانی مفید است که محصولات شما اطلاعات مورد نیاز را ندارند یا تعداد محصولات آنقدر زیاد است که ویرایش دستی آن‌ها عملی نیست. در ادامه، کدهای اختصاصی برای هر دو افزونه Rank Math و Yoast SEO ارائه شده است. این کدها را در انتهای فایل functions.php قالب فرزند خود قرار دهید.

کد رفع خطاهای اسکیما برای افزونه Rank Math

افزونه Rank Math از فیلتر rank_math/snippet/rich_snippet_product_entity برای سفارشی‌سازی اسکیما محصولات استفاده می‌کند. کد زیر با استفاده از این فیلتر، مقادیر پیش‌فرض را برای فیلدهای خالی تنظیم می‌کند.

/*
 * Fix RankMath Product Schema Errors for WooCommerce
 * Adds default values for missing fields: price, currency, priceValidUntil, SKU, MPN, and brand
 * Mahdi Jafarzadeh
 * http://localhost/wpwm/
 */
add_filter("rank_math/snippet/rich_snippet_product_entity", function($entity) {
    global $product;
    $id = get_the_ID();

    // Fix currency: convert IRT (Toman) to IRR (Rial) by multiplying price by 10
    if (get_woocommerce_currency() == 'IRT') {
        $entity['offers']['price'] = $product->get_price() * 10;
        $entity['offers']['priceCurrency'] = 'IRR';
    }

    // Fix priceValidUntil: use sale end date if exists, otherwise set to end of current year
    if (!empty($product->get_date_on_sale_to())) {
        $entity['offers']['priceValidUntil'] = date_i18n('Y-m-d', strtotime($product->get_date_on_sale_to()));
    } else {
        $entity['offers']['priceValidUntil'] = date('Y-12-31', time() + YEAR_IN_SECONDS);
    }

    // Fix SKU and MPN: use product ID as default unique identifier
    $entity['sku'] = $id;
    $entity['mpn'] = $id;

    // Fix brand: add a default brand name if missing
    if (empty($entity['brand'])) {
        $entity['brand'] = array(
            '@type' => 'Brand',
            'name'  => 'نام برند پیش‌فرض'
        );
    }

    return $entity;
});

کد رفع خطاهای اسکیما برای افزونه Yoast SEO

افزونه Yoast SEO برای سفارشی‌سازی اسکیما محصولات، از فیلتر wpseo_schema_product استفاده می‌کند. همچنین برای تغییر بخش Offer اسکیما، می‌توان از فیلتر wpseo_schema_offer بهره برد. کد زیر با استفاده از این فیلترها، مقادیر پیش‌فرض را برای فیلدهای خالی تنظیم می‌کند. توجه داشته باشید که برای استفاده کامل از قابلیت‌های اسکیما در Yoast، نیاز به افزونه Yoast WooCommerce SEO دارید.

/*
 * Fix Yoast SEO Product Schema Errors for WooCommerce
 * Adds default values for missing fields: price, currency, priceValidUntil, SKU, MPN, and brand
 * Mahdi Jafarzadeh
 * http://localhost/wpwm/
 */
add_filter('wpseo_schema_product', function($data, $context) {
    global $product;
    $id = get_the_ID();

    // Ensure $product is available
    if (!is_a($product, 'WC_Product')) {
        return $data;
    }

    // Find the offers node and fix currency and price
    if (isset($data['offers']) && is_array($data['offers'])) {
        foreach ($data['offers'] as &$offer) {
            // Fix currency: convert IRT (Toman) to IRR (Rial)
            if (get_woocommerce_currency() == 'IRT') {
                $offer['priceSpecification']['price'] = $product->get_price() * 10;
                $offer['priceSpecification']['priceCurrency'] = 'IRR';
            }

            // Fix priceValidUntil: use sale end date if exists, otherwise set to end of current year
            if (!empty($product->get_date_on_sale_to())) {
                $offer['priceValidUntil'] = date_i18n('Y-m-d', strtotime($product->get_date_on_sale_to()));
            } else {
                $offer['priceValidUntil'] = date('Y-12-31', time() + YEAR_IN_SECONDS);
            }
        }
    }

    // Fix SKU and MPN: use product ID as default unique identifier
    $data['sku'] = $id;
    $data['mpn'] = $id;

    // Fix brand: add a default brand name if missing
    if (empty($data['brand'])) {
        $data['brand'] = array(
            '@type' => 'Brand',
            'name'  => 'نام برند پیش‌فرض'
        );
    }

    return $data;
}, 10, 2);

نحوه عملکرد کدها به صورت گام به گام

در این بخش، هر بخش از کدهای بالا را به صورت دقیق بررسی می‌کنیم و نحوه عملکرد آن‌ها را توضیح می‌دهیم:

  1. دریافت داده‌های محصول (خطوط ۸-۹ در Rank Math و ۱۰-۱۱ در Yoast): با استفاده از global $product; به شیء محصول فعلی دسترسی پیدا می‌کنیم. همچنین $id = get_the_ID(); شناسه منحصربه‌فرد محصول را دریافت می‌کند.
  2. رفع خطای واحد پول (خطوط ۱۲-۱۵ در Rank Math و ۲۰-۲۳ در Yoast): بررسی می‌شود که آیا واحد پول فروشگاه IRT (تومان) است یا خیر. اگر چنین باشد، قیمت در ۱۰ ضرب شده و واحد پول به IRR (ریال) تغییر داده می‌شود.
  3. رفع خطای priceValidUntil (خطوط ۱۸-۲۲ در Rank Math و ۲۶-۳۰ در Yoast): بررسی می‌شود که آیا محصول در تخفیف است یا خیر. اگر تاریخ پایان تخفیف وجود داشته باشد، همان تاریخ به عنوان priceValidUntil تنظیم می‌شود. در غیر این صورت، پایان سال جاری به عنوان تاریخ اعتبار قیمت در نظر گرفته می‌شود.
  4. رفع خطای SKU و MPN (خطوط ۲۵-۲۶ در Rank Math و ۳۴-۳۵ در Yoast): SKU و MPN (شناسه‌های منحصربه‌فرد محصول) برابر با ID محصول قرار داده می‌شوند تا برای هر محصول یکتا باشند. شما می‌توانید پیشوند یا پسوند دلخواه به این مقادیر اضافه کنید.
  5. رفع خطای برند (خطوط ۲۹-۳۳ در Rank Math و ۳۸-۴۲ در Yoast): اگر فیلد برند در اسکیما خالی باشد، یک برند پیش‌فرض با نام نام برند پیش‌فرض به اسکیما اضافه می‌شود. شما می‌توانید این مقدار را با برند واقعی فروشگاه خود جایگزین کنید.

نکات مهم

در این بخش به نکات کلیدی برای استفاده صحیح از این کدها اشاره می‌کنیم:

  • استفاده از قالب فرزند: کدها را در فایل functions.php قالب فرزند قرار دهید تا با بروزرسانی قالب اصلی، تغییرات شما از بین نرود.
  • سفارشی‌سازی بر اساس نیاز: این کدها به صورت پیش‌فرض برای سایت‌هایی نوشته شده‌اند که هیچ‌کدام از اطلاعات مورد نیاز در محصولات وارد نشده است. اگر در فروشگاه شما بعضی از این اطلاعات به شکل صحیح وارد شده‌اند، باید قسمت مربوط به همان مورد را اصلاح یا حذف کنید.
  • محصولات متغیر (Variable Products): برای سایت‌هایی که از محصولات متغیر استفاده می‌کنند، ممکن است نیاز به بررسی و تغییر کد باشد. در چنین مواردی، اسکیما خروجی را به دقت بررسی کرده و از عملکرد صحیح آن اطمینان حاصل کنید.
  • تست پس از اعمال کد: پس از افزودن کد، حتماً یک صفحه محصول را در ابزار تست ریچ ری‌سالت گوگل (Rich Results Test) بررسی کنید تا از عدم وجود خطا اطمینان حاصل کنید.
  • غیرفعال کردن افزونه‌های متضاد: اگر از چندین افزونه برای مدیریت اسکیما استفاده می‌کنید، ممکن است بین آن‌ها تداخل ایجاد شود. در صورت بروز مشکل، افزونه‌های دیگر را غیرفعال کنید.
  • رفع خطاهای aggregateRating و review: همان‌طور که اشاره شد، این کدها خطاهای مربوط به aggregateRating و review را رفع نمی‌کنند. برای حل این خطاها، باید حداقل یک نظر با امتیاز به هر محصول اضافه کنید یا از کدهای جداگانه برای افزودن مقادیر ساختگی استفاده کنید.

جمع‌بندی

در این مقاله از سری مقالات آموزشی وردپرس، به بررسی روش رفع خطاهای اسکیما محصولات ووکامرس در دو افزونه محبوب Rank Math و Yoast SEO پرداختیم. با استفاده از کدهای ارائه شده، می‌توانید مقادیر پیش‌فرض را برای فیلدهای خالی اسکیما تعیین کنید و تمام خطاها و اخطارهای گوگل سرچ کنسول را به سرعت برطرف نمایید. این راهکار به ویژه برای فروشگاه‌هایی که تعداد زیادی محصول دارند و تکمیل دستی اطلاعات برای آن‌ها عملی نیست، بسیار مفید خواهد بود.

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

💡 بررسی ساختاری: برای حل قطعی ارورهای Merchant Listings و اسکیما در سرچ کنسول، از خدمات سئو تکنیکال وردپرس وبمستر وردپرس بهره‌مند شوید.

خدمات تخصصی وبمستر وردپرس

بهینه‌سازی سئو تکنیکال و معماری سایت

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

درباره مهدی جعفرزاده

مهدی جعفرزاده، برنامه‌نویس ارشد و متخصص بهینه‌سازی، سئو فنی و امنیت وردپرس در مرجع WPWM. توسعه‌دهنده ابزارها و کدهای سبک بدون وابستگی به افزونه‌های تجاری سنگین.

رزومه و مسیر حرفه‌ای مهدی جعفرزاده
گفت‌وگو و تبادل تجربه

دیدگاه‌ها و پرسش‌ها

پاسخ‌ها، تجربه‌ها و دیدگاه‌های کاربران در یک گفت‌وگوی منظم.

0 دیدگاه
دیدگاه خود را بنویسید پرسش یا تجربه‌تان را با دیگران به اشتراک بگذارید.
ایمیل شما منتشر نمی‌شود.

گفت‌وگوهای کاربران

جدیدترین دیدگاه‌ها در ابتدا
    این گفت‌وگو با شما شروع می‌شود.

    اولین پرسش یا تجربه را ثبت کنید؛ ایمیلتان نمایش داده نمی‌شود.

    فهرست محتوا

    حساب کاربری وبمستر
    ورود یا ساخت حساب

    برای ثبت سفارش، دریافت فایل‌ها و پیگیری خدمات وارد حساب شوید.

    1. شماره موبایل
    2. تأیید شماره
    3. تکمیل حساب
    کد ورود برای این شماره پیامک می‌شود.

    ورود با رمز عبور
    ابزار وبمستر

    ابزارهای آنلاین وردپرس، طراحی و توسعه

    مشاهده صفحه همه ابزارها
    وردپرس وبمستر

    معرفی مجموعه، ارتباط و ابزارهای وبمستر

    حساب کاربری