حلقة ARTICLES (المقالات)

تتم برمجة حلقة المقالات بوضع ARTICLES (لا تنسى S الجمع) بين هلالين:

<BOUCLEn(ARTICLES){criteria...}>

فالعناصر الموجودة في هذه الحلقة هي مقالات.

ملاحظة. لا تسترجع حلقة ARTICLES الا مقالات منشورة (فلا توجد اية وسيلة تتيح عرض المقالات «قيد التحرير» او «المعروضة للتقييم» او «المرفوضة»).

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

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

 {tout} (اي «الكل»). يتم اختيار كل المقالات المنشورة في الموقع (وفي كل الاقسام). وهذا المعيار مفيد اذا اردنا عرض احدث المقالات (الموجودة في كامل الموقع) في الصفحة الرئيسية. (في الحقيقة لا تتم معالجة المعيار «tout» كأمر برمجي: انه تذكير للمطور فقط اذ نحصل على النتيجة نفسها اذا لم نستخدم اي معيار في الحلقة).

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

 {id_rubrique} (الرقم التسلسلي للقسم). يسترجع المقالات الموجودة في القسم الذي يحمل الرقم التسلسلي id_rubrique.

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

 [SPIP 1.4]: المعيار {branche} (الفرع) يسترجع مجموع المقالات الموجودة في القسم واقسامه الفرعية. (انه نوع من الامتداد لمعيار {id_secteur}. الا انه، على عكس {id_secteur=2}، لا يمكن تحديد فرع مباشرة بواسطة {branche=2}: فمن الناحية التقنية يجب على القسم المطلوب ان يكون في السياق النشط. ينصح باستخدام هذا المعيار بحذر فإذا كان الموقع جيد البنية، ليس من المتوقع ان تحتاج اليه الا في حالات خاصة جداً).

 {id_auteur} (الرقم التسلسلي للمؤلف). يسترجع المقالات التي كتبها المؤلف رقم id_auteur.

 {id_mot} (الرقم التسلسلي للمفتاح). يسترجع المقالات المرتبطة بالمفتاح الذي يحمل هذا الرقم (وهو مفيد للحصول على المقالات المتعلقة بموضوع معين مثلاً).

 [SPIP 1.3]: المعياران {titre_mot=س س س س} (اسم المفتاح) او {type_mot=ش ش ش ش} (نوع المفتاح) يسترجعان المقالات المرتبطة بالمفتاح الذي يحمل اسم «س س س س» او المرتبطة بالمفاتيح العائدة الى مجموعة المفاتيح «ش ش ش ش». يجب التنبيه بأنه لا يمكن استخدام عدة معايير {titre_mot=س س س س} او {type_mot=ش ش ش ش} في حلقة واحدة.

 [SPIP 1.4]: المعيار {id_groupe=ص ص ص ص} (الرقم التسلسلي لمجموعة المفاتيح) يتيح اختيار المقالات المرتبطة بمجموعة مفاتيح، وهو يعادل {type_mot} ولكن بما اننا ادخلنا رقماً تسلسلياً تكون الصيغة الاملائية للامر «انظف». [ملاحظة: في وضع SPIP الحالي، لا يمكن اضافة هذا المعيار الى المعيار السابق {type_mot=ش ش ش ش}].

 [SPIP 1.7.1] المعيار {lang} يسترجع مقالات اللغة المطلوبة في عنوان الصفحة.

 [SPIP 1.7.2] تتيح المعايير {date} (او {date=...} او {date==...}) استرجاع مقال بالاعتماد على التاريخ الذي تم تمريره في عنوان url.

 {recherche} (اي بحث) يسترجع المقالات التي تم العثور عليها من جراء البحث عن كلمة معينة في واجهة البحث في الموقع. راجع المقال المخصص لمحرك البحث.

معايير العرض

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

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

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

 {doublons} (اي متكرر) او {unique} (اي فريد): هذان المعياران متطابقان تماماً ويتيحان منع عرض مقالات تم عرضها في حلقات اخرى في الصفحة تحتوي هي ايضاً على المعيار {doublons}.

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

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

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

 #ID_ARTICLE يعرض الرقم التسلسلي الفريد للمقال. وهو مفيد لإنشاء وصلات هايبرتكست غير متوقعة (مثلاً الى صفحة «طباعة هذا المقال»).

 #SURTITRE يسترجع العنوان المدخل للمقال.

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

 #SOUSTITRE يسترجع العنوان الفرعي.

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

 #CHAPO يسترجع المقدمة.

 #TEXTE يسترجع مادة المقال.

 #PS يسترجع الملاحظة.

 التواريخ: #DATE, #DATE_REDAC, #DATE_MODIF مفصلة في مقال آخر.

 #ID_RUBRIQUE الرقم التسلسلي للقسم الذي يحتوي المقال.

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

 #VISITES هو عدد الزيارات التي سجلها المقال.

 #POPULARITE هو نسبة شعبية المقال. راجع مقال «شعبية المقالات».

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

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

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

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

 #INTRODUCTION (اي المقدمة): [SPIP 1.4] اذا كان المقال يحتوي على وصف، يتم استخدام هذا الوصف، والا فيعرض SPIP اول 600 حرف من المقال (من المقدمة ثم المادة). [SPIP 1.3] الا ان الاصدارات السابقة من النظام، فتأخذ اول مجموعة من حروف المقال (المقدمة ثم المادة) دون استخدام الوصف.

 #LESAUTEURS مؤلفو المقال. باستخدام هذه العلامة، نتفادى انشاء حلقة AUTEURS (اي حلقة مؤلفين) للحصول على النتيجة نفسها.

 #PETITION وهو نص العريضة اذا وجدت. واذا وجدت وكان نصها فارغاً، يسترجع مسافة (وهي سلسلة غير فارغة لا تؤثر على علامات HTML في الصفحة).

 #URL_ARTICLE وهي عنوان URL لصفحة المقال.

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

 #FORMULAIRE_SIGNATURE (اي استمارة التوقيع) تبني الواجهة التي تتيح التوقيع على عريضة مرتبطة بالمقال.

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

الرموز

 #LOGO_ARTICLE وهو رمز المقال ويمكن اضافة رمز حوم اليه (اي تغيير الرمز عندما يحوم مؤشر الفأرة فوقه).

 #LOGO_ARTICLE_RUBRIQUE رمز المقال الذي يمكن وضع رمز القسم مكانه في حال غيابه.

 #LOGO_RUBRIQUE رمز القسم الذي يحتوي المقال.

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

[(#LOGO_ARTICLE|محاذاة|عنوان)]

ويمكن للمحاذاة ان تكون الى اليمين او اليسار. اما العنوان فهو عنوان URL الذي تؤدي اليه الوصلة المرتبطة بالرمز (مثلاً #URL_ARTICLE). واذا لم نحدد عنوان يبقى الرمز دون وصلة.

اذا اردنا استرجاع اسم ملف الرمز مباشرة، لعرض الصورة كخلفية جدول مثلاً، نستخدم المرشح |file كالتالي: [(#LOGO_ARTICLE|file)].

من ناحية اخرى هناك علامتان تتيحان استرجاع احد الرمزين (الرمز الاساسي ورمز الحوم):

 #LOGO_ARTICLE_NORMAL للرمز دون الحوم،
 #LOGO_ARTICLE_SURVOL لرمز الحوم.