حلقة DOCUMENTS (المستندات)

تسترجع حلقة DOCUMENTS قائمة بمستندات الوسائط المتعددة المرتبطة بمقال او قسم او الصور الموجودة في خبر.

لا تكتفي هذه الحلقة باسترجاع المستندات المرفقة التي ليست داخل مادة المقال، لكنها تصل ايضاً الى صور المقال (فمنذ الاصدار 1.4، يتعامل النظام مع الصور على انها مستندات) والمصغرات والمستندات المدرجة في مادة المقال.

للتذكير، غالباً ما سنستخدم حلقة DOCUMENTS مع المعيارين التاليين على الاقل:

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

تستخدم حلقة DOCUMENTS عادة داخل حلقة مقال او قسم (احياناً في خبر، الا ان الاستخدام هنا ينحصر في استرجاع الصور).

 {id_article} (الرقم التسلسلي للمقال). يسترجع مستندات المقال الذي يحمل الرقم التسلسلي id_article.

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

{id_breve} (الرقم التسلسلي للخبر). يسترجع مستندات الخبر الذي يحمل الرقم التسلسلي id_breve(لا يمكن ارفاق مستندات وسائط متعددة بالاخبار، يمكن فقط ارفاق صور. لذلك فاستخدام حلقة DOCUMENTS هنا محدد للغاية).

ملاحظة: لا يمكن هنا استخدام معيار {id_secteur}. فقد تم تصميم المستندات لتكون مرتبطة بقوة بالمقالات والاقسام وليس ليتم نداؤها بمفردها بدون هذه العناصر (لذا نستخدم في SPIP عبارة «مستندات مرفقة»).

معايير العرض

 {mode=document} او {mode=image}، يسمحان باختيار نوع المستندات التي نريد استرجاعها: مستندات وسائط متعددة او صور (والحال انه يتم التعامل مع الصور المرتبطة بالمقالات والمدرجة في مادتها على انها مستندات بوضعية mode=image).

ملاحظة. في مواقع SPIP السابقة للاصدار 1.4، كان من المعتاد عدم عرض الصور التي لم يتم ادراجها داخل مادة المقال. وفي هذه الحال، اذا قمت بإضافة حلقة DOCUMENTS في وضعية mode=image في موقع من هذا النوع، قد تظهر في الحلقة صور لم تكن مخصصة للنشر في الموقع العمومي. اذاً لا تستخدم هذه الحلقة الا في موقع تم تطويره بالاصدار 1.4 من SPIP او احدث، او توخى الحذر في استخدامها (تأكد من انه لا توجد صور غير مرغوبة مرتبطة بالمقالات القديمة).

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

 {extension=...}، يتيح اختيار المستندات حسب لاحقة اسماء ملفاتها (مثلاً «mov» او «ra» او «avi» لمشاهد الفيديو...). يمكن استخدام هذا المعيار مثلاً، لإنشاء «معرض» اي بناء حلقة لا تعرض الا المستندات من نوع الصور واخرى بتصميم مختلف لعرض باقي المستندات:

هذه الحلقة، BOUCLE_portfolio، تسترجع المستندات المرفقة بمقال والتي لم تعرض في مادته والتي تحمل اللواحق «jpg» او «png» او «gif».

 {doublons} يأخذهنا اهمية خاصة: فلا يتيح عدم عرض مستندات سبق عرضها في حلقة اخرى وحسب، بل كذلك، عدم عرض المستندات التي سبق وتم دمجها في المقال. واذا نسينا اضافة هذا المعيار، سيتم عرض كل المستندات المرافقة للمقال بما فيها تلك التي سبق وظهرت داخل مادة المقال [1].

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

 #LOGO_DOCUMENT تعرض رمز المستند (اي المصغّر) المرفق بالمقال. واذا لم يتم تثبيت مصغّر شخصي يديوياً، يستخدم SPIP مصغّراًً افتراضياً يناسب نوع ملف المستند.

 #URL_DOCUMENT عنوان URL لملف الوسائط المتعددة. يستخدم لعرض مضغّر يمكن نقره لفتح مستند الوسائط المتعددة. ويتم استخدام الامر التالي:

 #TYPE_DOCUMENT تعرض نوع المستند (ملف كويك تايم او ريل بلاير...).

 #TAILLE تعرض حجم الملف بالبايت. في حال الملفات الكبيرة، تصبح هذه القيمة كبيرة الى حد يتعذر عرضها، لذلك يستحسن استخدام المرشح #taille_en_octets الذي يعرض الحجم بالبايت والكيلوبايت وحتى الميغابايت:

 #LARGEUR (العرض) و#HAUTEUR (الارتفاع) توفران الابعاد بالنقاط.

 #ID_DOCUMENT تعرض الرقم التسلسلي للمستند.

 #EMBED_DOCUMENT هي علامة ذات استخدام محدد: فتتيح الادراج المباشر للملفات ذات التنسيق المسموح به (مشاهد الفيديو او الاصوات) في صفحة من صفحات الموقع. ينصح بعدم استخدام هذه العلامة بإفراط لأنه لا يحبذ ادراج المستندات مباشرة في الصفحات دون تحكم متشدد (الا اذا اردت لفترات تحميل الصفحات ان تصبح ضخمة). ويمكن اتمام العلامة بقيم خاصة بالتنسيقات المستخدمة، مثلاً: