معايير الاختيار
نستخدم احد المعايير (criteria) التالية لنحدد كيفية اختيار العناصر في الحلقة.
– {id_forum} (الرقم التسلسلي للمنتدى). يسترجع المشاركة التي تحمل الرقم التسلسلي id_forum. وبما ان هذا الرقم فريد، لا يسترجع هذا المعيار الا مشاركة واحدة او صفر مشاركات.
– {id_article} (الرقم التسلسلي للمقال). يسترجع المشاركات التابعة لهذا المقال.
– {id_rubrique} (الرقم التسلسلي للقسم). يسترجع المشاركات التابعة لهذا القسم. تنبيه، لا نتكلم هنا عن مشاركات مقالات القسم بل عن مشاركات القسم نفسه. والحال فمن الممكن تفعيل منتدى لكل قسم في المجال الداخلي.
– {id_breve} (الرقم التسلسلي للخبر). يسترجع المشاركات التابعة لهذا الخبر.
– {id_syndic} (الرقم التسلسلي للترخيص). يسترجع المشاركات العائدة لهذا الموقع.
– {id_thread} (الرقم التسلسلي للخيط). جاء به [SPIP 1.8]. يسترجع مشاركات هذا الخيط.
ملاحظة: في الحقيقة id_thread ليس الا رقم المشاركة id_forum التي تفتح خيط نقاش (رأس الخيط).
– {id_parent} (الرقم التسلسلي للنسب). يسترجع المشاركات التابعة لمشاركة اخرى هي النسب. وهو ضروري للتحكم بخيوط المشاركات (threads) في المنتدى.
– {id_enfant}. يسترجع المشاركة التي تتبع لها المشاركة الحالية (وهو يتيح «الصعود» في هرمية خيوط المشاركات).
– {meme_parent}. يسترجع المشاركات الاخرى التي تردّ على المشاركة التي تردّ عليها المشاركة الحالية.
– {plat} (مسطّح) او {tout} (الكل). يعرض كل المشاركات دون اعتبار هرميتها: باستخدام هذا المعيار، يمكنك اختيار كل المشاركات مهما كان موقعها في الخيط (دون تجاهل المعايير الاخرى طبعاً). ويتيح ذلك عرض المشاركات بترتيب زمني محض مثلاً، او تعداد مجموع المشاركات في المنتدى.
ملاحظة: اذا غاب معيارا {id_forum} او {id_parent}، في حال عدم استخدام {plat}، تعرض المشاركات التي ليس لها سلف فقط (اي الك الموجودة في اعلى الخيوط).
– {id_secteur} (الرقم التسلسلي للقسم الاساسي). يسترجع المشاركات التابعة لهذا القسم الاساسي. وهو قليل الفائدة من حيث المبدأ، الا انه يتيح، مثلاً، انشاء منتدى كبير ينحصر في موضوع معين ويجمع كل المشاركات العائدة لقسم اساسي مهما كان مكانها.
– منذ SPIP 1.4 يمكن ربط مشاركات المنتديات بمفاتيح. يمكن اذاً استخدام معاير المفاتيح في حلقات (FORUMS):
*- {id_mot} (الرقم التسلسلي للمفتاح) و{titre_mot=س س س س} (اسم المفتاح). يسترجعان المشاركات المرتبطة بالمفتاح الذي يحمل الرقم id_mot او بالمفتاح الذي يحمل اسم «س س س س».
*- {id_groupe} و{type_mot=ص ص ص ص}. يتيحان اختيار المشاركات المرتبطة بمفاتيح من المجموعة id_groupe، او من المجموعة التي تحمل الاسم type_mot.
معايير العرض
– يمكن تطبيق المعايير المشتركة لكل الحلقات.
علامات هذه الحلقة
– العلامات المسترجعة من قاعدة البيانات
تعود العلامات التالية الى العناصر المسترجعة مباشرة من قاعدة البيانات. يمكنك استخدامها ايضاً كمعايير فرز وترتيب (عادة {par titre} اي حسب عنوان المشاركة).
– #ID_FORUM يعرض الرقم التسلسلي الفريد للمشاركة.
– #ID_THREAD جاء به [SPIP 1.8]. يعرض رقم خيط النقاش الذي تعود له هذه المشاركة (وهو رأس id_forum خيط النقاش).
– #URL_FORUM، منذ [SPIP 1.8] يعطي العنوان الاساسي للصفحة التي تعرض المشاركة (باستخدام العناوين العادية في SPIP مثلاً، article.php3?id_article=8#forum15 للمشاركة 15 المرتبطة بالمقال 8).
– #ID_BREVE يعرض معرّف الخبر الذي ترتبط به المشاركة. يجب الانتباه الى ان هذه العملية ليست دورية: فالمشاركة التي تردّ على مشاركة مرتبطة بالخبر لا تحتوي رقم هذا الخبر.
– #ID_ARTICLE معرّف المقال الذي تعقّب عليه المشاركة.
– #DATE تاريخ نشر المشاركة.
– #TITRE عنوان المشاركة.
– #TEXTE نص المشاركة.
– #NOM_SITE اسم الموقع الذي قد يذكره صاحب المشاركة في نصه.
– #URL_SITE عنوان URL لهذا الموقع.
– #NOM اسم صاحب المشاركة.
– #EMAIL عنوانه الالكتروني في تنسيق حاضر للإرسال (اذ يدمج علامة mailto). وتستخدم هذه العلامة هكذا [(#EMAIL)] للحصول على العنوان الظاهر كما على الرابط للنقر على هذا العنوان.
– #IP عنوان IP لصاحب المشاركة حين ارسل مشاركته.
– العلامات التي يحسبها SPIP
– #FORMULAIRE_FORUM (اي استمارة المنتدى) تبني الواجهة التي تتيح ارسال مداخلة. لمزيد من المعلومات أنظر الاستمارات.
– #PARAMETRES_FORUM (اي قيم المنتدى) تنشئ قائمة المتغيرات التي تستخدمها واجهة استمارة المنتدى. مثلاً:
[<a href="spip.php?page=forum&(#PARAMETRES_FORUM)">التعقيب على هذه المشاركة</a>]
منذ [SPIP ١.٨.٢] يمكن إضافة متغير الى هذه العلامة يحدد عنوان العودة بعد إرسال المشاركة. مثلا:
<a href="spip.php?page=forum&(#PARAMETRES_FORUM{#SELF})">التعقيب على هذه المشاركة</a> تعيد الى الصفحة الحالية بعد التصديق على المشاركة.
لمحة تاريخية: في الإصدارات السابقة لـ[SPIP ١.٩] كان يجب كتابة
forum.php3?وليسspip.php?page=forum&.بشكل عام وحتى [SPIP ١.٩]، كانت عناوين الصفحات التي ينتجها SPIP على شكل
http://mysite.net/xxx.php3وليسhttp://mysite.net/spip.php?page=xxx.