أكتب وسوم Open Graph بيدي في كود الصفحة، ما الأخطاء الشائعة التي تتجنبها الأداة؟
أشهرها أربعة: رمز & أو علامة تنصيص في العنوان تكسر الوسم، واستخدام name حيث يتوقع البروتوكول property، وروابط نسبية للصفحة أو الصورة، ونسيان إحدى الخصائص الأربع المطلوبة. الأداة تهرّب كل قيمة، وتكتب property لوسوم og وname لوسوم twitter، وتنبّه على الروابط والخصائص الناقصة.
الخطأ الأول: رموز تكسر الوسم
حين تكتب الوسم يدويًا، فالقيمة محاطة بعلامتي تنصيص. إن احتوى العنوان على علامة تنصيص، انتهت القيمة في منتصفها وضاع باقي العنوان. والرمز & والفاصلة العليا قد يُقرآن بطريقة غير متوقعة أيضًا. جرّبنا في الأداة عنوانًا فيه فاصلة عليا ورمز &، ورابطًا فيه معاملان بينهما &، فخرج كل شيء مهرّبًا:
<meta property="og:title" content="Ahmed's Oud & Musk">
<meta property="og:url" content="https://example.com/gifts?size=small&wrap=yes">
لاحظ أن الرابط كذلك يحتاج إلى تهريب داخل الوسم، وهذا ما يُنسى كثيرًا في الكتابة اليدوية. المتصفح والمنصات يفكّون & إلى & عند القراءة، فيبقى الرابط صحيحًا.
الخطأ الثاني: name أم property؟
وسوم Open Graph تُكتب بالخاصية property، ووسوم Twitter تُكتب عادة بالخاصية name. الخلط بينهما شائع حين تنسخ سطرًا وتعدّله. الأداة تكتب كل نوع بطريقته دون أن تفكر أنت في ذلك:
<meta property="og:type" content="website">
<meta name="twitter:card" content="summary_large_image">
الخطأ الثالث والرابع: روابط نسبية وخصائص منسية
- رابط الصفحة النسبي مثل /gifts ترفضه الأداة وتطلب رابطًا كاملًا، لأن المنصة لا تعرف موقعك من المسار وحده.
- رابط الصورة النسبي مثل /images/gift.jpg تكتبه الأداة كما هو، لكن مع تنبيه بأن معظم المنصات لا تستطيع جلبه. في مثالنا ظهر هذا التنبيه، ومعه تنبيه ثانٍ لأننا لم نكتب نصًا بديلًا للصورة.
- إن نسيت العنوان أو الرابط أو الصورة، تنبّهك الأداة إلى أن الخاصية مطلوبة في البروتوكول. أما og:type فتكتبه دائمًا.
- النص الطويل جدًا (أكثر من 2000 حرف) والرابط الأطول من 2048 حرفًا يظهران خطأ.
الطريقة
- بدل كتابة الأسطر في المحرر، املأ الخانات في منشئ بيانات Open Graph بالنص العادي كما تريده أن يظهر، دون أي تهريب.
- اقرأ التنبيهات تحت الخانات وأصلح ما يلزم.
- انسخ الوسوم أو نزّلها في ملف HTML، والصقها في رأس الصفحة مكان الأسطر التي كتبتها يدويًا، لا بجانبها.
- افتح مصدر الصفحة بعد الحفظ وتأكد أن كل خاصية مكتوبة مرة واحدة.
ما لا تفعله الأداة: لا تفتح صفحتك ولا تقرأ الوسوم الموجودة فيها، فلا تعرف إن كانت هناك نسخة قديمة مكررة. ولا تكتب وسم title الخاص بنتائج البحث، فهذا تجربه في معاينة نتيجة البحث. والمنصات تحفظ البطاقة لفترة، فقد لا يظهر إصلاحك فورًا.
أسئلة شائعة
هل أكتب & بنفسي في خانة العنوان؟
لا. اكتب & عادية، والأداة تهرّبها. إن كتبت & بنفسك ستتحول إلى &amp;.
هل تهرّب الأداة النص العربي؟
الحروف العربية لا تحتاج تهريبًا وتُكتب كما هي. الرموز الخاصة فقط هي التي تُحوّل.
هل أستطيع تعديل الوسوم بعد النسخ؟
نعم، لكن الأسهل أن تعدّل في الأداة وتنسخ من جديد، حتى يبقى التهريب صحيحًا.