مشغل القرآن الكريم لووردبريس — الإصدار 1.0.0

طريقة الاستخدام:
- ارفع quran-player.zip من: لوحة التحكم ← إضافات ← أضف إضافة جديدة ← رفع إضافة.
- فعّل الإضافة.
- افتح الإعدادات ← مشغل القرآن الكريم.
- أنشئ تطبيق Backend/Server من Quran.Foundation Developer Console، ثم أدخل Client ID وClient Secret.
- ابدأ ببيئة Pre-live للاختبار. هذه البيئة تتضمن الفاتحة والبقرة فقط؛ يلزم اعتماد صلاحية Production لإتاحة كامل المصحف.
- احفظ البيانات واضغط «اختبار الاتصال الآن».
- أضف [quran_player] إلى صفحة أو مقالة، أو استخدم كتلة Gutenberg المسماة «مشغل القرآن الكريم».

حماية السر:
الأفضل تعريف التالي في wp-config.php قبل سطر «That's all, stop editing!»:

define('QFP_CLIENT_ID', 'ضع-client-id-هنا');
define('QFP_CLIENT_SECRET', 'ضع-client-secret-هنا');
define('QFP_ENV', 'prelive');

بعد الحصول على موافقة الإنتاج غيّر QFP_ENV إلى 'production'. تبقى بيانات السر على الخادم ولا تُرسل إلى المتصفح.

توثيق Quran.Foundation:
https://api-docs.quran.foundation/docs/quickstart/

الملفات الأساسية:
quran-player.php — ملف الإضافة الرئيسي
includes/class-qfp-api.php — المصادقة وطلبات API والتخزين المؤقت
includes/class-qfp-plugin.php — الشورت كود وكتلة Gutenberg وREST API والإعدادات
assets/js/quran-player.js — البحث والاختيارات والتشغيل وتذكر الاختيار
assets/js/block.js — تعريف كتلة Gutenberg
assets/css/quran-player.css — تنسيق الواجهة
