كل المقالات

إضافة Schema لموقع ووردبريس ومتجر ووكومرس: دليل عملي لـ JSON-LD

دليل إضافة Schema لموقع ووردبريس: أهم أنواع البيانات المنظمة، الفرق بين الإضافات والكود اليدوي، مثال Product جاهز بصيغة JSON-LD وطريقة الاختبار قبل النشر.

غلاف: كود JSON-LD لمنتج بجانب نتيجة البحث المميزة التي ينتجها
في هذا المقال

إضافة Schema لموقع ووردبريس تعني وضع بيانات Schema المنظمة (Structured Data)، غالباً بصيغة JSON-LD، تخبر محركات البحث بنوع كل صفحة بدقة: منتج، مقال، شركة، مسار تنقل. يمكنك إضافتها عبر إضافة لتحسين محركات البحث (SEO) أو بكتابتها يدوياً، ثم التأكد منها بأداة اختبار النتائج المنسقة (Rich Results Test) من جوجل. تساعد هذه البيانات محركات البحث على فهم المحتوى وقد تجعل الصفحة مؤهلة لنتائج منسقة (Rich Results)، لكنها لا تضمنها.

أهم النقاط

  • البيانات المنظمة تصف ما هو ظاهر فعلاً في الصفحة، وليست مكاناً لإضافة ادعاءات لا يراها الزائر.
  • JSON-LD هي الصيغة التي توصي بها جوجل، وهي الأسهل في الإدارة داخل ووردبريس.
  • إضافة جيدة للسيو تغطي معظم الاحتياجات (المؤسسة، المقال، مسار التنقل)، أما متاجر ووكومرس (WooCommerce) فتحتاج عناية أكبر ببيانات المنتج والعرض.
  • أهلية النتائج المنسقة تتغير مع الوقت، فراجع توثيق جوجل الحالي قبل أن تبني خطتك على ميزة معينة.
  • اختبر كل قالب صفحة (template) بأداة Rich Results Test وأداة Schema Markup Validator، ثم تابع Search Console.

ما هي البيانات المنظمة وصيغة JSON-LD؟

البيانات المنظمة هي مفردات قياسية يُشرف عليها موقع schema.org لوصف المحتوى. بدلاً من ترك الزاحف يخمّن أن «100 ريال» سعر، تقول له صراحة: هذا عرض (Offer)، وهذا سعره، وهذه عملته.

JSON-LD هي أشهر طريقة لكتابتها. توضع داخل وسم <script type="application/ld+json"> منفصلاً عن HTML المرئي، ما يسهّل توليدها باستخدام PHP واكتشاف الأخطاء فيها. يشرح دليل جوجل للبيانات المنظمة الصيغ المدعومة وسبب التوصية بـ JSON-LD.

أنواع Schema المهمة لمعظم مواقع ووردبريس

لا تحتاج عشرات الأنواع. أغلب المواقع يكفيها عدد صغير ودقيق.

المؤسسة (Organization) أو النشاط المحلي (LocalBusiness)

يصف شركتك: الاسم والشعار والرابط وبيانات التواصل والحسابات الاجتماعية. يُضاف عادةً مرة واحدة على مستوى الموقع. وإن كان لديك فرع فعلي فيمكن لـ LocalBusiness أن يضيف العنوان وساعات العمل.

الشخص (Person)

مفيد للعلامات الشخصية ومعارض الأعمال والصفحات التعريفية للكتّاب، إذ يربط اسم الكاتب بصفحته وحساباته.

المقال (Article وBlogPosting)

لمقالات المدونة والأخبار: العنوان والكاتب وتاريخ النشر والتعديل والصورة. تأكد أن التواريخ تطابق ما تعرضه الصفحة.

مسار التنقل (BreadcrumbList)

يعكس مسار التنقل في موقعك ليفهم محرك البحث هيكل الأقسام. منخفض المخاطر وتدعمه معظم إضافات السيو.

المنتج والعرض والتقييم (Product وOffer وReview)

لمتاجر ووكومرس. يحمل Product الاسم والصورة والوصف ورمز SKU والعلامة التجارية، ويحمل Offer السعر والعملة والتوفر والرابط. أما Review وAggregateRating فلا يوضعان إلا إذا كانت التقييمات الحقيقية معروضة في الصفحة. ويوضح دليل السيو لصفحات منتجات ووكومرس وأقسامها كيف يتكامل ذلك مع بقية الصفحة.

الأسئلة الشائعة (FAQPage)

