هذه المقالة مترجمة عن الملف المرافق لبرنامج المجلة Addons-Modules
1) البرامج المستقلة تكون ضمن مجلد modules
2) إذا كان اسم ملف البرنامج يتضمن مسافة فإنه يتعين استبدال الشرطة التحتية بالمسافة، فمثلا Web Links.php تصير Web_Links.php
3) عند إضافتك لملفات البرنامج في المجلد المذكور فإن البرنامج يتعرف عليه تلقائيًا، ويجعله (معطلا) إلى أن تفعله من لوحة التحكم، ويمكن للمسؤول الاطلاع على البرنامج وهو معطل.
4) سيضاف رابط البرنامج تلقائيا في وحدة ( البرامج المستقلة ).
5) يمكنك إضافة رابط للبرنامج في أي مكان؛ وهذه صيغته :
حيث Addon_Name هو اسم البرنامج.
ويشترط أن يكون الملف الرئيس للبرنامج هو ملف index.php
6) يجب أن تعلم أن تحسس الحروف في اسم البرنامج فاعلة؛ لأن web_links تختلف عن Web_Links
7)
في كل ملف من ملفات البرنامج عليك إضافة هذه البرمجة في أوله :
كود PHP:
if (!eregi("modules.php", $_SERVER['PHP_SELF'])) {
die ("You can't access this file directly...");
}
وفائدتها أنها تمنع الوصول المباشرة إلى الملف، ولا يمكن أن يعمل الملف إلا عن طريق ملف modules
8) يمكنك إضافة ملحقات المجلة
كود PHP:
require_once("mainfile.php");
$module_name = basename(dirname(__FILE__));
get_lang($module_name);
فالسطر الأول يستدعي الملف الأساس للمجلة؛ حيث يمكنك استخدام كائن قاعدة البيانات في برنامجك، أو الضوابط الأمنية، أو التحقق من دخول المسؤول أو العضو.
السطر الثاني لمعرفة اسم المجلد تلقائيا
السطر الثالث : لمعرفة اللغة التي يستخدمها الزائر أو العضو أو المسؤول.
9) إذا كنت تستخدم أمر switch() لتحديد الدول المستخدمة فإنه يتعين عليك عدم استخدام المتغير $mop
10) إذا كنت تستخدم الأوامر عبر دول معينة هكذا :
كود PHP:
switch($func) {
case "func-one":
funct-one();
break;
}
فإنك تستدعي الدالة بهذه الطريقة :
كود:
http://www.yoursite.com/modules.php?mop=modload&name=The_Web_Ring&file=index&func=func-one
11) إذا كانت الدالة تحتوي على متغيرات نحو :
كود PHP:
switch($func) {
case "func-one":
funct-one($xid, $xname);
break;
}
فإنها تكون بهذه الطريقة :
كود:
http://www.yoursite.com/modules.php?mop=modload&name=The_Web_Ring&file=index&func=func-one&xid=$xid&xname=$xname
12) - إذا كنت ترغب في استخدام أنموذج في البرنامج فإنه يتعين عليك أن يكون الأنموذج بهذه الصيغة :
كود PHP:
<form action="modules.php?name=Addon_Sample&file=index&func=function" method="post">
...
</form>
تذكر أنه يجب عليك تجنب هذه المتغيرات $name ، و $file , و $mop ، و $index ، و $modload ، و $mod_active
$name: يستخدم لتحديد اسم البرنامج
$file: لتحديد الملف المطلوب عرضه
$mop: لتحديد تحويل البرامج المستقلة
$index: لتحديد عرض الواحدت اليمنى أو إخفائها
$modload: لطلب البرنامج
$mod_active: للتأكد من تفعيل البرنامج
إذا استخدمت :
$index = 1;
فإن الواحدات في الجهة اليمنى ستظهر
13) تذكر أنه يمكنك إنشاء ملف مستقل للغة إذا رغبت في ذلك، ويكون مثلا باسم :
lang-english.php
تحت مجلد language
14) استعلام قواعد البيانات
يمكنك استعلام قواعد البيانات المعتادة
كود PHP:
$sql = "SELECT uid, uname FROM nuke_users";
$result = mysql_query($sql);
list($uid, $uname) = mysql_fetch_row($result);
أو استخدام الكائن المضمن في الملف الرئيس، هذا الكائن يحمل المتغير $db
كود PHP:
$sql = "SELECT uid, uname FROM nuke_users";
$result = $db->sql_query($sql);
$row = $db->sql_fetchrow($result);
ملحوظة :
يمكنك جعل المتغير مؤلفا على نهج :
كود PHP:
$uid = $row[uid];
لكن الطريقة الأسرع أن تستخدم المتغير مباشرة :
كود PHP:
echo "Hello $row[uname], Welcome to my site!";
15) لكي يكون برنامجك متوافقا مع المواصفات القياسية لـ HTML 4.1 فإنك عند كتابة الرابط :
كود:
<a href="modules.php?mop=modload&name=FAQ&file=index">
يلزمك أن يكون بهذه الطريقة :
كود:
<a href="modules.php?mop=modload&name=FAQ&file=index">
تلحظ هنا إضافة amp; بين علامة الجمع والمتغير