معايير الاختيار
نستخدم احد المعايير (criteria) التالية لنحدد كيفية اختيار العناصر في الحلقة.
– {tout} (اي «الكل»). يتم اختيار كل المفاتيح في الموقع.
– {id_mot} (الرقم التسلسلي للمفتاح). يسترجع المفتاح الذي يحمل الرقم التسلسلي id_mot الفريد.
– SPIP 1.4 {id_groupe} (الرقم التسلسلي للمجموعة) يسترجع المفاتيح التي تعود الى هذه المجموعة.
– SPIP 1.4 {id_article} يسترجع المفاتيح المرتبطة بهذا المقال (وهو الاستخدام الاكثر شيوعاً لهذه الحلقة).
– SPIP 1.4 {id_rubrique} (الرقم التسلسلي للقسم). يسترجع المفاتيح المرتبطة بهذا القسم.
– SPIP 1.4 {id_breve} (الرقم التسلسلي للخبر). يسترجع المفاتيح المرتبطة بهذا الخبر.
– SPIP 1.4 {id_syndic} يسترجع المفاتيح المرتبطة بموقع مبوّب.
– SPIP 1.4 {id_forum} يسترجع المفاتيح المرتبطة بمشاركة منتدى (يجدر التنبيه الى استخدام خاص جداً في هذه الحالة)
– {titre=تاريخ} يسترجع المفتاح «تاريخ» (مثلاً).
– {type=مواضيع} يسترجع المفاتيح الموجودة في مجموعة المفاتيح «مواضيع» (مثلاً).
معايير العرض
يمكن بالطبع تطبيق المعايير المشتركة لكل الحلقات.
علامات هذه الحلقة
العلامات المسترجعة من قاعدة البيانات
تعود العلامات التالية الى العناصر المسترجعة مباشرة من قاعدة البيانات. يمكنك استخدامها ايضاً كمعايير فرز وترتيب (عادة {par titre} اي حسب اسم المفتاح).
– #ID_MOT يعرض الرقم التسلسلي الفريد للمفتاح.
– #TITRE يعرض اسم المفتاح.
– #DESCRIPTIF يعرض وصف المفتاح.
– #TEXTE يعرض النص العائد للمفتاح.
– #TYPE هو المجموعة التي تحتوي المفتاح (على سبيل المثال، يمكن للمجموعة «مواضيع» ان تحتوي المفتاح «تاريخ»).
– #LOGO_MOT SPIP 1.4 يعرض رمز المفتاح (ملاحظة: هناك كتابة جديدة لتمرير المتغيرات الى شعارات LOGO_XX منذ SPIP ٢.١.
– #URL_MOT يعرض عنوان المفتاح.
الحلقة GROUPES_MOTS
لا تستخدم الحلقة GROUPES_MOTS (اي مجموعات الحلقات) كثيراً ولكن يتحتم ذكرها هنا. فإذا كان لديك عدة مجموعات مفاتيح، تتيح هذه الحلقة اختيار هذه المجموعات وانشاء صفحة، مثلاً، تحصي كل المفاتيح وترتبها حسب مجموعاتها ثم ابجدياً في داخل كل مجموعة، كما في الفقرة التالية:
<BOUCLE_groups(GROUPES_MOTS){par titre}>
<h1>#TITRE</H1>
<BOUCLE_keywords(MOTS){id_groupe}{par titre}{“ - “}>
#TITRE
</BOUCLE_keywords>
</BOUCLE_groups>
اما العلامات والمعايير المرتبطة بهذه الحلقة، فهي:
– #ID_GROUPE وهو معرّف مجموعة المفاتيح (يكون متوافراً ايضاً في حلقة MOTS).
– #TITRE وهو اسم المجموعة (وفي حلقة MOTS يمكن استخدام #TYPE لعرض هذه القيمة).