إضافة أداة سعر ذهب مباشر إلى WordPress

إذا كنت تدير مدونة مالية، أو موقع تاجر، أو صفحة محفظة على WordPress، يمكنك إضافة سعر ذهب مباشر دون إضافة، أو مفتاح API، أو أي PHP. أداة تهيئة أداة سعر الذهب تولّد لك إطار iframe واحداً. الصقه في كتلة Custom HTML أو أداة HTML في Elementor وستعمل.

تهيئة الأداة

انتقل إلى goldprice.dev/widgets/gold-price. لا حاجة للتسجيل ولا لمفتاح API. اختر عملة، ووحدة (أونصة تروي أو غرام)، وقيراطاً، وسمة، ولغة، وستبني الصفحة إطار iframe المطابق لك. انسخ ذلك المقطع واستخدمه في أي من طرق التثبيت أدناه.

إذا تخطيت أداة التهيئة وأردت الإعدادات الافتراضية فقط، فهذا هو الـ iframe الذي تولّده لعملة USD، وأونصة تروي، وقيراط 24، وسمة auto، واللغة الإنجليزية:

<iframe src="https://goldprice.dev/embed/xau?currency=USD&unit=oz&karat=24&theme=auto&locale=en" title="Live gold price" width="360" height="190" loading="lazy" style="border:0;width:100%;max-width:360px" referrerpolicy="strict-origin-when-cross-origin"></iframe>

تُحدَّث الأداة من تلقاء نفسها كل 60 ثانية. وهي مستضافة على goldprice.dev، لذا لا يصل أي مفتاح API إلى مصدر صفحتك أبداً.

تثبيتها عبر كتلة Custom HTML في Gutenberg

1. افتح المقالة أو الصفحة في محرر الكتل.
2. أضف كتلة Custom HTML (ابحث عن "Custom HTML" في أداة إدراج الكتل).
3. الصق مقطع iframe الخاص بك داخل الكتلة.
4. انتقل إلى Preview للتأكد من ظهور البطاقة، ثم انشر.

عادةً ما يحفظ WordPress ذاتي الاستضافة هذا بشكل صحيح لمسؤول (administrator). أما إذا كنت مسجلاً كمحرر (editor) أو مساهم (contributor) بلا صلاحية unfiltered_html، فإن WordPress يزيل وسم <iframe> عند الحفظ وتصبح الكتلة فارغة. راجع توثيق WordPress الرسمي لكتلة Custom HTML لمعرفة كيفية تخصيص هذه الصلاحية. الحل هو أن يلصق المسؤول الكتلة بنفسه، أو منح الدور صلاحية unfiltered_html.

إضافتها إلى شريط جانبي أو منطقة قالب

تعمل كتلة Custom HTML نفسها خارج جسم المقالة أيضاً. في Appearance → Widgets، أضف أداة Custom HTML إلى أي شريط جانبي أو منطقة تذييل والصق مقطع iframe الخاص بك. في قالب من نوع block theme، أضف كتلة Custom HTML إلى جزء من القالب، مثل الشريط الجانبي أو قالب صفحة، عبر Site Editor. في كلتا الحالتين، تُعرض الأداة أينما وُضعت الكتلة، وتتحدث من تلقاء نفسها.

تثبيتها عبر Elementor

1. حرّر الصفحة باستخدام Elementor.
2. اسحب أداة HTML إلى الصفحة.
3. الصق مقطع iframe الخاص بك داخل لوحة الكود الخاصة بأداة HTML.
4. حدّث الصفحة.

تعرض أداة HTML في Elementor الترميز الخام مباشرةً، بما في ذلك عناصر iframe، دون إزالة أي شيء. راجع دليل Elementor لأداة HTML لمزيد حول موقعها مقارنةً بخيارات التضمين الأخرى.

خيارات الأداة

تضبط أداة التهيئة هذه كمعاملات استعلام (query parameters) في src الخاص بالـ iframe. أي قيمة غير معروفة تعود ببساطة إلى الإعداد الافتراضي، لذا فإن أي خطأ إملائي لن يكسر التضمين.

نادراً ما تحتاج إلى بناء هذا الرابط يدوياً. اضبط الخيارات في أداة التهيئة وانسخ الـ iframe الذي تولّده.

إذا لم تظهر الأداة

مساحة فارغة مكان الـ iframe، على WordPress ذاتي الاستضافة. في الغالب مشكلة صلاحية unfiltered_html أعلاه: أزال محرر الكتل الوسم بصمت عند الحفظ. أعد إضافة الكتلة كمسؤول، أو تحقق من محتوى المقالة المحفوظ في عرض الكود بالمحرر بحثاً عن iframe مُزال.

لا يظهر شيء على WordPress.com. خطط WordPress.com المجانية والمنخفضة المستوى لا تسمح بتضمين iframe مخصص داخل كتلة Custom HTML؛ تحتاج إلى خطة تفعّل ميزات الاستضافة. راجع صفحة دعم WordPress.com لكتلة Custom HTML لمعرفة الخطط المؤهلة.

تُحمَّل الأداة لكن تبدو مقصوصة. تحتاج البطاقة إلى 320 بكسل عرضاً على الأقل و190 بكسل ارتفاعاً على الأقل. إذا كان الشريط الجانبي أو عمود المحتوى في قالبك أضيق من ذلك، ضع الأداة في منطقة بعرض كامل بدلاً من تصغيرها.

متى يكون API هو الخيار الأفضل

يغطي الـ iframe العملة، والوحدة، والقيراط، والسمة، واللغة، لكنه يبقى بطاقة ثابتة في تخطيط ثابت. إذا أردت السعر داخل مكوّن خاص بك بدلاً من iframe، أو تصميماً لا تغطيه خيارات السمة، أو بيانات تاريخية لرسم بياني خاص بك، استخدم API الخام بدلاً من ذلك وابنِ العرض بنفسك. محول أسعار الذهب مثال عملي على شكل ذلك لتحويل العملة والوحدة.

الترخيص والإسناد

الـ iframe الرسمي مجاني للتضمين على المواقع الشخصية والتجارية طالما بقي دون تعديل وبقي الإسناد الظاهر عليه سليماً. أما وضع علامة تجارية خاصة عليه (white-labeling) أو تقديمه على أنه تغذيتك الخاصة فيتطلب اتفاقية Enterprise منفصلة. بيانات API الخام المستخدمة في منتجك الخاص تخضع للترخيص التجاري المعتاد بدءاً من خطة Pro. الشروط الكاملة موجودة في شروط الخدمة ودليل الإسناد.