عرض مواقيت الصلاة في موقعك: مصدر البيانات وطريقة الحساب والتحديث
باختصار: عرض مواقيت الصلاة في موقع مسجد أو مركز أو مطعم يحتاج أمرين: مصدر بيانات موثوق يعطيك الأوقات لكل يوم، وطريقة حساب تطابق ما تعتمده الجهة المحلية في مدينتك. استخدم واجهة برمجية مجانية أو جدولاً سنوياً صادراً عن جهة معتمدة، ولا تحسب الأوقات يدوياً داخل الكود. اعرض الأوقات بتوقيت المدينة نفسها، واحفظ نتيجة كل يوم في الذاكرة المؤقتة حتى منتصف الليل بتوقيت المدينة، فتبقى الصفحة سريعة دون أن تعرض أوقاتاً قديمة. اكتب اسم طريقة الحساب في تذييل الصفحة، ليعرف الزائر على أي أساس تُحسب الأوقات.
ويدجت جاهز أم واجهة برمجية
أمامك خياران، ولكل منهما ثمنه:
| الخيار | ميزته | ما يجب أن تنتبه له |
|---|---|---|
| ويدجت جاهز من مزوّد خارجي | يُضاف بسطر أو سطرين، ولا يحتاج تطويراً | تعتمد على شروط الطرف الآخر، وقد يضيف إعلاناته أو يبطؤ الصفحة |
| واجهة برمجية تعرض البيانات بتصميمك | تتحكم في الشكل والتخزين والعرض | تحتاج تطويراً أولياً وصيانة عند تغيّر الواجهة |
إذا كان الموقع بسيطاً ويديره شخص غير تقني، فالويدجت الجاهز أسهل. أما إذا كنت تريد عرض الأوقات بجانب فعاليات المسجد أو قائمة المطعم، فالواجهة البرمجية تعطيك تحكماً أكبر. في الحالتين، تأكد من أن المزوّد يوضح مصدره وطريقة حسابه في وثائقه.
طريقة الحساب تختلف من جهة إلى أخرى
الفرق الجوهري بين الجداول والبرامج هو زاوية الشمس التي تحدد أذان الفجر والعشاء، وقد تعتمد الجهات المختلفة زوايا مختلفة. لذلك لا تقل "الأوقات صحيحة" دون أن تحدد الطريقة. اسأل لجنة المسجد أو الجهة المشرفة على الأوقات في مدينتك عن الطريقة التي يعتمدونها، ثم اختر في إعدادات المزوّد الطريقة نفسها. إذا وجدت فرقاً بين موقعك وتقويم المسجد المعلق، فالخلل غالباً في اختيار الطريقة لا في البيانات.
اكتب في التذييل شيئاً مثل: "المواقيت حسب طريقة الحساب المعتمدة لدى الجهة المحلية، وتُحدَّث يومياً." هذه العبارة تجيب سؤال الزائر دون أن تحول الصفحة إلى شرح فني.
التوقيت المحلي للمدينة
الأوقات تُحسب لموقع جغرافي، لذلك احفظ خط العرض وخط الطول للمدينة التي يقع فيها المسجد أو المطعم، ولا تستخدم مدينة قريبة. أضف أيضاً معرّف المنطقة الزمنية بصيغته الرسمية، مثل Asia/Riyadh، واعرض الأوقات بهذا التوقيت. لا تفترض أن الساعة ثابتة على فرق معين من توقيت الخادم، لأن الخادم قد يعمل في منطقة أخرى تماماً.
إذا كان الموقع يخدم أكثر من مدينة، فاجعل المدينة اختياراً واضحاً في أعلى الصفحة، واحفظ اختيار الزائر في المتصفح إن أمكن. ولا تفترض أن كل مدينة في البلد لها الوقت نفسه.
التخزين المؤقت لتبقى الصفحة سريعة
أسوأ شيء أن تستدعي الصفحة الواجهة البرمجية مع كل زيارة. الحل أن تحفظ النتيجة مرة واحدة لكل يوم، ثم تخدم الزوار من الذاكرة. المهم أن تنتهي صلاحية الذاكرة عند منتصف الليل بتوقيت المدينة، لا بعد 24 ساعة من وقت الحفظ، لأن ذلك يعني أن تعرض أوقات الأمس بعد الفجر.
const now = new Date();
const endOfDay = new Date(now.getTime());
endOfDay.setUTCHours(21, 0, 0, 0); // مثال: منتصف الليل بتوقيت الرياض بالـ UTC
if (endOfDay <= now) endOfDay.setUTCDate(endOfDay.getUTCDate() + 1);
const maxAge = Math.floor((endOfDay - now) / 1000);
res.setHeader('Cache-Control', `public, max-age=${maxAge}`);
الكود يحسب الثواني حتى منتصف الليل في الرياض، ويستخدمها عمراً أقصى للذاكرة. الرقم 21 هنا يعني منتصف الليل بتوقيت الرياض بالتوقيت العالمي، ويجب تعديله لأي مدينة أخرى. وإن كانت لديك مدن متعددة، فاحسب الذاكرة لكل مدينة بصورة منفصلة.
وإذا فشل الاتصال بالمصدر، فاعرض آخر بيانات صالحة مع ملاحظة صغيرة بتاريخها، ولا تعرض صفحة فارغة. هذه الخطوة تحمي الزائر من الخطأ دون أن تعطيه معلومة مضللة.
العد التنازلي للصلاة القادمة
العد التنازلي يضيف لمسة مفيدة، لكنه لا يحتاج مكتبة ثقيلة. احسب الصلاة القادمة مرة واحدة عند تحميل الصفحة، ثم حدّث الشاشة كل ستين ثانية. التحديث كل ثانية يستهلك البطارية على الهواتف دون فائدة، لأن أحداً لن يلاحظ الفرق بين ثانية وأخرى في هذا السياق.
قاعدة الأرقام والعرض
اختر الأرقام الغربية أو العربية وتمسك بها في كل الموقع. الأرقام الغربية أسهل في القراءة على الشاشات الصغيرة، ومتوافقة مع بقية صفحات الموقع في الغالب. وعند العرض، اكتب الساعة بتنسيق ثابت، مثل "04:52" دون الاختلاف بين صيغ الساعة الثانية عشرة والرابعة والعشرين. هذا الاتساق يقلل الأسئلة ويجعل الأوقات قابلة للمقارنة بسهولة.
خطوات التنفيذ
- حدد المدينة والمنطقة الزمنية، واطلب من الجهة المحلية طريقة الحساب التي تعتمدها.
- اختر الويدجت أو الواجهة البرمجية، وتأكد من أن المزوّد يذكر مصدر البيانات.
- أضف التخزين المؤقت حتى منتصف الليل بتوقيت المدينة.
- أضف رسالة تعرض آخر بيانات صالحة عند فشل الاتصال.
- قارن الأوقات المعروضة بالتقويم الرسمي لثلاثة أيام على الأقل قبل الإطلاق.
ماذا لو تغيّر الجدول الرسمي
قد تصدر الجهة المحلية تعديلاً في الجدول أو في طريقة الحساب بعد أن تكون قد بدأت العمل. لذلك اجعل تاريخ آخر تحديث ظاهراً في لوحة الإدارة، وأضف تنبيهاً بسيطاً لمن يدير الموقع عند اقتراب نهاية الجدول السنوي. لا تنتظر أن يسألك الزوار عن فرق دقيقة، فالتغيير الصامت أسوأ من التأخير المعلن.
قائمة تحقق
- ☐ طريقة الحساب مكتوبة في التذييل ومطابقة لما تعتمده الجهة المحلية.
- ☐ المنطقة الزمنية ومعرّف المدينة صحيحان.
- ☐ الذاكرة المؤقتة تنتهي عند منتصف الليل بتوقيت المدينة.
- ☐ الصفحة تعرض آخر بيانات صالحة عند انقطاع المصدر.
- ☐ الصفحة تعمل بسرعة على الهاتف دون مكتبات إضافية ثقيلة.
أسئلة شائعة
هل يجب أن تكون الأوقات مطابقة للمسجد الذي يجاورني؟
يفضل أن تطابق الطريقة التي يعتمدها المسجد أو الجهة المشرفة في منطقتك، لأن الزوار يقارنون غالباً بما يرونه أمام الباب. اكتب الطريقة صراحة حتى يفهم الزائر سبب أي فرق بسيط.
هل الواجهات البرمجية المجانية موثوقة؟
بعضها موثوق وموثق جيداً، لكن الاعتماد عليها يحتاج متابعة. تحقق من شروط الاستخدام ومن الحدود المسموح بها، واحتفظ بنسخة احتياطية من الجدول الرسمي عند الحاجة.
هل أحتاج تحديث الصفحة يدوياً كل سنة؟
إذا كنت تعتمد على الحساب الآلي، فلا تحتاج تحديثاً سنوياً للأوقات. لكن راجع الطريقة والمدينة مرة كل عام، لأن تغيير الجهة المعتمدة أو الموقع قد يحتاج تعديلاً.
ماذا أعرض إذا لم يتوفر الاتصال بالمصدر؟
اعرض آخر يوم صالح مع تاريخه، واطلب من الزائر الرجوع للتقويم الرسمي عند الشك. أفضل من عرض أرقام فارغة أو خاطئة.
إذا أردت أن نختار معك مصدر المواقيت ونربطه بموقعك بطريقة خفيفة وصحيحة، فاكتب لنا من صفحة التواصل ونرتب الخطوات معاً.