توسيع التعليمات الفورية

التعليمات الفورية (ابتداءً من الاصدار SPIP ٢.١) قادرة الآن على جمع بيانات من مصادر متعددة وعرضها بطريقة موحدة في نافذة لها اطاران يظهران دائماً لدى النقر على أحد رموز علامة الاستفهام التي تظهر في المجال الخاص من الموقع.

  • Apparu en : SPIP 2.1

المبادئ

لم يعد المتغير العام help_server عنوان URL الوحيد لمجلد التعليمات، بل أصبح الأن جدولاً من العناوين (تم الاحتفاظ بالتوافق مع الاصدارات القديمة).

عندما تطلب المساعدة بلغة ما «ل» مثلًا، يقوم SPIP بإحضار كل الصفحات التي تحمل اسم «L-aide.html» الموجودة على عناوين URL التي يحددها هذا المتغير العام، ثم يدمج البيانات هذه ببعضها. افتراضياً، يحتوي هذا الجدول العام عنصراً واحداً http://www.spip.net/aide، وهذا يجعل من الممكن الرجوع إلى التصرف المعتاد ولكن يمكن الآن تعزيزه بعناصر أخرى.

ولذلك يتم الإعلان في ملف mes_options.php بعد إنشائه [1] عن عنوان URL الذي يدل الى ملف او ملفات التعليمات الجديدة.

مثال

الهدف من هذا المثال هو إضافة فقرة تعليمات شخصية إلى الفصل الخاص بـاختصارات الكتابة الموجود في التعليمات الفورية.

 في مجلد squelettes/، نقوم بإنشاء ملف اسمه [2] ar-aide.html يحتوي على:

<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="ar" lang="ar" dir="rtl">
<head>
<link rel='stylesheet' href='http://www.spip.net/prive/spip_admin.css' type='text/css' />
</head>
<body>
<h2>raccourcis/اختصارات الكتابة</h2>
<!-- إضافة التعليمات الشخصية هنا -->
<h3 class="spip">اختصارات الكتابة الشخصية</h3>
<p style="color:red;">
هذه فقرة شخصية حول اختصارات الكتابة
</p>
<p style="color:navy;">
هنا فقرة شخصية أخرى
</p>
<!-- نهاية التعليمات الشخصية -->
</body>
</html>

 في ملف mes_options.php، نقوم بإعلان عنان URL الخاص بالمجلد الذي يحتوي الملف الجديد:

// عنوان جديد للعثور على مزيد من التعليمات
$GLOBALS['help_server'][] = url_de_base(1) . 'squelettes/';

 هكذا، بمجرد النقر على اختصارات الكتابة في الهامش الايمن من نافذة التعليمات الفورية الاعتيادية، يظهر فصل اختصارات الكتابة الخاص بالنظام مضاف اليه (في آخره) النص الشخصي [3].

نقاط الدخول الافتراضية في قائمة التعليمات

للتمكن من «تطعيم» التعليمات الافتراضية بتعليمات إضافية، يجب إضافة علامات الى صفحة التعليمات الشخصية باستخدام أحد الأقسام <h2>key/menu_title</h2> المتوافرة في موقع spip.net.

القائمة الكاملة:

تثبيت SPIP

  • install0/إعداد أذونات الدخول
  • install1/الاتصال بخادم SQL
  • install2/إختيار قاعدة البيانات
  • install5/المعلومات الشخصية
  • ftp_auth/التحقق بواسطة بروتوكول FTP
  • erreur_mysql/مسألة صفحات نموذجية؟

المقالات

  • raccourcis/إختصارات الكتابة
  • arttitre/العنوان، العنوان المدخل، العنوان الفرعي
  • -* artrub/اختيار القسم
  • artdesc/وصف مقتضب
  • artchap/المقدمة
  • artvirt/إعادة توجيه المقالات
  • arttexte/المادة
  • artdate/التاريخ
  • artdate_redac/تاريخ النشر السابق
  • artauteurs/المؤلفون
  • logoart/شعار المقال
  • artstatut/وضعية المقال
  • artprop/إقتراح مقال

الأقسام

  • rubhier/تنظيم الأقسام الهرمي
  • rubrub/اختيار القسم
  • rublogo/شعار القسم

الأخبار

  • breves/الأخبار
  • brevesrub/اختيار القسم
  • breveslien/وصلة هايبرتكست
  • brevesstatut/وضعية الخبر
  • breveslogo/شعار الخبر

