السلام عليكم ورحمة الله وبركاته،
في الموضوع السابق: شرح تضمين محتوى الموسوعة القرآنية في أي موقع (https://community.itqan.dev/d/606) عرضنا خدمة التضمين في صورتها الأولى، وجاءت في تعليقاتكم أسئلةٌ واقتراحاتٌ نافعة، فكانت هي خارطة العمل في هذا التحديث. وثمرته صفحتان:
وهذا تفصيل لما تمت إضافته:
- اقترحت الأخت رقية بورية أن يكون للخدمة دليل استخدام في الموقع نفسه، لا في المنتدى وحده ← دليل الاستخدام (https://quranpedia.net/embed-docs)، وفيه جدول المعاملات كاملًا ومعاينة حية، وله نسخة إنجليزية.
- وسأل الأخ أبو بكر عبد الرحمن عن الفتح مباشرةً على قسم بعينه كالتدبر ← صار ذلك بمعامل type، ومعه lock لتثبيت القسم, كما أضفنا خيار لتثبيت كتاب تفسير محدد.
- وسأل الأخ علي ملص عن تخصيص المظهر ليوافق هوية الموقع ← صارت المعاملات: theme وprimary وbg وsize وradius، وتُشتَقُّ درجات اللون كلُّها من لونك الأساسي.
- وعلَّق الأخ هادي الأحمد بأن ذلك لا يتيسَّر في الإطارات إلا بسكربتٍ مساعد في الصفحة الأم ← وهو embed.js؛ يضبط ارتفاع الإطار تلقائيًّا، ويفتح الآية في نافذةٍ داخل صفحتك من غير أن يغادرها القارئ. وأمَّا ملاحظته أن الـ API أيسر لمن يبني واجهته بنفسه، فذاك مفتوحٌ أيضًا: التوثيق (https://quranpedia.net/api-docs)، ونسخ البيانات الكاملة (https://quranpedia.net/dumps).
والبدء لا يتجاوز سطرين:
<div data-quranpedia-embed data-surah="2" data-ayah="255"></div>
<script src="https://quranpedia.net/embed.js" defer></script>
وتفصيل المعاملات كلِّها — من نطاق الآيات، إلى فتح كتابٍ بعينه، إلى موازنة الترجمات — في الدليل. ومن أراد ألَّا يحفظ شيئًا منها، فليختر في منشئ الكود (https://quranpedia.net/embed-builder) الآيةَ والقسمَ والمظهر، وينسخ الكود جاهزًا.
وبقيت الأصول على حالها: لا ملفات تعريف ارتباط ولا جلسات، والتضمين متاحٌ من أيِّ نطاق، ولا حاجة إلى نسخ المحتوى أو تخزينه؛ فالرابط يعرض أحدث نسخة منه دائمًا.
جزاكم الله خيرًا على ملاحظاتكم؛ فهي التي وجَّهت هذا العمل. ومن جرَّب الخدمة، أو احتاج تخصيصًا لا يجده، فليذكره هنا؛ فالباب مفتوحٌ لتحديثٍ آخر.
وبارك الله في كل جهدٍ يخدم كتابه.
