بسم الله الرحمن الرحيم

# التعريف بالكائن :

هو كائن بسيط ومتواضع يقوم بعرض التقويم الهجري وهو كائن ابن(son) لكائن الأستاذ صلاح فايع VisualMind الذي يقوم بتحويل التاريخ الميلادي إلى هجري.

---

# المميزات :

1- إمكانية تقديم أو تأخير دخول الشهر .
2- إمكانية تصحيح عدد أيام الشهر .
3- إمكانية تغيير فارق التوقيت الذي بين دولتك والدولة التي بها سيرفر إستضافة الموقع .
4- إمكانية تغيير شكل التقويم بسهولة من خلال قالب (Template) خارجي حسب الحاجة , وكذلك نوع الخط وحجمه الخاص بعرض تواريخ الأيام .

---

# طريقة الاستخدام :

الخطوة الأولى # قم بإستدعاء الكائن في الملف الذي تريد , بكتابة :
<?php require_once 'hjri_calendar.class.php'; ?>


الخطوة الثانية # إنشاء الكائن :
<?php $Hjri = new HjriCalendar('+3', '0', '29'); ?>
حيث أن القيم المدخلة كالتالي :
- القيمة الأولى : وهي فارق التوقيت بين دولتك والدولة التي بها سيرفر استضافة الموقع , ولمعرفة توقيت السيرفر استعرض الملف (server_time.php) المرفق مع الكائن , ثم قم بإدخال الفارق , مع مراعاة إشارة + للزيادة و - للنقصان . يمكنك ترك القيمة خالية أو وضعها بـ (0) إذا كانت التوقيت صحيحاً .
- القيمة الثانية : وهي لتقديم أو تأخير أول يوم وذلك حسب دخول الشهر , مع مراعاة إشارة + للتقديم و - للتأخير .
- القيمة الثالثة : وهي في حالة إذا كان الشهر ناقصاً أي 29يوم والكائن قام بإعطائك 30يوماً , فيمكنك تغيير ذلك بوضع القيمة الصحيح أي (29) , والعكس كذلك بالنسبة إذا كان الشهر كاملاً والكائن قام بإعطائك 29 , فعليك أن تضع (30) .


الخطوة الثالثة # طباعة التقويم :
<?php $Hjri->printCalendar('tpl_1.html', 'Tahoma', '11'); ?>
حيث أن القيم المدخلة كالتالي :
- القيمة الأولى : اسم القالب (Template) الذي تريد استخدامه لعرض التقويم .
- القيمة الثانية : اسم الخط الذي تريد استخدامه لعرض تواريخ الأيام .
- القيمة الثالثة : حجم الخط .

---

المثال كاملاً

<?php require_once 'hjri_calendar.class.php'; $Hjri = new HjriCalendar('+3', '0', '29'); $Hjri->printCalendar('tpl_1.html', 'Tahoma', '11'); ?>

---

# ملاحظة هامة :

عند الرغبة في تغيير أو إنشاء قالب جديد عليك مراعاة
- (+month+) : اسم الشهر .
- (+calendar+) : تواريخ الأيام .

---

[و ما أوتيتم من العلم إلا قليلاً]
اللهم لا علم لنا إلا ما علمتنا أنك السميع العليم
اللهم علمنا ما ينفعنا ووفقنا لخدمة دينك وأمة نبيك محمد صلى الله عليه وسلم

الحقوق متاحة لكل مسلم ©
إذا كان هناك أي استفسار أو ملاحظة أو اقتراح , فراسلني على بريدي al3mlaq@gawab.com
أخوكم في الله
نواف أمين بكر حريري - مكة المكرمة :)
18/10/1425 هـ