صور ومستندات

  • ins_img/إدراج صور
  • ins_doc/ارفاق مستندات
  • ins_upload/تثبيت الملفات عبر بروتوكول FTP او SSH

المفاتيح

  • mots/مفهوم المفاتيح
  • artmots/المفاتيح
  • motsgroupes/مجموعات المفاتيح

المواقع المبوبة

  • reference/تبويب موقع
  • rubsyn/المواقع المرخصة
  • artsyn/المقالات المرخصة
  • confhttpproxy/إستخدام جهاز وكيل

المراسلة الداخلية

  • messut/الرسائل بين المستخدمين
  • messpense/المذكرات
  • messcalen/الروزنامة
  • messconf/تخصيص المراسلة

متابعة المنتديات

  • suiviforum/متابعة المنتديات

إعداد الموقع

  • confnom/إسم موقعك وعنوانه
  • confart/محتوى المقالات
  • confdates/المقالات المؤجلة
  • confforums/تشغيل المنتديات
  • confbreves/نظام الأخبار
  • confmessagerie/المراسلة الداخلية
  • confstat/أحصاءات الزيارات
  • confmails/البريد الالكتروني الآلي
  • confmoteur/محرك البحث المدمج [4]

إعداد الواجهة الشخصية

  • intersimple/واجهة مبسّطة \ كاملة [5]
  • cookie/كعكة الإدارة
  • deconnect/الخروج

استخدامات متطورة

  • artmodif/مقالات قيد التعديل
  • suivimodif/متابعة التعديلات
  • corrortho/تدقيق الإملاء [6]
  • previsu/العرض المسبق
  • latex/المعادلات الرياضية
  • confurl/أنواع عناوين URL

SPIP برنامج حر

  • licence/الترخيص وشروط الاستخدام

إضافة فصل جديد في القائمة اليمنى

قد نرغب في إضافة فصل جديد في القائمة اليمنى (حيث عناوين الفصول معروضة بخلفية ملونة).
يكفي لذلك إضافة علامة <h1> </h1> في ملف ar-aide.html:

<body>
<h1>تعليمات خاصة شخصية</h1>
<h2>block_custom/تعليمات حول هذا العنصر</h2>
<h3 class="spip">كيفية استخدام هذا العنصر</h3>
<p>
هنا فقرة تعليمات شخصية.
</p>
<p>
إضافة فقرة تعليمات شخصية أخرى.
</p>
<h2>another_block_custom/تعليمات حول عنصر آخر</h2>
<h3 class="spip">كيفية استخدام عنصر آخر</h3>
<p>
فقرة تعليمات شخصية أخرى.
</p>
</body>
 

ترتيب ملفات التعليمات وتنظيمها

قد ترغب في تنظيم ملفات التعليمات الإضافية في مجلد فرعي محدد («my_help» مثلاً)، يجب إذاً الإعلان في ملف «mes_options.php»:

$GLOBALS['help_server'][] = url_de_base(1) . 'squelettes/my_help/';
 

أنظر أيضاً علامة #AIDER

حواشي

[1في ما يتعلق بالملحقات، («myplugin») مثلاً يتم الإعلان عن عنوان URL في ملف myplugin_options.php. مثلاً:
$GLOBALS['help_server'][] = url_de_base(1) . str_replace("../", "", _DIR_PLUGIN_MYPLUGIN);
او اذا كنت تفضل تخزين ملفاتك في مجلدات فرعية محددة:
$GLOBALS['help_server'][] = url_de_base(1) . str_replace("../", "", _DIR_PLUGIN_MYPLUGIN) . "my_help/";.

[2في حال تعدد اللغات، إنشاء ملف لكل لغة مستخدمة بإضافة اختصار اللغة المناسب لاسم الملف: es-aide.html ،en-aide.html، fr-aide.html...

[3نذكر أنه لعرض هذه الإضافات الشخصية، يجب تفريغ الذاكرة المخبأة (لحذف مجلد tmp/cache/aide/).

[4تم التخلي عنه في spip2

[5تم التخلي عنه في spip2

[6تم التخلي عنه في spip2

مؤلف aaddllii, George نُشر في: تم التحديث: 26/10/12

الترجمات: عربي, català, English, français, Nederlands, українська