تعلم بناء صفحة جديدةفي الـvBulletin بتقنيات متطورة

**ابو خـالد** · 04 / 05 / 2006 46 : 01 PM

السلام عليكم

اليوم سوف ندرس سويا طريقة انشاء صفحة جديدة وتعزيز هذه الصفحة وتطويرها بقدر الامكان ولنستفد الاستفادة القصوى من امكانيات مكتبات الـvBulletin 3.5.x .

إنشاء الصفحة بابسط ما يكن

افتح ملف جديد وليكن اسمه mypage.php وليكن في نفس دليل منتداك ،،،

وضع هذا الكود بداخله واحفظ الملف:

كود PHP:




<?php







// ######################## اعداد البئية العامة ###########################



error_reporting(E_ALL & ~E_NOTICE);







// ##################### تعريف الثوابت المهمة #######################



// تعريف اسم الملف بدون الحاق الامتداد الخاص به وذلك لكي تسهل عملية مناداته داخل المنتدى



// وليكن الاسم نفس اسم الملف







define('THIS_SCRIPT', 'mypage'); 







// #################### استدعاء القوالب والبييانات ######################



//مصفوفة القوال المستخدمة في هذا الملف



$globaltemplates = array(



// اسماء القوالب التي سوف يتم استدعاءها



'mypage_temp1',// اسم القالب الاول



'mypage_temp2',// اسم القالب الثاني



);















// ########################## الثوابت ############################



require_once('./global.php');







// #################### مسار كود الجافا سكريبت ########################



$headinclude = str_replace('clientscript', $vbulletin->options['bburl'] . '/clientscript', $headinclude);







// ########################################################################



// #########################بداية الكود الخاص بصفحتك ############################



// ########################################################################







$navbits = array(); 



// عنوان الصفحة في الشريط 



$navbits[$parent] = 'صفحتي المتطورة';







$navbits = construct_navbits($navbits);



eval('$navbar = "' . fetch_template('navbar') . '";');// استدعاء قالب النافبار







// استدعاء قوالبك الخاصة والتي عرفتها بالاعلى



eval('print_output("' . fetch_template('mypage_temp1') . '");');



//############################################################################



// .:: s u d a b e s t . c o m ::.



//############################################################################



?>

انتهينا من الملف ق بحفظه.

الان نقم بإنشاء القوالب التي نريدها

ولتكن هذه محتويات قالب mypage_temp1:

كود PHP:




$stylevar[htmldoctype]



<html dir="$stylevar[textdirection]" lang="$stylevar[languagecode]">



<head><meta http-equiv="Content-Type" content="text/html; charset=windows-1256">



$headinclude



<title>$vboptions[bbtitle]</title>



</head>



<body>







$header



$navbar







<table class="tborder" cellpadding="$stylevar[cellpadding]" cellspacing="$stylevar[cellspacing]" border="0" width="100%" 







align="center">



<tr>



<td class="tcat">عنوان صفحتي المتطورة</td>



</tr>



<tr>



<td class="alt1">هنا ضع اي شي تريد قوله :)</td>



</tr>



</table>







$footer



</body>



</html>

انتهينا ، قم الان بطلب عنوان الملف mypage.php وانظر.

أضافة اسم الصفحة في المتواجدون الان

عندما تكن تنظر في المتواجدون الان بيظهر لك اسم المستخدم ومكان تواجده ، "مثلا : يقرا رسالة خاصة من "

الان اذا اتى زائر وفتح هذه الصفحة سوف يظهر لك مكان تواجده باسم "Unknown Location" او " غير معروف"

واليكم طريقة التعريف عبر الـPlugins أضف Plugins جديد و ضعه فيه الكود التالي :

كود PHP:


Product: vBulletin



Hook Location: online_location_process



Title: My Custom Location (Part1)



Plugin PHP Code: if ($filename == 'mypage.php')



{



$userinfo['activity'] = 'test';



}



Plugin is Active: Yes

واحفظ

كود PHP:


قم باضافة Plugin جديد مره اخرى وضع فيه الكود التالي :



Product: vBulletin



Hook Location: online_location_unknown



Title: My Custom Location (Part2)



Plugin PHP Code: if ($userinfo['activity'] == 'mypage')



{



$userinfo['action'] = 'يشاهد صفحتي المتطورة'; /



$userinfo['where'] = '<a href="./test.php?' . $vbulletin->session->vars['sessionurl'] . '">هذه صفحتي المتطورة</a>'; 



$handled = true;



}



