تضمين بودكاست Podhoc في موقعك — توثيق أداة iframe

ضمّن بودكاستَك من Podhoc في أي موقع خلال ثوانٍ

أنت تنشر بودكاست في Podhoc، وتريد أن يظهر في مدونتك، أو ضمن وحدة دورة تدريبية، أو في مقال غرفة أخبار، أو داخل ويكي فريقك. تضمين Podhoc هو iframe واحد فقط — تضعه في موقعك، يضغط القارئ Play، فيُبث الصوت من podhoc.com دون مغادرة صفحتك.

صلاحيات التضمين للمؤلف فقط. فقط مؤلّف البودكاست يمكنه توليد سنيبت تضمين لذلك البودكاست — زر Embed مقيَّد على الخادم بحسب owner_id للبودكاست، ومخفي على صفحات «اكتشف» للبودكاستات التي لست مؤلفها. هذا يُبقي الإسناد نظيفاً ويمنح المؤلف الحقيقي السيطرة على الإزالات.

لا حاجة لأي حساب من جانب المستمع. يسمع القراء المجهولون معاينة مجانية مدتها 30 ثانية دون تسجيل؛ بالضغط على “استمع على Podhoc” تُفتح الصفحة المصدر حيث يمكنهم تسجيل الدخول للاستماع للحلقة كاملة (تُطبَّق الأرصدة وفق مصفوفة أرصدة اكتشف). عمليات تشغيل المعاينة تستوعبها Podhoc — فهي لا تستهلك رصيدك من الكريدت. يزن المشغّل 50 كيلوبايت gzip، ويُحمَّل بكسل عند دخول العرض، ويعرض عبارة «غير متاح» بدلاً من إطار مكسور إذا ألغيت نشر البودكاست الأصلي.

كيف تحصل على كود التضمين

1. افتح بودكاستَك في «اكتشف» Podhoc

انتقل إلى app.podhoc.com/discover وافتح أحد بودكاستاتك المنشورة. لا يظهر زر Embed إلا على البودكاستات التي أنت مؤلفها، لأن صلاحيات التضمين مرتبطة بالمؤلف؛ على صفحات «اكتشف» للبودكاستات التي لست مؤلفها، يكون زر Embed مخفياً.

2. اضغط Embed وانسخ مقتطف iframe

في صفحة البودكاست اضغط Embed. ستفتح نافذة منبثقة بها HTML للـ iframe معبّأ مسبقاً بالـ slug القياسي ومُعرّف صلاحية التضمين الفريد. انسخ المقتطف كاملاً. مُعرّف الصلاحية هو ما تستخدمه Podhoc لإسناد تشغيلات التضمين إلى حسابك ولإدارة الإزالات؛ لا تحذفه من المقتطف.

3. الصق iframe في موقعك

أسقط المقتطف في أي كتلة HTML — أداة HTML مخصّصة في WordPress، بطاقة embed في Ghost، أمر /embed في Notion، صفحة MDX في Docusaurus، أو <iframe> خام في موقع ثابت. يعمل المشغّل من podhoc.com، ويُحمَّل بكسل عند دخول العرض، ويضيف 50 كيلوبايت gzip إلى وزن الصفحة.

مثال: تضمين حيّ

هذا هو المقتطف القياسي وقد أُشير فيه إلى بودكاست تجريبي من «اكتشف». استبدل الـ slug ?podcast=example بـ slug بودكاستك بعد الخطوة 2.

<iframe
  src="https://app.podhoc.com/embed?podcast=example"
  width="100%"
  height="240"
  loading="lazy"
  frameborder="0"
  allow="autoplay; clipboard-write; encrypted-media; picture-in-picture"
  title="مشغّل Podhoc"
></iframe>

السمة loading="lazy" غير قابلة للتفاوض — فهي تُبقي التضمين خارج المسار الحرج للشبكة إلى أن يصل القارئ إليه أثناء التمرير، وهذا ما يحمي درجة سرعة صفحتك.

خيارات التخصيص

في النسخة الأولى يُسلَّم iframe ثابتاً بصرياً بعرض 100% × ارتفاع 240 بكسل وبهوية Podhoc اللونية. المقابض التالية على خارطة الطريق وستُوثَّق هنا فور إصدارها:

• قريباً: العرض — معامل استعلام ?w= لتخصيص عرض الإطار الافتراضي.
• قريباً: الارتفاع — معامل استعلام ?h= لتخطيطات مدمجة أو موسّعة.
• قريباً: الثيمة — ?theme=light|dark|auto ليلائم الواجهة هوية موقعك.

ريثما تصل هذه الخيارات، التضمين بسيط عمداً — مقتطف واحد بلا ضبط، يعمل بنفس الشكل في كل صفحة.

الأداء

• حجم الباندل: 50 كيلوبايت gzip لأول تضمين في الصفحة. التضمينات اللاحقة في الصفحة نفسها تضيف فقط بيانات البودكاست (~2 كيلوبايت لكل واحد)، لا كامل كود المشغّل.
• التحميل الكسول: يضع iframe السمة loading="lazy" افتراضياً. يؤجّل المتصفح طلب الشبكة حتى يصل القارئ إلى المشغّل أثناء التمرير، لذا فإن تضميناً تحت الطيّة يكلّف صفر بايت حتى يُحتاج إليه.
• البث: يُقدَّم الصوت من توزيع CloudFront نفسه الذي يخدم app.podhoc.com، باستخدام طلبات byte-range لتنقّل فوري.
• الأثر على سرعة الصفحة: في مراجعاتنا الداخلية لـ Lighthouse، تظل صفحة بها تضمين Podhoc ضمن نقطة واحدة من الصفحة نفسها بلا تضمين متى ما بقي المقتطف تحت الطيّة.

الحماية من إساءة الاستخدام — 100 تشغيل / يوم / مضيف

لإبقاء بثّ «اكتشف» العام مستداماً دون تحميل تكلفته على من يضمّن، تطبّق Podhoc حدّاً ليّناً قدره 100 تشغيل في اليوم لكل مضيف. الحدّ مفروض على النطاق المُضمِّن، لا على البودكاست — فإذا استضفت عشر عمليات تضمين على مدونتي.example، يتقاسم النطاق كله ميزانية الـ 100 تشغيل اليومية.

عملياً:

• تُبثّ أول 100 تشغيل في اليوم بشكل طبيعي.
• بعد ذلك يستمرّ تحميل المشغّل وعرض بيانات البودكاست، لكنه يُظهر رسالة ودّية: «تم بلوغ الحدّ اليومي — جرّب غداً أو افتح في Podhoc».
• يُعاد ضبط العدّاد عند منتصف الليل بتوقيت UTC.

إن كانت لديك حاجة مشروعة لرفع الحدّ (غرفة أخبار شائعة، منصّة دورات بحركة مرور عالية)، راسلنا عبر صفحة الدعم — نحتفظ بقائمة سماح للمضمِّنين الموثوقين.

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

تعكس كتلة الأسئلة الشائعة أدناه قائمة faqs: في front-matter الصفحة، وهي ما يصدّره Hugo كبيانات منظَّمة لمحرّكات البحث وملخّصات الذكاء الاصطناعي.

ذات صلة

• الأسعار — حِزَم الكريدت والاشتراكات (تشغيلات التضمين لا تستهلك رصيدك).
• الخصوصية — ما نسجّله عندما يضغط القارئ Play على التضمين.
• الشروط — قواعد الاستخدام المقبول لأداة التضمين.
• اكتشف — تصفّح البودكاستات العامة واحصل على أكواد التضمين.

افتح «اكتشف» واحصل على كود تضمين →