اذا كنا قد رخّصنا مواقع مبوبة، تستخدم هذه الحلقة برفقة حلقة SYNDIC_ARTICLES التي تسترجع قائمة بمقالات هذه المواقع.
لمحة تاريخية:قبل SPIP 1.3 كان اسم هذه الحلقة SYNDICATION لأن المواقع المرخّصة وحدها هي التي كان يمكن تبويبها.
<BOUCLEn(SYNDICATION){criteria...}>فالإسمان متساويان تماماً (الا ان «SITES» تناسب اكثر وظيفة التبويب التي يفترض ان تنجزها منذ الاصدار ١.٣، علماً بأن الترخيص يصبح احد خيارات هذه الوظيفة).
معايير الاختيار
نستخدم احد المعايير (criteria) التالية لنحدد كيفية اختيار العناصر في الحلقة.
– {tout} (اي الكل). يتم اختيار كل المواقع المبوبة.
– {id_syndic} (الرقم التسلسلي للموقع المرخص). يسترجع الموقع المرخص الذي يحمل الرقم التسلسلي id_syndic الفريد.
– {id_rubrique} (الرقم التسلسلي للقسم). يسترجع المواقع المبوبة الموجودة في القسم الذي يحمل الرقم التسلسلي id_rubrique الفريد.
– {id_secteur} (الرقم التسلسلي للقسم الاساسي). يسترجع المواقع المبوبة الموجودة في القسم الاساسي الذي يحمل هذا الرقم التسلسلي (ونذكر ان الاقسام الاساسية هي الاقسام الموجودة في اصل الموقع او اعلى التنظيم الهرمي وليس داخل اقسام اخرى).
– {id_mot} (الرقم التسلسلي للمفتاح) منذ SPIP 1.3: يسترجع المواقع المبوبة المرتبطة بالمفتاح الذي يحمل هذا الرقم ويكون في السياق (داخل حلقة من نوع (MOTS) او متغير في عنوان URL الخ).
– {titre_mot=xxxx} (اسم المفتاح) او {type_mot=yyyy} (نوع المفتاح) منذ SPIP 1.3 يسترجعان المواقع المبوبة المرتبطة بالمفتاح الذي يحمل اسم «xxxx» او المرتبطة بالمفاتيح العائدة الى مجموعة المفاتيح «yyyy». يجب التنبيه الى انه اذا ادخلما عدة معايير {titre_mot=xxxx} او {type_mot=yyyy} سيتم استرجاع المواقع التي تملك كل هذه المفاتيح في وقت واحد (SPIP ١.٩ تم ادخل هذه الميزة).
– {id_groupe=zzzz} (الرقم التسلسلي لمجموعة المفاتيح) منذ SPIP 1.4 يتيح اختيار المواقع المبوبة المرتبطة بمجموعة مفاتيح، وهو يعادل {type_mot} ولكن بما اننا ادخلنا رقماً تسلسلياً تكون الصيغة الاملائية للامر «انظف».
معايير العرض
يمكن بالطبع تطبيق المعايير المشتركة لكل الحلقات.
– {syndication=oui} او {syndication=non} (منذ SPIP 1.3) يتيحان عرض المواقع المبوبة المرخصة فقط او تلك المبوبة لكن غير المرخصة.
– {moderation=oui} (اي مع مراقبة) منذ SPIP 1.4 ويعرض المواقع المرخصة ذات الوصلات المصدودة استباقياً (اي «مراقبة»). اما عكس هذا المعيار فهو {moderation!=oui}.
علامات هذه الحلقة
العلامات المسترجعة من قاعدة البيانات
تعود العلامات التالية الى العناصر المسترجعة مباشرة من قاعدة البيانات. يمكنك استخدامها ايضاً كمعايير فرز وترتيب (مثلاً: {par nom_site} اي حسب اسم الموقع).
– #ID_SYNDIC تعرض الرقم التسلسلي الفريد للموقع المرخص. مثلاً، للذهاب الى الصفحة التي تصف الموقع (وهي site.html في مجلد dist/) نكتب:
<BOUCLE_sites(SITES) {id_rubrique} {par nom_site}>
<li><a href="[(#ID_SYNDIC|generer_url_site)]">#NOM_SITE</a></li>
</BOUCLE_sites>تنبيه: هذه الكتابة لا تصلح الا لإصدارات SPIP السابقة للإصدار ٢. في الإصدار ٢ وما بعده يجب استخدام الكتابة:
<BOUCLE_sites(SITES) {id_rubrique} {par nom_site}>
<li><a href="[(#ID_SYNDIC|generer_url_entite{site})]">#NOM_SITE</a></li></BOUCLE_sites>– #NOM_SITE هي اسم الموقع المرخص.
– #URL_SITE تسترجع عنوان URL الموقع المرخص.
– #DESCRIPTIF تسترجع وصف الموقع المرخص.
– #ID_RUBRIQUE هي رقم القسم الذي يحتوي على الترخيص.
– #ID_SECTEUR هي رقم القسم الاساسي (اي الموجود في اصل الموقع) الذي يحتوي على الترخيص.
علامات اخرى
– #LOGO_SITE تعرض الرمز المخصص للموقع.
– #URL_SYNDIC تعرض عنوان URL لملف ترخيص الموقع.
– #FORMULAIRE_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 ١.٩، كانت عناوين URL التي ينتجها SPIP من نوع
http://mysite.net/xxx.php3وليسhttp://mysite.net/spip.php?page=xxx.