حلقة RUBRIQUES (الأقسام)

تسترجع حلقة RUBRIQUES قائمة... بالأقسام (يا سبحان الخالق!)

<BOUCLEn(RUBRIQUES){critiria...}>

ملاحظة. لا تعرض حلقة RUBRIQUES الا الأقسام «النشطة»، اي الأقسام التي تحتوي على مقالات منشورة او مستندات مرفقة او مواقع منشورة او أقسام فرعية نشطة. هكذا نتجنب في الموقع العمومي وجود أقسام تشكل طريقاً مسدوداً لا توفر اي وسيلة تصفح الا انه منذSPIP 1.7.1 صار من الممكن فرض عرض الاقسام الفارغة.

معايير اختيار الأقسام

نستخدم احد المعايير (criteria) التالية لنحدد كيفية اختيار الأقسام في الحلقة.

 {id_rubrique} (الرقم التسلسلي للقسم). يسترجع القسم الذي يحمل الرقم التسلسلي id_rubrique. وبما ان هذا الرقم فريد، لا يسترجع هذا المعيار الا قسم واحد او صفر أقسام.

 {id_secteur} (الرقم التسلسلي للقسم الاساسي). يسترجع الأقسام الموجودة في القسم الاساسي الذي يحمل هذا الرقم التسلسلي (يمكن كذلك استخدام المعيار {branche} المفصل في حلقة ARTICLES (المقالات)).

 {id_parent}. يسترجع قائمة بالأقسام الموجودة في القسم الذي يحمل هذا الرقم.

 {racine} (الجذر). يسترجع قائمة بالأقسام التي تطابق بدقة {id_parent=0}.

 {id_enfant}. يسترجع القسم الذي يحتوي هذا القسم (نتيجة واحدة او صفر اذا كان القسم في اصل الموقع).

 {meme_parent}. يسترجع قائمة بالأقسام التي تتبع القسم الذي يتبع له القسم الحالي. ويتيح عرض الأقسام «الشقيقة» الموجودة في المستوي نفسه من الهرم.

 {recherche}. يسترجع الأقسام التي يتم العثور عليها من خلال محرك البحث المدمج في SPIP. راجع المقال المخصص لمحرك البحث.

 يمكن ربط الأقسام بمفاتيح. بالتالي يمكن استخدام معايير المفاتيح في حلقات (RUBRIQUES) هكذا:

• {id_mot} (الرقم التسلسلي للمفتاح) و{titre_mot=س س س س} (اسم المفتاح). يسترجعان الأقسام المرتبطة بالمفتاح الذي يحمل الرقم id_mot او بالمفتاح الذي يحمل اسم «س س س س».
• {id_groupe} و{type_mot=ص ص ص ص}. يتيحان اختيار الأقسام المرتبطة بمفاتيح من المجموعة id_groupe، او من المجموعة التي تحمل الاسم type_mot.

 {tout} (اي «الكل»). منذ [SPIP 1.7.1] يعرض الاقسام الفارغة اضافة الى الاقسام التي تحتوي على عناصر منشورة. يقتصر هذا الخيار على حالات محددة؛ والحال ان SPIP لا يعرض افتراضياً في الموقع العمومي الاقسام التي لا تحتوي عناصر نشطة لتجنب عرض اي «طريق مسدود» (اي الوصول الى صفحات لا تقدم اي محتوى).

 {lang} (اي «اللغة»). منذ [SPIP 1.7.1] بحدد الاقسام ذات اللغة المطلوبة في عنوان الصفحة.

معايير العرض

بعد تحديد احد المعايير اعلاه، يمكن اضافة المعايير التالية للحد من عدد الأقسام التي نريد عرضها.

 يمكن بالطبع تطبيق المعايير المشتركة لكل الحلقات.

 {exclus} (اي مستثنى) ويتيح استثناء القسم الذي نوجد فيه من الأقسام المعروضة (وهو مفيد اذا تم استخدامه مع معيار meme_parent).

علامات هذه الحلقة

العلامات المسترجعة من قاعدة البيانات

تعود العلامات التالية الى العناصر المسترجعة مباشرة من قاعدة البيانات. يمكنك استخدامها ايضاً كمعايير فرز وترتيب (عادة {par titre} اي حسب اسم القسم).

 #ID_RUBRIQUE يعرض الرقم التسلسلي الفريد للقسم.

 #TITRE يسترجع اسم القسم.

 #DESCRIPTIF يسترجع الوصف.

 #TEXTE يسترجع النص الاساسي للقسم.

 #ID_SECTEUR الرقم التسلسلي للقسم الاساسي الذي يحتوي القسم (نذكر ان القسم الاساسي هو القسم الموجود في اصل الموقع).

 #LANG يسترجع لغة القسم الاساسي.

العلامات التي يحسبها SPIP

العلامات التالية ناتجة عن المعالجة التي يقوم بها SPIP وبالتالي لا يمكن استخدامها كمعايير ترتيب وفرز.

 #NOTES الحواشي (يحسبها SPIP من خلال تحليل نص القسم).

 #INTRODUCTION (اي المقدمة): اول 600 حرف من نص القسم ويتم الغاء تنسيق النص.

 #URL_RUBRIQUE هو عنوان URL لصفحة القسم.

 #DATE وهو تاريخ آخر ما نشر في القسم و\او اقسامه الفرعية (مقالات او اخبار...).

 #FORMULAIRE_FORUM (اي استمارة المنتدى) تبني الواجهة التي تتيح ارسال مداخلة تعقّب على القسم.

 #PARAMETRES_FORUM (اي قيم المنتدى) تنشئ قائمة المتغيرات التي تستخدمها واجهة استمارة المنتدى. مثلاً:
 [<A HREF="forum.php3?(#PARAMETRES_FORUM)"> التعقيب على هذا القسم</A>]

 #FORMULAIRE_SITE يعرض واجهة تتيح لزوار الموقع اقتراح تبويب مواقع. وتظهر هذه المواقع كمواقع «مقترحة» في المجال الخاص بانتظار التصديق عليها من قبل احد المدراء.

ولا تظهر هذه الاستمارة في الموقع العمومي الا اذا تم تفعيل خيار «إدارة دليل للمواقع» في صفحة اعداد الموقع في المجال الخاص واذا تم اعطاء خيار «من يمكنه اقتراح مواقع مبوبة؟» قيمة «زوار الموقع العمومي».

الرمز

 #LOGO_RUBRIQUE وهو رمز القسم ويمكن اضافة رمز حوم اليه (اي تغيير الرمز عندما يحوم مؤشر الفأرة فوقه). واذا كان القسم لا يملك رمزاً، يبحث SPIP تلقائياً عن رمز القسم الذي يحتوي هذا القسم وهكذا دواليك حتى اصل الموقع.

ويتم وضع الرمز بالطريقة التالية:

[(#LOGO_RUBRIQUE|alinement|address)]

 #LOGO_RUBRIQUE_NORMAL يعرض الرمز دون الحوم، و#LOGO_RUBRIQUE_SURVOL لعرض رمز الحوم. وتتيح هاتان العلامتان مثلاً، التحكم برمز مع حوم للوصلات الى الأقسام الاخرى والابقاء على رمز الحوم فقط للقسم الذي نوجد فيه.