Plugin is Active: Yes

قم بالحفظ

( هنالك طريقة اخرى عبر الملفات ومعقدة نوعا ماء كنت استخدمها قبل 3.5 )

انتهينا بحمد الله من تعريف اماكن التواجد.

اعطاء صلاحيات المشاهدة لصفحتي

هنالك طريقتين لعمل تحديد الصلاحيات بالنسبة للمجموعات وكلاهما يعتمدان على الشرط المنطقي " IF" ،، وسوف نستخدم اسهل الطرق .

1- الطريقة الاولى عبر القوالب

2- عبر الملف البرمجي

في قالبك ضع هذا الشرط في المكان المناسب واحبذ بعد متغير الـ$navbar ، هذا الكةد يقم بعرض الصفحة اذا كان المستخدم ينتمي الى المجموعة رقم 6 ( وهي في العادة مجموعة المشرف العام)

كود:

<if condition="is_member_of($bbuserinfo, 6)">

اذا كان المستخدم ينتمي للمجموعة 6

<else />

اعرض هذا

</if>

1

لناخد مثال آخر ،،، اذا كنت تريد عرض الصفحة للاعضاء فقط

كود PHP:


<if condition="!$bbuserinfo['userid']">

طريقة استخدام المتغيرات في القوالب

1- المتغيرات العادية ، مثل $sudabest , $var1،، يمكنك استخدامها بكل يسر.

2- متغيرات المصفوفات مثل $sudabest[hosting] ،، ولا تستخدم ابدا علامات الاقتباس المفردة او الزوجية، والا سوف يظهر لك خطا.

3- متغيرات الكائنات او الاوبجيكت ،

كود:

{$sudabest->host['package']}

، تذكر الازواج من هذا النوع {} في البداية والنهاية

* لاسباب امنية لا تستخدم ابدا مصفوفات الـ$_POST[], $_GET[], $_REQUEST حاول ا تتجنبها في قوالبك.

إستخدام العبارات الشرطية

كل قوالب الاصدار الثالث تدعم استخدام العبارة الشرطية IF في قوالبها

مثلا:-

كود PHP:




<if condition="$somevbulletinvar">



htmlcode



<else />



other html code



</if>

انتبه لا يمكنك ان تستخدم عبارة else if في القوالب واذا كنت بحوجة الى استخدامها عليك بهذه الطريقة

كود PHP:




<if condition="$condition1">



htmlcode



<else />



<if condition="$condition2">



more html code



</if>



</if>

وهكذا ........

أنشاء رسالة خطا

لانشاء رسالة خطا خاصة بك ينبغي ان تراعي :-

1- انشاء عبارة جديدة في Front-End Error Messages

2- يجب ان يكن اسم المتغير لهذه العبارة ان يبدا بي "error_"

3- يجب ان تضع الدالة هذه في الملف البرمجي:

كود PHP:


 eval(standard_error(fetch_error('error_mypagephrase')));

وتاكد من تطابق متغير العبارة الذي عرفته مع error_mypagephrase

انشاء رسائل اعادة التوجيه

لإنشاء رسالة اعادة توجيه خاصة يجب ان تراعي :-

1- تاكد بانه لايوجد نتيجة استعلام او اية نتيجة اخرى قبل هذه اعادة التوجيه.

2- تعريف مسار صفحة اعادة التوجيه ، مثلا:-

كود PHP:


 $vbulletin->url = "mypage.php" . $vbulletin->session->vars['sessionurl'] ."somevar=someval";

3- تذكر باننا نستخدم دائما الاسم mypage.php .

4- لاتنسى ان تستبدل الـsomevar=someval باسماء متغيراتك الخاصة التي تريد تمريرها للصفحة القادمة هذه.

الان علينا بالقيام بإضافة عبارات رسالة اعادة التوجيه :-

1- قم بإنشاء عبارة في مجموعة "Front-End Redirect Messages" ، ويجب ان تبدا بـ"redirect_" .

2- اضف الكود التالي :-

كود PHP:


 eval(print_standard_redirect('redirect_myphrase', true, true));

في المكان الذي تريد فيه رسالة اعادة التوجيه.

بحمد الله وصلنا لنهاية هذا الدرس ، واتمنى اكن قد أفدتكم

تحياتي القلبية لكم بالتوفيق

--------------------------------------------------------------------------------------------------------

المصدر