88 lines
2.2 KiB
Markdown
88 lines
2.2 KiB
Markdown
# Velora Player
|
|
|
|
إضافة ووردبريس تضيف مشغّل صوت أنيق يمكن إدراجه داخل المحرر أو عبر `shortcode`.
|
|
|
|
## ماذا تفعل الإضافة؟
|
|
|
|
- تعرض ملف صوتي واحد أو `playlist`
|
|
- تعمل داخل Gutenberg كبلوك
|
|
- تعمل أيضًا عبر `shortcode`
|
|
- تدعم صورة غلاف وعنوان للمسار
|
|
- تحتوي على ثيمات جاهزة
|
|
- تسجّل عدد مرات التشغيل بشكل بسيط
|
|
|
|
## طريقة الاستخدام
|
|
|
|
### 1. من محرر ووردبريس
|
|
|
|
- افتح الصفحة أو المقالة
|
|
- أضف بلوك `Velora Player`
|
|
- اختر الملف الصوتي
|
|
- أضف العنوان وصورة الغلاف إذا رغبت
|
|
- اختر الثيم أو اترك الإعداد الافتراضي
|
|
- انشر الصفحة
|
|
|
|
### 2. باستخدام shortcode
|
|
|
|
استخدم:
|
|
|
|
```text
|
|
[audio_player src="https://example.com/audio.mp3" title="Episode 1" image="https://example.com/cover.jpg" theme="glassmorphism"]
|
|
```
|
|
|
|
### 3. استخدام Playlist داخل shortcode
|
|
|
|
يمكن تمرير `playlist` كسطور، وكل سطر بهذا الشكل:
|
|
|
|
```text
|
|
العنوان|رابط الصوت|رابط الصورة
|
|
```
|
|
|
|
مثال:
|
|
|
|
```text
|
|
[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`
|
|
|
|
ستجد:
|
|
|
|
- إجمالي التشغيلات
|
|
- أكثر الملفات تشغيلًا
|
|
- ملخصًا بسيطًا لاستخدام المشغّل
|