يُستخدم لوسم محتوى الأسئلة والأجوبة. انتبه هنا: قصرت جوجل عرض النتائج المنسقة للأسئلة الشائعة على مجموعة محدودة من المواقع، فلا تتوقع ظهورها لمعظم الأنشطة التجارية. أهلية النتائج المنسقة تتغير، لذا ارجع إلى توثيق جوجل بدل الاعتماد على نصائح قديمة. يبقى الوسم صالحاً، ويظل قسم الأسئلة الشائعة المرئي مفيداً للقراء.

الإضافة أم الكود اليدوي: أيهما يناسبك؟

الطريقةالأنسب لـالمميزاتالعيوب
إضافة السيو (Yoast SEO أو Rank Math وغيرهما)معظم المواقع التجارية والمدوناتإعداد سريع، إعدادات افتراضية منطقية، ربط الكيانات تلقائياًتحكم محدود وقد لا تطابق الإعدادات محتواك
مخرجات ووكومرس المدمجةبيانات المنتج الأساسيةتولّد بيانات Product وOffer الأساسيةقد تفتقد العلامة التجارية أو GTIN أو الشحن، وقد تتكرر مع إضافة السيو
إضافة Schema متخصصةأنواع مخصصة كثيرةربط مرئي للحقول بالأنواعإضافة أخرى للصيانة، وخطر التكرار
JSON-LD يدوي في القالبالمواقع المخصصة والحالات الخاصةتحكم كامل وعبء أقليحتاج وقت مطور ومزامنة مع المحتوى

الجواب العملي لمعظم المواقع: اترك إضافة واحدة للسيو تتولى المؤسسة والمقال ومسار التنقل، ثم أضف أو عدّل ما ينقص فقط. يصبح الكود اليدوي منطقياً عندما يكون لديك نوع محتوى مخصص أو هيكل منتج خاص لا تدعمه الإضافات. هذا النوع من العمل النظيف والمركّز هو ما أفضّله في المواقع المخصصة بدل تكديس إضافات جديدة، وتجد في صفحتي التعريفية طريقة عملي في مشاريع ووردبريس.

مثال صحيح على JSON-LD لمنتج

فيما يلي مثال كامل لمنتج وهمي بالكامل. كل القيم تجريبية، فاستبدلها ببيانات حقيقية تطابق ما يراه المتسوق في الصفحة.

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Example Widget Pro",
  "image": [
    "https://www.example.com/images/example-widget-pro.jpg"
  ],
  "description": "A placeholder product used to illustrate Product markup.",
  "sku": "EX-WIDGET-001",
  "brand": {
    "@type": "Brand",
    "name": "Example Brand"
  },
  "offers": {
    "@type": "Offer",
    "url": "https://www.example.com/product/example-widget-pro/",
    "priceCurrency": "USD",
    "price": "100.00",
    "availability": "https://schema.org/InStock",
    "itemCondition": "https://schema.org/NewCondition"
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.5",
    "reviewCount": "10"
  }
}

بعض الملاحظات على المثال. السعر price رقم عادي مكتوب كنص، بلا رمز عملة ولا فاصل آلاف، والعملة تُكتب في priceCurrency (مثل SAR أو AED أو EGP أو USD). وقيمة availability رابط كامل من schema.org. أضف aggregateRating فقط إذا كانت الصفحة تعرض تلك التقييمات فعلاً، وإلا فاحذفه. وقائمة الخصائص الكاملة في schema.org/Product.

وإذا أضفت هذا الكود يدوياً في متجر ووكومرس، فتأكد أولاً أن ووكومرس أو إضافة السيو لا تطبع كتلة Product لنفس الصفحة. وجود كيانين متنافسين من نوع Product من أكثر الأخطاء شيوعاً.

كيف تختبر بيانات Schema

  1. أداة Rich Results Test (search.google.com/test/rich-results): تبيّن ميزات النتائج المنسقة التي تتأهل لها صفحتك وتعرض الأخطاء والتحذيرات. اختبر الرابط الحي لا الكود الملصق فقط.
  2. أداة Schema Markup Validator (validator.schema.org): تفحص صلاحية الوسم وفق schema.org بوجه عام، بما في ذلك أنواع لا تستخدمها جوجل في النتائج المنسقة.
  3. Google Search Console: تقارير التحسينات تعرض الأخطاء على مستوى الموقع بعد أن تزحف جوجل إليه، فتكشف مشكلات قوالب الصفحات على نطاق واسع.
  4. عرض مصدر الصفحة: ابحث عن application/ld+json واقرأ ما يُطبع فعلاً، فالإضافات قد تطبع أكثر مما تتوقع.

