velora-player/README.md
2026-03-23 17:04:23 +01:00

2.2 KiB

Velora Player

إضافة ووردبريس تضيف مشغّل صوت أنيق يمكن إدراجه داخل المحرر أو عبر shortcode.

ماذا تفعل الإضافة؟

  • تعرض ملف صوتي واحد أو playlist
  • تعمل داخل Gutenberg كبلوك
  • تعمل أيضًا عبر shortcode
  • تدعم صورة غلاف وعنوان للمسار
  • تحتوي على ثيمات جاهزة
  • تسجّل عدد مرات التشغيل بشكل بسيط

طريقة الاستخدام

1. من محرر ووردبريس

  • افتح الصفحة أو المقالة
  • أضف بلوك Velora Player
  • اختر الملف الصوتي
  • أضف العنوان وصورة الغلاف إذا رغبت
  • اختر الثيم أو اترك الإعداد الافتراضي
  • انشر الصفحة

2. باستخدام shortcode

استخدم:

[audio_player src="https://example.com/audio.mp3" title="Episode 1" image="https://example.com/cover.jpg" theme="glassmorphism"]

3. استخدام Playlist داخل shortcode

يمكن تمرير playlist كسطور، وكل سطر بهذا الشكل:

العنوان|رابط الصوت|رابط الصورة

مثال:

[audio_player playlist="Episode 1|https://example.com/ep1.mp3|https://example.com/ep1.jpg
Episode 2|https://example.com/ep2.mp3|https://example.com/ep2.jpg" theme="podcast-style"]

إذا تم استخدام playlist فسيتم تشغيل المسارات من داخل نفس المشغّل.

الخيارات المتاحة في shortcode

  • src رابط الملف الصوتي
  • title عنوان المسار
  • image صورة الغلاف
  • playlist قائمة تشغيل
  • theme الثيم

الثيمات المتوفرة

  • modern-dark
  • glassmorphism
  • podcast-style

الإعدادات

من لوحة التحكم:

Velora Player > Design Settings

يمكنك تعديل:

  • الثيم الافتراضي
  • الألوان
  • الحواف والمسافات
  • إظهار صورة الغلاف

التحليلات

من لوحة التحكم:

Velora Player > Analytics

ستجد:

  • إجمالي التشغيلات
  • أكثر الملفات تشغيلًا
  • ملخصًا بسيطًا لاستخدام المشغّل