# 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`

ستجد:

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