يرجى الانتظار ...ديموفنف توفر لك نظام إحترافي سلس للهوك بوينت ، حيث أن الهوك بوينت كتوضيح هي عباره عن مراكز نقاط يتم زرعها و توزيعها داخل ملفات الـ PHP سواء لديموفنف أو لبرمجيتك و التي تسمح من خلالها سواء لك أو للمبرمجين الأخرين من تنفيذه أكواد خاصة بهم و مناداتها في هذه النقاط ، و التي تتيح للمبرمج الفرصة وقتها في إضافة إضافاته البرمجية إلي البرنامج دون الاضطرار إلي تعديل ملف المصدر للملف الرئيسي ، هناك نقاط أساسية يجب فهمها عن نظام نقاط الهوك بديموفنف :
- يتم حفظ نقاط الهوك في ملف xml حيث في ديموفنف يتواجد ملف نقاط الهوك في المسار include/xml بإسمhook_points.xml ، أما في البلجن فيتواجد ملف نقاط الهوك في المسار include/plugins/pluginFolder/xml/pluginfolder-hook_points.xml مع إستبدال pluginfolder بإسم مجلد البلجن.
(هام : يجب أن يتم حفظ ملف نقاط الهوك بنفس صياغ هذا الإسم في البلجنات)
[code] // hook points groups functionsglobal_start functionsglobal_end [/code]
ملاحظات :
يتم تقسيم نقاط الهوك إلي مجموعات ، كل مجموعة تحتوي النقاط الخاصه بها.
الخاصية module في الوسم hookmodule هو إسم مجموعة نقاط الهوك.
الوسم hook يحتوي علي إسم نقطة الهوك.
أساسيات :
- زراعة نقطة هوك في مكان داخل ملف الـ PHP :
يمكنك زراعة نقطة إرتكاز في ملف الPHP في أي مكان تريده من الملف ، من أجل إتاحة إستدعاء هذه النقطة ، مع ملاحظة أنه يجب أن تكون هذه النقطة معرفة مسبقاً في ملف نقاط الهوك للبلجن و المجموعة المندرج تحتها هذه النقطة مستدعاة في بداية ملف الـ PHP .
حيث يجب أولاً في بداية ملف الـPHP الموجود علي المسار الرئيسي لديموفنف ، وضع أسماء مجموعات نقاط الهوك المسموح بتنفيذ أي من نقاطها في هذا الملف ، و يتم ذلك عن طريق الإضافة إلي المصفوفة $Globalhookmodules
بالإضافة لها في بداية ملف الـPHP قبل إستدعاء أي ملف من مجلد include .
مثال :
PHP :
حيث أن الدالة $hook->hook_exist() تقوم بالتأكد إن كانت نقطة الهوك متاحة للإستدعاء أم لا (للتأكد أن النقطة مضافة لملف الـ XML لنقاط الهوك ، و أنه تم تعريف المجموعة الخاصة للإستدعاء)، ومن ثم في حال تم التأكد ، تقوم الدالة $hook->execute_hook() بتنفيذ النقطة و إستدعاء كل الدوال المرسله لها من البلجنات و تنفيذها.
ملاحظة : يمكن تمرير مصفوفة من البارميترز إلي الدوال المرسله من البلجنات إلي نقطة الهوك مع Reference من أجل, علي سبيل المثال, تعديل قيمة في متغير داخل ملف الـ PHP الرئيسي.
مثال :
PHP :
- إرسال دالة من البلجن إلي نقطة هوك :
من خلال البلجن الخاص بك ، تستطيع إرسال الكود الخاص بك إلي نقطة الهوك عن طريق وضع هذا الكود في دالة ، و من ثم إرسالها إلي نقطة الهوك بإستخدام دالة add_hook().
مثال :
في ملف دوال البلجن الموجود علي المسار include/plugins/pluginfolder/pluginfolder_plugin.php
مع ملاحظة إستبدال pluginfolder بـ إسم مجلد البلجن.
ضع الكود الخاص بك الذي تريد إرساله داخل دالة ، و من ثم إستخدم الدالة add_hook() لإرساله إلي نقطة الهوك ، حيث أن هذه الدالة تقبل 3 متغيرات :
- المتغير الأول (إجباري) : وهو يحمل إسم نقطة الهوك الذي سترسل إليها الدالة.
- المتغير الثاني (إجباري) : إسم الدالة التي سترسل إلي نقطة الهوك.
- المتغير الثالث (إختياري) : ترتيب الهوك (لـ أولوية تنفيذه).
PHP :
ملاحظة : البارميتر $vars هو المرسل من مركز نقطة الهوك كـ Reference ، وهو ليس إجباري و يتوقف علي حسب إن كان إرتكاز نقطة الهوك يرسل باراميترز أم لا كما تم الإيضاح سابقاً.