اختبر نموذجاً واحداً من كل قالب صفحة (template): مقال، صفحة، منتج، قسم. إذا كان قالب الصفحة سليماً فكل الصفحات التي تستخدمه سليمة.

أخطاء Schema الشائعة

وسم لا يطابق المحتوى المرئي

إذا كان JSON-LD يقول إن المنتج له 200 تقييم والصفحة لا تعرض أي تقييم، فهذا وسم مضلل، وإرشادات جوجل تشترط أن تمثل البيانات المنظمة محتوى يراه المستخدم. وينطبق هذا على الأسعار والتوفر وإجابات الأسئلة الشائعة.

كيانات مكررة أو متعارضة

تشغيل إضافة السيو مع مخرجات ووكومرس وإضافة Schema معاً يولّد غالباً كتلتي Product، أو مؤسستين باسمين مختلفين. اختر مصدراً واحداً لكل نوع وعطّل البقية.

خصائص مطلوبة ناقصة

وسم Product بلا سعر صالح في العرض، أو Article بلا عنوان، سيظهر تحذيرات أو أخطاء. الخصائص المطلوبة والموصى بها مذكورة في توثيق جوجل لكل ميزة.

بيانات قديمة

الأسعار أو التوفر المكتوبة يدوياً في كود ثابت تتقادم لحظة تغيّر المخزون. في المتاجر، ولّد بيانات Offer ديناميكياً من ووكومرس ولا تعتمد على كتلة ثابتة.

وسم كل شيء

كثرة Schema لا تعني جودتها. أضف الأنواع التي تعكس محتوى حقيقياً وتخدم غرضاً. الأنواع غير المستخدمة أو غير الدقيقة تضيف ضجيجاً ومخاطرة.

وإذا كنت تجري مراجعة أشمل، فإن قائمة تحقق السيو لووردبريس تضع البيانات المنظمة إلى جانب بقية الأساسيات التقنية.

الأسئلة الشائعة

هل تحسّن إضافة Schema ترتيب موقعي في جوجل؟

ليس بشكل مباشر وفق ما أعلنته جوجل. تساعد البيانات المنظمة محركات البحث على فهم محتواك وقد تؤهل الصفحات لنتائج منسقة تحسّن شكل ظهورك، لكن لا أحد يستطيع الوعد بتحسّن في الترتيب بسببها.

هل أحتاج إلى إضافة (plugin) لوضع Schema في ووردبريس؟

لا، لكن الإضافة هي أسهل طريق للأنواع الشائعة كالمؤسسة والمقال ومسار التنقل. والكود اليدوي أفضل عندما تحتاج هيكلاً مخصصاً أو تريد تجنب إضافات زائدة. وفي الحالتين تجنب تشغيل مصدرين لنفس النوع.

هل سيعطيني وسم الأسئلة الشائعة نتيجة منسقة في جوجل؟

على الأرجح لا لمعظم المواقع. قصرت جوجل نتائج الأسئلة الشائعة المنسقة على مواقع معينة، وقد تتغير الأهلية، فراجع توثيق جوجل الحالي للبيانات المنظمة. ويمكنك مع ذلك إبقاء قسم أسئلة شائعة مرئي لقرائك.

كيف أعرف أن Schema تعمل بشكل صحيح؟

مرّر الرابط الحي في أداة Rich Results Test وأداة Schema Markup Validator، ثم راجع تقارير التحسينات في Google Search Console. وافحص مصدر الصفحة للتأكد أن هناك كتلة واحدة فقط لكل كيان.

لماذا تظهر لدي أخطاء تكرار في Schema المنتج؟

غالباً لأن ووكومرس وإضافة السيو وإضافة Schema منفصلة تطبع كلها بيانات Product. عطّل المصادر الزائدة ليُطبع كيان Product واحد فقط لكل صفحة.

الخلاصة

إضافة Schema لموقع ووردبريس عمل يستحق الدقة لا السرعة: اختر الأنواع القليلة التي تطابق محتواك الحقيقي، واستخدم مصدراً واحداً لكل نوع، وتأكد أن كل شيء يطابق ما يراه الزائر، واختبر كل قالب. وإن أردت مساعدة في مراجعة البيانات المنظمة أو تنفيذها في موقع ووردبريس أو متجر ووكومرس، تواصل معي عبر قسم التواصل.